قوالب Skill و Subagent وفريق الأيجنتس

1 · قالب Skill

المكان: .claude/skills/<اسم-المهارة>/SKILL.md داخل المشروع، أو ~/.claude/skills/ لتعمل في كل مشاريعك.

---
name: product-writer
description: يكتب أوصاف منتجات المتجر بأسلوب العلامة. استخدمه عند طلب وصف منتج أو تحسين وصف موجود أو تجهيز منتجات جديدة للرفع على المتجر.
---

# كاتب أوصاف المنتجات

## المدخلات
- اسم المنتج، والسعر، والمواصفات (من ملف أو رابط أو صورة)

## الخطوات
1. اقرأ المواصفات واستخرج 3 فوائد للعميل لا 3 مواصفات
2. اكتب عنواناً من 6 كلمات كحد أقصى يذكر الفائدة الأوضح
3. اكتب وصفاً من 3 أسطر: لمن المنتج، وماذا يحل، ولماذا الآن
4. أضِف قائمة المواصفات كما هي بلا تعديل
5. راجع النص مقابل قواعد الأسلوب أدناه قبل التسليم

## قواعد الأسلوب
- لهجة سعودية بسيطة، بلا مبالغة
- لا إيموجي، ولا «الأفضل في السوق» بلا دليل
- الأسعار بالريال وبأرقام لاتينية

## شكل المخرج
| العنوان | الوصف | المواصفات | كلمات البحث |

## مثال
[حالة حقيقية كاملة: المدخل والمخرج]

الوصف (description) هو الأهم: هو ما يقرؤه Claude ليقرر متى يستخدم المهارة. اكتب فيه المواقف التي تستدعيها بكلمات المستخدم نفسها.

2 · قالب Subagent

المكان: .claude/agents/<الاسم>.md

---
name: quality-reviewer
description: يراجع أي مخرج قبل تسليمه ويحكم PASS أو RETURN. استخدمه بعد انتهاء أي أيجنت كاتب أو مصمم.
tools: Read, Grep, Glob
---

أنت مراجع جودة مستقل. لم تكتب العمل الذي تراجعه، ودورك أن تجد ما فات كاتبه.

قِس المخرج على هذه المعايير العشرة، ولكل معيار: ناجح أو راسب مع السبب:
1. ...
10. ...

أعد حكمك بهذا الشكل فقط:
{"verdict": "PASS" | "RETURN", "score": 0-10, "fixes": ["..."]}

لا تعدّل الملفات بنفسك. اكتب الملاحظات فقط.

الأدوات (tools): أعطِ كل أيجنت أقل ما يحتاجه. المراجع يقرأ فقط، فلا يحتاج صلاحية الكتابة.

3 · لوحة تصميم الفريق

املأ جدولاً واحداً لكل فريق قبل أن تبني أي أيجنت:

أسئلة قبل البناء

1. ما مصدر الحقيقة الواحد؟ ملف أو مجلد تقرأ منه كل الأيجنتس ولا ينسخ منه أحد.
2. ما شكل التسليم بين الأيجنتس؟ جدول أو JSON بحقول ثابتة، لا نص حر.
3. من يعمل بالتوازي ومن ينتظر غيره؟
4. كم مرة يُسمح بالإرجاع؟ مرتان كحد أقصى، ثم يُرفع للإنسان.
5. أين يوافق الإنسان؟ قبل أي إنفاق أو إرسال أو نشر.

4 · أعطال شائعة وعلاجها