كل مشروع جديد، أو قديم انتقل إليك، يبدأ بالأعمال نفسها: أداة تنسيق وأداة فحص، واعتماديات متأخرة، وربما مستودع يضم عدة حزم (monorepo). هنا ستة أوامر مخصّصة (slash commands) لـ Claude Code، لكل مهمة ملف بخطوات مرقّمة يتبعه Claude في مشروعك بدل أن تمليها عليه. جهّزتُها لـ Claude Code وحده، لا لـ claude.ai أو Codex.
التنسيق والفحص
- setup-formatting: Prettier لـ JavaScript وTypeScript مع ملف .prettierrc، وBlack وisort لـ Python، والسكربتان format وformat:check، ثم husky وlint-staged للتنسيق قبل كل commit.
- setup-linting: ESLint مع typescript-eslint، أو flake8 وmypy وpylint لـ Python، أو Checkstyle وSpotBugs وPMD لـ Java، وملف .eslintrc.json يحذّر من console وany، والسكربتان lint وlint:fix، وخطوة فحص في CI.
الاعتماديات والبيئة وبنية المستودع
- modernize-deps: يحصر الحزم المتأخرة بـ npm outdated و
pip list --outdatedوcomposer outdated، ويدقّق أمنيًا بـ npm audit وpip-audit، ثم يحدّث على مراحل: patch، ثم minor، ثم major، ويختبر بعد كل مرحلة. - setup-development-environment: قائمة من عشر مراحل بلا كود، من تحليل تقنيات المشروع إلى ملفات .env نموذجية وقائمة لاستقبال عضو جديد، وتنتهي بسكربت يفحص سلامة البيئة. وبعض بنودها، كتقويمات الفريق، خارج المستودع.
- setup-monorepo: يعمل مع nx وlerna وrush وyarn-workspaces وpnpm-workspaces وturborepo، ويضبط ترقيم الإصدارات وخط CI يختبر الحزم المتأثرة وحدها.
الأمر الأكبر: تحديد معدل الطلبات
setup-rate-limiting ملف من قرابة 1900 سطر، نحو خمسة أضعاف بقية الأوامر مجتمعة، وهو بناء خاصية في الخادم أكثر منه تجهيزًا لمشروع. أمثلته لـ Express مع Redis: حد عام لكل مستخدم أو عنوان IP، وحد لتسجيل الدخول بخمس محاولات فاشلة كل 15 دقيقة، وحدود للباقات والمسارات، وخوارزميتا token bucket وsliding window، وحصص شهرية، واختبارات supertest، ومراقبة لنسبة الطلبات المرفوضة.
مثال: مستودع بعدة حزم على pnpm
تكتب /commands-project-setup:setup-monorepo pnpm-workspaces. بحسب نص الأمر تحل pnpm-workspaces محل $ARGUMENTS، ولو تركتها فارغة لحلّل Claude المشروع واقترح أداة. ثم تطلب خطواته إنشاء packages/ أو apps/ للتطبيقات، وlibs/ أو shared/ للمكتبات المشتركة، وtools/ وdocs/، وكتابة pnpm-workspace.yaml، والختام بحزم تجريبية تتحقق من اعتماد حزمة على أخرى.
طريقتان للتحميل
- للتجربة: فك الضغط في مجلد ثابت، ومن مجلد مشروعك شغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بالمسار الفعلي، فتظهر الأوامر لهذه الجلسة وحدها. - للاستخدام الدائم: انسخ ما تحتاجه من plugin/commands إلى .claude/commands في المشروع، أو إلى ~/.claude/commands لكل مشروعاتك، واستدعِه باسمه المختصر مثل /setup-linting.
ملاحظات من قراءتي للملفات
- تحتاج Claude Code مسجّل الدخول، وnpm لأغلب الأوامر، وpip أو composer لأجزاء Python وPHP، وخادم Redis لتحديد المعدل وقاعدة بيانات SQL لحصصه.
- تأذن ترويسات setup-formatting وsetup-linting وmodernize-deps بأوامر npm دون pip وcomposer، فقد يستأذنك Claude قبلها. وشغّل modernize-deps على فرع مستقل، لأن التحديث يغيّر package-lock.json.
- يكتب setup-formatting ملفي .prettierrc وpyproject.toml بأمر echo يستبدل الملف الموجود؛ فإن كان عندك pyproject.toml فاطلب إضافة [tool.black] إليه. ويشغّل lint-staged أمر
eslint --fixالذي يثبّته setup-linting، ولا يضم الملف خطوة تفعيل خطاف husky؛ فاطلبها. - بعض الأمثلة قديمة: يعتمد setup-linting صيغة .eslintrc.json، والإصدارات الحديثة من ESLint تقرأ eslint.config.js افتراضيًا، ويستخدم setup-rate-limiting الخيار onLimitReached الذي أزالته مكتبة express-rate-limit في الإصدار 7؛ فاطلب مطابقة الكود لإصداراتك.
أرفقتُ دليلًا عربيًا لخطوات التحميل وفهرسًا بمسار كل أمر. كتب الأوامر الستة مجتمع BuildWithClaude، وحقوقها لـ davepoon بترخيص MIT، وأبقيتُ نصوصها دون تعديل.
