Skills: تركيب المهارات وتنسيقها

مثال على سلسلة المهارات: العملية الكاملة لإرسال الكود

مراجعة الكود → إصلاح تلقائي → تشغيل الاختبارات → تحديث التوثيق → إرسال الكود
     ↓           ↓          ↓          ↓          ↓
  تقرير المراجعة  رقعة الإصلاح  تقرير الاختبار  تحديث التوثيق  معرف الالتزام

مثال على مصفوفة المهارات: فحص جودة شامل

            ┌→ مسح أمني ─┐
تغيير الكود ──┤→ تحليل الأداء ─┤→ تقرير الجودة
            └→ فحص الأسلوب ─┘

مثال على التنسيق الشرطي: نشر ذكي

تحديد نوع التغيير:
├── تغيير توثيق → تحديث التوثيق فقط
├── تغيير اختبار → تشغيل الاختبارات فقط
├── تغيير كود → العملية الكاملة (مراجعة→اختبار→نشر)
└── تغيير تكوين → مراجعة + تأكيد ثم نشر

## استراتيجية التنفيذ

1. نفّذ أولاً مهارة code-review
2. إذا وُجدت مشاكل 🔴:
   - نفّذ مهارة auto-fix
   - أعد تنفيذ code-review لتأكيد الإصلاح
3. بعد اجتياز المراجعة، نفّذ مهارة test-runner
4. بعد نجاح الاختبارات، أخرج تقريرًا ملخصًا

مخرجات المهارة A → اكتب إلى متغير سياق → المهارة B تقرأ

مثال:
code-review يكتشف 3 مشاكل →
  سياق: { review_issues: [...], fix_targets: [...] }
→ auto-fix يقرأ fix_targets وينفذ الإصلاحات

## قالب التقرير الملخص

### نتائج تنفيذ سلسلة المهارات
| الخطوة | المهارة | الحالة | المدة | المخرجات الرئيسية |
|:-----|:------|:-------|:---------|:-----------|
| 1 | code-review | ✅ | 30 ث | 5 مشاكل |
| 2 | auto-fix | ✅ | 45 ث | أُصلح 4 |
| 3 | test-runner | ✅ | 2 د | الكل ناجح |

تصميم الاقتران الفضفاض:
├── المهارة A لا تستدعي مباشرة دوال المهارة B الداخلية
├── المهارات تمرر البيانات عبر تنسيقات قياسية (مثلاً JSON، Markdown)
├── فشل مهارة واحدة لا يؤثر على الوظائف الأساسية للمهارات الأخرى
└── كل مهارة يمكن اختبارها بشكل مستقل

## متطلبات التساوي
- تشغيل مهارة المراجعة عدة مرات ينتج نفس النتائج
- مهارة الإصلاح تتحقق مما إذا كانت المشكلة مُصلحة بالفعل، تتخطى إن كان كذلك
- مهارة النشر تتحقق من الحالة الحالية، تؤكد بدلاً من إعادة النشر إذا كان منشورًا بالفعل

---
name: pr-gate
description: "بوابة جودة PR: مراجعة+اختبار+أمن ثلاثية في واحدة"
triggers:
  - keyword: "pr-gate|quality gate"
---

## تدفق التنفيذ

1. استدعِ code-review (مراجعة كود)
2. استدعِ test-runner (تشغيل اختبارات)
3. استدعِ security-scan (مسح أمني)
4. جمّع نتائج الثلاثة
5. أخرج توصية الدمج:
   - الثلاثة ناجحة → ✅ يُوصى بالدمج
   - أي 🔴 → ❌ لا يُوصى بالدمج
   - 🟡 فقط → ⚠️ دمج بعد الإصلاحات