المهارات: SKILL.md
بعد قراءة هذا القسم، ستكون قادرًا على كتابة SKILL.md وجعل Agent الخاص بك يحمّله تلقائيًا عند الحاجة. سنجرّب عمليًا مهارة "كتابة التقرير الأسبوعي".
ما هي المهارات
الأدوات تحل مسألة "ما الذي يمكن فعله" (قراءة الملفات، تشغيل الأوامر)، أما المهارات فتحل مسألة "كيف ينبغي إنجاز هذا الأمر".
الأمر أشبه بدليل إجراءات تمنحه الشركة لموظف جديد: ما العناوين الفرعية التي يقسم إليها التقرير الأسبوعي، وعدم اختلاق المحتوى، وبأي اسم ملف يُحفظ... هذه ليست قدرات، بل طرق عمل. اكتب طرق العمل في ملف، وسيقرأه Agent عند الحاجة فيتقنها.
Agent Skills هي بالضبط صيغة من هذا النوع: المهارة مجلد يحتوي على SKILL.md (فقرة بيانات وصفية بصيغة YAML في البداية، تليها خطوات مكتوبة بلغة Markdown)، ويمكن أن يحتوي أيضًا على نصوص برمجية ومراجع وغيرها.
الأصل: أطلقت Anthropic مهارات Skills بتاريخ 2025/10/16، وفي 2025/12/18 نشرت Agent Skills كمعيار مفتوح على agentskills.io. وفي 2026/11/4، أقرّ المشروع وثيقة الحوكمة، ووفقًا للوثيقة سيُنشأ كمشروع تابع لمؤسسة Linux، برخصة Apache-2.0.
كتابة SKILL.md
مهارة "كتابة التقرير الأسبوعي" لدينا موضوعة في skills/weekly-report/SKILL.md:
---
name: weekly-report
description: تنظيم سجلات العمل في مجلد معين في تقرير أسبوعي واحد
---
# كتابة التقرير الأسبوعي
1. استخدم list_dir لمعرفة ملفات السجلات الموجودة في المجلد المعطى، واستخدم read_file لقراءتها واحدًا واحدًا.
2. نظّم المحتوى تحت أربعة عناوين فرعية: "أُنجز هذا الأسبوع / قيد التنفيذ / خطة الأسبوع القادم / يحتاج إلى مساعدة"، كل بند بجملة واحدة مع ذكر تاريخ الحدث.
3. لا تختلق محتوى غير موجود في السجلات؛ والعناوين الفرعية التي لم تُذكر في السجلات اكتب عندها "لا شيء".
4. استخدم write_file لكتابة النتيجة في 周报.md، وقبل الكتابة اعرض النص كاملًا على المستخدم.الحقلان الإلزاميان في المواصفة:
| الحقل | المتطلبات |
|---|---|
name | لا يزيد عن 64 حرفًا، ويسمح فقط بالحروف اللاتينية الصغيرة والأرقام والشرطة، ويجب أن يكون مطابقًا لاسم المجلد الذي يوجد فيه |
description | من 1 إلى 1024 حرفًا، يوضّح "ماذا يفعل" و"متى يُستخدم" |
الحقول الاختيارية هي license وcompatibility وmetadata، بالإضافة إلى allowed-tools التجريبي.
الإفصاح التدريجي: لا حاجة لقراءة كل شيء دفعة واحدة
إذا كان لديك عشرات المهارات، فحشرها كلها في التوجيهات هدر كبير. الطريقة الموصى بها في المواصفة تنقسم إلى ثلاث طبقات:
- عند الإقلاع تُقرأ البيانات الوصفية فقط: أي name وdescription لكل مهارة، نحو 100 token؛
- عند الاستخدام يُقرأ النص الكامل: ملف SKILL.md بأكمله، ويُنصح بأن يكون أقل من 5000 token وفي حدود 500 سطرًا؛
- عند الحاجة فقط تُقرأ الموارد: النصوص البرمجية والملفات المرجعية المرفقة.
جعل Agent الخاص بك يدعم المهارات
يوجد على موقع المواصفة مقال مخصص بعنوان "إضافة دعم Skills إلى Agent الخاص بك". جوهره أمران فقط: وضع دليل المهارات في التوجيهات النظامية، وتوفير طريقة لقراءة المهارات. تنفيذنا:
def load_skills():
skills = {}
for f in sorted((HERE / "skills").glob("*/SKILL.md")):
meta = dict(re.findall(r"^(\w+):\s*(.+)$", f.read_text(encoding="utf-8").split("---")[1], re.M))
skills[meta["name"]] = (meta["description"], f)
return skills
SKILLS = load_skills()
def load_skill(name): # 用到时才把完整说明读进来(渐进式披露)
return SKILLS[name][1].read_text(encoding="utf-8") if name in SKILLS else f"没有叫 {name} 的技能"
SYSTEM = ("……\n可用技能(需要时先 load_skill):\n"
+ "\n".join(f"- {n}:{d}" for n, (d, _) in SKILLS.items()))ثم أضف load_skill إلى قائمة الأدوات. وتقدم المواصفة نصيحتين إضافيتين: يُفضل جعل المعامل name للأداة من نوع تعداد (بالسماح بأسماء المهارات الموجودة فقط)، لمنع النموذج من اختلاق مهارات غير موجودة؛ وعند عدم وجود أي مهارات، لا تضع دليلًا فارغًا ولا تسجّل هذه الأداة. بالإضافة إلى ذلك، أصبح .agents/skills/ يشكل اتفاقية شائعة لدليل المهارات عبر مختلف العملاء.
جرّبها
python agent.py "用写周报的技能,把 worklog 文件夹整理成周报"تشغيلنا الفعلي على qwen3:8b:
[1] load_skill({"name": "weekly-report"})
[2] read_file({"path": "/worklog/11-16.txt"})
[3] list_dir({"path": "./worklog"})
[4] read_file({"path": "./worklog/11-16.txt"})
[5] read_file({"path": "./worklog/11-18.txt"})
[6] read_file({"path": "./worklog/11-20.txt"})
Agent: نتيجة تنظيم التقرير الأسبوعي:
# التقرير الأسبوعي
## ما أُنجز هذا الأسبوع
- الاثنين: إصلاح خلل تنسيق صفحة تسجيل الدخول على Safari
……
## أحتاج مساعدة
- لا شيء
بعد تأكيد المحتوى سأقوم بإنشاء ملف 周报.md.لاحظ أنه أنجز الأمرين المكتوبين في المهارة: العناوين الفرعية الأربعة كاملة، وما لم يُذكر يُكتب "لا شيء"؛ وقبل كتابة الملف يعرض النص الكامل عليك. كل هذا لم يفرضه الكود، بل هو مكتوب في SKILL.md.
اختبر معرفتكما الفرق بين المهارات والأدوات؟
تحقّق
- أستطيع ذكر الحقلين الإلزاميين في SKILL.md ومتطلباتهما
- أستطيع شرح الطبقات الثلاث للكشف التدريجي
- نجحت في تشغيل مهارة كتابة التقرير الأسبوعي، وكتبت مهارة خاصة بي
الفصل التالي يتصل بالمنظومة: MCP: اكتب خادمًا ووصّله.