Skills: أنماط التصميم المتقدمة

بنية نمط الاستراتيجية
┌──────────┐
│ السياق   │ → تقييم الشروط → اختيار الاستراتيجية
└────┬─────┘
     ├── الاستراتيجية A (مشروع Python)
     ├── الاستراتيجية B (مشروع TypeScript)
     └── الاستراتيجية C (مشروع Go)

## اختيار استراتيجية المراجعة

اختيار تلقائي بناءً على حزمة تقنيات المشروع:

{{#if tech_stack == "python"}}
تنفيذ استراتيجية مراجعة Python:
- تحقق من تلميحات الأنواع
- تحقق من docstrings
- تحقق من التوافق مع PEP 8
{{/if}}

{{#if tech_stack == "typescript"}}
تنفيذ استراتيجية مراجعة TypeScript:
- تحقق من أنواع any
- تحقق من تعريفات الواجهات
- تحقق من أمان الأنواع
{{/if}}

مثال سلسلة المسؤولية

المدخلات → فحص التنسيق → فحص الأمان → فحص الأداء → المخرجات
         ↓ فشل      ↓ فشل        ↓ فشل
        إرجاع خطأ   إرجاع خطأ    إرجاع خطأ

## سلسلة مسؤولية مراجعة الكود

### البوابة الأولى: فحص التنسيق
- هل ترميز الملف صحيح
- هل أسلوب الكود يلبي المعايير
- فشل التنسيق → إرجاع مشاكل التنسيق، لا تستمر

### البوابة الثانية: فحص الأمان
- كشف حقن SQL، XSS
- كشف المفاتيح المشفرة بشكل ثابت
- فشل الأمان → إرجاع مشاكل الأمان، لا تستمر

### البوابة الثالثة: فحص الجودة
- طول الدوال، التعقيد الدائري
- كشف الكود المكرر
- فشل الجودة → إرجاع مشاكل الجودة

### الكل ناجح → إخراج تقرير اجتياز المراجعة

مزايا سلسلة المسؤولية
├── خروج مبكر: فشل الفحص السابق يرجع فورًا، يوفر العبء اللاحق
├── فصل الاهتمامات: كل فاحص يركز فقط على بُعده
├── قابلية التوسع: أضف أبعاد فحص جديدة بإضافة حلقة واحدة
└── قابلية التكوين: يمكن تخطي حلقات فحص معينة

نمط المراقب

مصدر الحدث: تغيير ملف
├── المراقب A: تشغيل اختبارات تلقائي
├── المراقب B: مراجعة كود تلقائية
└── المراقب C: تحديث توثيق تلقائي

---
name: file-change-watcher
description: "تغيير الملف يُفعّل إجراءات تلقائية"
triggers:
  - context: "file_modified"
---

## قواعد الاستجابة للتغييرات

تحديد تلقائي عند تغيير الملف:
- تغيير src/**/*.py → تفعيل اختبارات Python
- تغيير src/**/*.ts → تفعيل اختبارات TypeScript
- تغيير docs/** → تفعيل تحقق التوثيق
- تغيير .env* → تذكير بالتحقق من تكوين البيئة

## طريقة قالب المراجعة

### الهيكل الثابت
1. جمع التغييرات
2. مراجعة ملف بملف (← قابل للتخصيص)
3. تجميع التقرير
4. إخراج التوصيات

### الخطوة القابلة للتخصيص (الخطوة 2)
خصص أبعاد المراجعة حسب اللغة/نوع المشروع

طريقة القالب = مهارة أساسية + مهارة فرعية قابلة للتوصيل

base-review.md (الهيكل)
├── جمع التغييرات
├── استدعاء مهارة {{review_strategy}} (قابلة للتوصيل)
├── تجميع التقرير
└── إخراج التوصيات

python-review.md (استراتيجية محددة) → تُملأ في review_strategy
ts-review.md (استراتيجية محددة) → تُملأ في review_strategy

المهارة الأساسية: code-review
├── + مُزيّن التخزين المؤقت: تخزين مؤقت لنتائج المراجعة
├── + مُزيّن التسجيل: تسجيل عمليات المراجعة
└── + مُزيّن الإشعارات: إبلاغ الفريق عند إكمال المراجعة

## مهارة مراجعة مُحسّنة

بالإضافة إلى تدفق المراجعة الأساسي، أضف:
1. قبل المراجعة: سجّل طلب المراجعة والطابع الزمني
2. بعد المراجعة: أرسل النتائج إلى قناة الفريق
3. التخزين المؤقت: أعد استخدام نتائج آخر مرة للملفات غير المتغيرة