Skills: المشاكل الشائعة واستكشاف الأخطاء

أربع طبقات لتشخيص المشاكل
├── الطبقة 1: طبقة الملف
│   ├── هل الملف موجود؟
│   ├── هل المسار صحيح؟
│   └── هل الـ frontmatter صالح؟
├── الطبقة 2: طبقة التكوين
│   ├── هل المحفز مطابق؟
│   ├── هل الأدوات مربوطة؟
│   └── هل الصلاحيات كافية؟
├── الطبقة 3: طبقة القالب
│   ├── هل التعليمات واضحة؟
│   ├── هل الأمثلة كافية؟
│   └── هل القيود صريحة؟
└── الطبقة 4: طبقة التنفيذ
    ├── هل الأدوات استُدعيت كما هو متوقع؟
    ├── هل المخرجات تطابق التنسيق؟
    └── هل النتيجة تلبي الهدف؟

اختبار A/B للقوالب
1. أبقِ جميع الشروط الأخرى كما هي
2. عدّل جزءًا واحدًا فقط من القالب
3. قارن جودة المخرجات
4. احتفظ بالإصدار الأفضل
5. سجّل سبب التغيير

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

تقنيات الضبط الدقيق الشائعة
├── إضافة أمثلة: تنسيق مخرجات خاطئ → أضف مثال مخرجات متوقع
├── إضافة قيود: مخرجات مطولة → أضف "موجز، لا يزيد عن N سطر"
├── إضافة خطوات: أداة لم تُستدعَ → أضف "الخطوة N: استخدم أداة XX"
├── إضافة شروط: سلوك غير صحيح → أضف "إذا X، ثم Y؛ وإلا Z"
└── إضافة نفي: يفعل أشياء لا يجب فعلها → أضف "لا تفعل X"

إصلاح مشاكل الأدوات
├── أداة لم تُستدعَ: حدد صراحةً في التدفق "استخدم Read لقراءة الملف"
├── أداة خاطئة: اذكر في القالب "استخدم Edit وليس Write لتعديل الملفات"
├── صلاحيات غير كافية: تحقق من تكوين allow/deny في settings.json
└── انتهاء مهلة الأداة: ضيّق نطاق البحث، قلّل حجم البيانات

إصلاح مشاكل المحفزات
├── لا يتفعّل: كلمة مفتاحية غامضة جدًا → أضف مرادفات شائعة
├── تفعيل خاطئ: كلمة مفتاحية واسعة جدًا → ضيّق نطاق المطابقة
├── تعارضات: مهارات متعددة تتنافس → عدّل الأولويات
└── تفعيل متكرر: شرط فضفاض جدًا → أضف شروط AND

## قائمة فحص التصحيح

### فحوصات أساسية
- [ ] مسار الملف صحيح
- [ ] صياغة YAML للـ frontmatter صحيحة
- [ ] name وdescription مملوءان
- [ ] triggers مُكوّنة

### فحوصات وظيفية
- [ ] روابط الأدوات كاملة
- [ ] القالب يحتوي على خطوات تنفيذ واضحة
- [ ] يوجد مثال على تنسيق المخرجات
- [ ] يوجد قيود وشروط حدية

### فحوصات الجودة
- [ ] مُتحقق في مشروع اختبار
- [ ] تنسيق المخرجات مستقر
- [ ] استدعاءات الأدوات معقولة
- [ ] لا مخاطر أمنية