🔍

systematic-debugging

Name: systematic-debugging
Author: sickn33

مخاطر منخفضة

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

متاح أيضًا من: Cycleaddict,ZhanlinCui,DMJGilbert,Asmayaseen,DYAI2025,davila7,ChrisWiles,CodingCossack,Doyajin174,obra,Cygnusfear

لا تُهدر وقتك في إصلاحات عشوائية. تُعلم هذه المهارة مساعدات الذكاء الاصطناعي منهجية تصحيح منظمة تجد الأسباب الجذرية قبل محاولة الإصلاحات، مما يقلل وقت التصحيح من ساعات إلى دقائق.

يدعم: Claude Codex Code(CC)

⚠️ 68 ضعيف

تنزيل ZIP المهارة

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

فعّل وابدأ الاستخدام

اختبرها

استخدام "systematic-debugging". زر تسجيل الدخول لا يعمل. هل يمكنك إصلاحه؟

النتيجة المتوقعة:

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

استخدام "systematic-debugging". واجهة برمجة التطبيقات ترجع خطأ 500 على نقطة النهاية /users

النتيجة المتوقعة:

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

استخدام "systematic-debugging". إصلاح استثناء المؤشر الفارغ في user-service.ts السطر 42

النتيجة المتوقعة:

سأتحقق من السبب الجذري أولاً. من أين تأتي القيمة الفارغة؟ من استدعى هذا بفارغ؟ دعني أتتبع عبر استدعاء المكدس للعثور على المصدر، ثم أصلح في المصدر بدلاً من إضافة كود دفاعي في السطر 42.

التدقيق الأمني

مخاطر منخفضة

v1 • 2/25/2026

All 126 static findings are false positives. The skill contains legitimate debugging methodology with example commands shown as educational content. JavaScript template literals were misidentified as shell execution. Environment variable checks are for NODE_ENV configuration. Keychain commands are debugging examples, not malicious access. No actual security risks found.

الملفات التي تم فحصها

1,264

الأسطر التي تم تحليلها

النتائج

إجمالي عمليات التدقيق

مشكلات منخفضة المخاطر (4)

condition-based-waiting-example.ts:36 condition-based-waiting-example.ts:79 condition-based-waiting-example.ts:128

JavaScript Template Literals Misidentified as Shell Execution

Backticks in TypeScript files are JavaScript template literals for string interpolation, not shell command execution. The static scanner misidentified these as Ruby/shell backtick execution.

SKILL.md:103-104

Diagnostic Commands Shown as Debugging Examples

Commands like 'security list-keychains' in SKILL.md are shown as examples of what to check when debugging code signing issues, not actual malicious keychain access.

defense-in-depth.md:58 root-cause-tracing.md:77

Standard Environment Variable Configuration Pattern

process.env.NODE_ENV access is a standard, safe pattern for detecting test environments and conditionally running test-specific code.

find-polluter.sh:22 find-polluter.sh:23 find-polluter.sh:30

Legitimate Test Debugging Scripts

The find-polluter.sh script uses standard bash command substitution and redirection for running tests and checking file state - a legitimate debugging utility.

تم تدقيقه بواسطة: claude

درجة الجودة

الهندسة المعمارية

100

قابلية الصيانة

المحتوى

المجتمع

الأمان

100

الامتثال للمواصفات

ماذا يمكنك بناءه

إصلاح فشل الاختبارات المتكررة

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

تصحيح حوادث الإنتاج

عند حدوث مشاكل في الإنتاج، اتبع التحقيق المنظم لتحديد السبب الجذرية بسرعة بدلاً من تخمين الحلول تحت الضغط.

تعلمcipline التصحيح

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

جرّب هذه الموجهات

طلب تصحيح أساسي

أرى هذا الخطأ: [الصق الخطأ]. يرجى استخدام التصحيح المنهجي للتحقيق في السبب الجذرية قبل اقتراح أي إصلاحات.

تصحيح متعدد المكونات

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

تحقيق فشل الاختبار

هذا الاختبار [اسم الاختبار] يفشل. يرجى اتباع عملية التصحيح المنهجية لمعرفة السبب، ثم إنشاء حالة اختبار فاشلة قبل الإصلاح.

سؤال معماري

جربت ثلاثة إصلاحات لهذه المشكلة وكل منها كشف عن مشكلة جديدة في مكان مختلف. يرجى استخدام التصحيح المنهجي لتحديد ما إذا كانت هذه مشكلة معمارية.

أفضل الممارسات

أكمل دائماً التحقيق في السبب الجذرية قبل اقتراح أي إصلاح - هذا يمنع إصلاح الأعراض بدلاً من الأسباب
اجمع الأدلة من خلال إعادة الإنتاج والتأثير بدلاً من التخمين بناءً على الأعراض
عندما فشلت ثلاثة إصلاحات أو أكثر، questioningالمعمار بدلاً من محاولة إصلاح آخر
أنشئ حالة اختبار فاشلة قبل تنفيذ الإصلاح للتأكد من أن الإصلاح يحل المشكلة فعلياً

تجنب

اقتراح إصلاحات دون إكمال التحقيق في السبب الجذرية للمرحلة الأولى
تجربة إصلاحات عشوائية متعددة لمعرفة ما يعمل ('تصحيح الرشاش')
تخطي خطوة إنشاء حالة الاختبار والتحقق يدوياً بدلاً من ذلك
إضافة تغييرات متعددة دفعة واحدة 'لتوفير الوقت' - هذا يمنع عزل ما نجح فعلياً

الأسئلة المتكررة

متى يجب أن أستخدم هذه المهارة؟

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

هل هذا يبطئ التصحيح؟

لا. التصحيح المنهجي أسرع من التخمين العشوائي. للإصلاحات العشوائية معدل نجاح 40% في المحاولة الأولى بينما تحقق الأساليب المنهجية 95% نجاح، مما يوفر ساعات من إعادة العمل.

ماذا لو كانت المشكلة بيئية حقاً أو خارجية؟

إذا كشف التحقيق المنظم أن المشكلة بيئية حقاً أو تعتمد على التوقيت أو خارجية، فقد أكملت العملية. وثّق ما حققته ونفذ معالجة مناسبة مثل إعادة المحاولات أو رسائل الخطأ.

كيف أعرف متى أتساءل عن المعمار؟

تساءل عن المعمار عندما جربت 3 إصلاحات أو أكثر وكل منها كشف عن مشكلة جديدة في مكان مختلف، أو عندما تتطلب الإصلاحات إعادة هندسة ضخمة للتنفيذ. هذا يشير إلى مشكلة معمارية أساسية، وليس خلل بسيط.

هل يمكن لهذه المهارة المساعدة في مشاكل الأداء؟

نعم. النهج المنهجيينapplicable لأي مشكلة تقنية بما في ذلك مشاكل الأداء. استخدم نفس التحقيق في السبب الجذرية للعثور على سبب تدهور الأداء قبل محاولة التحسينات.

ما التقنيات الداعمة المضمنة؟

تتضمن هذه المهارة تتبع السبب الجذري لتحليل مكدس الاستدعاء الخلفي، والدفاع المتعدد لإضافة التحقق في طبقات متعددة، والانتظار القائم على_condition لاستبدال المهلة التعسفية باستطلاع شرطي مناسب.