Skills: مهارات تصحيح الأخطاء

---
name: error-diagnoser
description: "تشخيص الأسباب الجذرية من رسائل الخطأ"
triggers:
  - keyword: "error|bug|exception"
tools:
  - Read
  - Grep
  - Glob
  - Bash
---

## تدفق تحليل السجلات
1. اقرأ ملف السجل
2. Grep لكلمات ERROR/WARN المفتاحية
3. استخرج أكوام الاستثناءات والجدول الزمني
4. ربط إدخالات السجل للطلب نفسه
5. إخراج تقرير التحليل

المراحل الأربع لتصحيح الأخطاء
├── 1. إعادة الإنتاج
│   ├── أكد أن الخطأ قابل لإعادة الإنتاج
│   ├── سجّل خطوات إعادة الإنتاج
│   └── ضيّق شروط إعادة الإنتاج
├── 2. التحديد
│   ├── اقرأ تتبع كومة الخطأ
│   ├── ابحث عن الكود ذي الصلة
│   └── أكد موقع المشكلة
├── 3. الإصلاح
│   ├── حلّل السبب الجذري
│   ├── اكتب كود الإصلاح
│   └── أضف فحوصات دفاعية
└── 4. التحقق
    ├── سيناريو إعادة الإنتاج ناجح
    ├── شغّل مجموعة الاختبارات الكاملة
    └── أكد عدم وجود تراجع

## تصحيح الأخطاء بالبحث الثنائي
1. أكد نطاق الإصدارات حيث توجد المشكلة
2. Bash: git bisect start
3. ضيّق النطاق إلى التزام محدد خطوة بخطوة
4. Read لفرق ذلك الالتزام
5. حدد سطر الكود المحدد الذي أدخل المشكلة

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

ترتيب قراءة كومة الخطأ:
1. السطر الأخير: نوع الخطأ والرسالة (الأكثر أهمية)
2. الثاني-الثالث من الأسفل: مواقع الاستدعاء في كودك
3. الإطارات الأعلى: سلسلة استدعاءات الإطار/المكتبة
4. أول سطر غير إطاري: نقطة التفعيل الفعلية

---
name: smart-debug
description: "تصحيح منهجي: إعادة إنتاج→تحديد→إصلاح→تحقق"
tools:
  - Read
  - Grep
  - Glob
  - Bash
  - Edit
---

## تدفق تصحيح الأخطاء
1. Read لرسالة الخطأ وتتبع الكومة
2. Grep للعثور على مكان ظهور رسالة الخطأ في الكود
3. Read للكود ذي الصلة، حلّل الأسباب المحتملة
4. اذكر 3 فرضيات وتحقق واحدة تلو الأخرى
5. بعد تأكيد السبب الجذري، Edit للإصلاح
6. Bash لتشغيل الاختبارات للتحقق