نظرة عامة
المهارات هي مجلدات مستقلة توفر للوكلاء تعليمات ومراجع وموارد خاصة بالمجال. تُعرّف كل مهارة بملفSKILL.md يحتوي على بيانات وصفية YAML ومحتوى Markdown.
تستخدم المهارات الكشف التدريجي — يتم تحميل البيانات الوصفية أولاً، ثم التعليمات الكاملة فقط عند التفعيل، وكتالوجات الموارد فقط عند الحاجة.
هيكل المجلد
name في SKILL.md.
تنسيق SKILL.md
حقول البيانات الوصفية
| الحقل | مطلوب | القيود |
|---|---|---|
name | نعم | 1-64 حرف. أحرف صغيرة أبجدية رقمية وشرطات. بدون شرطات بادئة/لاحقة/متتالية. يجب أن يطابق اسم المجلد. |
description | نعم | 1-1024 حرف. يصف ما تفعله المهارة ومتى تُستخدم. |
license | لا | اسم الترخيص أو مرجع لملف ترخيص مضمّن. |
compatibility | لا | حد أقصى 500 حرف. متطلبات البيئة (منتجات، حزم، شبكة). |
metadata | لا | تعيين مفتاح-قيمة نصي عشوائي. |
allowed-tools | لا | قائمة أدوات معتمدة مسبقًا مفصولة بمسافات. تجريبي. |
الاستخدام
المهارات على مستوى الوكيل
مرر مسارات مجلدات المهارات إلى وكيل:المهارات على مستوى الطاقم
تُدمج مسارات المهارات في الطاقم مع كل وكيل:المهارات المحمّلة مسبقًا
يمكنك أيضًا تمرير كائناتSkill مباشرة:
كيف يتم تحميل المهارات
يتم تحميل المهارات تدريجيًا — فقط البيانات المطلوبة في كل مرحلة يتم قراءتها:| المرحلة | ما يتم تحميله | متى |
|---|---|---|
| الاكتشاف | الاسم، الوصف، حقول البيانات الوصفية | discover_skills() |
| التفعيل | نص محتوى SKILL.md الكامل | activate_skill() |
scripts/ و references/ و assets/ متاحة في مسار المهارة path للوكلاء الذين يحتاجون للإشارة إلى الملفات مباشرة.