أنشئ مجموعات تعليمات قابلة للإعادة الاستخدام لسير العمل المتخصصة. حدد سير عمل مخصصة وأضف ملفات داعمة وعلّم Bob مهامًا متخصصة للحصول على نتائج متسقة.

المهارات هي مجموعات تعليمات قابلة للإعادة الاستخدام تُعلّم Bob سير عمل جديدة ومهامًا متخصصة. فكّر فيها كوصفات يتبعها Bob لإنجاز أنواع محددة من الأعمال بطريقة متسقة وقابلة للتكرار.

لماذا تستخدم المهارات

إعادة الاستخدام: حدد سير العمل مرة واحدة واستخدمها عبر محادثات متعددة.

الاتساق: تأكد من أن Bob يتبع نفس الأسلوب في كل مرة لمهام محددة.

التخصص: أنشئ خبرة خاصة بالمجال لمراجعات الكود والاختبار والتوثيق وغيرها.

التعاون الجماعي: شارك سير العمل الموحدة عبر فريقك من خلال نظام التحكم في الإصدار.

المرونة: أدرج ملفات داعمة مثل قوائم المراجعة والقوالب والمواد المرجعية.

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

عندما تُفعّل مهارة، يتلقى Bob تعليماتها ويحصل على الوصول إلى أي ملفات داعمة في مجلد المهارة. يتبع Bob هذه التعليمات بعد ذلك لإنجاز مهمتك وفق سير العمل المحدد.

تُحمَّل المهارات مرة واحدة لكل محادثة لتجنب المحفزات المكررة. يُحدد Bob تلقائيًا متى يُفعّل مهارة بناءً على طلبك ووصف المهارة.

إنشاء مهارة

الإعداد الأساسي

أنشئ مجلدًا داخل .bob/skills/ في جذر مشروعك، أو استخدم ~/.bob/skills/ للمهارات العامة.

أضف ملف SKILL.md داخل ذلك المجلد.

مثال على البنية:

SKILL.md

تنسيق SKILL.md

يستخدم ملف SKILL.md YAML front matter متبوعًا بتعليمات المهارة:

---
name: code-review
description: راجع الكود بحثًا عن الأخطاء والمشكلات الأمنية وأفضل الممارسات
---

عند مراجعة الكود، تحقّق مما يلي:
- الثغرات الأمنية
- مشكلات الأداء
- غياب معالجة الأخطاء عند حدود API
- الاستيرادات غير المستخدمة والكود غير المستخدم

قدّم ملخصًا يبيّن مستوى الخطورة لكل نتيجة.

الحقول المطلوبة:

name: الاسم المعروض للمهارة في واجهة Bob

description: ملخص واضح يساعد Bob في تحديد متى يُفعّل هذه المهارة — المهارات بدون وصف تُتجاهل

قسم التعليمات: كل ما يأتي بعد الفاصل --- يصبح التعليمات التي يتلقاها Bob عند تفعيل المهارة.

إضافة ملفات داعمة

يمكنك تضمين ملفات ومجلدات فرعية إضافية بجانب SKILL.md لتوفير مواد مرجعية وقوالب وقوائم مراجعة وسكريبتات وموارد أخرى. يستطيع Bob قراءة هذه الملفات تلقائيًا بمجرد تفعيل المهارة.

مثال مع ملفات داعمة:

SKILL.md

checklist.md

severity-guide.md

analyze.sh

report-generator.py

يمكن أن تتضمن الملفات والمجلدات الداعمة:

قوائم مراجعة وقوالب

توثيق مرجعي

أمثلة على الإعداد

سكريبتات وأدوات مساعدة في مجلدات فرعية

أدلة الأسلوب

أي موارد أخرى لازمة للمهارة

مواقع المهارات

يمكن تعريف المهارات على مستويين:

الموقع	النطاق	حالة الاستخدام
`<project>/.bob/skills/`	خاص بالمشروع	سير العمل الفريدة لهذا المشروع
`~/.bob/skills/`	عام	سير العمل الشخصية أو على مستوى المؤسسة

الأولوية: إذا احتوى كلا الموقعين على مهارة بنفس الاسم، تأخذ الأولوية للمهارة على مستوى المشروع.

الموافقة على المهارات

بشكل افتراضي، يطلب Bob إذنك قبل تفعيل مهارة. هذا يمنحك التحكم في متى تُطبَّق سير العمل المتخصصة.

لتخطي مطالبة الموافقة، فعّل الموافقة التلقائية للمهارات في إعداداتك:

عبر /settings: افتح الإعدادات بأمر /settings، ثم فعّل Auto-approve: Skills.

عبر settings.json: أضف "autoApprove": { "skills": true } إلى ~/.bob/settings/settings.json.

مع تفعيل هذا الإعداد، يُفعّل Bob المهارات تلقائيًا عند الاقتضاء دون طلب إذن.

كتابة مهارات فعّالة

أوصاف واضحة

اكتب أوصافًا تشير بوضوح إلى متى يجب استخدام المهارة. يعتمد Bob على هذه الأوصاف لتحديد ملاءمة المهارة.

جيد: "راجع الكود بحثًا عن الأخطاء والمشكلات الأمنية وأفضل الممارسات"

تجنب: "مهارة لمراجعة الكود"

تعليمات مُركَّزة

حافظ على إيجاز ملف SKILL.md الرئيسي بتركيزه على سير العمل الأساسي. انقل المواد المرجعية التفصيلية والأمثلة وقوائم المراجعة إلى ملفات داعمة.

مثال:

---
name: api-documentation
description: أنشئ توثيق API وفق معايير OpenAPI
---

أنشئ توثيق API يتضمن:
- أوصاف نقاط النهاية
- مخططات الطلبات والاستجابات
- متطلبات المصادقة
- أمثلة للطلبات والاستجابات

اتبع دليل الأسلوب في `api-style-guide.md` واستخدم القالب في `api-template.md`.

خطوات قابلة للتنفيذ

نظّم التعليمات كخطوات واضحة وقابلة للتنفيذ يمكن لـ Bob اتباعها بشكل منهجي.

مثال:

---
name: feature-implementation
description: نفّذ ميزات جديدة وفق معايير الفريق
---

<Steps>
<Step>
راجع متطلبات الميزة.

</Step>

<Step>
أنشئ خطة بالتغييرات المطلوبة على الملفات.

</Step>

<Step>
نفّذ الميزة وأضف الاختبارات.

</Step>

<Step>
حدّث التوثيق.

</Step>

<Step>
تحقّق من نجاح جميع الاختبارات.

</Step>
</Steps>

اتبع معايير كتابة الكود في `coding-standards.md`.

أمثلة على المهارات

مهارة مراجعة الكود

---
name: security-review
description: راجع الكود بحثًا عن الثغرات الأمنية وأفضل الممارسات
---

أجرِ مراجعة للكود تركّز على الأمان:

<Steps>
<Step>
تحقّق من الثغرات الشائعة:
- مخاطر حقن SQL
- ثغرات XSS
- مشكلات المصادقة والتفويض
- كشف البيانات الحساسة

</Step>

<Step>
راجع أفضل ممارسات الأمان:
- التحقق من صحة المدخلات
- ترميز المخرجات
- الإعداد الآمن
- معالجة الأخطاء

</Step>

<Step>
قدّم النتائج متضمنة:
- مستوى الخطورة (حرج، مرتفع، متوسط، منخفض)
- الموضع في الكود
- الإصلاح المقترح
- مرجعًا إلى معايير الأمان

</Step>
</Steps>

استخدم دليل مستويات الخطورة في `severity-levels.md` للتصنيف.

مهارة التوثيق

---
name: api-docs
description: أنشئ توثيقًا شاملًا لـ API
---

أنشئ توثيق API يتضمن:

<Steps>
<Step>
قسم النظرة العامة:
- الغرض وحالات الاستخدام
- متطلبات المصادقة
- عنوان URL الأساسي وإدارة الإصدارات

</Step>

<Step>
لكل نقطة نهاية:
- طريقة HTTP والمسار
- الوصف والغرض
- معاملات الطلب
- مخطط نص الطلب
- رموز الاستجابة ومخططاتها
- أمثلة للطلبات والاستجابات

</Step>

<Step>
أقسام إضافية:
- معالجة الأخطاء
- تحديد المعدل
- تقسيم النتائج إلى صفحات

</Step>
</Steps>

اتبع القالب في `api-doc-template.md` والأمثلة في `api-examples.md`.

نصائح وأفضل الممارسات

ابدأ بسيطًا: ابدأ بتعليمات أساسية وحسّنها بناءً على النتائج.

استخدم الملفات الداعمة: حافظ على إيجاز SKILL.md بنقل المحتوى التفصيلي إلى ملفات مرافقة.

اختبر بشكل شامل: تحقق من أن المهارات تعمل كما هو متوقع قبل مشاركتها مع فريقك.

التحكم في الإصدار: أدرج مهارات المشروع في مستودعك لاتساق الفريق.

تسمية واضحة: استخدم أسماء مهارات وصفية تشير إلى غرضها.

مسؤولية واحدة: أنشئ مهارات مُركَّزة لمهام محددة بدلاً من محاولة التعامل مع سير عمل متعددة غير مترابطة.

المهارات

في هذه الصفحة