Vercel 生产优化审计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-labs-agent-skills-vercel-optimize。
技能介绍
要解决什么问题
Vercel 上的 Next.js、SvelteKit、Nuxt 等项目,性能与成本问题往往分散在路由级指标、缓存策略、部署配置与少量热点代码里。若一开始就全仓 grep,很容易把时间与注意力耗在低信号文件上,建议和真实流量对不上。
本技能把审计顺序固定为:先有生产信号,再决定是否读源码;只有 signals.json 就绪且 scripts/gate-investigations.mjs 指向具体路由、文件或项目设置时,才进入候选范围内的深潜。
如何工作
流水线大致分四段:
- 采集与合并信号:在已
vercel link的目录执行collect-signals.mjs,用统一--scope拉取 14 天窗口内的vercel metrics、vercel usage、vercel contract;preflight 会读package.json判断框架支持情况。 - 门禁候选:
gate-investigations输出toLaunch(代码侧候选)、platform(账号/项目级建议)、gated(仍须出现在报告中的跳过项)及默认 6 个代码候选预算。 - 深潜与调查:
deep-dive.mjs做指标对账(如metric_mismatch、deployment_regression);按briefs-manifest.json生成 brief,只读 brief 列出的文件及路由局部 import;子代理输出须符合references/recommendations.md的 JSON 形态。 - 校验与报告:
verify校验引用、references/docs-library.json版本匹配与客户文案(references/voice.md);最终只交付可渲染的 Markdown 建议,不暴露内部门禁/质量分字段。
每条建议需能追溯到候选或平台项,并附带 signals.json 或 evidence.deepDive 中的观测数据;涉及代码时要有带行号的文件引用。
边界与注意点
- 路由级、指标驱动的排序依赖 Observability Plus;近 14 天无有意义流量时只能做流量无关的 scanner 与项目设置检查,不能对路由修复做可信排序。
- 未 link、scope 与项目不一致、日配额耗尽等 blocker 会明确要求你选择正确团队/项目或接受受限审计,不会静默退回纯代码模式。
- Hono / Remix / unknown 框架默认 blocked;Astro 等为 limited。Workflow 端点
/.well-known/workflow/v1/*不因墙钟时长本身被建议缩短。 - Shell 中禁止写入
VERCEL_TOKEN、--token等可能出现在聊天记录里的鉴权片段。
使用场景
- Next.js App Router 上线后某几条路由缓存命中低,想用 14 天 metrics 定位再只读对应路由代码
- 团队 Vercel 账单升高,需要先对齐 usage/contract 再门禁出前 6 个最值得看的候选
- SvelteKit 项目在 Observability Plus 下要做平台级设置检查加路由映射 scanner,而非全仓库扫一遍
- link 在 team scope 下偶发 metrics 与个人 org 混读,需先确认 project/scope 再重跑采集
适合人员
- 负责 Vercel 团队项目的全栈工程师,需要指标证据支撑的路由与缓存改造建议而非泛泛 checklist
- 平台/ SRE 工程师,要在不泄露 token 的前提下用 CLI 拉 metrics 并写进可给客户看的审计报告
- 使用 Next.js Pages 或 Nuxt 的技术负责人,想先过 framework preflight 再决定是否接受 limited 审计
- 月度复盘 Vercel 成本的 Tech Lead,希望建议绑定 deployment 回归或 error storm 等 deep-dive 观测