Skip to main content

تشريح ملف SKILL.md

تتطلب كل قدرة ملف SKILL.md. يتكوّن من جزأين: واجهة YAML العلوية (بيانات وصفية قابلة للقراءة آليًا) ومتن Markdown (تعليمات يقرأها نموذج اللغة).

حقول الواجهة العلوية

مرجع الحقول

المشغّلات الدائمة

استخدم الرمز الشامل "*" كمشغّل لجعل المهارة تُحقن في كل رسالة، بغض النظر عمّا يقوله المستخدم:
لا تُحتسب المهارات الدائمة ضمن حدّ المطابقة — تُحقن أولاً، ثم تُضاف حتى 3 مهارات مطابقة بالكلمات المفتاحية فوقها. هذا مثالي للمهارات النقية التي تُحدد سلوكًا عامًا للوكيل (انضباط التخطيط، تنسيق المخرجات، قواعد الأمان) بدلاً من الاستجابة لمواضيع محددة.
المشغّلات الدائمة تؤثر فقط على المهارات النقية (بدون 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. يقرؤه نموذج اللغة في وقت التشغيل عندما تكون القدرة ذات صلة. اكتبه كتعليمات مباشرة لنموذج اللغة:
متن Markdown هو المكان الذي تُرمّز فيه معرفة الخبراء. اكتب التعليمات كأنك تعلّم مطورًا مبتدئًا ذكيًا كيف يستخدم الأداة بشكل صحيح. كلما كانت التعليمات أفضل، كان أداء الوكيل أفضل.