أوامر البناء والنشر — commands-ci-deployment

مجانًا

أحد عشر أمرًا في Claude Code لمراحل البناء والنشر: إعداد خط CI وتشغيل فحوصه حتى تنجح، وكتابة Dockerfile وملفات Kubernetes، وسجل التغييرات والإصدارات التلقائية على GitHub، ثم الإصلاح العاجل والتراجع عن إصدار تعطّل في الإنتاج.

  • مجاني، ولا يتطلب أي دفع
  • تنزيل فوري بعد إتمام الطلب
  • مشترياتك محفوظة في حسابك

من أول ملف CI إلى التراجع عن إصدار تعطّل في الإنتاج، لكل مرحلة هنا أمر (slash command) في Claude Code يحمل خطواتها مرتبة. لم أجهّز منها نسخة لـ claude.ai أو Codex، لكن نص أوامر التخطيط مثل ci-setup يصلح للصق في محادثة.

من خط CI إلى Kubernetes

  • ci-setup: عشرون خطوة لتخطيط CI/CD، تبدأ باختيار المنصة بين GitHub Actions وGitLab CI وJenkins وغيرها، وتشمل بوابات الجودة وفحص الأمان وترحيل قواعد البيانات، مع أمثلة YAML.
  • run-ci: يتعرّف على إعداد CI (.github/workflows أو .gitlab-ci.yml أو Jenkinsfile) وعلى نظام البناء (package.json أو pyproject.toml أو go.mod)، ثم يشغّل الفحوص ويصلح الأخطاء ويعيدها حتى تنجح كلها.
  • containerize-application: Dockerfile متعدد المراحل على صورة أساس صغيرة (Alpine أو distroless أو slim)، وملف .dockerignore، ومستخدم غير root، وفحوص صحة، وإعداد Docker Compose.
  • setup-kubernetes-deployment: ملفات Deployment وService وConfigMap وSecret وNetworkPolicy، مع Ingress والتوسّع التلقائي.

الإصدارات وسجل التغييرات

  • add-changelog: ينشئ CHANGELOG.md بصيغة Keep a Changelog وأقسامها من Added إلى Security، ويقترح توليده آليًا بأداة conventional-changelog-cli أو auto-changelog.
  • release: يضيف إلى CHANGELOG.md ما تغيّر منذ آخر إصدار، ويراجع README.md، ويرفع رقم الإصدار بحسب حجم التغيير.
  • prepare-release: عشرون خطوة قبل الإصدار، من تحديد الرقم وفق Semantic Versioning وتجميد الكود إلى التحقق على staging ومراجعة ما بعد الإطلاق.
  • setup-automated-releases: إصدارات تلقائية على GitHub، وتفصيله في المثال.
  • changelog-demo-command: ملف تجريبي من المستودع الأصلي، لا يؤدي مهمة في مشروعك.

حين يتعطّل الإنتاج

  • hotfix-deploy: إصلاح عاجل على فرع يبدأ من وسم الإنتاج، ونشر blue-green أو rolling، ثم تقرير للحادثة ودمج الإصلاح في main.
  • rollback-deploy: عشرون خطوة تبدأ بالمفاضلة بين التراجع والإصلاح إلى الأمام، وتمر بأوامر مثل kubectl rollout undo أو docker service update --rollback، ثم فحص صحة الخدمة وإعادة الحركة تدريجيًا.

مثال: إصدار يُبنى من رسائل الـ commits

في مستودع على GitHub تكتب /commands-ci-deployment:setup-automated-releases. بحسب ملف الأمر، يحدد Claude موضع رقم الإصدار، ويكتب CONTRIBUTING.md بقاعدة Conventional Commits: feat: يرفع الرقم الأوسط، وfix: الأخير، وfeat!: الأول. ثم يضيف .github/workflows/release.yml الذي يولّد عند الدفع إلى main الوسم وملاحظات الإصدار وإصدار GitHub، وpr-check.yml لفحص عناوين طلبات الدمج.

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

  • فك الضغط في مجلد ثابت، وشغّل من مجلد مشروعك claude --plugin-dir "PATH/TO/EXTRACTED/plugin" بالمسار الفعلي، فتظهر الأوامر لهذه الجلسة وحدها بصيغة /commands-ci-deployment:run-ci.
  • لتبقى دائمًا، انسخ ما تحتاجه من plugin/commands إلى .claude/commands في مشروعك أو إلى ~/.claude/commands، واستدعه باسمه، مثل /run-ci.

قبل تشغيلها على مشروع حقيقي

  • يلزمك Claude Code مسجّل الدخول، وتكلفة النموذج على حسابك، وأدوات كل أمر: Git للإصدارات، وDocker أو kubectl للحاويات والتراجع.
  • يمنح ملف run-ci صلاحية تشغيل أي أمر في الطرفية وتعديل الملفات، فشغّله على فرع مستقل. ويمنح hotfix-deploy وprepare-release صلاحية أوامر git وnpm، وفي خطواتهما git push؛ فاحذف Bash(git *) من allowed-tools ليستأذنك Claude قبل الدفع.
  • السكربتات في أمثلة النشر والتراجع، مثل switch-to-blue.sh، توضيحية لا توجد في الحزمة، وأمثلة GitHub Actions مبنية على actions/checkout@v3 وNode.js 18؛ فاطلب مواءمتها مع مشروعك.

الترخيص MIT، وحقوق الأوامر لـ davepoon ومجتمع BuildWithClaude؛ أبقيتُ نصوصها كما وردت، وأرفقتُ معها دليلًا عربيًا وفهرسًا بمسار كل أمر.