مساعد نشر Vercel

## لمن هذا

المطورون الأماميون والمبرمجون المستقلون الذين ينشرون تطبيقات Next.js على Vercel. تتعامل هذه الإضافة مع دورة النشر الكاملة — من تطبيق أفضل الممارسات وإدارة متغيرات البيئة إلى تشغيل عمليات النشر ومراقبة الحالة — كل ذلك من الدردشة.

## البداية السريعة في 3 خطوات

1. **المراجعة قبل النشر** — اطلب: `"استخدم next-best-practices لمراجعة هيكل تطبيق Next.js الخاص بي والإشارة إلى أي مشاكل قبل النشر"`. تتحقق المهارة من استخدام مكونات الخادم وأنماط جلب البيانات واتفاقيات الملفات.
2. **النشر** — اطلب: `"استخدم vercel-deployment لنشر مشروعي في ~/Projects/myapp إلى الإنتاج"`. تتعامل المهارة مع سير عمل Vercel CLI بما في ذلك التحقق من صحة متغيرات البيئة.
3. **إدارة النشر** — اطلب: `"استخدم vercel-automation لسرد آخر 5 عمليات نشر وعرض حالة كل منها"`. يمكن للمهارة أيضًا التراجع أو إدارة DNS أو تحديث متغيرات البيئة.

## خطوة → مهارة → مدخلات → مخرجات

| الخطوة | المهارة | ما تقدمه | ما تحصل عليه |
|------|-------|------------------|--------------|
| مراجعة ما قبل النشر | next-best-practices | دليل المشروع أو مقتطف الكود | قائمة المشاكل + توصيات أفضل الممارسات |
| النشر | vercel-deployment | مسار المشروع + البيئة المستهدفة | عنوان URL للنشر + ملخص سجل البناء |
| إدارة ما بعد النشر | vercel-automation | اسم المشروع + الإجراء (قائمة/تراجع/dns) | قائمة النشر والحالة أو التأكيد |

## الأعطال الشائعة والإصلاحات

- **vercel-deployment fails with "not logged in"** → شغّل `vercel login` في الطرفية أولاً، أو قدم متغير بيئة `VERCEL_TOKEN`.
- **next-best-practices flags Server Component issues** → اتبع اقتراحات الإصلاح في المخرجات. الإصلاح الشائع: انقل `"use client"` إلى أصغر شجرة فرعية ممكنة.
- **vercel-automation can't find the project** → أسماء المشاريع حساسة لحالة الأحرف في Vercel. تحقق من الاسم الدقيق في لوحة تحكم Vercel.

## معايير النجاح

تعرف على نجاح العملية عندما:
- next-best-practices تُرجع قائمة تحقق بجميع العناصر الحرجة خضراء
- vercel-deployment تُرجع عنوان URL مباشر `.vercel.app`
- vercel-automation تُدرج عمليات النشر مع طوابع زمنية دقيقة وحالة