Claude Code: مهارات الوكيل ومُنشئ المهارات

آخر تحديث: 2026-08-31

مهارات الوكيل هي "حزم المهارات المهنية" لـ Claude Code — ثبّت مهارة، ويكتسب Claude Code سير عمل مهني كامل.

💡 نصيحة: المهارات ليست قوالب أوامر بسيطة، بل تعريفات سير عمل كاملة تتضمن خطوات وقوائم تحقق وتنسيقات إخراج ومنطق تحقق. skill-creator يتيح لك تخصيص هذه المهارات.

📋 المتطلبات السابقة: الفصل 15 - نظام الذاكرة

1. ما ستتعلمه


2. مفهوم مهارات الوكيل

(1) ما هي المهارة

المكوّن الوصف
شروط التفعيل أي المهام تُفعّل هذه المهارة
خطوات العمل خطوات تنفيذ مرتبة
نقاط التحقق قائمة تحقق بعد كل خطوة
تنسيق الإخراج تنسيق قياسي للإخراج النهائي
تبعيات الأدوات أي الأدوات مطلوبة

(2) المهارة مقابل التعليمات البسيطة

البُعد التعليمات البسيطة المهارة
البنية نص حر سير عمل منظم
الاكتمال قد تُغفل خطوات نقاط التحقق تضمن الاكتمال
الاتساق قد تختلف كل مرة نفس التدفق كل مرة
إمكانية إعادة الاستخدام لمرة واحدة قابلة لإعادة الاستخدام عبر المشاريع
التحقق بدون تحقق تلقائي تحقق مدمج

▶ مثال 1: المهارة مقابل التعليمات البسيطة

TEXT 📖 للعرض فقط
# تعليمات بسيطة
> راجع جودة كود هذا الملف
[مراجعة حرة الشكل، قد تُغفل جوانب]

# استخدام المهارة
> /skill code-review
[يتبع التدفق المنظم لمهارة مراجعة الكود]
  الخطوة 1: قراءة الملف ✓
  الخطوة 2: فحص الأمان ✓ (حقن SQL، XSS، كشف بيانات حساسة)
  الخطوة 3: فحص الأداء ✓ (استعلامات N+1، تسريبات الذاكرة)
  الخطوة 4: فحص الأسلوب ✓
  الخطوة 5: توليد التقرير ✓
  جميع نقاط التحقق اجتازت

3. المهارات المدمجة والمجتمعية

(1) المهارات المدمجة

المهارة الوظيفة التفعيل
code-review مراجعة الكود /skill code-review
bug-fix سير عمل إصلاح الأخطاء /skill bug-fix
إعادة هيكلة سير عمل إعادة الهيكلة /skill refactor
test-gen توليد الاختبارات /skill test-gen
api-design تصميم واجهة برمجة التطبيقات /skill api-design
security-تدقيق تدقيق أمني /skill security-audit

(2) إدارة المهارات

BASH
# سرد المهارات المتاحة
claude /skills

# تثبيت مهارة مجتمعية
claude /skill install @community/pr-review

# عرض تفاصيل المهارة
claude /skill info code-review

4. أمثلة استخدام المهارات

▶ مثال 2: سير عمل مهارة bug-fix

TEXT 📖 للعرض فقط
> /skill bug-fix "TypeError: Cannot read property 'id' of undefined at UserController.getProfile"

Claude Code [مهارة bug-fix]:
  الخطوة 1: تحديد موضع الخطأ ✓
    → وُجد: getProfile() يصل إلى req.user.id بدون فحص null

  الخطوة 2: تحليل السبب الجذري ✓
    → req.user غير معرّف عندما يفشل وسيط المصادقة بصمت

  الخطوة 3: تصميم الإصلاح ✓
    → إضافة فحص null في getProfile()
    → إصلاح وسيط المصادقة ليرمي استثناء عند الفشل

  الخطوة 4: تنفيذ الإصلاح ✓
    → تعديل UserController.ts و auth.ts

  الخطوة 5: التحقق من الإصلاح ✓
    → تشغيل الاختبارات: 5/5 نجحت ✓

  الخطوة 6: منع التكرار ✓
    → أُضيف اختبار حالة حدية لـ null user

  الخطأ أُصلح ✓ | ملفان معدّلان | اختبار واحد مضاف

