skill

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

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

mattpocock746,030+ تثبيتموثوق

نبذة

# تشخيص الأخطاء

منهجية للأخطاء الصعبة. تخطى المراحل فقط عندما يكون هناك مبرر واضح.

عند استكشاف قاعدة الكود، اقرأ `GLOSSARY.md` (إذا كان موجودا) للحصول على نموذج ذهني واضح للوحدات ذات الصلة، وتحقق من ADRs في المنطقة التي تعمل عليها.

## تنقيح

تتطلب منك هذه المهارة عرض الأوامر والمخرجات والتحف الملتقطة. **نقح كل سر أولا**: اكتب `<REDACTED>` مكانه. أنشئ حلقات ضد متغيرات البيئة، بحيث تبقى بيانات الاعتماد في البيئة بدلا من عرضها. تحمل التحف الملتقطة رؤوس المصادقة: اقتبس فقط الأسطر التي تحمل الإشارة.

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

## المرحلة 1: بناء حلقة تغذية راجعة

**هذه هي المهارة.** كل شيء آخر ميكانيكي. إذا كان لديك إشارة نجاح/فشل **محددة** للخطأ (تتحول إلى اللون الأحمر عند _هذا_ الخطأ)، فستجد السبب؛ التجزئة، واختبار الفرضيات، والأدوات كلها تستهلكها فقط. إذا لم يكن لديك واحدة، فلن ينقذك أي قدر من التحديق في الكود.

خصص جهدا غير متناسب هنا. **كن حازما. كن مبدعا. ارفض الاستسلام.**

### طرق بنائها، بهذا الترتيب تقريبا

1. **اختبار فاشل** عند أي نقطة اتصال تصل إلى الخطأ: وحدة، تكامل، شامل (e2e). 2. **Curl / نص HTTP** مقابل خادم تطوير قيد التشغيل. 3. **استدعاء CLI** مع مدخلات ثابتة، ومقارنة مخرجات stdout بلقطة معروفة وصحيحة. 4. **نص متصفح بلا رأس** (Playwright / Puppeteer) يدير واجهة المستخدم ويتحقق من DOM/console/network. 5. **إعادة تشغيل تتبع ملتقط.** احفظ طلب شبكة حقيقي / حمولة / سجل أحداث على القرص؛ أعد تشغيله عبر مسار الكود بمعزل. 6. **أداة اختبار مؤقتة.** قم بتشغيل مجموعة فرعية دنيا من النظام (خدمة واحدة، تبعيات وهمية) التي تختبر مسار كود الخطأ باستدعاء دالة واحدة. 7. **حلقة خاصية / تشويش.** إذا كان الخطأ هو "مخرجات خاطئة أحيانا"، قم بتشغيل 1000 مدخل عشوائي وابحث عن وضع الفشل. 8. **أداة تجزئة.** إذا ظهر الخطأ بين حالتين معروفتين (التزام، مجموعة بيانات، إصدار)، قم بأتمتة "التشغيل في الحالة X، التحقق، التكرار" حتى تتمكن من `git bisect run` عليه. 9. **حلقة تفاضلية.** قم بتشغيل نفس المدخلات عبر الإصدار القديم مقابل الإصدار الجديد (أو تكوينين) ومقارنة المخرجات. 10. **نص bash يدوي (HITL).** الملاذ الأخير. إذا كان يجب على الإنسان النقر، قم بتوجيه _هم_ باستخدام `scripts/hitl-loop.template.sh` بحيث تظل الحلقة منظمة. تتغذى المخرجات الملتقطة إليك.

ابن حلقة التغذية الراجعة الصحيحة، وسيتم إصلاح الخطأ بنسبة 90%.

### إحكام الحلقة

تعامل مع الحلقة كمنتج. بمجرد أن يكون لديك حلقة، **أحكمها**:

- هل يمكنني جعلها أسرع؟ (إعداد التخزين المؤقت، تخطي التهيئة غير ذات الصلة، تضييق نطاق الاختبار.) - هل يمكنني جعل الإشارة أكثر حدة؟ (التحقق من العرض المحدد، وليس "لم يتعطل".) - هل يمكنني جعلها أكثر حتمية؟ (تثبيت الوقت، بذر RNG، عزل نظام الملفات، تجميد الشبكة.)

حلقة متقطعة تستغرق 30 ثانية أفضل بالكاد من عدم وجود حلقة؛ حلقة حتمية تستغرق ثانيتين هي قوية، وقوة خارقة لتصحيح الأخطاء.

