SuperAPI AI 工具集

deploy-to-vercel

部署与运维

查看项目

更新于 10-16 03:47

技能介绍

用途:把任意项目部署到 Vercel,并在条件允许时尽量将项目链接到 Vercel、实现 push 即部署。默认部署为预览环境,只有用户明确要求才使用生产部署。

主要能力与流程:技能先做四项检查——git remote get-url origin、是否存在 .vercel/project.json 或 .vercel/repo.json、vercel whoami 是否登录、以及 vercel teams list --format json 列出团队。若用户属于多个团队,则以列表形式让用户选择,并通过 --scope 传入后续命令;若已有 .vercel 配置,则按其中 orgId 确定团队。

按状态选择方法:已链接且有 Git 远程时,询问用户同意后 git add、git commit、git push,由 Vercel 自动构建,预览分支产生预览部署;随后可用 vercel ls --format json 获取预览 URL。已链接但无远程时,使用 vercel deploy [path] -y --no-wait,再用 vercel inspect <deployment-url> 查看状态。未链接但 CLI 已认证时,先 vercel link --repo --scope <team-slug>(有远程)或 vercel link --scope <team-slug>(无远程)再部署。未安装或未认证时,先 npm install -g vercel、vercel login,再链接部署。

免认证回退:在无法安装或登录的沙箱(如 claude.ai、Codex)中,运行 resources/deploy.sh [path] 或 resources/deploy-codex.sh 等脚本,脚本会自动识别框架、打包(排除 node_modules、.git、.env)、上传并等待构建,返回预览 URL 和 Claim URL,并提示用户到 Claim URL 认领部署。

限制与注意:不要在未获明确批准时推送;不要用 vercel project inspect、vercel ls 或 vercel link 在未链接目录探测状态,只有 vercel whoami 在任意位置安全;不要 curl 部署 URL 验证;Windows 下可用 PowerShell Get-Command 解析 vercel;网络受限时可在 claude.ai 设置允许 *.vercel.com;沙箱网络失败可提升权限重跑部署命令。MCP 无需必需,如不可用按本地指令与脚本回退。