deploy-to-vercel-vercel-labs-agent-skills

1. 基本信息

项目	内容
名称	deploy-to-vercel-vercel-labs-agent-skills
项目自述名称	`deploy-to-vercel`（SKILL.md front matter 内 `name` 字段原值）。说明：仓库 README 第 160 行另有一节名为 `vercel-deploy-claimable`，描述与本技能“免鉴权 claim 部署”分支高度重合；经比对 SKILL.md 与第三方报道（见第 8 章 MarkTechPost），判断其为该能力的文档遗留旧名，现已整合进 deploy-to-vercel v3.0.0 的 “No-Auth Fallback” 方法，不构成独立技能，仅在此如实记录该处文档不一致
作者/维护者	Vercel（vercel-labs 官方工程团队维护，SKILL.md `metadata.author: vercel`）
来源链接	https://github.com/vercel-labs/agent-skills/tree/main/skills/deploy-to-vercel
许可证	MIT（仓库 README「License」章节明确声明；GitHub License API 未识别到独立 LICENSE 文件，以 README 声明为准，如实标注这一细节）
GitHub Stars/Forks	所属合集仓库 29,058 / 2,602（GitHub API 实测 2026-07-15；仓库为多技能合集，星数不直接归属本技能自身，独立佐证见第 2 章媒体报道）
最新版本	SKILL.md 声明 3.0.0；该子目录 GitHub 提交历史 API 仅查得 1 条记录（2026-03-06，仓库存在 zip 归档与目录重构痕迹，历史可能不完整，如实说明）；仓库整体最近提交 2026-07-07（GitHub API 实测）
安装方式	`npx skills add vercel-labs/agent-skills --skill deploy-to-vercel`（单技能）或 `npx skills add vercel-labs/agent-skills`（整包）；亦作为 claude.ai / Claude Desktop 预置技能直接可用

2. 功能介绍与亮点

deploy-to-vercel 是 Vercel 官方团队出品的部署技能，核心是一套四步决策流程：收集项目状态 → 选择部署方式 → 执行部署 → 返回链接。

核心能力：

五级部署路径（按优先级自动选择）：已关联 Git 仓库时走 git push 触发自动构建；已关联但无 Git 时走 vercel deploy 直接部署；未关联时先 vercel link 再部署；未鉴权环境走完整 CLI 安装 + 鉴权 + 部署；完全沙盒环境（claude.ai、Codex）则走脚本化免鉴权部署
免鉴权 “claim” 部署：自动识别 40+ 前端框架并支持静态站点，打包上传后返回预览链接与认领（claim）链接，用户事后可将部署转移到自己账号，无需在沙盒环境中共享 Vercel 凭据
内置安全设计：明确要求“git push 前必须先询问用户”，避免意外提交；提示不要用 vercel ls/vercel link 等命令在未关联目录触发交互式弹窗
官方 Vercel 工程团队出品，2026-01-18 经 MarkTechPost 专题报道；同仓库姊妹技能 react-best-practices 已验证有独立安装量佐证，反映该合集整体受欢迎程度

3. 适用场景

固定分类：DevOps 与基础设施。

适合用 Claude Code、Codex 等 Agent 把本地项目或 Agent 生成的 Web 应用直接部署上线、快速拿到可分享预览链接的初中级开发者；尤其适合不熟悉 Vercel CLI 鉴权与 team 选择细节的新手，以及在 claude.ai / Codex 等沙盒环境中没有本地终端权限的用户；也适合已有 Vercel 项目、希望 Agent 自动维护“git push 即部署”工作流的个人开发者。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——SKILL.md 为标准 Claude Skill 格式，仓库根目录另含专门的 CLAUDE.md 说明文档（已抓取核实）
Codex：✅ 原生支持——SKILL.md 明确写明 Codex 专属回退脚本 deploy-codex.sh（bash ~/.claude/skills/deploy-to-vercel/resources/deploy-codex.sh，已抓取核实）
OpenClaw：❓ 未验证——抓取材料未提及
Hermes Agent：❓ 未验证——抓取材料未提及

（未为兼容性单独发起搜索，以上判断仅基于本次已抓取材料。）

5. 推荐理由

让 Agent 把代码部署上线，是编程任务里最高频的“最后一步”，但初级用户常常卡在 Vercel CLI 鉴权、git remote 关联、team 选择这些琐碎细节上。deploy-to-vercel 把这套判断逻辑标准化成一个技能：Agent 自动侦测项目当前状态，挑选最合适的部署路径，并明确要求“push 前先问用户”，把最终控制权留给人。对完全没有 Vercel 账号的用户，还有免鉴权的“claim”部署模式可以先看效果、后续再认领到自己账号，进一步降低了上手门槛。这套设计出自 Vercel 官方工程团队，可信度和维护质量有保障。

6. 评分

维度	分数	说明
受欢迎程度	9.0	官方一线机构（Vercel）出品；经 MarkTechPost 等科技媒体专题报道；合集仓库 star 29,058（不直接计入本技能，仅作背景）；未能拿到本技能自身的独立安装量数字，置信度略低于满分
可用性	9.0	一条命令安装，或在 claude.ai / Codex 中预置可用；SKILL.md 含清晰决策树、警告与多环境回退方案；仓库整体近期活跃维护（2026-07-07）；免费 Vercel Hobby 计划即可使用，无强制付费依赖
安全性	8.0	见下方安全检查清单
综合	8.7	三项均值，超过 7.0 达标线，安全性远超一票否决线

安全检查清单：

Shell/权限范围：执行 git、vercel CLI 命令（含真实 git push 与线上部署），范围明确但具有真实副作用；SKILL.md 内置“push 前必须先问用户”的安全设计
联网外发：需访问 Vercel 基础设施完成部署，目标透明（claude.ai 环境需放行 *.vercel.com）
API Key/凭据：需要 Vercel 账号鉴权（或走免鉴权 claim 模式），凭据由官方 CLI 标准方式存储
可疑指令/注入迹象：完整抓取 SKILL.md 全文核实，未发现要求执行流程外操作的可疑指令
作者/组织信誉：Vercel 官方工程团队，一线机构，信誉高
License：MIT，README 明确声明（未见独立 LICENSE 文件，如实标注）
维护时间：仓库整体活跃（最近提交 2026-07-07）；该子目录提交历史 API 查询记录较少，如实说明，未据此扣分（已反映在受欢迎程度分）

7. 跟同类 Skills 相比的优势

Skill	定位	核心差异
deploy-to-vercel（本次推荐）	通用 Vercel 部署（git push / CLI / 免鉴权 claim 三种路径）	覆盖从“零配置沙盒环境”到“已有 CI/CD 项目”的完整部署光谱
vercel-optimize（同仓库姊妹技能）	已部署项目的成本/性能审计	审计“部署后”表现，不负责部署动作本身，且依赖 Vercel Observability Plus 付费方案
vercel-cli-with-tokens（同仓库姊妹技能）	基于 Token 的 CLI 鉴权	只解决“如何免交互认证”，不含部署路径决策逻辑
netlify-deploy（OpenAI 官方 Codex 插件）	Netlify 平台的等效部署技能	面向 Codex 插件生态（`.codex-plugin` 清单格式），功能定位相同但绑定 Netlify 平台，二者互为竞品
cloudflare（OpenAI 官方 Codex 插件）	Cloudflare Workers/Pages/DNS 管理	覆盖范围更广（含 DNS/基础设施管理），权限面更大，并非纯部署工具

8. 用户评价

MarkTechPost（科技媒体专题报道，2026-01-18）：将该技能定位为“面向 AI 编程 Agent 的包管理器”生态的一部分，重点介绍其“claim URL”机制——用户无需在沙盒环境共享凭据即可完成部署（已抓取核实）
apidog.com 博客（作者 Ashley Innocent，2026-01-26）：将该功能评价为实现“hands-off”自动化部署，建议搭配 API 测试工具加速开发迭代，未见具体批评（已抓取核实）
codex.danielvaughan.com 博客（作者 Daniel Vaughan）：将 npx skills add vercel-labs/agent-skills 列为技能安装标准示例命令，称 Skills CLI 已成为该生态事实上的“包管理器”，未对 Vercel 具体技能包做评价性表述（已抓取核实）

如实说明：以上三条均为科技媒体/技术博客报道，非用户在 Reddit/HN 等社区论坛的一手使用评价；本次专门检索未能抓取到独立社区评价来源。

9. 其他补充

该仓库同时收录 vercel-optimize、vercel-cli-with-tokens、web-design-guidelines、writing-guidelines、react-native-skills、react-view-transitions、composition-patterns 等姊妹技能，共享同一 npx skills 安装工具链；仓库根目录同时提供 AGENTS.md 与 CLAUDE.md 两份面向不同 Agent 的说明文档。

10. 安装使用方式

单技能安装：npx skills add vercel-labs/agent-skills --skill deploy-to-vercel
整包安装（含全部姊妹技能）：npx skills add vercel-labs/agent-skills
claude.ai / Claude Desktop 用户：该技能已预置，无需额外安装，触发词如 “deploy my app”、“push this live”、“create a preview deployment”
Codex 用户：技能自带 deploy-codex.sh 专属脚本，安装后按对话内提示触发即可
安装后无需重启；首次在未鉴权环境使用时会自动尝试 npm install -g vercel，随后引导完成鉴权，或走免鉴权 claim 流程

11. 注意事项

该技能会执行真实的 git push 与线上部署操作，具有真实副作用；虽然 SKILL.md 明确要求“push 前必须先问用户”，首次使用仍建议保持关注
claude.ai 等沙盒环境需要允许访问 *.vercel.com 域名，否则可能触发网络限制
该子目录 GitHub 提交历史 API 查询仅见 1 条记录，仓库存在 zip 归档与目录重构痕迹，具体历史提交次数无法完整还原，如实说明
官方材料未提及对 OpenClaw、Hermes Agent 的支持声明，如需在这两个生态使用建议先行验证
免鉴权“claim”部署模式生成的预览链接在被认领前，理论上任何拿到链接的人都可访问，涉及敏感项目建议尽快认领或改用鉴权模式部署