كثيرًا ما يسبق الكودُ توثيقَه: تصدر النسخة الجديدة بلا سطر في CHANGELOG.md، ويُدمج إصلاح الخطأ دون شرح لما تغيّر، وتُرقّى المكتبة دون دليل ترحيل للفريق. جمعتُ هنا عشرة أوامر (slash commands) تستدعيها بأسمائها في Claude Code وحده، إذ لا نسخة منها لـ claude.ai أو Codex.
أمران يرافقان كل إصدار
- add-to-changelog: يأخذ رقم الإصدار ونوع التغيير ووصفه، والأنواع ستة: added وchanged وdeprecated وremoved وfixed وsecurity. ينشئ CHANGELOG.md إن غاب، ويضع السطر تحت قسم الإصدار أو يفتح له قسمًا بتاريخ اليوم.
- explain-issue-fix: يقرأ git diff أو آخر commits، ويشرح المشكلة وحلها والملفات المعدّلة وسبب تعديل كل منها، والمفاضلات، وما بقي من مهام.
أربعة قوالب لأدلة طويلة
- migration-guide: عشرون قسمًا تشمل نطاق الترحيل وما يكسره التحديث وخطة التراجع والنشر بطريقة blue-green أو canary، مع ملاحظات لحالات منها React 17 إلى 18 وMySQL إلى PostgreSQL.
- troubleshooting-guide: أوامر تشخيص مثل top وdf -h وjournalctl، ومرجع لرموز HTTP مثل 500 و503، وأعطال قواعد البيانات والشبكة والمصادقة.
- create-onboarding-guide: تجهيز بيئة المطوّر الجديد، وخريطة الكود، وسير العمل بالفروع ومراجعة الكود، وأولى مهامه، وصلاحياته.
- create-architecture-documentation: توثيق البنية بنموذج C4 أو قالب Arc42، بمخططات Mermaid أو PlantUML، وسجلات قرارات البنية (ADRs).
أربعة أوامر لا تكشفها أسماؤها
- create-docs: يحلّل مشكلة (issue) على GitHub برقمها ويكتب مواصفة تقنية بخطة التنفيذ والاختبار والملفات المتأثرة. ويجلبها بالسكربت scripts/fetch-github-issue.sh، وهو ليس في الحزمة، فجهّزه أو عدّل هذه الخطوة.
- docs: لمشروعات dbt؛ يكتب ملف YAML لنموذج SQL أو يحدّثه، بأوصاف الأعمدة واختبارات unique وnot_null، دون تخمين القيم المقبولة.
- update-docs: يحدّث ملفات حالة التنفيذ وCLAUDE.md وREADME.md، ومساراته مثل specs/implementation_status.md من المشروع الأصلي، فعدّلها لمجلداتك.
- load-llms-txt: يجلب بـ curl ملف llms.txt لمشروع xatu-data وحده ثم ينتظر. وإن غيّرت الرابط صلح لأي ملف llms.txt آخر.
مثال: من إصلاح الخطأ إلى سطر في السجل
أصلحتَ خطأً في عارض HTML ولم تُنشئ commit بعد. تشغّل /commands-documentation-changelogs:explain-issue-fix فيكتب من الفرق شرحًا تنقله إلى وصف طلب الدمج. ثم تنقل المثال الثاني من ملف الأمر: /commands-documentation-changelogs:add-to-changelog 1.0.2 fixed “Bug in HTML renderer causing incorrect output”. تنص تعليماته على وضع السطر تحت Fixed في قسم 1.0.2 ثم اقتراح commit. وفي آخره تذكير بأن تحدّث رقم الإصدار داخل __init__.py وsetup.py، فتجاهله إن لم يكن مشروعك بلغة Python.
التحميل
- فك الضغط في مجلد لن تنقله، ثم شغّل من مجلد مشروعك
claude --plugin-dirمتبوعًا بالمسار الكامل لمجلد plugin. تظهر الأوامر في تلك الجلسة وحدها، مسبوقة باسم الإضافة. - ولتبقى في كل جلسة، انسخ ما تحتاجه منها إلى .claude/commands داخل المشروع أو ~/.claude/commands لكل مشروعاتك، ثم استدعِ /add-to-changelog بلا بادئة.
أرفقتُ دليلًا عربيًا لطريقة --plugin-dir، وفهرسًا بمسار كل ملف.
قبل الاستخدام
- تحتاج إلى Claude Code بحساب مسجّل يتحمّل استهلاك النموذج، وإلى مستودع git لأمر explain-issue-fix.
- تلميح المدخلات في migration-guide وtroubleshooting-guide هو عنوان الخطوة الأولى؛ فاكتب بعد الأمر ما تنتقل منه وإليه أو النظام المقصود.
- ينتهي ملفا docs وupdate-docs في المصدر بجملة ناقصة، وما قبلها كامل.
- الأدلة يكتبها النموذج من كودك، فراجع أوامر التشخيص وخطوات التراجع قبل اعتمادها.
الترخيص: MIT، ونصه داخل الحزمة. الأوامر العشرة من إسهامات مجتمع BuildWithClaude، وحقوق نشرها لـ davepoon.