### الأخطاء غير الحتمية

الهدف ليس إعادة إنتاج نظيفة بل **معدل تكرار أعلى**. كرر المشغل 100 مرة، قم بالموازاة، أضف ضغطا، ضيق نوافذ التوقيت، حقن فترات توقف. الخطأ الذي يتكرر بنسبة 50% قابل للتصحيح؛ 1% ليس كذلك، لذا استمر في رفع المعدل حتى يصبح قابلا للتصحيح.

### عندما لا يمكنك بناء حلقة حقا

توقف واذكر ذلك صراحة. اذكر ما جربته. اطلب من المستخدم: (أ) الوصول إلى أي بيئة تعيد إنتاجه، (ب) قطعة أثرية ملتقطة ومنقحة (ملف HAR، تفريغ سجل، تفريغ أساسي، تسجيل شاشة مع طوابع زمنية)، أو (ج) إذنا لإضافة أدوات إنتاج مؤقتة. **لا** تنتقل إلى الافتراض دون وجود حلقة.

### معيار الإنجاز: حلقة محكمة تتحول إلى اللون الأحمر

تكتمل المرحلة 1 عندما تكون الحلقة **محكمة** و**قادرة على التحول إلى اللون الأحمر**: يمكنك تسمية **أمر واحد** (مسار نص برمجي، استدعاء اختبار، curl) قمت **بتشغيله بالفعل مرة واحدة على الأقل** (اعرض الاستدعاء ومخرجاته، منقحة)، ويكون:

- [ ] **قادر على التحول إلى الأحمر**: يدفع مسار كود الخطأ الفعلي ويؤكد **العرض الدقيق للمستخدم**، بحيث يمكن أن يتحول إلى الأحمر عند هذا الخطأ والأخضر بمجرد إصلاحه. ليس "يعمل بدون أخطاء"؛ يجب أن يكون قادرا على _التقاط هذا الخطأ المحدد_. - [ ] **حتمي**: نفس الحكم في كل تشغيل (الأخطاء المتقطعة: معدل تكرار عال ومثبت، كما هو مذكور أعلاه). - [ ] **سريع**: ثوان، وليس دقائق. - [ ] **قابل للتشغيل بواسطة الوكيل**: يمكنك تشغيله دون مراقبة؛ لا يوجد تدخل بشري إلا عبر `scripts/hitl-loop.template.sh`.

إذا وجدت نفسك تقرأ الكود لبناء نظرية قبل وجود هذا الأمر، **توقف: القفز مباشرة إلى الفرضية هو الفشل الدقيق الذي تمنعه هذه المهارة.** لا يوجد أمر قادر على التحول إلى الأحمر، لا توجد المرحلة 2.

## المرحلة 2: إعادة الإنتاج + التقليل

شغل الحلقة. راقبها وهي تتحول إلى اللون الأحمر مع ظهور الخطأ.

تأكد من:

- [ ] تنتج الحلقة وضع الفشل الذي وصفه **المستخدم**، وليس فشلا مختلفا يحدث بالصدفة بالقرب منه. خطأ خاطئ = إصلاح خاطئ. - [ ] يمكن إعادة إنتاج الفشل عبر عمليات تشغيل متعددة (أو، للأخطاء غير الحتمية، يمكن إعادة إنتاجه بمعدل عال بما يكفي لتصحيحه). - [ ] لقد التقطت العرض الدقيق (رسالة الخطأ، الإخراج الخاطئ، التوقيت البطيء) بحيث يمكن لاحقا p

التثبيت

شغل هذا الأمر

npx skills add mattpocock/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/diagnosing-bugs` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة تشخيص الأخطاء؟

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

كيف أثبت تشخيص الأخطاء؟

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

npx skills add mattpocock/skills
مع أي أدوات ذكاء اصطناعي تعمل تشخيص الأخطاء؟

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

من طور تشخيص الأخطاء؟

طورها mattpocock.

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

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

أصول ذات صلة

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

كل بدائل تشخيص الأخطاء ←
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
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (التزام، فرع، وسم، أو قاعدة دمج) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (…696,572+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
نشر Azure
نفذ عمليات نشر Azure للتطبيقات المعدة مسبقا والتي تحتوي على ملفات .azure/deployment-plan.md والبنية التحتية الموجودة. لا تستخدم هذه المهارة عندما يطلب…618,328+

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

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

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