Shipwright إضافة لـ Claude Code تحوّل وصفًا مكتوبًا لفكرة تطبيق إلى مشروع ويب كامل على جهازك ورابط معاينة على Vercel. تكتب الفكرة بعد الأمر /shipwright:build، فيسلّمها Claude إلى محرك منفصل اسمه Product Agent، يمر بالمشروع من التصميم إلى الكود والاختبار والنشر ثم فحص الرابط. وتعليماتها مكتوبة لمن لا يعرف البرمجة، فلا تحمّلك قرارًا تقنيًا.
أربعة أوامر تكتبها بنفسك
/shipwright:build: يفحص Node.js وGit وPython وProduct Agent وVercel CLI، ثم يعرض عليك اسم التطبيق وميزاته وينتظر موافقتك، ويشغّل البناء في الخلفية ويتابع سجله كل 60 إلى 90 ثانية./shipwright:enhance: يضيف ميزة إلى تطبيق بنيتَه: يجده في سجل مشروعاتك، ويقرأ DESIGN.md، ويعرض التغييرات قبل تنفيذها./shipwright:stacks: يشرح التقنيات الأربع وحدود استضافة Vercel (serverless)./shipwright:projects: جدول بتطبيقاتك، فيه حالة كل تطبيق ودرجة جودته ورابطه.
كيف تُختار التقنية
يختار Product Agent التقنية بخوارزمية تقييم خاصة به. أما ملف stacks-reference.md الذي يعتمد عليه الوكيل builder وأمر stacks فيحدد أربع تقنيات: Next.js مع Supabase لتطبيقات الحسابات ولوحات البيانات وللأفكار غير الواضحة، وNext.js مع Prisma للأسواق والمنصات متعددة الشركات، وAstro للمدونات وصفحات الهبوط، وSvelteKit للأدوات الخفيفة.
ما يعمل خلف الأوامر
- الوكيل builder: فيه خطوات البناء لكل تقنية، وحلول لأخطاء متكررة مثل SQLite على Vercel والاعتماد الدائري في سياسات RLS على Supabase، ودرجة جودة من 100 لا تتجاوز 69 إن لم يُنشر التطبيق. وعلى تعليماته يقوم البناء اليدوي إن غاب Product Agent.
- ثلاثة Hooks: الأول يفحص رسالتك بحثًا عن عبارات حقن التعليمات، والثاني يوقف أوامر مثل rm -rf / وsudo rm وتمرير curl إلى bash، ويمنع الكتابة في مجلدات النظام وملفات .ssh و.aws، والثالث يسجّل نشاط البناء في builds.jsonl. ومعها tests/test_hooks.sh لاختبار الفحصين على جهازك.
مثال من README الإضافة
الأمر المذكور هناك: /shipwright:build “a todo app with user accounts and dark mode”. بحسب ملف المهارة، ينشئ Claude بعد موافقتك مجلدًا مثل ~/Projects/todo-app ويبدأ بناءً يقدّر الملف مدته بين 15 و45 دقيقة. ثم يقرأ نتيجة JSON فيها الرابط ودرجة الجودة وعدد الاختبارات الناجحة، ويعطيك تقريرًا مبسطًا ورابط معاينة، ويقترح أن تكتب push to production حين تريد رابطًا عامًا.
التثبيت
- فكّ ضغط الملف في مجلد ثابت، ثم شغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بمسارك الفعلي؛ هذا يحمّل الإضافة للجلسة الحالية فقط. - Product Agent ليس داخل الحزمة؛ من مجلد plugin شغّل bash setup.sh، فيحاول تثبيته من PyPI ويعرض طريقة التثبيت اليدوي إن فشل. الإصدار الأدنى 12، وأمر enhance يحتاج 12.4.0.
- سجّل الدخول بالأمر vercel login، واسمح مسبقًا بالأوامر التي يوصي بها ملف CLAUDE.md.
أرفقتُ دليلًا عربيًا بهذه الخطوات وفهرسًا بمسارات الوكيل والمهارات الأربع.
حدود قبل أن تبدأ
- تعمل في Claude Code وحده، على macOS أو Linux، ولا يدعم هذا الإصدار Windows بحسب README.
- تحتاج Node.js 20+ وGit وPython 3.10+ وVercel CLI وحساب Vercel، وحساب Supabase للتطبيقات ذات قاعدة البيانات، ويشترط README اشتراك Pro أو Max في Claude.
- كل تطبيق يُنشر على Vercel، ويذكر README أن ذلك يمنع اتصال WebSocket الدائم، والمهمة الخلفية التي تتجاوز خمس دقائق، وحفظ الملفات على الخادم.
- تطلب تعليماتها من Claude أن يخاطبك بالإنجليزية المبسطة.
كتب المطوّر Nate Nelson إضافة Shipwright ونشرها بترخيص MIT المرفق نصه في الحزمة، ومصدرها مستودعه على GitHub.
