Claude Code: مهارات الوكيل ومُنشئ المهارات
آخر تحديث: 2026-08-31
مهارات الوكيل هي "حزم المهارات المهنية" لـ Claude Code — ثبّت مهارة، ويكتسب Claude Code سير عمل مهني كامل.
💡 نصيحة: المهارات ليست قوالب أوامر بسيطة، بل تعريفات سير عمل كاملة تتضمن خطوات وقوائم تحقق وتنسيقات إخراج ومنطق تحقق. skill-creator يتيح لك تخصيص هذه المهارات.
📋 المتطلبات السابقة: الفصل 15 - نظام الذاكرة
1. ما ستتعلمه
- مفهوم مهارات الوكيل وبنيته
- المهارات المدمجة والمجتمعية
- أمثلة استخدام المهارات
- إنشاء مهارات مخصصة باستخدام skill-creator
- أفضل ممارسات المهارات
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 يُنشئ الإطار؛ وأنت تحسّن الخطوات ونقاط التحقق حسب احتياجاتك.
📖 ملخص
- المهارات سير عمل منظم: خطوات + نقاط تحقق + تنسيق إخراج
- المهارات المدمجة: code-review، bug-fix، security-تدقيق، إلخ
/skill <اسم>يُفعّل تنفيذ المهارة وفق التدفق- skill-creator يُنشئ مهارات مخصصة بشكل تفاعلي
- سير العمل المتكرر والعمليات الحرجة تستفيد من المهارات؛ والمهام لمرة واحدة لا تحتاجها
📝 تمارين
- أساسي (⭐): استخدم مهارة
code-reviewالمدمجة لمراجعة ملف، وقارنها بالتعليمات البسيطة. - متوسط (⭐⭐): استخدم skill-creator لإنشاء مهارة مخصصة (مثلاً: سير عمل النشر)، واختبر التنفيذ.
- متقدم (⭐⭐⭐): أنشئ 3 مهارات أساسية لفريق تغطي تطوير→اختبار→نشر بنقاط تحقق كاملة.