تصحيح الأخطاء

# /debug

> إذا رأيت عناصر نائبة غير مألوفة أو كنت بحاجة للتحقق من الأدوات المتصلة، انظر [CONNECTORS.md](../../CONNECTORS.md).

قم بجلسة تصحيح أخطاء منظمة للعثور على المشاكل وحلها بشكل منهجي.

## الاستخدام

``` /debug $ARGUMENTS ```

## كيفية العمل

``` ┌─────────────────────────────────────────────────────────────────┐ │ التصحيح │ ├─────────────────────────────────────────────────────────────────┤ │ الخطوة 1: إعادة الإنتاج │ │ ✓ فهم السلوك المتوقع والفعلي │ │ ✓ تحديد خطوات إعادة الإنتاج الدقيقة │ │ ✓ تحديد النطاق (متى بدأت المشكلة؟ من المتأثر؟) │ │ │ │ الخطوة 2: عزل المشكلة │ │ ✓ تضييق نطاق المكون أو الخدمة أو مسار التعليمات البرمجية │ │ ✓ التحقق من التغييرات الأخيرة (النشرات والتعديلات والمعتمدات) │ │ ✓ مراجعة السجلات ورسائل الأخطاء │ │ │ │ الخطوة 3: التشخيص │ │ ✓ صياغة الفرضيات واختبارها │ │ ✓ تتبع مسار التعليمات البرمجية │ │ ✓ تحديد السبب الجذري (وليس فقط الأعراض) │ │ │ │ الخطوة 4: الإصلاح │ │ ✓ اقتراح حل مع شرح │ │ ✓ الأخذ في الاعتبار التأثيرات الجانبية والحالات الحدية │ │ ✓ اقتراح الاختبارات لمنع الانحدار │ └─────────────────────────────────────────────────────────────────┘ ```

## ما أحتاجه منك

أخبرني عن المشكلة. أي من هذه يساعد: - رسالة خطأ أو تتبع المكدس - خطوات إعادة الإنتاج - ما تغير مؤخراً - السجلات أو لقطات الشاشة - السلوك المتوقع مقابل السلوك الفعلي

## النتيجة

```markdown ## تقرير التصحيح: [ملخص المشكلة]

### إعادة الإنتاج - **المتوقع**: [ما يجب أن يحدث] - **الفعلي**: [ما يحدث بدلاً من ذلك] - **الخطوات**: [كيفية إعادة الإنتاج]

### السبب الجذري [شرح سبب حدوث الخطأ]

### الإصلاح [تغييرات التعليمات البرمجية أو إصلاحات التكوين المطلوبة]

### الوقاية - [اختبار يجب إضافته] - [حماية يجب وضعها] ```

## إذا كانت الموصلات متاحة

إذا كان **~~المراقبة** متصلاً: - سحب السجلات ومعدلات الأخطاء والمقاييس حول وقت المشكلة - عرض النشرات الأخيرة وتغييرات التكوين التي قد تكون مرتبطة

إذا كان **~~التحكم بالإصدار** متصلاً: - تحديد الالتزامات والطلبات السحب الأخيرة التي تمس مسارات التعليمات البرمجية المتأثرة - التحقق مما إذا كانت المشكلة مرتبطة بتغيير معين

إذا كان **~~متتبع المشروع** متصلاً: - البحث عن تقارير الأخطاء ذات الصلة أو المشاكل المعروفة - إنشاء تذكرة للإصلاح بمجرد تحديده

## نصائح

1. **شارك رسائل الخطأ بدقة** — لا تعيد صياغتها. النص الدقيق مهم. 2. **اذكر ما تغير** — النشرات الأخيرة وتحديثات المعتمدات وتغييرات التكوين هي المشبوهون الأساسيون. 3. **أدرج السياق** — "هذا يعمل في المرحلة الاختبارية لكن ليس في الإنتاج" أو "يؤثر فقط على حمولات كبيرة" يضيق الخناق بسرعة.