skill
تحسين Vercel
يستخدم لتحسين التكلفة والأداء لمشاريع Vercel المنشورة، خاصة Next.js وSvelteKit وNuxt وتطبيقات Astro المحدودة. يقوم أولا بجمع مقاييس Vercel، الاستخدام، إعدادات المشروع، ونتائج فحص الكود؛ ثم يحقق فقط في المرشحين المدعومين بالمقاييس؛ وينتج توصيات مرتبة تستند إلى ملفات متحقق منها ووثائق Vercel/إطار العمل الواعية بالإصدارات. يفعل لخفض فاتورة Vercel، المسارات البطيئة أو المكلفة، فرص التخزين المؤقت، استدعاءات الدوال (Function Invocations)، دقائق البناء (Build Minutes)، نقل البيانات السريع (Fast Data Transfer)، Core W...
نبذة
# تحسين Vercel
قم بإجراء تدقيق لتحسين Vercel يركز على قابلية المراقبة أولا. لا تفحص ملفات المصدر حتى يصبح `signals.json` موجودا وتشير بوابة حتمية إلى مسار أو ملف أو إعداد مشروع.
المبدأ الأساسي: اقرأ [references/doctrine.md](references/doctrine.md) إذا كانت أي قاعدة غير واضحة.
- المقاييس أولا. تبدأ التوصيات من إشارات إنتاج Vercel، وليس من البحث الشامل في المستودع. - بوابات حتمية. يقرر `scripts/gate-investigations.mjs` ما يستحق التحقيق. - نطاق محدد بالمرشح. اقرأ فقط الملفات التي يسميها مرشح أو سلسلة استيراد محلية للمسار. - استشهادات واعية بالإصدار. استخدم فقط `references/docs-library.json`؛ يتم تجريد الاستشهادات غير الصالحة أو غير المتطابقة مع الإصدار. - نص العميل. اقرأ [references/voice.md](references/voice.md) قبل كتابة نص التقرير أو مخرجات الدردشة.
## المتطلبات المسبقة
- Vercel CLI v53+ مع `vercel metrics` و `vercel usage` و `vercel contract` و `vercel api`. - جلسة CLI مصادق عليها: `vercel login`. - دليل تطبيق مرتبط: `vercel link`. يمكن أن يساعد `VERCEL_PROJECT_ID` في حل تكوين المشروع، لكن `vercel metrics` لا يزال يتطلب ربط الدليل. يجب أن يتضمن الرابط أو البيئة نطاق المؤسسة/الفريق/المستخدم للمشروع المقصود حتى يتمكن المجمع من حل `--scope` الآمن ل CLI والحفاظ على `vercel metrics` و `vercel usage` و `vercel contract` على نفس الحساب. - Node.js 20+. - Observability Plus لتوصيات مدعومة بالمقاييس على مستوى المسار.
لا تضع أبدا رموز المصادقة في أوامر shell. لا تكتب `VERCEL_TOKEN=...` أو `--token ...` أو `Authorization: Bearer ...` في الأوامر التي قد يتم عرضها في الدردشة.
## دعم الأطر
تقرأ عملية الفحص المسبق `package.json` وتحدد التوقعات قبل انتشار المقاييس.
| الإطار | الحالة | ملاحظات | |---|---|---| | Next.js App Router | مدعوم | أقوى تعيين للمسارات، الماسحات الضوئية، كتيبات التشغيل، الاستشهادات | | Next.js Pages Router | مدعوم | مقتصر على اصطلاحات Pages Router عند اكتشافها | | SvelteKit | مدعوم | تعيين المسارات لملفات `src/routes` وماسح SvelteKit | | Nuxt | مدعوم | تعيين المسارات بالإضافة إلى الفحوصات العامة/المنصة؛ توصيات أقل خاصة بالإطار | | Astro | محدود | تعيين المسارات بالإضافة إلى الفحوصات العامة؛ توصيات أقل خاصة بالإطار | | Hono / Remix / غير معروف | محظور افتراضيا | استمر فقط إذا وافق المستخدم على تدقيق محدود للمنصة/التعليمات البرمجية فقط |
إذا كان غير مدعوم، توقف واسأل قبل المسح أو التحديد:
```text This project uses <framework>. Vercel Optimize supports metric-backed code recommendations for Next.js, SvelteKit, and Nuxt. Astro support is limited. For <framework>, I can still run a limited platform/scanner audit, but route-level Vercel metrics may not map back to source files.
Do you want me to continue with the limited audit, or stop here? ```
إذا استمر المستخدم، أعد تشغيل التجميع باستخدام `--continue-unsupported-framework`.
## دليل التشغيل
استخدم دليل تشغيل جديد لكل تدقيق. لا تعيد استخدام الملخصات أو مخرجات الوكيل الفرعي أو التقارير عبر عمليات التشغيل.
```bash RUN_DIR="$(mktemp -d -t vercel-optimize-XXXXXX)" ```
## خط الأنابيب
### 1. جمع الإشارات ومسحها ودمجها
قم بالتشغيل من دليل التطبيق المرتبط أو مرر `--cwd` حيث يدعمه السكريبت. احتفظ ب JSON الخاص ب stdout منفصلا عن سجلات stderr. لا تجمع التدفقات.
```bash node scripts/collect-signals.mjs [projectId] > "$RUN_DIR/vercel-signals.json" 2> "$RUN_DIR/collect.stderr" node -e 'JSON.parse(require("fs").readFileSync(process.argv[1], "utf8"))' "$RUN_DIR/vercel-signals.json"
node scripts/scan-codebase.mjs <repo-root> > "$RUN_DIR/codebase.json" node scripts/merge-signals.mjs "$RUN_DIR/vercel-signals.json" "$RUN_DIR/codebase.json" --out "$RUN_DIR/signals.json" ```
تفاصيل التجميع والمخططات ومعرفات المقاييس وسلوك التدهور موجودة في [references/data-collection.md](references/data-collection.md). سجل المقاييس هو [lib/queries.mjs](lib/queries.mjs)؛ احتفظ بجميع الاستعلامات على النافذة المشتركة لمدة 14 يوما.
يقوم `collect-signals.mjs` بحل مالك المشروع المرتبط إلى `commandScope.cliScope` ويتحقق من أن الحساب المحلول يمكنه قراءة المشروع المحلول قبل التحقق من Observability Plus. تعيد السكريبتات اللاحقة استخدام هذا النطاق لكل أمر Vercel CLI يقبل `--scope`. لا تقم بتشغيل `vercel usage` أو `vercel metrics` أو `vercel contract` يدويا بدون نفس النطاق؛ يمكن أن يبلغ الاستخدام غير المحدد النطاق عن المؤسسة الشخصية للمستخدم بينما تأتي مقاييس المسار من مشروع الفريق.
إذا كان حل المشروع أو النطاق غامضا، توقف واسأل المستخدم عن مشروع Vercel ونطاق الفريق/الشخصي الذي يرغب في تدقيقه. لا تستنتج النطاق المقصود من فريق `vercel whoami` الحالي، ولا تتابع جمع المقاييس أو الاستخدام أو العقد حتى يحدد الرابط أو تطابق المشروع الدقيق في `.vercel/repo.json` أو `VERCEL_PROJECT_ID` + `VERCEL_ORG_ID` الحساب المقصود.
استخدم هذا الموجه ل `PROJECT_SCOPE_UNRESOLVED` أو `SCOPE_UNRESOLVED` أو `PROJECT_SCOPE_MISMATCH`:
```text I can't safely identify the Vercel project and account for this audit yet.
Please confirm the Vercel project name or ID and the team slug/name, or tell me it's under your pers ```
التثبيت
شغل هذا الأمر
npx skills add vercel-labs/agent-skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add vercel-labs/agent-skills`، أو استنسخ المستودع وانسخ مجلد `skills/vercel-optimize` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة تحسين Vercel؟
يستخدم لتحسين التكلفة والأداء لمشاريع Vercel المنشورة، خاصة Next.js وSvelteKit وNuxt وتطبيقات Astro المحدودة. يقوم أولا بجمع مقاييس Vercel، الاستخدام، إعدادات المشروع، ونتائج فحص الكود؛ ثم يحقق فقط في المرشحين المدعومين بالمقاييس؛ وينتج توصيات مرتبة تستند إلى ملفات متحقق منها ووثائق Vercel/إطار العمل الواعية بالإصدارات. يفعل لخفض فاتورة Vercel، المسارات البطيئة أو المكلفة، فرص التخزين المؤقت، استدعاءات الدوال (Funct…
كيف أثبت تحسين Vercel؟
شغل هذا الأمر في الطرفية:
npx skills add vercel-labs/agent-skillsمع أي أدوات ذكاء اصطناعي تعمل تحسين Vercel؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور تحسين Vercel؟
طورها vercel-labs.
هل تحسين Vercel مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى