skill

تحسين Vercel

يستخدم لتحسين التكلفة والأداء لمشاريع Vercel المنشورة، خاصة Next.js وSvelteKit وNuxt وتطبيقات Astro المحدودة. يقوم أولا بجمع مقاييس Vercel، الاستخدام، إعدادات المشروع، ونتائج فحص الكود؛ ثم يحقق فقط في المرشحين المدعومين بالمقاييس؛ وينتج توصيات مرتبة تستند إلى ملفات متحقق منها ووثائق Vercel/إطار العمل الواعية بالإصدارات. يفعل لخفض فاتورة Vercel، المسارات البطيئة أو المكلفة، فرص التخزين المؤقت، استدعاءات الدوال (Function Invocations)، دقائق البناء (Build Minutes)، نقل البيانات السريع (Fast Data Transfer)، Core W...

vercel-labs83,580+ تثبيتموثوق

نبذة

# تحسين 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل تحسين Vercel ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط وثائق المجال. يشغل مرة واحدة قبل الاستخدام الأول لم…967,342+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
بوابة Azure AI
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة ال…605,853+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
تحقق من سؤال مقابل مصادر أولية موثوقة للغاية، وسجل النتائج كملف Markdown في المستودع. استخدم هذا عندما يريد المستخدم البحث في موضوع، أو جمع حقائق حول…576,164+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في إنشاء المحتوى