حين تكتفي بإصلاح عَرَض العطل قد يعود لاحقًا، وحين تتراكم ملفات الهجرة (migrations) يصعب أن ترى علاقات الجداول في صورة واحدة. لهاتين المشكلتين أمران في Claude Code: five يطبّق طريقة «لماذا الخمس» (Five Whys) على المشكلة التي تصفها، وmermaid يحوّل عبارات CREATE TABLE إلى مخطط علاقات بصيغة Mermaid.
صيغة الأوامر خاصة بـ Claude Code، ولم أجهّز نسخة لـ Codex. وعلى claude.ai يمكنك لصق نص five.md في المحادثة مع وصف مشكلتك.
ماذا يفعل كل أمر
- five: يبدأ من وصفك للمشكلة، ويسأل «لماذا حدث هذا؟» ويعيد السؤال على كل إجابة خمس مرات على الأقل أو حتى يبلغ السبب الجذري، ثم يختبره بالرجوع منه إلى العَرَض ويقترح حلولًا تعالجه. وتنبّه ملاحظاته إلى أن السبب قد يكون في طريقة العمل لا في الكود وحده.
- mermaid: يأخذ مسار المصدر ومسارًا اختياريًا للإخراج (الافتراضي docs/erd.md)، كما في مثال ملفه /mermaid schema.sql docs/database-erd.md. يبحث عن ملفات .sql و.ddl، وإن لم تحدد مسارًا فتّش مجلدات مثل migrations وschema. يستخرج الجداول والأعمدة وأنواعها والمفاتيح الأساسية والأجنبية، ثم يكتب مخطط erDiagram في ملف واحد أو ملف لكل قاعدة بيانات، ويذكر ملفه PostgreSQL وMySQL وSQLite.
- use-stepper: أقصر ملف في الحزمة: أربع مراحل بلا تفاصيل، هي تحديد المشكلة ثم التخطيط ثم البناء ثم الاختبار والنشر.
- share-your-story: يشرح كتابة قصة عن أداة بنيتها ونشرها في موقع BuildWithClaude: مكان الملف في مجلد stories، وحقول الترويسة، والطول المناسب بين ثلاث فقرات وخمس، ثم نسخ المستودع (fork) وفتح طلب الدمج بأداة gh. هو دليل مساهمة في ذلك المشروع، لا أداة تعمل على مشروعك.
مثال من ملف five: تطبيق يتوقف عند التشغيل
تكتب في الجلسة: /commands-miscellaneous:five التطبيق يتوقف عند بدء التشغيل. وفي الملف نفسه سلسلة لهذه الحالة: الاتصال بقاعدة البيانات يفشل، لأن سلسلة الاتصال غير صحيحة، لأن متغير البيئة غير مضبوط، لأن سكربت النشر لا يضبطه، لأن التوثيق لم يذكر متطلبات البيئة. فالسبب الجذري نقص في توثيق النشر، والحل الذي يطلبه الأمر يعالج هذا النقص، لا سلسلة الاتصال وحدها.
تحميل الأوامر في Claude Code
- فك ضغط ملف ZIP في مجلد ثابت، ثم جرّب الأوامر في جلسة واحدة:
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بعد وضع مسارك مكان PATH/TO/EXTRACTED. - بهذه الطريقة يسبق اسمُ الإضافة اسمَ الأمر، مثل /commands-miscellaneous:mermaid.
- لتستدعيها بأسمائها القصيرة كما في الأمثلة، انسخ ما تحتاجه من plugin/commands إلى .claude/commands في مشروعك، أو إلى ~/.claude/commands لتتاح في كل مشروعاتك.
ما تحتاجه، وحدود الأوامر
- ترويسة ملف mermaid تمنحه أدوات Read وWrite وBash وGlob، أي أنه يكتب الملفات ويشغّل أوامر في الطرفية. وإن توفرت أداة mermaid-cli تحقق بها من المخطط عبر npx، وهذا يحتاج Node.js؛ وإلا راجع الصياغة يدويًا. وإن كان عندك ملف docs/erd.md فحدّد مسار إخراج آخر.
- الاستخراج في mermaid مبني على عبارات CREATE TABLE، ويذكر هجرات Rails وDjango دون تفصيل لطريقة قراءتها؛ فإن كانت هجراتك بلغة إطار العمل لا بـ SQL فراجع المخطط جدولًا جدولًا.
- الأوامر تعليمات نصية بالإنجليزية بلا سكربتات، والتحليل والمخطط يكتبهما النموذج.
ومع الملفات الأصلية أرفقتُ دليلًا عربيًا يشرح التحميل، وفهرسًا بمسار كل أمر.
الترخيص: MIT. كتب الأوامر الأربعة مجتمع BuildWithClaude، وحقوقها لـ davepoon، وهي في الحزمة بنصها الأصلي.
