Skills: مقدمة في المهارات والمفاهيم الأساسية
آخر تحديث: 2026-08-31
ما زلت تكتب قوالب طويلة من الصفر في كل محادثة؟ المهارات تتيح لك تحويل أفضل الممارسات إلى زر — في المرة القادمة، استدعِها بنقرة واحدة.
1. ما هي المهارات
المهارات هي وحدات توسيع قدرات قابلة لإعادة الاستخدام لمساعدات البرمجة بالذكاء الاصطناعي، تتكون من قوالب، وروابط أدوات، ومحفزات. سواء كان ذلك مهارات Claude Code في .claude/skills/، أو دليل OpenCode في skills/، أو قواعد Cursor، فجميعها تشترك في نفس الفلسفة:
| البُعد | المحادثة العادية (بدون مهارات) | باستخدام المهارات |
|---|---|---|
| القوالب | تُكتب يدويًا في كل مرة | قوالب مُعدة مسبقًا، تُحمّل بنقرة واحدة |
| استدعاءات الأدوات | يجب تحديدها صراحةً | مرتبطة تلقائيًا، تُفعّل عند الحاجة |
| الاتساق | يختلف من شخص لآخر، تتذبذب الجودة | مخرجات موحدة، جودة مستقرة |
| إعادة الاستخدام | نسخ ولصق | مُدارة بالإصدارات، مُشاركة ضمن الفريق |
| التفعيل | يدوي | اكتشاف تلقائي + استدعاء يدوي |
(1) تموضع المهارات
تملأ المهارات الفجوة بين "هندسة القوالب البحتة" و"الوكلاء المستقلين بالكامل":
- ليست قوالب بسيطة — فهي تربط الأدوات، وتحدد شروط المحفز، وتدير السياق
- ليست أطر وكلاء كاملة — فهي "إضافات" للوكلاء تعزز بدلاً من أن تستبدل
- ليست نصوصًا لمرة واحدة — مُدارة بالإصدارات، قابلة للتركيب، قابلة للمشاركة
(2) القدرات الأساسية
البنية الأساسية للمهارات
├── قوالب القوالب (قوالب النظام + قوالب المهام + أمثلة)
├── روابط الأدوات (قراءة/كتابة الملفات / Shell / البحث / أدوات MCP)
├── المحفزات (كلمات مفتاحية / أنواع ملفات / شروط سياقية)
├── نظام المتغيرات (مدخلات المستخدم / متغيرات البيئة / حقن السياق)
├── تنسيق التركيب (سلاسل المهارات / مهارات متوازية / فروع شرطية)
└── الإصدارات والمشاركة (إدارة Git / سوق المهارات / مزامنة الفريق)
حول مخرجات أمثلة الكود
يستخدم هذا الدورة نمط الفصل الحتمي/غير الحتمي لأمثلة الكود، وهو أفضل ممارسة في الصناعة لدروس أدوات وكيل الذكاء الاصطناعي:
| العلامة | المعنى | مخرجاتك |
|---|---|---|
| المخرجات: | نتائج حتمية (التثبيت، التكوين، العد، إلخ) | يجب أن تتطابق بشكل وثيق مع المثال |
| تدفق التفاعل: | تدفق سلوك الوكيل (استدعاءات LLM، اختيار الأدوات، إلخ) | النص الفعلي سيختلف، لكن التدفق سيكون مشابهًا |
| التحقق: | كيفية التحقق من نتائج التمارين | اتبع الخطوات الموصوفة للتحقق |
1 + 1 = 2 (دائمًا نفس الشيء). أدوات وكيل الذكاء الاصطناعي: agent.chat("تحليل الكود") = ??? (مختلف في كل مرة). هذه خاصية أساسية لأدوات وكيل الذكاء الاصطناعي، وليست خطأً.
2. المفاهيم الأساسية
(1) القالب
القالب هو روح المهارة، حيث يحدد المعايير السلوكية للذكاء الاصطناعي في إطار تلك المهارة:
name: code-review
system_prompt: |
أنت خبير مراجعة أكواد أول. اتبع هذه المبادئ عند المراجعة:
1. افهم القصد أولاً، ثم تحقق من التنفيذ
2. أعطِ الأولوية لمشاكل الأمان وعنق زجاجة الأداء
3. قدّم اقتراحات إصلاح محددة، وليس تعليقات غامضة
4. مستويات الخطورة: 🔴 يجب الإصلاح / 🟡 يُنصح بالإصلاح / 🟢 للإشارة فقط
(2) روابط الأدوات
تحدد روابط الأدوات مجموعة الأدوات التي يمكن للمهارة استخدامها أثناء التنفيذ:
| نوع الأداة | الوصف | أمثلة |
|---|---|---|
| أدوات الملفات | قراءة وكتابة ملفات المشروع | Read، Write، Edit |
| أدوات Shell | تنفيذ الأوامر | Bash، Terminal |
| أدوات البحث | بحث في الكود والمحتوى | Grep، Glob |
| أدوات MCP | اتصالات الخدمات الخارجية | قاعدة بيانات، API، متصفح |
| أدوات مخصصة | مطوّرة من قبل المستخدم | أي دالة قابلة للاستدعاء |
(3) المحفز
تحدد المحفزات متى تُفعّل المهارة:
triggers:
- keyword: "review code|review"
- file_pattern: "**/*.py"
- context: "git_diff_available"
(4) السياق
يدير السياق حقن المعلومات أثناء تنفيذ المهارة، بما في ذلك هيكل المشروع، وأسلوب الكود، واتفاقيات الفريق، وغيرها.
3. من العمل اليدوي إلى الآلي
Alice هي قائدة فريق تقني تريد توحيد مراجعات الكود. في البداية، كانت تكتب قوالب طويلة يدويًا في كل مرة:
السيناريو: توحيد مراجعات الكود
النهج التقليدي — تكرر Alice القالب لكل مراجعة:
Alice: "يرجى مراجعة هذا PR، ركّز على الأمان، الأداء، القراءة،
صنّف حسب الخطورة، قدّم اقتراحات إصلاح......"
(يجب عليها كتابة أكثر من 200 كلمة من القوالب في كل مرة)
نهج المهارات — تنشئ Alice مهارة مراجعة كود، ثم تستدعيها بنقرة واحدة:
# .claude/skills/code-review.md
عندما أقول "review"، نفّذ مراجعة كود تلقائيًا......
علّق Bob: "قيمة المهارات ليست فقط توفير الوقت — بل تحويل أفضل ممارسات الفريق إلى عمليات موحدة. أي شخص يستدعيها يحصل على مخرجات متسقة وعالية الجودة."
4. مقارنة المنصات
| المنصة | موقع المهارات | التنسيق | الميزات |
|---|---|---|---|
| Claude Code | .claude/skills/*.md |
Markdown + YAML | دعم أصلي، محفزات غنية |
| OpenCode | دليل skills/ |
Markdown | بسيط وبديهي، مجتمع نشط |
| Cursor | .cursor/rules/ |
Markdown | قواعد على مستوى المشروع، تفعيل تلقائي |
| Windsurf | .windsurfrules |
نص | تكوين ملف واحد |
| Copilot | .github/copilot-instructions.md |
Markdown | تكامل مع منظومة GitHub |
❓ الأسئلة الشائعة
📖 ملخص
- المهارات هي حزم مجمعة قابلة لإعادة الاستخدام من القوالب + الأدوات + المحفزات
- أربعة مفاهيم أساسية: القالب، روابط الأدوات، المحفز، السياق
- مشتركة بين المنصات: Claude Code، OpenCode، Cursor تدعم جميعها آليات مشابهة
- تحول جذري من "كتابة القوالب يدويًا في كل مرة" إلى "الاستدعاء الموحد بنقرة واحدة"
📝 تمارين
- أساسي (⭐): اشرح بكلماتك الخاصة الفروق الأساسية الثلاثة بين المهارة والقالب العادي.
- متوسط (⭐⭐): اذكر 3 سيناريوهات من عملك اليومي، وحلّل أيها مناسب لتغليفه كمهارات، واشرح السبب.
- متقدم (⭐⭐⭐): صمّم مهارة "فحص النشر": ما القوالب المطلوبة؟ أي أدوات تُربط؟ ما شروط المحفز؟