用途:将任意项目部署到 Vercel。除非用户明确要求生产环境,否则始终以预览(preview)方式部署,目标是把项目链接到 Vercel,实现后续 git push 自动部署的长期方案。
主要能力与流程:
- 收集项目状态,依次检查四项:git remote get-url origin、查看 .vercel/project.json 或 .vercel/repo.json 判断是否已链接、vercel whoami 判断 CLI 是否已安装并认证、vercel teams list --format json 列出可用团队。多团队时以列表形式让用户选择,选定后用 --scope <team-slug> 传递。
- 按状态选择部署方法:已链接且有 git remote 时,经用户批准后提交并推送(git add .、git commit、git push),再用 vercel ls --format json 获取预览 URL;已链接但无 git remote 时用 vercel deploy [path] -y --no-wait,再以 vercel inspect <deployment-url> 查看状态;未链接且 CLI 已认证时先链接(有 git remote 用 vercel link --repo --scope <team-slug>,否则用 vercel link --scope <team-slug>)再部署;未链接且 CLI 未认证时先 npm install -g vercel、vercel login,再链接并部署。
- 无认证回退(Codex 沙箱):先用 command -v vercel 检查,若 CLI 不可用或报“No existing credentials found”,改用脚本 bash "$skill_dir/resources/deploy-codex.sh" [路径],返回 previewUrl 和 claimUrl,并告知用户认领链接。
适用场景:需要在 Vercel 上快速获得应用预览链接、希望项目接入 git 推送自动部署的场合。
限制与注意:未链接目录中不要用 vercel project inspect、vercel ls 或 vercel link 检测状态,只有 vercel whoami 可安全运行;生产部署仅在用户明确要求时执行;推送前必须获得用户明确批准;不要用 curl 验证部署链接;沙箱中若网络被阻塞可对实际部署命令申请提权,但不要对 CLI 可用性检查提权。具体收费、额度、平台支持范围等信息暂未提供。