مهارات Claude Code: بناء سير عمل مخصص لمساعدك البرمجي بالذكاء الاصطناعي

يأتي Claude Code مزودًا بمساعد ذكاء اصطناعي عام الاستخدام. تتيح لك المهارات تخصيصه. المهارة هي ملف ماركداون يُعلّم Claude Code كيفية التعامل مع نوع معين من المهام: النشر على Kubernetes، كتابة ترحيلات قواعد البيانات، مراجعة طلبات السحب، أو اتباع قواعد الترميز الخاصة بفريقك.

الفرق بين "اكتب لي مكون React" و"اكتب لي مكون React يتبع نظام التصميم الخاص بنا، باستخدام الخطافات المخصصة لدينا، مع حدود أخطاء صحيحة وسمات وصول" هو مهارة.

ما هي المهارات فعليًا

المهارة هي ملف ماركداون في .claude/commands/ (على مستوى المشروع) أو ~/.claude/commands/ (عالمي). عندما تكتب /skill-name في Claude Code، يتم حقن محتوى الملف في المحادثة كتعليمات.

.claude/
  commands/
    deploy.md          # /deploy
    review-pr.md       # /review-pr
    write-test.md      # /write-test

هذا كل شيء. لا حاجة لصيغة خاصة، لا تجميع، ولا SDK. مجرد ماركداون يصف كيفية القيام بشيء ما.

كتابة مهارتك الأولى

إليك مثال عملي: مهارة تفرض قواعد رسائل الالتزام الخاصة بفريقك.

.claude/commands/commit.md:

# سير عمل الالتزام

## الخطوات
1. شغّل `git diff --staged` لرؤية ما يتم الالتزام به
2. حلل التغييرات وصنفها: feat, fix, refactor, docs, test, chore
3. اكتب رسالة الالتزام باتباع القواعد:
   - الصيغة: `type(scope): description`
   - النطاق هو اسم الحزمة أو الوحدة
   - الوصف بصيغة الأمر، بحروف صغيرة، بدون نقطة في النهاية
   - الجسم يشرح السبب WHY، وليس ماذا WHAT
4. إذا شملت التغييرات عدة نطاقات، أنشئ التزامات منفصلة
5. شغّل `git commit -m "message"` مع الرسالة المولدة

## القواعد
- لا تستخدم `--no-verify` لتخطي الخطافات
- لا تعدل الالتزامات المنشورة
- إذا فشلت الاختبارات في pre-commit، أصلح المشكلة أولاً

## أمثلة
- `feat(billing): add stripe webhook handler`
- `fix(auth): handle expired refresh tokens`
- `refactor(api): extract rate limiter to shared package`

الآن /commit يعطي Claude Code سير عمل منظم بدلًا من تعليمات غامضة مثل "التزم بتغييري".

أنماط تصميم المهارات

نمط قائمة التحقق

الأفضل للمهام التي تتطلب خطوات تحقق متعددة.

# قائمة التحقق قبل النشر

قبل النشر، تحقق من كل بند:

- [ ] اجتياز `pnpm typecheck`
- [ ] اجتياز `pnpm test`
- [ ] لا توجد عبارات console.log في كود الإنتاج
- [ ] توثيق متغيرات البيئة في .env.example
- [ ] ترحيلات قاعدة البيانات قابلة للعكس
- [ ] تغييرات API متوافقة مع الإصدارات السابقة

إذا فشل أي تحقق، أوقف العملية وبلغ عن المشكلة. لا تتابع النشر.

نمط شجرة القرار

الأفضل للمهام التي يعتمد فيها النهج على السياق.

# سير عمل إصلاح الأخطاء

1. أعد إنتاج الخطأ (ابحث عن اختبار فاشل أو اكتب واحدًا)
2. حدد السبب الجذري:
   - إذا كان خطأ نوع → أصلح تعريف النوع في المصدر
   - إذا كان حالة تسابق → أضف قفلًا أو ترتيبًا مناسبًا
   - إذا كان نقص تحقق → أضف تحقق المخطط على الحدود
   - إذا كان خطأ منطقي → أصلح وأضف اختبار تراجع
3. تحقق من أن الإصلاح لا يكسر الاختبارات الحالية
4. اكتب اختبارًا كان سيكشف هذا الخطأ

نمط القالب

