مع كل تعديل تتكرر الخطوات نفسها: قراءة ما تغيّر، وكتابة رسالة commit مفهومة، وفتح فرع وطلب دمج (pull request) على GitHub، ثم معالجة تعليقات المراجعة. وفي الحزمة اثنا عشر أمرًا (slash commands) لـ Claude Code، يتولى كل منها جزءًا من هذه الدورة عبر git أو أداة GitHub CLI (gh).
تعمل في Claude Code وحده لأنها تنفّذ git على جهازك، فلا يشغّلها claude.ai، ولم أجهّز منها نسخة لـ Codex.
من بلاغ الخطأ إلى طلب الدمج
- bug-fix: من وصف الخطأ إلى issue على GitHub، ففرع وإصلاح، ثم طلب دمج مربوط بها.
- fix-github-issue: يقرأ الـ issue برقمها عبر
gh issue view، ثم يصلح ويكتب اختبارات ويشغّلها مع فحص الصياغة والأنواع. - fix-issue: سطر واحد يطلب إصلاح المشكلة التي تذكرها.
- fix-pr: يعالج تعليقات المراجعة غير المحلولة على طلب دمج فرعك الحالي.
- create-pr: ينشئ فرعًا، وينسّق الملفات بأداة Biome، ويقسّم التغييرات إلى commits منطقية، ثم يفتح طلب دمج بملخص وخطة اختبار.
- create-pull-request: دليل لفتح طلب دمج مسودة بالأمر
gh pr create --draftوفق قالب المشروع. - pr-review: يراجع طلب دمج برقمه أو رابطه بعين مدير المنتج، ثم المطوّر، فمهندسَي الجودة والأمن.
الـ commit والفروع وسلامة المستودع
- commit: يشغّل فحوص الصياغة والبناء ما لم تمرّر
--no-verify، ويقترح تقسيم التغييرات المتباينة، ثم يكتب رسالة من نوع feat أو fix أو docs برمز تعبيري، سطرها الأول دون 72 حرفًا. - commit-fast: المنطق نفسه، لكنه يعتمد أول رسالة من ثلاث وينفّذ
git commitدون أن يسألك. - update-branch-name: يقارن فرعك بـ main ويعيد تسميته باسم يصف العمل عبر
git branch -m. - create-worktrees: سكربتات bash تنشئ worktree في
./treeلكل طلب دمج مفتوح أو لفرع جديد، وتحذف اختياريًا worktrees الفروع المحذوفة. - husky: لا يثبّت Husky رغم اسمه، بل يثبّت الاعتماديات ويشغّل فحص الصياغة والأنواع والبناء والاختبارات، ويصلح ما يفشل ثم يضيفه بـ
git add.
مثال: وصف خطأ ينتهي بطلب دمج
تكتب في الجلسة /commands-version-control-git:bug-fix login button does nothing on Safari، وبحسب ملفه يأتي الـ issue أولًا، ثم الفرع، فالإصلاح، فـ commit ورفع الفرع، وأخيرًا طلب دمج مربوط بها.
التثبيت
- فك الضغط في مجلد ثابت، وشغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بالمسار الفعلي، فتظهر الأوامر بالبادئةcommands-version-control-gitفي تلك الجلسة. - لتبقى في مشروعك انسخ ملفات
plugin/commandsإلى.claude/commandsفيه، فتستدعيها باسم قصير مثل/commitأو/pr-review 42، أو إلى~/.claude/commandsلكل مشروعاتك. - يحيل commit-fast إلى
.claude/commands/commit.mdلا إلى ملف الإضافة، فانسخهما معًا.
قبل تشغيلها على مستودعك
- يلزمك Claude Code وتكلفة النموذج على حسابك، وgit، وgh بعد
gh auth loginلسبعة أوامر، وBiome للأمر create-pr، وbash لسكربتات create-worktrees (Git Bash على ويندوز). - إن لم تجهّز ملفات للحفظ أضاف commit كل الملفات المعدّلة والجديدة، فراجع
git statusقبله. - يطلب pr-review نشر المراجعة على GitHub وتنفيذ أي تحسين مؤجل فورًا، ويستعمل سكربت التنظيف في create-worktrees الخيار
--force. - يفترض update-branch-name أن الفرع الرئيسي main، ويفترض create-pull-request وجود
.github/pull_request_template.md. - تنقطع نصوص commit وhusky وpr-review في المصدر قبل نهايتها، ونقلتُها كما وردت.
- نصوص الأوامر بالإنجليزية.
الترخيص: MIT. الأوامر من مجتمع BuildWithClaude وحقوقها لـ davepoon، ونصوصها دون تعديل؛ وأرفقتُ دليلًا عربيًا وفهرسًا بمسار كل أمر.
