skill

تصحيح الأخطاء المنهجي

يستخدم عند مواجهة أي خطأ برمجي، أو فشل في الاختبار، أو سلوك غير متوقع، وذلك قبل اقتراح أي إصلاحات.

obra284,215+ تثبيتموثوق

نبذة

# تصحيح الأخطاء المنهجي

## نظرة عامة

**المبدأ الأساسي:** ابحث دائما عن السبب الجذري قبل محاولة الإصلاحات. إصلاح الأعراض هو فشل.

**انتهاك نص هذه العملية هو انتهاك لروح تصحيح الأخطاء.**

## القانون الحديدي

``` لا إصلاحات بدون تحقيق في السبب الجذري أولا ```

إذا لم تكن قد أكملت المرحلة الأولى، فلا يمكنك اقتراح إصلاحات.

## متى تستخدمه

استخدمه لأي مشكلة فنية: - فشل الاختبارات - أخطاء في الإنتاج - سلوك غير متوقع - مشاكل الأداء - فشل البناء (Build failures) - مشاكل التكامل

**استخدم هذا بشكل خاص عندما:** - تكون تحت ضغط الوقت (حالات الطوارئ تجعل التخمين مغريا) - يبدو "إصلاح سريع واحد" واضحا - لقد جربت بالفعل إصلاحات متعددة - الإصلاح السابق لم ينجح - لا تفهم المشكلة بشكل كامل

**لا تتخطاه عندما:** - تبدو المشكلة بسيطة (الأخطاء البسيطة لها أسباب جذرية أيضا) - تكون في عجلة من أمرك (التسرع يضمن إعادة العمل) - يريد المدير إصلاحها الآن (المنهجية أسرع من العشوائية)

## المراحل الأربع

يجب عليك إكمال كل مرحلة قبل الانتقال إلى التالية.

### المرحلة 1: التحقيق في السبب الجذري

**قبل محاولة أي إصلاح:**

1. **اقرأ رسائل الخطأ بعناية** - لا تتخطى الأخطاء أو التحذيرات - غالبا ما تحتوي على الحل الدقيق - اقرأ تتبعات المكدس (stack traces) بالكامل - لاحظ أرقام الأسطر، مسارات الملفات، رموز الأخطاء

2. **إعادة الإنتاج بشكل متسق** - هل يمكنك تفعيله بشكل موثوق؟ - ما هي الخطوات الدقيقة؟ - هل يحدث في كل مرة؟ - إذا لم يكن قابلا لإعادة الإنتاج ← اجمع المزيد من البيانات، لا تخمن

3. **تحقق من التغييرات الأخيرة** - ما الذي تغير والذي يمكن أن يسبب هذا؟ - Git diff، الالتزامات الأخيرة (recent commits) - تبعيات جديدة، تغييرات في التكوين (config changes) - اختلافات بيئية

4. **جمع الأدلة في الأنظمة متعددة المكونات**

**عندما يحتوي النظام على مكونات متعددة (CI → build → signing, API → service → database):**

**قبل اقتراح الإصلاحات، أضف أدوات التشخيص:** ``` لكل حدود مكون: - سجل البيانات التي تدخل المكون - سجل البيانات التي تخرج من المكون - تحقق من انتشار البيئة/التكوين - تحقق من الحالة في كل طبقة

شغل مرة واحدة لجمع الأدلة التي تظهر أين يحدث الخلل ثم حلل الأدلة لتحديد المكون الفاشل ثم حقق في هذا المكون المحدد ```

**مثال (نظام متعدد الطبقات):** ```bash # الطبقة 1: سير العمل (Workflow) echo "=== الأسرار المتاحة في سير العمل: ===" echo "IDENTITY: $([ -n "${IDENTITY:-}" ] && echo SET || echo UNSET)"

# الطبقة 2: سكربت البناء (Build script) echo "=== متغيرات البيئة في سكربت البناء: ===" printenv IDENTITY >/dev/null 2>&1 && echo "IDENTITY في البيئة" || echo "IDENTITY ليس في البيئة"

# الطبقة 3: سكربت التوقيع (Signing script) echo "=== حالة Keychain: ===" security list-keychains security find-identity -v

# الطبقة 4: التوقيع الفعلي codesign --sign "$IDENTITY" --verbose=4 "$APP" ```

**هذا يكشف:** أي طبقة تفشل (الأسرار → سير العمل ✓، سير العمل → البناء ✗)

5. **تتبع تدفق البيانات**

**عندما يكون الخطأ عميقا في مكدس الاستدعاء (call stack):**

راجع `root-cause-tracing.md` في هذا الدليل لتقنية التتبع العكسي الكاملة.

**نسخة سريعة:** - من أين تنشأ القيمة الخاطئة؟ - ما الذي استدعى هذا بقيمة خاطئة؟ - استمر في التتبع للأعلى حتى تجد المصدر - أصلح عند المصدر، وليس عند العرض

### المرحلة 2: تحليل النمط

**ابحث عن النمط قبل الإصلاح:**

1. **ابحث عن أمثلة عاملة** - حدد موقع كود مشابه يعمل في نفس قاعدة الكود - ما الذي يعمل وهو مشابه لما هو معطل؟

2. **قارن بالمراجع** - إذا كنت تنفذ نمطا، اقرأ تنفيذ المرجع بالكامل - لا تتصفح بسرعة - اقرأ كل سطر - افهم النمط بالكامل قبل تطبيقه

3. **حدد الاختلافات** - ما الذي يختلف بين ما يعمل وما هو معطل؟ - اذكر كل اختلاف، مهما كان صغيرا - لا تفترض "هذا لا يمكن أن يكون مهما"

4. **فهم التبعيات** - ما هي المكونات الأخرى التي يحتاجها هذا؟ - ما هي الإعدادات، التكوين، البيئة؟ - ما هي الافتراضات التي يقوم عليها؟

### المرحلة 3: الفرضية والاختبار

**المنهج العلمي:**

1. **صياغة فرضية واحدة** - اذكر بوضوح: "أعتقد أن X هو السبب الجذري لأن Y" - اكتبها - كن محددا، لا غامضا

2. **اختبر بأقل قدر ممكن** - قم بأصغر تغيير ممكن لاختبار الفرضية - متغير واحد في كل مرة - لا تصلح أشياء متعددة في وقت واحد

3. **تحقق قبل المتابعة** - هل نجح؟ نعم ← المرحلة 4 - لم ينجح؟ صغ فرضية جديدة - لا تضف المزيد من الإصلاحات فوق بعضها

4. **عندما لا تعرف** - قل "لا أفهم X" - لا تتظاهر بالمعرفة - اطلب المساعدة - ابحث أكثر

### المرحلة 4: التنفيذ

**أصلح السبب الجذري، وليس العرض:**

1. **أنشئ حالة اختبار فاشلة** - أبسط إعادة إنتاج ممكنة - اختبار آلي إذا أمكن - سكربت اختبار لمرة واحدة إذا لم يكن هناك إطار عمل - يجب أن يكون موجودا قبل الإصلاح - استخدم مهارة `superpowers:test-driven-development` لكتابة اختبارات فاشلة صحيحة

2. **نفذ إصلاحا واحدا** - عالج السبب الجذري المحدد - تغيير واحد في كل مرة - لا تحسينات "بينما أنا هنا" - لا تجميع

التثبيت

شغل هذا الأمر

npx skills add obra/superpowers

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add obra/superpowers`، أو استنسخ المستودع وانسخ مجلد `skills/systematic-debugging` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة تصحيح الأخطاء المنهجي؟

يستخدم عند مواجهة أي خطأ برمجي، أو فشل في الاختبار، أو سلوك غير متوقع، وذلك قبل اقتراح أي إصلاحات.

كيف أثبت تصحيح الأخطاء المنهجي؟

شغل هذا الأمر في الطرفية:

npx skills add obra/superpowers
مع أي أدوات ذكاء اصطناعي تعمل تصحيح الأخطاء المنهجي؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور تصحيح الأخطاء المنهجي؟

طورها obra.

هل تصحيح الأخطاء المنهجي مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل تصحيح الأخطاء المنهجي ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
واجهة سطر الأوامر Hyperframes
واجهة سطر الأوامر (CLI) ل HyperFrames من job - لإنشاء الهياكل، والتحقق من الإطارات، وعرضها، وتعديل الجدول الزمني، والمعاينة، والتصيير محليا أو سحابيا،…1,214,920+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدمها عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجواب".869,010+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (التزام، فرع، وسم، أو قاعدة دمج) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (…696,572+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة