Skills: إدارة الإصدارات والتحديثات

MAJOR.MINOR.PATCH

MAJOR: تغييرات غير متوافقة (تغيير تنسيق المخرجات، تغيير ربط الأدوات)
MINOR: إضافات متوافقة (بُعد مراجعة جديد، محفز جديد)
PATCH: إصلاحات متوافقة (تحسين القوالب، تحديث أمثلة)

# سجل التغييرات

## [2.1.0] - 2026-08-20

### مضاف
- إضافة محفز Git diff
- إضافة خيار إخراج مخططات Mermaid

### مُغيّر
- تحسين قالب المراجعة، تقليل المخرجات الوهمية

### مُصلح
- إصلاح خطأ تحليل كتل الكود المتداخلة

## [2.0.0] - 2026-08-01

### تغييرات غير متوافقة
- تغير تنسيق المخرجات من نص عادي إلى Markdown منظم
- تغير اسم المتغير من `file` إلى `target_file`

### الترحيل
- تحديث مراجع المتغيرات: `{{file}}` → `{{target_file}}`
- تحليل المخرجات يحتاج التكيف مع التنسيق الجديد (راجع دليل الترحيل)

## دليل الترحيل: v1 → v2

### تغييرات المتغيرات
- `{{file}}` → `{{target_file}}`
- `{{level}}` → `{{severity_level}}`

### تغييرات تنسيق المخرجات
- v1 نص عادي → v2 Markdown منظم
- علامات الخطورة: `[CRITICAL]` → `🔴`

### تغييرات ربط الأدوات
- تبعية جديدة: Grep (للبحث السياقي)

ثلاثة مبادئ توافق
├── تنسيق المخرجات: الحقول الجديدة لا تؤثر على القديمة
├── نظام المتغيرات: المتغيرات الجديدة لها قيم افتراضية؛ القديمة تبقى قابلة للاستخدام
└── المحفزات: المحفزات الجديدة لا تعطل الموجودة

عملية الإهمال (تمتد عبر 3 إصدارات)
1. v1.1.0: علّم كمُهمل، لا يزال قابلاً للاستخدام، أخرج تحذيرًا
2. v1.2.0: معطل افتراضيًا، يتطلب تفعيلًا صريحًا
3. v2.0.0: أُزيل بالكامل

## تصميم طبقة التوافق

دعم أسماء المتغيرات القديمة والجديدة معًا:

{{#if target_file}}
  الملف المستهدف: {{target_file}}
{{#else if file}}
  ⚠️ المتغير `file` مهمل، يرجى استخدام `target_file`
  الملف المستهدف: {{file}}
{{/if}}

تدفق تحديث مهارات الفريق
1. المشرف ينشر إصدارًا جديدًا + CHANGELOG
2. إبلاغ الفريق (Slack/بريد إلكتروني/تعليق PR)
3. أعضاء الفريق git pull للحصول على التحديثات
4. إصدارات MAJOR تتطلب مراجعة دليل الترحيل
5. تحقق اختبار محلي
6. تأكيد وإرسال تغييرات تكييف المشروع

# المشروع يثبّت إصدارات المهارات
skills:
  code-review:
    version: "^1.5.0"
  deploy:
    version: "2.0.0"