- يُضاف إلى الـ system prompt قسم صغير بعنوان Available skills: سطر لكل skill (
- name: description)، وجملة واحدة تطلب من الـ model استدعاءload_skillقبل أي مهمة تغطيها skill. - تُسجَّل تلقائيًا tool باسم
load_skill(مدخلها{ name }). تُرجع المحتوى الكامل للـ skill كنتيجة للـ tool. - نصوص الـ skills ليست في الـ prompt قبل تحميلها. الـ agent الذي يملك عشرين skill طويلة يدفع تقريبًا سطرًا واحدًا لكل skill في كل طلب، ولا تُدفع تكلفة النص الكامل إلا في الـ runs التي تستخدمه.
Skills في الكود
defineSkill({ name, description, content }) تتحقق من مدخلاتها. يجب أن يطابق name النمط ^[a-z0-9][a-z0-9-_]{0,63}$، ويجب ألا يكون description وcontent فارغين. توضّح الأخطاء موضع المشكلة وكيفية إصلاحها.
AgentExecutor.execute() يأخذ خيار skills نفسه؛ راجع الـ executor API.
إذا كانت لديك tool مسجّلة مسبقًا باسم load_skill، فإن تمرير skills يرمي خطأ: غيّر اسم الـ tool أو احذف الخيار.
Skills من القرص
loadSkills(dir) يقرأ ملفات الـ skills، فيستطيع غير المطورين تعديلها دون المساس بالكود. هناك تنسيقان مدعومان ويمكنك الجمع بينهما في مجلد واحد:
descriptionمطلوب.nameاختياري، وقيمته الافتراضية اسم المجلد (في تنسيقSKILL.md) أو اسم الملف بدون.md.- المجلدات التي لا تحتوي
SKILL.mdنتجاهلها. والأمر نفسه لأي ملف.mdمنفرد بلا frontmatter (مثلREADME.md): يُتخطى مع تحذير في الـ console بدلًا من أن يفشل التحميل كله. أما الملف الذي فيه frontmatter لكن بلاdescriptionفما زال خطأ. - الـ skill ذات التنسيق
<name>/SKILL.mdتحفظ مجلدها فيskill.directory. بعد ذلك تضيفload_skillمسار المجلد وتسرد الملفات المجاورة لـSKILL.md(حتى 50 ملفًا)، وتُسجَّل tool باسمread_skill_file(مدخلها{ skill, path }) لقراءتها. المسار نسبي لمجلد الـ skill ولا يمكنه الخروج منه:..والمسارات المطلقة والـ symlinks التي تشير إلى خارجه كلها مرفوضة. يمكنك قراءة ملفات نصية حتى 256 KB.defineSkill({ directory })يضبط الحقل نفسه لـ skill تبنيها في الكود. وإذا كانت لديك tool خاصة بك اسمهاread_skill_fileفإنها تتعارض بالطريقة نفسها التي تتعارض بهاload_skill. - تُرجَع الـ skills مرتبة بالاسم، فتكون الـ prompts deterministic.
- الأخطاء من نوع
LOUSHO_SKILL_INVALIDوتسمّي الملف والمشكلة:descriptionناقص، YAML غير صالح، اسم غير صالح، مجلد تتعذر قراءته، أو skill-ان بالاسم نفسه (مع ذكر المسارين كليهما).
اختبار الـ skills
استخدمmockModel للتأكد من أن الـ model يرى الأوصاف فقط، لا النصوص الكاملة، إلى أن يحمّل skill: الـ system prompt في الطلب الأول يسرد الـ skills، والطلب الذي يلي استدعاء load_skill يحتوي النص الكامل في نتيجة الـ tool.