skill
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.
نبذة
# تشخيص الأخطاء
منهجية للأخطاء الصعبة. تخطى المراحل فقط عندما يكون هناك مبرر واضح.
عند استكشاف قاعدة الكود، اقرأ `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يعمل مع
خطوات التثبيت
ثبت باستخدام `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.
هل تشخيص الأخطاء مجانية؟
نعم، يمكنك استخدامها مجانا.
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 microsoft/azure-skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى