تشريح ملف SKILL.md
تتطلب كل قدرة ملفSKILL.md. يتكوّن من جزأين: واجهة YAML العلوية (بيانات وصفية قابلة للقراءة آليًا) ومتن Markdown (تعليمات يقرأها نموذج اللغة).
حقول الواجهة العلوية
مرجع الحقول
| الحقل | مطلوب | الوصف |
|---|---|---|
name | نعم | معرّف فريد للقدرة |
version | لا | إصدار دلالي لمنطق التحديث |
description | نعم | وصف قصير يظهر في تعريفات الأدوات |
triggers | نعم | كلمات مفتاحية لمطابقة الصلة. استخدم "*" للتفعيل الدائم (انظر أدناه) |
tools | لا | تعريفات الأدوات بتنسيق JSON Schema لواجهة استدعاء الأدوات في نموذج اللغة |
danger_patterns | لا | تعابير نمطية ستقوم amygdala بـ حجبها |
confirm_patterns | لا | تعابير نمطية ستتطلب فيها amygdala موافقة |
requires | لا | قدرات أخرى تعتمد عليها هذه القدرة |
المشغّلات الدائمة
استخدم الرمز الشامل"*" كمشغّل لجعل المهارة تُحقن في كل رسالة، بغض النظر عمّا يقوله المستخدم:
المشغّلات الدائمة تؤثر فقط على المهارات النقية (بدون
tools). قدرات الإضافات التي تحتوي أدوات تظهر دائمًا في قسم <tools> بغض النظر عن المشغّلات.مخطط الأدوات
تتبع مصفوفةtools تنسيق JSON Schema القياسي المستخدم في واجهات استدعاء الأدوات في نماذج اللغة. تحتاج كل أداة إلى name وdescription وكائن parameters.
أنماط الخطر والتأكيد
هذه تعابير نمطية تُطابق ضدtoolName + " " + JSON.stringify(args). تستخدمها amygdala للتحكم في استدعاءات الأدوات.
- danger_patterns: تُحجب الاستدعاءات المطابقة. يتلقى نموذج اللغة رسالة رفض.
- confirm_patterns: تُطلق الاستدعاءات المطابقة مربع حوار موافقة في واجهة المستخدم. يجب أن يوافق المستخدم قبل التنفيذ.
المهارات النقية (بدون إضافة)
القدرة التي تحتويtools: [] (أو بدون حقل tools) هي مهارة نقية. ليس لها كود إضافة ولا أدوات قابلة للاستدعاء — فقط متن Markdown الذي يُحقن في قسم <skills> في موجّه النظام عندما تتطابق مشغّلات المهارة.
تُوجّه المهارات النقية سلوك نموذج اللغة دون إضافة أدوات جديدة. استخدمها لـ:
- انضباط التخطيط — إجبار الوكيل على التخطيط قبل تنفيذ المهام متعددة الخطوات
- تنسيق المخرجات — فرض استجابات منظمة أو تفضيلات لغوية أو نبرة معينة
- أدلة الإجراءات — تعليم الوكيل كيف يستخدم الأدوات الحالية لسير عمل محدد (مثل عمليات git عبر
shell_exec) - قواعد الأمان — إضافة قيود تنطبق على جميع استخدامات الأدوات
<tools> تلقائيًا. تظهر المهارات النقية في قسم <skills> فقط عند تفعيلها. القسمان مستقلان — يمكن لرسالة واحدة تفعيل كليهما.
متن Markdown
كل شيء أسفل--- في الواجهة العلوية هو متن Markdown. يقرؤه نموذج اللغة في وقت التشغيل عندما تكون القدرة ذات صلة. اكتبه كتعليمات مباشرة لنموذج اللغة: