إنشاء مهارات للوكلاء الذكيين: الميكانيكا وأفضل الممارسات والتحويل إلى إضافة

مؤلف المقال، مطوّر مستودع rpa-skills، يشرح بالتفصيل كيفية إنشاء المهارات لوكلاء الذكاء الاصطناعي بالطريقة الصحيحة. المهارة ليست ملف Markdown واحدًا، بل مجلد يحتوي على ملف SKILL.md إلزامي يتضمن ترويسة YAML (الاسم، الوصف) وجسم التعليمات، بالإضافة إلى مجلدات اختيارية references/ وscripts/ وassets/ وملف README.md. مبدأ الكشف التدريجي يقوم بتحميل وصف المهارة فقط في النظام؛ ويتم سحب الجسم عند التفعيل، لذا يجب ألا يتجاوز الجسم 500 سطر، مع نقل المحتوى الثقيل إلى references/. في حقل الوصف، من المهم تحديد الغرض وشروط التفعيل بوضوح، وتجنب الكلمات العامة مثل يجب لمنع النموذج من تفعيل المهارة بشكل عشوائي. يؤكد المؤلف على الفرق بين المهارات والقواعد: القواعد (مع alwaysApply: true) نشطة دائمًا ومناسبة لأسلوب الكود أو معالجة الأخطاء، بينما المهارات أفضل للإجراءات متعددة الخطوات (النشر، التطوير القائم على السلوك، تحليل الأخطاء). يجب كتابة أوصاف المهارات وجسمها باللغة الإنجليزية بسبب الترميز: الحروف السيريلية تستهلك في المتوسط ضعف عدد الرموز المميزة مقارنة باللاتينية، مما يوفر السياق. يتم تقديم ممارسات من Anthropic: درجات الحرية (قيود صارمة للمهام الحرجة، مجال مفتوح للمهام الإبداعية)، العمليات الحتمية يجب نقلها إلى scripts، قسم إلزامي للأخطاء الشائعة (Gotchas)، أسماء بصيغة المصدر (مثل معالجة-pdfs)، وتجنب التنوع المفرط—من الأفضل تقديم حل رئيسي واحد وحل احتياطي واحد. لاختبار مهارة ما، قم بتشغيل وكيل فرعي بسياق نظيف وتحقق مما إذا كانت المهارة تُفعَّل تلقائيًا، وأين أخطأت، وما إذا كانت النتيجة مطابقة للتوقعات. يُنصح بثلاث عمليات تشغيل على الأقل على مهام مختلفة وعلى نماذج مختلفة، بما في ذلك النماذج الصغيرة التي تتبع التعليمات حرفيًا. يتم تعبئة مهارة السوق كإضافة—مجلد يحتوي على ملف manifest plugin.json (في .claude-plugin/ لـ Claude Code، وفي .codex-plugin/ لـ Codex)، مع تحديد البيانات الوصفية، مع مطابقة الاسم مع الاسم من SKILL.md ومزامنة الإصدار. يمكن أن تتضمن الإضافة أيضًا أوامر Slash، ووكلاء فرعيين، وخطافات، وخوادم MCP.