1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | vercel-functions-vercel-vercel-plugin |
| 作者/维护者 | Vercel, Inc.（官方团队） |
| 来源链接 | https://github.com/vercel/vercel-plugin/tree/main/skills/vercel-functions |
| 许可证 | Apache-2.0（根目录 LICENSE 文件确认；GitHub API license 字段因检测算法限制显示 NOASSERTION） |
| GitHub Stars | 234（合集仓库 vercel/vercel-plugin 整体，GitHub API；该技能所在子目录近 5 个月内有 18 次专项提交，未单独统计 star） |
| Forks | 39（合集仓库整体，GitHub API） |
| 最新版本 | v0.46.0（plugin.json 版本号，仓库未建立正式 Release/Tag） |
| 安装方式 | 随 vercel-plugin 整体插件安装（见第 10 章） |
2. 功能介绍与亮点
vercel-functions 是 Vercel 官方 vercel-plugin 技能合集中的核心技能之一（metadata 中 priority 字段标为 8，是合集内优先级最高的两个技能之一），教 AI 编码助手为运行在 Vercel 上的 Serverless/Edge 函数做出正确的配置与优化决策。该技能由插件团队直接原创维护，未走合集内“上游仓库同步”模式。
核心亮点：
- 运行时选型决策矩阵：给出 Node.js（全量 API）、Edge（V8 Isolates，冷启动 <1ms）、Bun（公测，CPU 密集型延迟降约 28%）、Rust（公测，Fluid Compute 原生速度）四种运行时的对比表，按“数据库连接”“认证重定向”“AI 流式输出”等具体需求给出选择建议。
- Fluid Compute 架构讲解：说明 Active CPU 计费只在 CPU 实际运算时计费、等待期间按更低费率计、多请求共享实例最多降本 85%，以及默认 300 秒执行时限（Pro/Enterprise 可达 800 秒）。
- 内置反模式实时检测（validate 规则）：用正则匹配在编码助手写代码时当场捕捉 7 类常见错误——残留 Express.js 中间件、Pages Router 类型误用于 App Router、向只读的 Serverless 文件系统写入本地文件、绕过统一层直连 AI Provider SDK、进程内内存缓存跨调用失效、手写重试逻辑、路由处理函数缺少可观测性埋点——每条都给出具体替代方案，而非只提示“有问题”。
- 技能间自动跳转（chainTo）：检测到特定代码模式（如直连 OpenAI/Anthropic SDK、手写轮询、本地文件写入）时，自动建议加载合集内 ai-sdk、workflow、vercel-storage 等更专精的技能，减少用户在多份文档间来回切换。
3. 适用场景
固定分类：DevOps 与基础设施。
适用于把应用部署在 Vercel 平台、需要在 Node.js/Edge/Bun/Rust 运行时之间做选型、用 Fluid Compute 控制成本、实现 WebSocket/SSE 流式响应或配置 Cron 定时任务的开发者；也适合团队希望编码助手在写 route handler 时自动发现“本地文件写入”“内存缓存不跨调用共享”等 Serverless 平台特有反模式的场景。
4. 跨 Agent 兼容性
- Claude Code：原生支持，仓库 README 明确列为受支持工具，提供插件市场安装方式。
- Codex：原生支持，README 支持列表中明确列出 OpenAI Codex。
- OpenClaw：未验证，官方文档未提及。
- Hermes Agent：未验证，官方文档未提及。
（README 另确认支持 Cursor、GitHub Copilot CLI、Grok Build、Kimi Code，但均不在本站四个目标生态之内，仅作背景参考。）
5. 推荐理由
“Serverless 函数怎么配置”是几乎每个 Vercel 项目都要面对、却容易在 Node/Edge 运行时之间选错、或踩中“本地文件系统只读”“内存缓存不跨调用共享”这类平台特有陷阱的问题。这个技能把官方文档变成一份决策矩阵加一套实时反模式检测：开发者不必先通读全部函数文档，编码助手就能在写代码当场指出用错的模式并给出可替换方案，比事后线上报错才发现问题成本低得多。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方 Vercel 出品；所在合集近 5 个月内该子目录有 18 次专项提交（最近一次 2026-06-30），仓库 Issues 区有 44 个开放问题、多名外部具名开发者反馈真实使用问题，Vercel 官方 Changelog 与科技媒体（webdeveloper.com）均有专文报道插件发布 |
| 可用性 | 9 | 文档详尽（含运行时对比表、代码示例、7 条自动反模式检测规则），一条命令随插件整体安装；该子目录近 3 个月内有提交，维护活跃；无需额外付费依赖 |
| 安全性 | 8 | 官方出品、Apache-2.0 开源可审计；技能本身不执行 shell 命令，仅对已有代码做只读正则模式匹配；所属插件的产品遥测仅聚合每日活跃/首次使用等指标，公开披露且可用环境变量关闭 |
综合评分（三项均值）= 8.3
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 该技能自身不触发 shell 命令执行，仅提供配置指导与对既有代码的只读正则模式匹配 |
| ② 运行时联网外发 | 该技能不产生额外网络请求；所属插件另有独立的产品遥测（每日活跃标记等聚合指标，发往 Vercel 自有 telemetry.vercel.com），README 已披露且可用环境变量 VERCEL_PLUGIN_TELEMETRY=off 关闭，不采集提示词/文件路径/工具调用内容 |
| ③ API Key/凭据 | 该技能本身不要求凭据；实际部署到 Vercel 平台需标准 Vercel 账号登录态，由 Vercel 官方 CLI 统一管理 |
| ④ 可疑指令 | 未发现可疑指令或隐蔽外发；validate 规则均为公开可读的正则表达式，用途透明 |
| ⑤ 作者信誉 | Vercel, Inc. 官方团队，信誉良好 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 最近维护 | 该子目录最近一次专项提交为 2026-06-30，所属仓库整体持续活跃维护至今（最近一次提交 2026-07-31） |
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 vercel-functions 的差异 |
|---|---|---|
| workers-best-practices-cloudflare-skills | Cloudflare 官方为 Workers 平台编写的代码审查规则库，检索最新文档后核对配置、请求处理、架构、可观测性、代码模式五大类反模式 | 聚焦“审查已有代码”，需主动检索文档；vercel-functions 额外覆盖运行时选型（Node/Edge/Bun/Rust）与 Fluid Compute 成本模型，并有跨技能自动跳转机制 |
| netlify-deploy-netlify-context-and-tools | Netlify 官方部署技能，覆盖 CLI 鉴权、Git 持续部署、手动部署、构建故障排查全生命周期 | 聚焦“部署动作”本身；vercel-functions 聚焦部署之后函数运行时的配置与性能/成本优化，两者关注的生命周期阶段不同 |
vercel-functions 的差异化在于同时覆盖运行时选型决策与代码反模式实时检测两件事，且通过 chainTo 机制把用户自动带到合集内更专精的技能（如 AI 流式输出走 ai-sdk、长耗时任务走 workflow），不是单纯的静态文档或部署清单。
8. 用户评价
该技能所属的 vercel-plugin 合集仓库在 GitHub Issues 区可查到多名具名开发者的具体技术反馈，例如有开发者指出插件早期版本对几乎所有对话都无差别注入全部技能、造成上下文噪音（该问题已在后续版本修复为仅在检测到 Vercel/Next.js/Eve 项目时才激活），也有开发者指出合集内某技能的文档数值与官方文档实测行为不符。这些反馈显示合集已被开发者实际接入项目并深度使用。vercel-functions 本身目前在第三方平台尚无独立于合集之外的具名评价。
9. 其他补充
vercel-plugin 合集共含 31 个技能，覆盖 Vercel 生态几乎全部产品线；其中 11 个技能采用“上游仓库同步”模式（如 ai-sdk 同步自 vercel/ai、vercel-cli 同步自 vercel/vercel），vercel-functions 不在此列，为插件团队原创维护的技能。
10. 安装使用方式
该技能未提供独立安装入口，需随 vercel-plugin 整体插件安装，安装后自动包含 vercel-functions：
方式一：Claude Code 插件市场
/plugin marketplace add vercel/vercel-plugin
/plugin install vercel-plugin@vercel-plugin方式二：命令行安装（支持 Claude Code、Cursor、Codex 等）
npx plugins add vercel/vercel-plugin安装后可通过 /vercel-plugin:vercel-functions 直接调用，也会在检测到 Vercel/Next.js 项目且对话涉及函数配置、流式响应、Cron 等关键词时自动触发注入。
11. 注意事项
- 该技能只是 vercel-plugin 合集的一部分，无法脱离整个插件单独安装；安装即引入合集内全部 31 个技能与 3 个专用 Agent。
- 所属插件默认开启轻量级产品遥测（每日活跃与首次使用标记等聚合指标），不采集提示词或文件内容，可用
VERCEL_PLUGIN_TELEMETRY=off关闭。 - 仅适用于部署在 Vercel 平台的项目；Bun、Rust 运行时与部分 Fluid Compute 特性标注为公测阶段，行为可能随版本调整。
- 内置的反模式检测基于正则模式匹配，无法覆盖全部代码写法，仍需开发者自行判断是否采纳建议。