إذا كان مشروعك مكتوبًا بـ JavaScript وتريد نقله إلى TypeScript دون أن تشرح لـ Claude الطريقة في كل مرة، فهذا أمر مخصّص واحد (slash command) اسمه migrate-to-typescript. يضع أمام Claude Code قائمة عمل من عشر مراحل، تبدأ بتحليل الكود واعتمادياته وتنتهي بتوثيق قرارات النقل للفريق، فيقرأ ملفات مشروعك ويعدّلها في مكانها.
المراحل العشر كما يرتّبها الملف
- التحليل والتخطيط: يقدّر حجم الكود وتعقيده، ويفحص دعم الاعتماديات الخارجية لـ TypeScript، ثم يختار بين نقل تدريجي أو كامل ويضع جدولًا للمراحل.
- التثبيت والإعداد: يثبّت TypeScript وحزم @types، ويكتب tsconfig.json بإعدادات صارمة (strict)، مع تعيين المسارات (path mapping) والترجمة التزايدية.
- أداة البناء: يعدّل إعداد webpack أو Vite، وخادم التطوير والتحديث الفوري (HMR)، وسكربتات package.json.
- ترتيب نقل الملفات: يبدأ بملفات الإعداد والوحدات المساعدة، ثم يتدرّج من الأبسط إلى الأعقد، ويغيّر الامتداد من js إلى ts أو tsx، ويتعامل مع مشروع يجمع اللغتين أثناء الانتقال.
- تعريفات الأنواع: واجهات (interfaces) لاستجابات الـ API وهياكل البيانات، وتصريحات مخصّصة للمكتبات التي لا أنواع لها.
- إضافة الأنواع إلى الكود: أنواع صريحة لمعاملات الدوال وقيمها المرجعة، وأصناف (classes) مكتوبة بأنواعها، وأنواع عامة (generics)، وأنواع الاتحاد والأنواع المشروطة.
- أخطاء المترجم: يعالجها بطريقة منهجية، ويتعامل مع null وundefined تحت الفحص الصارم (strict null checks)، ويضبط قواعد ESLint، ويضيف فحص الأنواع إلى CI/CD.
- الاختبارات: ينقل ملفات الاختبار إلى TypeScript، ويضيف اختبارات للأنواع بأدوات مثل tsd، وتقريرًا لتغطية الأنواع (type coverage).
- بيئة المطوّر: إعداد المحرّر والإكمال التلقائي، وتتبّع الأخطاء عبر source maps، وقوالب كود جاهزة.
- التوثيق والفريق: تحديث توثيق المشروع، ودليل لمعايير كتابة TypeScript، وتسجيل قرارات النقل، ودليل لحل المشكلات الشائعة.
ما يحدث حين تستدعيه
تفتح Claude Code في مجلد المشروع وتكتب /commands-typescript-migration:migrate-to-typescript (أو /migrate-to-typescript إن نسخته إلى مشروعك). وبحسب نص الملف، يمر Claude بالمراحل بهذا الترتيب، ولا يطلب منه الملف أن يتوقف لأخذ موافقتك بين مرحلة وأخرى؛ فإن أردت مراجعة الخطة أولًا فاطلب ذلك، مثل: «نفّذ المرحلة الأولى فقط واعرض عليّ الخطة». وابدأ من فرع Git مستقل، لأن المراحل التالية تغيّر package.json وأسماء الملفات.
التثبيت
- للتجربة في جلسة واحدة: فكّ الضغط في مجلد ثابت، ثم شغّل من مجلد مشروعك
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بعد وضع مسارك الفعلي. - لإبقائه في مشروع بعينه: انسخ الملف plugin/commands/migrate-to-typescript.md إلى .claude/commands داخل المشروع، واستدعِه باسمه المختصر
/migrate-to-typescript.
أرفقتُ دليلًا عربيًا بالطريقة الأولى، وفهرسًا بمسار الأمر داخل الحزمة.
ما يلزمه وحدوده
- يلزمك Claude Code مسجَّل الدخول، وتُحسب تكلفة النموذج على حسابك، ومدير حزم مثل npm لتثبيت الحزم.
- الملف قائمة مراحل عامة: يذكر webpack وVite دون إصدارات، ولا يحدد قيمًا بعينها في tsconfig.json؛ فراجع ما يقترحه Claude على توثيق TypeScript.
- لا يحمل الملف سطر allowed-tools، فيعمل بصلاحيات جلستك كما هي.
- بعض بنود المرحلة الأخيرة تخص الناس لا الكود، مثل تدريب الفريق؛ وما يسلّمه Claude فيها وثائق مكتوبة.
- الأمر مكتوب بصيغة Claude Code؛ في Codex أو claude.ai تلصق نصه مع طلبك، لكن claude.ai لا يصل إلى مجلد مشروعك، ولم أجهّز لهما طريقة تثبيت.
- الملف بالإنجليزية كما كتبه أصحابه. وصفتُ ما يطلبه من نصه.
كتب هذا الأمر مجتمع BuildWithClaude، ومصدره مستودع davepoon/buildwithclaude (الإصدار 1.0.0)، بترخيص MIT المرفق نصه في الحزمة.
