أربعة أوامر slash لـ Claude Code لواجهات API: تصميم واجهة REST على Express، وبناء خادم GraphQL على Apollo Server، ثم توثيق الواجهة بمواصفة OpenAPI وصفحة Swagger UI. كل أمر ملف Markdown بمراحل مرقّمة يتبعها Claude داخل مشروعك، وفي ثلاثة منها أمثلة كود. الصيغة إضافة (plugin) لـ Claude Code، ولم أجهّز منها نسخة لـ claude.ai أو Codex.
الأوامر الأربعة وما يبنيه كل منها
- design-rest-api: عشر مراحل تبني هيكل Express تحت routes/api/v1 لموارد users وproducts وorders وauth: تحقّق من المدخلات بمكتبة Joi، وصنف ApiResponse يوحّد شكل الردود والأخطاء، ومصادقة JWT، وتوثيق Swagger، واختبارات supertest. ويقرأ رقم الإصدار من المسار أو من ترويسة api-version أو ترويسة Accept، ويختم بمقاييس Prometheus عبر prom-client.
- implement-graphql-api: أطول الأوامر، بقرابة 1700 سطر. فيه مخطط SDL لمتجر من مستخدمين ومنتجات وطلبات، بترقيم صفحات من نوع Connection يعتمد المؤشرات (cursor)، ثم DataLoader لتفادي مشكلة N+1، وصلاحيات graphql-shield، واشتراكات لحظية تعمل عبر Redis في الإنتاج وفي الذاكرة أثناء التطوير، وحدود لعمق الاستعلام وتعقيده.
- doc-api: يوثّق الواجهة من كودها في 18 خطوة: يمسح المشروع بحثًا عن المسارات والمعالجات، ويكتب مواصفة OpenAPI 3.0 وأمثلة طلب واستجابة وتوثيقًا للمصادقة والأخطاء، ثم يجهّز صفحة Swagger UI. ويضم الملف أمثلة لـ FastAPI وSpring Boot.
- generate-api-documentation: أقصر الأربعة، وخطة بلا كود في عشر مراحل: اختيار أداة التوثيق، واستخراج المواصفة آليًا من الكود، والاستضافة، وربط التوليد بخط CI/CD، وإخراج التوثيق بصيغ HTML وPDF وMarkdown.
مثال: مواصفة لخدمة طلبات بلا توثيق
لتوثيق خدمة طلبات قائمة تكتب في الجلسة: /commands-api-development:doc-api orders-service. بحسب نص الأمر تحلّ عبارة orders-service محل المتغيّر $ARGUMENTS، فيصير عنوان المواصفة «orders-service API». ثم يبحث عن المسارات ونماذج البيانات، ويكتب لكل مسار وسائطه ورموز استجابته وأمثلته. وفي مشروع Express يُنتظر منه إعداد swagger-jsdoc يقرأ التعليقات في ملفات routes ويعرض التوثيق على /api-docs.
تحميل الإضافة في Claude Code
- فك الضغط في مجلد ثابت، وشغّل من مجلد مشروعك
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بالمسار الفعلي. تُحمَّل الأوامر للجلسة الحالية وحدها، وتستدعيها باسم الإضافة مثل/commands-api-development:design-rest-api. - للاستخدام الدائم انسخ الملفات الأربعة من
plugin/commandsإلى.claude/commandsفي مشروعك، أو إلى~/.claude/commandsلكل مشروعاتك، واستدعِ الأمر باسمه المختصر مثل/doc-api.
ما يلزمك، وما في الملفات من نواقص
- يلزمك Claude Code مثبتًا ومسجّل الدخول، وتكلفة تشغيل النموذج على حسابك.
- الأوامر تعليمات بالإنجليزية بلا سكربتات؛ الكود يكتبه النموذج في مشروعك، فراجعه واختبره قبل الدمج. وكود الخادم في أمري التصميم والبناء JavaScript على Node.js، فاذكر لغة مشروعك إن اختلفت، واطلب التوثيق بالعربية إن أردته.
- يشير مخطط GraphQL في implement-graphql-api إلى نوع ReviewConnection دون أن يعرّفه، فلن يُبنى المخطط كما هو؛ اطلب إكماله أو احذف الحقل.
- كُتبت أمثلة GraphQL على الحزمة القديمة apollo-server-express، بخياري playground وsubscriptions من إصداراتها القديمة، أما الإصدارات الحالية من Apollo Server فتأتي في حزمة
@apollo/server؛ فاطلب مطابقة الكود للإصدار المثبّت عندك. - تلميح المدخلات (argument-hint) في ترويسة doc-api منقول خطأً من خطوته الأولى؛ تجاهله واكتب اسم خدمتك أو مجلدها.
أرفقتُ مع الملفات دليلًا عربيًا لخطوات التحميل، وفهرسًا بمسار كل أمر.
كتب هذه الأوامر مجتمع BuildWithClaude (حقوق النشر لـ davepoon) ونشرها بترخيص MIT، وأبقيتُ ملفاتها الأربعة كما هي دون تعديل.
