توسيع نطاق "وضع الوكيل" باستخدام المهارات

تتيح لكم المهارات تعزيز إمكانات "وضع الوكيل" من خلال الخبرات المتخصّصة وسير العمل المخصّص. وهي تستند إلى Agent Skills المعيار المفتوح.

على عكس ملفات AGENTS.md، تمثّل المهارات خبرات عند الطلب. يسمح هذا الهيكل لـ "وضع الوكيل" بالاحتفاظ بعدد كبير من الإمكانات المتخصّصة، مثل الانتقال بين إصدارات مكتبة معيّنة أو جعل مكوّن قابل للإنشاء يتكيّف مع أحجام الشاشات المختلفة، بدون إحداث فوضى في قدرة استيعاب النموذج المباشرة.

يقرّر النموذج بشكل مستقل متى يستخدم مهارة معيّنة استنادًا إلى طلبكم ووصف المهارة. عند تحديد مهارة ذات صلة، يجلب النموذج بشكل ديناميكي التعليمات والموارد الكاملة المطلوبة لإكمال المهمة.

لتفعيل مهارة عند الطلب، اطلبوا من الوكيل تنفيذ مهمة ذات صلة بالمهارة. يمكنكم أيضًا إدخال الرمز @ في مربّع الإدخال لتفعيل مهارة معيّنة.

الميزات الأساسية

• الخبرات المشترَكة: يمكنكم تجميع سير العمل المعقّد (مثل عملية مراجعة طلبات السحب لفريق معيّن) في مجلد مخصّص يمكن لأي مستخدم استخدامه.
• سير العمل القابل للتكرار: يمكنكم ضمان تنفيذ المهام المعقّدة المتعدّدة الخطوات بشكل متّسق من خلال تقديم تعليمات موحّدة.
• تجميع الموارد: يمكنكم تضمين النصوص البرمجية أو النماذج أو البيانات النموذجية بجانب التعليمات حتى يحصل الوكيل على كل ما يحتاجه في مكان واحد.
• الاستخدام الفعّال لقدرة استيعاب السياق: لحفظ رموز السياق، يتم تحميل بيانات التعريف الخاصة بالمهارة فقط (الاسم والوصف) في البداية. ولا يتم تحميل ملف SKILL.md الكامل إلا عند التفعيل. لا يتم تحميل الملفات الداعمة ضمن الأدلة references/ أو scripts/ أو assets/ في السياق إلا عندما يحتاجها الوكيل تحديدًا.

إنشاء مهاراتكم الخاصة

يبحث الوكيل عن المهارات بدءًا من الدليلَين .skills/ أو .agent/skills/ الموجودَين في جذر مشروعكم. لإنشاء مهارة مخصّصة، اتّبِعوا الخطوات التالية:

1. أنشئوا دليلًا لمهارتكم (على سبيل المثال، my-new-skill/).
2. أنشئوا ملفًا SKILL.md (مع مراعاة حالة الأحرف) داخل الدليل الجديد.

يجب أن تلتزم المهارات بالقواعد التالية:

• دليل واحد لكل مهارة: يجب أن يكون لكل مهارة دليل فريد خاص بها يتضمّن ملف SKILL.md وأي موارد إضافية.
• التداخل: يجب أن تكون جميع المهارات في الدليلَين .skills/ أو .agent/skills/ في جذر المشروع. ومع ذلك، يمكنكم استخدام أدلة فرعية لتحسين التنظيم (على سبيل المثال، skills/ui-flows/<skill name>/SKILL.md أو skills/testing/<skill name>/SKILL.md).
• النطاق: حاليًا، لا يتم دعم سوى المهارات الموجودة ضمن قاعدة رموز المشروع.

يستخدم ملف SKILL.md كتلة YAML لبيانات التعريف وMarkdown عادية للتعليمات.

• name: معرّف فريد للمهارة. يجب أن يتطابق هذا المعرّف مع اسم الدليل.
• description: شرح واضح لما تفعله المهارة ومتى يجب أن يستخدمها الوكيل.
• النص: يحتوي نص Markdown أسفل كتلة YAML على التعليمات التي توجّه سلوك الوكيل عندما تكون المهارة نشطة.

---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

إرشادات التنسيق

• الاسم: 64 حرفًا كحد أقصى (أحرف صغيرة وأرقام وواصلات فقط).
• الوصف: 1024 حرفًا كحد أقصى.
• محتوى النص: يجب أن يتراوح بين 10 آلاف و20 ألف حرف (من 2,500 إلى 5,000 رمز تقريبًا). إذا تجاوزت التعليمات هذا الحد، ننصحكم بنقل المستندات التفصيلية إلى ملف موارد كما هو موضّح في الأدلة الاختيارية للمهارات.

الأدلة الاختيارية للمهارات

للحفاظ على ملف SKILL.md موجزًا ووحدات، يمكنكم تضمين موارد إضافية في الأدلة الاختيارية التالية ضمن مجلد مهارتكم:

• scripts/: يحتوي على رموز قابلة للتنفيذ (مثل Python أو Bash) يمكن للوكيل تشغيلها.
• references/: يحتوي على مستندات فنية تفصيلية أو مراجع واجهة برمجة التطبيقات أو أدلة خاصة بالنطاق.
• assets/: يحتوي على موارد ثابتة مثل نماذج المستندات أو مخططات واجهة المستخدم أو مخططات JSON.

عند الإشارة إلى هذه الملفات ضمن تعليمات SKILL.md، استخدِموا المسارات النسبية من جذر المهارة. على سبيل المثال: Run the script at scripts/cleanup.py.