Skills: مهارات إعادة الهيكلة

---
name: smell-detector
description: "كشف روائح الكود"
tools:
  - Grep
  - Glob
  - Read
---

## تدفق الكشف
1. Glob للحصول على قائمة الملفات
2. Grep للبحث عن أنماط روائح الكود
3. Read للتأكيد بعمق
4. إخراج تقرير مرتب حسب الخطورة

مصفوفة مخاطر إعادة الهيكلة
           تأثير صغير   تأثير كبير
تغيير صغير  🟢 آمن      🟡 يحتاج اختبار
تغيير كبير  🟡 يحتاج مراجعة  🔴 يحتاج خطوات تدريجية

## ترتيب إعادة الهيكلة
1. مخاطر منخفضة قبل العالية (استخراج ثوابت → استخراج دوال → تقسيم أصناف)
2. المحلي قبل العام (مستوى الدالة → مستوى الصنف → مستوى الوحدة)
3. كل خطوة قابلة للتحقق (خطوات صغيرة، شغّل الاختبارات في كل خطوة)
4. قابل للتوقف في أي وقت (الكود يجب أن يعمل بعد أي خطوة)

## الفحوصات المسبقة
1. Bash: شغّل مجموعة الاختبارات الكاملة، أكد نجاح خط الأساس
2. Bash: git commit للحالة الحالية (نقطة لقطة)
3. Read: افهم السياق الكامل لهدف إعادة الهيكلة
4. حدد جميع مواقع الاستدعاء (من يعتمد على هذا الكود)

حلقة إعادة الهيكلة الآمنة
┌──────────────────┐
│ 1. تعديل صغير     │
│ 2. تشغيل الاختبارات │
│ 3. الاختبارات ناجحة؟ │
│    ├─ نعم → استمر  │
│    └─ لا → تراجع   │
└──────────────────┘

## قائمة التحقق
- [ ] مجموعة الاختبارات الكاملة ناجحة
- [ ] السلوك الوظيفي لم يتغير
- [ ] الكود أبسط/أنظف
- [ ] لا TODO/FIXME جديدة
- [ ] لا تبعيات دائرية

---
name: safe-extract-function
description: "استخراج دالة آمن"
tools:
  - Read
  - Edit
  - Grep
  - Bash
---

## تدفق الاستخراج
1. Read لتحليل الدالة الطويلة، حدد كتل المنطق المستقلة
2. اذكر خطة الاستخراج (أي أسطر → اسم الدالة الجديدة)
3. نفّذ خطوة بخطوة:
   a. Edit لإنشاء دالة جديدة أسفل الأصلية
   b. Edit لتعديل الدالة الأصلية لاستدعاء الدالة الجديدة
   c. Bash لتشغيل الاختبارات
4. بعد جميع الاستخراجات، شغّل مجموعة الاختبارات الكاملة