تسعة عشر أمرًا (slash commands) لـ Claude Code تغطي عمل الاختبار من أوله: تقييم الكود، ثم اختبار يفشل ليثبت الخطأ، ثم تجهيز اختبارات الطرف إلى الطرف والحمل والطفرات. الحزمة إضافة (plugin) لـ Claude Code، بلا نسخة جاهزة لـ claude.ai أو Codex.
تقييم الكود وتنظيفه
- agent-preflight: قبل أن يعدّل الوكيل ملفاتك يصنّف المهمة أخضر أو أصفر أو أحمر حسب خطرها، ويكتب إيصالًا بالمسموح والممنوع وخطة التحقق والتراجع وشروط التوقف، ولا ينفّذ قبل موافقتك.
- code_analysis: يقرأ ملفًا أو مجلدًا، ولا يعلن أداة تعديل أو طرفية، ويرصد التعقيد والتكرار والثغرات الشائعة ومواضع البطء.
- optimize: يحلل أداء الكود ويقترح ثلاثة تحسينات محددة.
- check: يتعرّف على مدير الحزم (npm أو pnpm أو yarn أو bun)، ويشغّل فحوص المشروع ويصلح ما يفشل، دون commit ودون تغيير أرقام الإصدارات.
- clean: يشغّل أدوات التنسيق والفحص حسب اللغة، مثل black في Python وeslint وprettier في JavaScript.
كتابة الاختبارات نفسها
- repro-issue: تصف المشكلة، فيعيد إنتاجها في اختبار يفشل.
- write-tests: يكتشف إطار الاختبار، مثل Jest أو PyTest، ويتبع أسلوب الاختبارات الموجودة.
- generate-tests: يكتب مجموعة اختبارات كاملة لملف أو مكوّن، هدفها تغطية 80% أو أكثر.
- generate-test-cases: يحلل دالة أو ملفًا ويولّد حالات إيجابية وسلبية وحدّية، مع بدائل وهمية (mocks) للاعتماديات الخارجية.
- tdd: يلتزم دورة Red-Green-Refactor، بفرع لكل ميزة وملف ملاحظات في notes/features.
- testing_plan_integration: يقترح حالات اختبار التكامل ويعرضها عليك قبل أن يكتبها.
تجهيز بنية الاختبار
سبعة أوامر تختار الأداة وتعدّها وتربطها بخط CI: e2e-setup بأدوات مثل Playwright وCypress، وsetup-visual-testing لمقارنة لقطات الواجهة، وsetup-load-testing لاختبار الحمل بأدوات مثل k6، وadd-mutation-testing بأدوات مثل Stryker وmutmut، وadd-property-based-testing بأدوات مثل Hypothesis. ويجمع setup-comprehensive-testing اختبارات الوحدة والتكامل والطرف إلى الطرف والحمل في إعداد واحد، ويحدد test-coverage فجوات التغطية.
مثال: تقرير عن مجلد src
بعد تحميل الإضافة تكتب /commands-code-analysis-testing:code_analysis src/ فيعيد Claude، بحسب ملف الأمر، تقريرًا يبدأ بدرجة عامة لصحة الكود، تليه الملاحظات مصنفة حسب الفئة ومرتبة بالأولوية (عالية ومتوسطة ومنخفضة) مع الملف ورقم السطر وتوصية لكل ملاحظة، ثم يضيف الملاحظات العالية إلى قائمة مهام الجلسة. وبلا مسار يحلل مجلد العمل الحالي.
التحميل
- فك الضغط في مجلد ثابت، وشغّل من مشروعك
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بالمسار الفعلي؛ تُحمَّل الأوامر للجلسة الحالية وحدها، وتستدعيها مسبوقةً باسم الإضافة، مثل /commands-code-analysis-testing:check. - للاستخدام الدائم انسخ ما تحتاجه من plugin/commands إلى .claude/commands في مشروعك أو إلى ~/.claude/commands، فتستدعيه باسمه المختصر مثل /check.
أرفقتُ دليلًا عربيًا بطريقة التحميل، وفهرسًا بمسار كل أمر.
ما يجب أن تعرفه قبل التشغيل
- يلزمك Claude Code مسجّل الدخول، وتكلفة النموذج على حسابك. وأداة الطرفية المعلنة في e2e-setup وtest-coverage هي npm وحدها.
- يبدأ tdd من الفرع main ما لم تحدد غيره، وينهي كل ميزة بدفع الفرع إلى GitHub وفتح طلب دمج. وملفه منقطع في المصدر عند منتصف جملة.
- يعيد clean تنسيق المستودع كله؛ ابدأ من شجرة git نظيفة لتراجع الفرق.
- كُتب testing_plan_integration لمشروعات Rust، وoptimize وrepro-issue سطر واحد لكل منهما، وtest-changelog-automation ملف تجريبي بلا وظيفة.
- تعليمات الملفات بالإنجليزية.
كتبها مساهمون في مجتمع BuildWithClaude في مستودع davepoon/buildwithclaude، بترخيص MIT المرفق نصه داخل الحزمة. والأوامر نفسها ضمن حزمة الأوامر الكاملة مع 158 أمرًا آخر.
