Vercel Optimize 是一个以可观测性为先的 Vercel 优化审计技能,用于对已部署应用做成本与性能排查,而非全仓库盲目检索。其核心原则是:先取得生产指标,再由确定性门控脚本决定哪些候选值得深入,仅读取候选或路由局部导入链涉及的少量文件,并只引用经版本校验的文档。
主要能力包括:收集 Vercel 生产信号并扫描代码库、合并为 signals.json;通过 gate-investigations.mjs 生成待查候选与平台级建议;对候选做深挖与一致性核对;对每个 brief 生成调查任务并可由子代理并行执行;随后验证建议、剔除版本不匹配或无效引用,最终渲染为面向客户的报告。默认候选预算为 6 个并带多样性保护,可用 --max-candidates 12 或 all 扩展。
使用前需满足:Vercel CLI v53+(含 vercel metrics、vercel usage、vercel contract、vercel api)、已 vercel login、已 vercel link 的目录、Node.js 20+,以及路由级指标所需的 Observability Plus。基本流程为:创建运行目录、运行 collect-signals.mjs、scan-codebase.mjs、merge-signals.mjs,检查框架支持与 Observability Plus 等阻塞项,运行 gate-investigations.mjs,按需生成 brief、调查、收集输出,再运行 verify-and-regen.mjs 与 render-report.mjs。
适用范围:支持 Next.js App Router/Pages Router、SvelteKit、Nuxt;Astro 支持有限;Hono、Remix 及未知框架默认阻断,需用户确认后才以受限平台/代码模式继续。限制:无近期流量时路由指标稀疏;未启用 Observability Plus 需用户选择启用或接受受限审计;不应把 Workflow 运行时端点时长或长连接路由的墙钟时长直接当作问题;不要在命令中暴露认证令牌,也不得从当前身份推断审计范围。