أوامر تشخيص الأخطاء — commands-utilities-debugging

حين تظهر رسالة خطأ ولا تعرف من أين تبدأ، يعطيك الأمر debug-error داخل Claude Code منهجًا من ثماني عشرة خطوة: يجمع رسالة الخطأ وسجلّ الاستدعاءات (stack trace)، ويعيد إنتاج المشكلة، ثم يختبر فرضيات السبب واحدة بعد الأخرى حتى يصل إلى السبب الجذري. ومعه في هذه الإضافة (plugin) ثلاثة عشر أمرًا آخر.

الأوامر، مجمّعة حسب ما تحتاجه

لفهم الكود وإصلاحه

• debug-error: تشخيص منهجي للخطأ الذي تكتبه بعد اسم الأمر، حتى اقتراح اختبارات تمنع تكراره.
• explain-code: شرح الكود على ستة عشر محورًا، من البنية إلى الشرح سطرًا بسطر والحالات الحدّية.
• check-file: فحص ملف واحد تحدّد مساره: الجودة والثغرات والأداء والاختبارات الناقصة، مع تركيز على TypeScript وJavaScript.
• code-review: مراجعة المستودع كله في ثماني خطوات، منها البحث عن مفاتيح API وكلمات مرور داخل الكود، بتوصيات مرتبة حسب الخطورة.
• refactor-code: إعادة هيكلة بخطوات صغيرة في فرع يبدأ اسمه بـ refactor/، تسبقها كتابة الاختبارات الناقصة.
• directory-deep-dive: يحلّل مجلدًا ويكتب داخله ملف CLAUDE.md يلخّص معماريته، فيقرؤه Claude كلما عمل فيه.

لإدارة git

• git-status: الفرع الحالي، وكم يسبق الفرع البعيد أو يتأخر عنه، والملفات المعدّلة وما يلزم بعدها.
• clean-branches: يحصر الفروع المدموجة والراكدة ويحذفها، ويشرح استرجاع فرع محذوف عبر git reflog.

لمن يدير مهامه في Linear

• code-to-task: يحوّل تعليقات TODO وFIXME وHACK والدوال الموسومة deprecated إلى مهام مرتبة حسب الأولوية.
• generate-linear-worklog: يكتب سجلّ عمل تقنيًا من التزامات git وينشره تعليقًا على تذكرة Linear.

للقرارات الكبيرة

• ultra-think: يحلّل مسألة من أربع زوايا (التقنية والتجارية والمستخدم والنظام)، ويقترح من ثلاثة حلول إلى خمسة ثم يوصي بأحدها.
• architecture-scenario-explorer: يقارن خيارات معمارية عبر سيناريوهات ومخاطر، وينتهي بوثيقة قرار معماري.

والأمران الباقيان: all-tools يعرض أدوات جلستك بتواقيعها، وcode-permutation-tester يوازن بين عدة طرق لكتابة الشيء نفسه ويقدّر أداءها قبل التنفيذ، فأرقامه تقديرات لا قياسات.

مثال من ملف debug-error

تكتب /commands-utilities-debugging:debug-error ثم تلصق رسالة الخطأ كاملة، مثل TypeError: Cannot read properties of undefined، فتصل إلى الأمر في موضع $ARGUMENTS. وبحسب تعليماته يقرأ سجلّ الاستدعاءات ليحدّد السطر الذي نشأ فيه الخطأ، ويراجع التغييرات الأخيرة حوله، ثم يعزل السبب بالتنصيف (binary search)، ويصمّم إصلاحًا للسبب الجذري يختبره على الحالة الأصلية. ولا يأذن الملف مسبقًا إلا بأداة القراءة (Read)، فتعديل الكود وتشغيل الاختبارات يطلبان إذنك.

التحميل والتشغيل

• فكّ ضغط الملف في مجلد ثابت، وشغّل من مشروعك claude --plugin-dir "PATH/TO/EXTRACTED/plugin" بالمسار الفعلي. هذا التحميل يخص الجلسة الحالية وحدها.
• لأمر واحد ثابت في مشروع بعينه، انسخ ملفه من plugin/commands إلى .claude/commands في المشروع، فيظهر باسمه القصير مثل /debug-error.
• المتطلبات: Claude Code مسجَّل الدخول، وgit، واتصال بـ Linear لأمري Linear. وفي claude.ai يمكنك لصق نص الملف تعليماتٍ، لكن $ARGUMENTS والأذونات لا تعمل هناك.

قبل أول تشغيل

• clean-branches يأذن مسبقًا بكل أوامر git، ومنها الحذف بـ git branch -D وgit push origin --delete، فقد تُنفَّذ دون طلب إذن؛ اطلب قائمة الفروع أولًا وراجعها قبل الحذف.
• git-status يقارن فرعك بـ origin/main؛ إن كان فرعك الرئيسي master فاذكر ذلك له.
• أمثلة بعض الملفات تستخدم بادئات قديمة مثل /project:ultra-think؛ مع الإضافة استخدم /commands-utilities-debugging:ultra-think.
• نصوص الأوامر بالإنجليزية، وأرفقتُ معها دليلًا عربيًا وفهرسًا للملفات.

المصدر والترخيص

الأوامر من مستودع buildwithclaude بترخيص MIT (حقوق النشر لـ davepoon)، وتنسب ثلاثة منها أصلها إلى IndyDevDan وThomas Landgraf، ولم أعدّل في نصوصها شيئًا.