skill
تصحيح الأخطاء المنهجي
يستخدم عند مواجهة أي خطأ برمجي، أو فشل في الاختبار، أو سلوك غير متوقع، وذلك قبل اقتراح أي إصلاحات.
نبذة
# تصحيح الأخطاء المنهجي
## نظرة عامة
**المبدأ الأساسي:** ابحث دائما عن السبب الجذري قبل محاولة الإصلاحات. إصلاح الأعراض هو فشل.
**انتهاك نص هذه العملية هو انتهاك لروح تصحيح الأخطاء.**
## القانون الحديدي
``` لا إصلاحات بدون تحقيق في السبب الجذري أولا ```
إذا لم تكن قد أكملت المرحلة الأولى، فلا يمكنك اقتراح إصلاحات.
## متى تستخدمه
استخدمه لأي مشكلة فنية: - فشل الاختبارات - أخطاء في الإنتاج - سلوك غير متوقع - مشاكل الأداء - فشل البناء (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يعمل مع
خطوات التثبيت
ثبت باستخدام `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.
هل تصحيح الأخطاء المنهجي مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى