1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | vercel-optimize-vercel-labs-agent-skills |
| 项目自述名称 | vercel-optimize |
| 作者/维护者 | Vercel Engineering |
| 来源链接 | https://github.com/vercel-labs/agent-skills/tree/main/skills/vercel-optimize |
| 许可证 | MIT（README 明确标注） |
| GitHub Stars / Forks | 合集仓库整体 29,177 / 2,619（GitHub API 实测；该数字属整个 agent-skills 合集，不代表本技能自身热度） |
| 平台安装量 | skills.sh 页面显示约 3.66 万次安装（该数字为技能级独立统计，非合集仓库共享指标） |
| 最新版本 | 1.2.0（技能自带 metadata.json，2026 年 5 月首次发布） |
| 安装方式 | npx skills add vercel-labs/agent-skills --skill vercel-optimize，或手动复制到 .agents/skills/vercel-optimize |
2. 功能介绍与亮点
面向已部署到 Vercel 的项目（Next.js、SvelteKit 支持最完整），走“先取证、后建议”流程：用 Vercel CLI 拉取调用量、时长、冷启动、CPU/内存、Core Web Vitals、账单等真实生产指标，规则化筛出值得深挖的候选点，再定向扫描源码，产出带前后代码对比、引用官方文档版本号的排名建议。
亮点：拒绝“看起来能优化”式臆测，建议必须挂钩真实观测数据；用确定性规则而非模型直觉决定深挖范围，且只引用受控文档清单，避免编造链接。
3. 适用场景
所属分类：DevOps 与基础设施。适合项目已部署在 Vercel、想做成本复盘或上线前性能体检、需要真实数据背书而非凭经验排查的团队与个人开发者。
4. 跨 Agent 兼容性
- Claude Code：原生支持——
AGENTS.md明确写道“你是一个基于 Anthropic Claude Agent SDK 构建的 Claude agent”，子任务提示词专为其撰写。 - Codex / OpenClaw / Hermes Agent：均未验证，文档中未见相关适配说明。
5. 推荐理由
Vercel 官方出品，用真实生产观测数据驱动可验证的成本与性能优化建议，而非凭经验猜测，能把建议直接锚定在账单和延迟数字上，减少无效改动。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Vercel 为一线基础设施厂商官方出品，技能级安装量约 3.66 万次；但技能本身 2026 年 5 月才发布，尚未检索到独立第三方社区讨论 |
| 可用性 | 8 | 一条 npx skills add 命令即可安装，README/SKILL.md 文档详尽；但完整路由级指标需要付费的 Observability Plus 订阅，且需先完成 vercel login/vercel link，并非零配置 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 执行一系列 Node.js 脚本（信号采集→代码扫描→合并→门控→深挖→核实→渲染），权限限于读取本地项目文件与调用已认证的 Vercel CLI，范围清晰 |
| ② 运行时是否联网外发数据 | 仅通过用户自己已登录的 Vercel CLI 与 Vercel 官方 API 通信，未发现向第三方地址外发数据的迹象 |
| ③ API key/凭据存储方式 | 不直接管理密钥，而是复用 vercel login 生成的官方 CLI 会话，凭据托管在 Vercel 官方客户端而非技能自身 |
| ④ 可疑指令/Prompt Injection 迹象 | SKILL.md 内含多条约束“子任务如何生成报告”的内部指令（如强制只引用白名单文档、禁止编造数字、禁止使用内部术语对外输出），经核实这些指令的作用范围限定在该技能自身的报告渲染环节，未发现试图诱导访问无关文件、外发凭据或执行技能职责之外操作的内容 |
| ⑤ 作者/组织信誉 | Vercel Engineering 官方团队署名，仓库归属 vercel-labs 组织 |
| ⑥ License | MIT，清晰明确 |
| ⑦ 最近维护时间 | 该子目录最近一次提交距今约一个半月左右，非弃置项目 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 vercel-optimize 的差异 |
|---|---|---|
| performance-optimization（addyosmani/agent-skills） | 通用型性能方法论，覆盖前端、后端、API、数据库，强调“先测量后优化”，可用合成测试或真实用户监控数据 | 平台无关、覆盖面更广，但不内置任何特定托管平台的数据抓取能力，需要使用者自行接入观测工具；vercel-optimize 则直接打通 Vercel 官方 CLI 的指标与账单接口，开箱即得真实生产数据，代价是仅服务于部署在 Vercel 上的项目 |
| Vercel 控制台自带的 Speed Insights / Observability 仪表盘 | Vercel 产品原生功能，以可视化仪表盘形式呈现指标，需要人工阅读和决策 | 只负责“呈现数据”，不生成代码级修复建议；vercel-optimize 站在这些同一份数据之上，多做了一步“筛选出该改哪里、怎么改”的自动化分析 |
8. 用户评价
该技能目前在第三方平台尚无独立的具名用户评价。
9. 其他补充
技能自带贡献规范与专门测试用例目录，新增优化规则须配套 fixture 验证；路线图提到未来会覆盖 AI Gateway 等更多计费维度。
10. 安装使用方式
- 一键安装（推荐）：
npx skills add vercel-labs/agent-skills --skill vercel-optimize - 手动安装：复制
skills/vercel-optimize到项目的.agents/skills/vercel-optimize
前置条件：Node.js 20+；Vercel CLI v53+ 并已 vercel login；项目目录已 vercel link；完整路由级指标需 Observability Plus 订阅，未订阅可用有限模式。
安装后注意事项：无需重启 agent，对话中提及“优化 Vercel 项目性能/成本”即可触发；首次运行前需确认已完成 CLI 登录与项目关联，否则信号采集会直接失败。
11. 注意事项
- 强依赖 Vercel 平台与其 CLI，无法用于非 Vercel 托管的项目
- 完整功能需付费 Observability Plus 订阅，有限模式下分析深度打折
- Next.js、SvelteKit 支持最完整，Hono/Remix 默认不处理
- 发布较新（2026 年 5 月），长期维护节奏仍需持续观察
- 除 Claude Code 外其他 agent 兼容性未经验证