الانتقال إلى المحتوى الرئيسي

نظرة عامة

المهارات هي مجلدات مستقلة توفر للوكلاء تعليمات ومراجع وموارد خاصة بالمجال. تُعرّف كل مهارة بملف 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 للوكلاء الذين يحتاجون للإشارة إلى الملفات مباشرة.