skill
النشر على Vercel
نشر التطبيقات والمواقع الإلكترونية على Vercel. استخدم هذه الأداة عندما يطلب المستخدم إجراءات نشر مثل "انشر تطبيقي"، "انشر وأعطني الرابط"، "اجعل هذا مباشرا"، أو "أنشئ نشرا للمعاينة".
نبذة
# النشر إلى Vercel
انشر أي مشروع إلى Vercel. **انشر دائما كمعاينة** (وليس إنتاج) ما لم يطلب المستخدم صراحة النشر للإنتاج.
الهدف هو وضع المستخدم في أفضل إعداد طويل الأمد: ربط مشروعه ب Vercel مع عمليات النشر عبر git-push. تحاول كل طريقة أدناه تقريب المستخدم من هذه الحالة.
## الخطوة 1: جمع حالة المشروع
قم بإجراء جميع الفحوصات الأربعة قبل تحديد الطريقة التي ستستخدمها:
```bash # 1. التحقق من وجود git remote git remote get-url origin 2>/dev/null
# 2. التحقق مما إذا كان مرتبطا محليا بمشروع Vercel (أي ملف يعني أنه مرتبط) cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null
# 3. التحقق مما إذا كان Vercel CLI مثبتا وموثقا vercel whoami 2>/dev/null
# 4. سرد الفرق المتاحة (إذا كان موثقا) vercel teams list --format json 2>/dev/null ```
### اختيار الفريق
إذا كان المستخدم ينتمي إلى فرق متعددة، اعرض جميع أسماء الفرق (slugs) المتاحة كقائمة نقطية واسأل أي فريق يريد النشر إليه. بمجرد أن يختار المستخدم فريقا، انتقل فورا إلى الخطوة التالية — لا تطلب تأكيدا إضافيا.
مرر اسم الفريق (slug) عبر `--scope` في جميع أوامر CLI اللاحقة (`vercel deploy`, `vercel link`, `vercel inspect`, إلخ):
```bash vercel deploy [path] -y --no-wait --scope <team-slug> ```
إذا كان المشروع مرتبطا بالفعل (يوجد `.vercel/project.json` أو `.vercel/repo.json`)، فإن `orgId` في تلك الملفات يحدد الفريق — لا داعي للسؤال مرة أخرى. إذا كان هناك فريق واحد فقط (أو حساب شخصي فقط)، تخطى المطالبة واستخدمه مباشرة.
**حول دليل `.vercel/`:** المشروع المرتبط يحتوي إما على: - `.vercel/project.json` — يتم إنشاؤه بواسطة `vercel link` (ربط مشروع واحد). يحتوي على `projectId` و `orgId`. - `.vercel/repo.json` — يتم إنشاؤه بواسطة `vercel link --repo` (ربط قائم على المستودع). يحتوي على `orgId` و `remoteName` ومصفوفة `projects` تربط الدلائل بمعرفات مشاريع Vercel.
أي من الملفين يعني أن المشروع مرتبط. تحقق من كليهما.
**لا تستخدم** `vercel project inspect` أو `vercel ls` أو `vercel link` للكشف عن الحالة في دليل غير مرتبط — بدون تكوين `.vercel/`، ستطالب بشكل تفاعلي (أو مع `--yes`، ستربط بصمت كأثر جانبي). `vercel whoami` فقط هو الآمن للتشغيل في أي مكان.
## الخطوة 2: اختيار طريقة النشر
### مرتبط (يوجد `.vercel/`) + لديه git remote ← Git Push
هذه هي الحالة المثالية. المشروع مرتبط ولديه تكامل Git.
1. **اسأل المستخدم قبل الدفع (push).** لا تدفع أبدا بدون موافقة صريحة: ``` هذا المشروع متصل ب Vercel عبر git. يمكنني الالتزام والدفع (commit and push) لتشغيل عملية نشر. هل تريد مني المتابعة؟ ```
2. **الالتزام والدفع (Commit and push):** ```bash git add . git commit -m "deploy: <وصف التغييرات>" git push ``` يقوم Vercel بالبناء تلقائيا من الدفع. تحصل الفروع غير الإنتاجية على عمليات نشر معاينة؛ يحصل فرع الإنتاج (عادة `main`) على نشر إنتاجي.
3. **استرداد عنوان URL للمعاينة.** إذا كان CLI موثقا: ```bash sleep 5 vercel ls --format json ``` يحتوي إخراج JSON على مصفوفة `deployments`. ابحث عن أحدث إدخال — حقل `url` الخاص به هو عنوان URL للمعاينة.
إذا لم يكن CLI موثقا، اطلب من المستخدم التحقق من لوحة تحكم Vercel أو فحوصات حالة الالتزام على مزود Git الخاص به للحصول على عنوان URL للمعاينة.
---
### مرتبط (يوجد `.vercel/`) + لا يوجد git remote ← `vercel deploy`
المشروع مرتبط ولكن لا يوجد مستودع Git. انشر مباشرة باستخدام CLI.
```bash vercel deploy [path] -y --no-wait ```
استخدم `--no-wait` حتى يعود CLI فورا بعنوان URL للنشر بدلا من الحظر حتى ينتهي البناء (قد تستغرق عمليات البناء بعض الوقت). ثم تحقق من حالة النشر باستخدام:
```bash vercel inspect <deployment-url> ```
لعمليات النشر الإنتاجية (فقط إذا طلب المستخدم صراحة): ```bash vercel deploy [path] --prod -y --no-wait ```
---
### غير مرتبط + CLI موثق ← اربط أولا، ثم انشر
يعمل CLI ولكن المشروع لم يتم ربطه بعد. هذه هي الفرصة لوضع المستخدم في أفضل حالة.
1. **اسأل المستخدم أي فريق يريد النشر إليه.** اعرض أسماء الفرق (slugs) من الخطوة 1 كقائمة نقطية. إذا كان هناك فريق واحد فقط (أو حساب شخصي فقط)، تخطى هذه الخطوة.
2. **بمجرد اختيار فريق، انتقل مباشرة إلى الربط.** أخبر المستخدم بما سيحدث ولكن لا تطلب تأكيدا منفصلا: ``` ربط هذا المشروع ب <اسم الفريق> على Vercel. سيؤدي هذا إلى إنشاء مشروع Vercel للنشر إليه وتمكين عمليات النشر التلقائية في عمليات دفع Git المستقبلية. ```
3. **إذا كان هناك git remote موجودا،** استخدم الربط القائم على المستودع مع نطاق الفريق المحدد: ```bash vercel link --repo --scope <team-slug> ``` يقرأ هذا عنوان URL الخاص ب git remote ويطابقه مع مشاريع Vercel الموجودة التي تنشر من هذا المستودع. يقوم بإنشاء `.vercel/repo.json`. هذا أكثر موثوقية بكثير من `vercel link` (بدون `--repo`)، والذي يحاول المطابقة باسم الدليل وغالبا ما يفشل عندما يكون المجلد المحلي ومشروع Vercel مسميين بشكل مختلف.
**إذا لم يكن هناك git remote،** ارجع إلى الربط القياسي: ```bash vercel link --scope <
التثبيت
شغل هذا الأمر
npx skills add vercel-labs/agent-skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add vercel-labs/agent-skills`، أو استنسخ المستودع وانسخ مجلد `skills/deploy-to-vercel` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة النشر على Vercel؟
نشر التطبيقات والمواقع الإلكترونية على Vercel. استخدم هذه الأداة عندما يطلب المستخدم إجراءات نشر مثل "انشر تطبيقي"، "انشر وأعطني الرابط"، "اجعل هذا مباشرا"، أو "أنشئ نشرا للمعاينة".
كيف أثبت النشر على Vercel؟
شغل هذا الأمر في الطرفية:
npx skills add vercel-labs/agent-skillsمع أي أدوات ذكاء اصطناعي تعمل النشر على Vercel؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور النشر على Vercel؟
طورها vercel-labs.
هل النشر على Vercel مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى