Written with AI assistance from the source video. The video is the authority.
Log in to leave a comment
No posts yet
إن الهيكل المتجانس الذي يحشر جميع أنواع الإرشادات والأدوات في مطالبة نظام واحدة سرعان ما يُظهر عيوبه. فمع طول المحادثة قليلاً، ينسى الوكيل التوجيهات المكتوبة في منتصف المطالبة. وبسبب إرسال عشرات الآلاف من الرموز بشكل متكرر مع كل طلب، ترتفع تكاليف الاستدلال وتضطر إلى الانتظار طويلاً حتى يظهر الرمز الأول.
في بيئة العمل الفعلي، يتم حل هذه المشكلة باستخدام هيكل التحميل التدريجي للسياق المستند إلى المواصفات المفتوحة agentskills.io. وهي طريقة توفر الرموز عن طريق استدعاء المهارات المناسبة فقط في اللحظة المطلوبة.
يجب تقسيم مطالبات النظام المتجانسة بناءً على حدود النطاق، وصلاحيات تنفيذ الأدوات، وتكرار التنفيذ. ويجب الحفاظ على 3 مهارات أو أقل يتم تنشيطها في نفس الوقت في جلسة واحدة لمنع تداخل المهارات أثناء البحث عن التشابه الدلالي.
في الجزء العلوي من ملف المهارة المنفصل، يجب كتابة واجهة YAML الأمامية (YAML Frontmatter) التي تحدد المعرف باستخدام الشرطات والحروف الإنجليزية الصغيرة والأرقام فقط، بالإضافة إلى غرض التشغيل.
name: backend-api-generator
description: Generates Spring Boot REST API controller and service boilerplate code. Use when the user asks to create API endpoints, build REST controllers, or define DTO mappings for backend services.
when_to_use:
`
إن عملية بناء هيكل التحميل التدريجي بسيطة:
من خلال تحويل الهيكل المتجانس الذي كان يشغل دائماً 15,000 إلى 30,000 رمز إلى هيكل التحميل المتأخر SKILL.md، يتم تقليل النفقات العامة الأولية للرموز بنسبة تزيد عن 90%. واستنادًا إلى بيانات الاختبار الداخلية لشركة Anthropic، يمكن تقليل وقت التأخير p95 من 12% إلى 40%، وخفض متوسط استهلاك الرموز لكل محادثة بنسبة 29.6%.
عندما يتم تحميل مهارات متعددة بشكل تسلسلي، يحدث غالبًا أن تبقى إرشادات المهارة السابقة في الجلسة وتشوه العمل التالي. بالنسبة للفحص عالي الخطورة أو المهام التي تترك الكثير من السجلات، يجب إدخال إعداد تفريع السياق (context: fork) في واجهة YAML الأمامية لعزلها على مستوى العملية.
`
لا يمكن تخطي مهمة تحديد عقود بيانات المدخلات والمخرجات (Data Contract) بوضوح.
`markdown
All responses must strictly adhere to the following JSON structure without markdown wrapping:
{
"status": "SUCCESS" | "FAILED",
"generated_files": [
{
"path": "string",
"content": "string"
}
],
"error_message": "string | null"
}
`
العزل في عملية فرعية يمنع تدفق سجلات استدعاء الأدوات إلى الجلسة الرئيسية. ونظراً للحفاظ على نظافة جلسة المحادثة الرئيسية، تقل أيضًا احتمالية حدوث أخطاء عند تبادل البيانات بين الوكلاء الفرعيين.
إذا كانت المتطلبات غامضة أو تكررت أخطاء استدعاء الأدوات، فسيدخل الوكيل في حلقة إعادة محاولة لا نهائية. هذه هي اللحظة التي تتبخر فيها عشرات الدولارات من تكاليف واجهة برمجة التطبيقات في دقائق معدودة. إن وضع قائمة تحقق التحقق الثابت خطوة بخطوة (Verification Checklist) في نص ملف المهارة يتيح للوكيل إجراء التحقق بنفسه قبل إنهاء المهمة.
`markdown
Before declaring the task finished, you MUST sequentially execute the following verification checklist:
`
إن طريقة كتابة قاطع الدائرة (Circuit Breaker) الذي يقطع الحلقة فعلياً بسيطة أيضًا.
`markdown
[SKILL EXECUTION HALTED]
Skill Name: backend-api-generator
Failure Reason: [Brief error description]
Attempts Made: [Number of retries]
Suggested Action: [Action required by backend developer]
`
من الأمان تعيين خيار disable-model-invocation: true للمهام الخطيرة مثل حذف الملفات أو إسقاط قواعد البيانات (DB drop). هذا يمنع الوكيل من استدعائها من تلقاء نفسه ويقصر تنفيذها على إدخال المطور للأمر الشرطي (/skill-name) مباشرة.
عندما يقوم أعضاء الفريق بكتابة المهارات معاً، يجب اتباع هندسة الدليل القياسية لـ agentskills.io لعدم المعاناة من تعارضات ملفات مارك다운. يتم تقسيم وترتيب النص، والبرامج النصية لواجهةs الأوامر (CLI)، والوثائق المرجعية، وأصول القوالب الثابتة بوضوح داخل المجلد الرئيسي.
| مسار الدليل والملف | الدور | إرشادات الكتابة |
|---|---|---|
| skills/api-generator/SKILL.md | مستند نقطة الدخول الإلزامي | يتضمن واجهة YAML الأمامية وإرشادات الإجراءات الأساسية (في حدود 500 سطر) |
| skills/api-generator/scripts/ | مجلد الكود القابل للتنفيذ | مكان البرامج النصية لـ Python/Bash CLI التي يستدعيها الوكيل عند الحاجة |
| skills/api-generator/references/ | مجلد المستندات المرجعية المساعدة | يضم مواصفات واجهة برمجة التطبيقات الكبيرة، ومخططات قواعد البيانات، ودلائل الأنماط |
| skills/api-generator/assets/ | مجلد قوالب الموارد الثابتة | تخزين نماذج ملفات التكوين وأكواد التمهيد (Boilerplate) المولدة |
عند التحقق من جودة المهارة، يتم استخدام إطار عمل التقييم promptfoo.
`yaml
description: "Backend Agent Skills Validation Suite"
prompts:
`
عند النشر، يتم الجمع بين استراتيجية التطوير القائمة على الجذع (Trunk-based development) التي تستخدم فروعاً قصيرة الأنفاس وعلامات Git (v1.2.0). إذا قام الوكيل بسلوك غريب في الإنتاج، يمكنك التراجع فوراً إلى نقطة العلامة السابقة بالأمر git checkout tags/v1.1.0 -b hotfix/rollback.