الأفضل لتوليد مخرجات متسقة.

# نقطة نهاية API جديدة

أنشئ نقطة نهاية API جديدة باتباع قواعدنا:

## هيكل الملفات
- معالج المسار: `apps/api/src/routes/{resource}/{action}.ts`
- المخطط: `apps/api/src/schemas/{resource}.ts`
- الاختبار: `apps/api/src/routes/{resource}/__tests__/{action}.test.ts`

## العناصر المطلوبة
- مخطط Zod للتحقق من الطلب
- وسيط المصادقة
- تحديد معدل الطلبات
- استجابات خطأ منظمة باستخدام errorResponse()
- استجابات نجاح باستخدام successResponse()
- تعليقات توثيق OpenAPI

تثبيت مهارات المجتمع

لدى نظام Claude Code مكتبة متنامية من مهارات المجتمع. ثبّتها باستخدام:

npx add-skill username/repo-name -y

مجموعات المهارات الشهيرة:

• coreyhaines31/marketingskills (29 مهارة تسويق وSEO)
• hedging8563/lemondata-api-skill (تكامل LemonData API)

تظهر المهارات المثبتة في ~/.claude/commands/ وتعمل عبر جميع المشاريع.

مهارات المشروع مقابل المهارات العالمية

الموقع	النطاق	حالة الاستخدام
.claude/commands/	هذا المشروع فقط	قواعد المشروع، سير عمل النشر
~/.claude/commands/	جميع المشاريع	تفضيلات شخصية، أدوات عامة

يجب الالتزام بمهارات المشروع في مستودعك ليستفيد الفريق بأكمله. المهارات العالمية مخصصة لتفضيلات سير العمل الشخصية.

متقدم: المهارات مع الخطافات

يمكن للمهارات الإشارة إلى الخطافات (أوامر شل تُشغل عند أحداث معينة) للفرض التلقائي:

# فحص قبل الالتزام

قبل أي التزام، تُشغل الخطافات التالية تلقائيًا:
- `pre-commit`: يشغل typecheck + lint
- `post-commit`: يحدث سجل التغييرات

إذا فشل خطاف، تحقق من مخرجات الخطأ وقم بإصلاح المشكلة.
لا تستخدم --no-verify لتجاوز الخطافات.

يتم تكوين الخطافات نفسها في .claude/settings.json:

{
  "hooks": {
    "pre-commit": "pnpm typecheck && pnpm lint-staged"
  }
}

نصائح لمهارات فعالة

1. كن محددًا بشأن مسارات الملفات وقواعد التسمية. "إنشاء مكون" غامض. "إنشاء مكون في src/components/ui/ باستخدام تسمية PascalCase" قابل للتنفيذ.

2. أدرج أمثلة على المخرجات الصحيحة. يتعلم Claude Code بشكل أفضل من الأمثلة بدلاً من القواعد المجردة.

3. حدد ما لا يجب فعله. "لا تستخدم نوع any" أكثر قابلية للتنفيذ من "استخدم أنواع صحيحة".

4. حافظ على تركيز المهارات. مهارة واحدة لكل سير عمل. مهارة من 200 سطر تغطي كل شيء أقل فائدة من خمس مهارات من 40 سطرًا تعالج كل منها مهمة واحدة جيدًا.

5. قم بترقيم إصدارات مهاراتك. مع تطور قواعدك، حدّث المهارات. المهارات القديمة أسوأ من عدم وجود مهارات لأنها تفرض أنماطًا قديمة.

الأثر في العالم الحقيقي

تبلغ الفرق التي تعتمد المهارات عن تحسن مستمر:

• دورات مراجعة الكود تنخفض لأن القواعد تُفرض قبل المراجعة
• وقت الانضمام يقل لأن المطورين الجدد يحصلون على نفس التوجيه كالمخضرمين
• جودة الكود المولد بالذكاء الاصطناعي تتحسن لأن الذكاء الاصطناعي لديه سياق صريح عن معايير المشروع

الاستثمار صغير (30 دقيقة لكتابة أولى مهاراتك) والعائد يتراكم مع كل تفاعل.

---

ابنِ باستخدام الذكاء الاصطناعي، موجهًا بقواعدك الخاصة. lemondata.cc توفر بنية API لأدوات التطوير المدعومة بالذكاء الاصطناعي.