5. إنشاء مهارات مخصصة باستخدام skill-creator

(1) بنية تعريف المهارة

YAML
# .claude/skills/my-deployment.yaml
name: deployment
description: "Standardized deployment workflow"
trigger:
  keywords: ["deploy", "deployment"]

steps:
  - name: "Pre-check"
    actions:
      - "Confirm all tests pass"
      - "Check no uncommitted changes"
    checkpoints:
      - "npm test exit code = 0"
      - "git status clean"

  - name: "Build"
    actions:
      - "Run build command"
    checkpoints:
      - "build/ directory exists"

  - name: "Deploy"
    actions:
      - "Push code to remote"
      - "Trigger CI/CD pipeline"
    checkpoints:
      - "git push successful"

  - name: "Verify"
    actions:
      - "Wait for deployment"
      - "Access health check endpoint"
    checkpoints:
      - "HTTP 200 from /health"

output:
  format: "markdown"

▶ مثال 3: استخدام skill-creator

TEXT 📖 للعرض فقط
> /skill-creator create a "database migration" Skill

Claude Code:
  I'll help you create a DB migration Skill. A few questions:
  1. Database tool? Prisma
  2. Migration steps? Modify schema, generate migration, run, verify
  3. Safety checks? Backup database, check reversibility
  4. Output format? Markdown report

  → Creating .claude/skills/db-migration.yaml
  → Skill created ✓
  Usage: /skill db-migration

6. أفضل ممارسات المهارات

(1) متى تنشئ مهارة

السيناريو إنشاء مهارة؟ السبب
سير عمل متكرر ✅ نعم التوحيد مفيد
عمليات حرجة ✅ نعم نقاط التحقق تمنع الإغفال
عمل الفريق ✅ نعم معايير عمل موحدة
مهام لمرة واحدة ❌ لا التعليمات البسيطة تكفي
استعلامات بسيطة ❌ لا هندسة زائدة

(2) مبادئ التصميم

المبدأ الوصف
الحد الأدنى لا تزيد عن 6 خطوات
قابل للتحقق كل خطوة لها نقاط تحقق واضحة
قابل للعكس العمليات الحرجة لديها خطط تراجع
قابل للتركيب المهارات يمكن تداخلها

❓ أسئلة شائعة

س ما الفرق بين المهارة والإضافة؟
ج المهارات تعريفات سير عمل (خطوات+نقاط تحقق)؛ والإضافات توسيعات وظيفية (أدوات+خطافات). المهارات تستخدم أدوات توفرها الإضافات، لكنها مفاهيم مستقلة.
س هل تضمن المهارة الجودة؟
ج ليس 100%. المهارات توفر تدفقات منظمة ونقاط تحقق، لكن جودة التنفيذ تعتمد على قدرة النموذج. العمليات الحرجة يجب أن تُراجع بشرياً.
س هل يمكن إعادة استخدام المهارات عبر المشاريع؟
ج نعم. في ~/.claude/skills/ للمهارات العامة، و.claude/skills/ للمهارات الخاصة بالمشروع.
س هل المهارات المُنشأة بواسطة skill-creator جيدة؟
ج النسخة الأولى قابلة للاستخدام لكن تحتاج تحسيناً. skill-creator يُنشئ الإطار؛ وأنت تحسّن الخطوات ونقاط التحقق حسب احتياجاتك.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): استخدم مهارة code-review المدمجة لمراجعة ملف، وقارنها بالتعليمات البسيطة.
  2. متوسط (⭐⭐): استخدم skill-creator لإنشاء مهارة مخصصة (مثلاً: سير عمل النشر)، واختبر التنفيذ.
  3. متقدم (⭐⭐⭐): أنشئ 3 مهارات أساسية لفريق تغطي تطوير→اختبار→نشر بنقاط تحقق كاملة.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%