Vercel 项目与部署
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/acedatacloud-skills-vercel。
技能介绍
你要解决什么问题
在 Vercel 上跑前后端或静态站点时,项目列表、某次部署为什么红、域名有没有挂上、要不要对生产再发一版——这些事往往得切到控制台逐页点,或在本地手写 curl 记 Bearer 头和 teamId 参数。Projects 这条技能把调用方式固定成一套约定:用 curl + jq 打 Vercel REST API,统一从 $VERCEL_ACCESS_TOKEN 取鉴权,团队资源时再带 ?teamId=$VERCEL_TEAM_ID。
技能如何工作
- 鉴权与基址:所有请求使用
Authorization: Bearer $VERCEL_ACCESS_TOKEN,基址为https://api.vercel.com;团队作用域资源在 URL 上追加teamId查询参数。 - 项目与部署:按 SKILL 指引查询、浏览项目及相关部署记录,便于对照 Git 提交与线上版本。
- 失败构建诊断:针对状态为
ERROR的部署,结合 API 返回信息定位构建失败环节(状态机一般为QUEUED→BUILDING→READY/ERROR/CANCELED)。 - 域名与重部署:处理域名绑定与部署关联;重部署通过
POST https://api.vercel.com/v13/deployments(deploymentId或 git source),必须先向用户确认——会直接打到生产环境。 - 错误处理:接口错误体为
{"error":{"code","message"}},应向用户原样展示message;403常见于 Token 看不到对应 team/project,需用正确 scope 重新连接。
时间字段 created / ready 为毫秒时间戳,展示给用户前除以 1000。
适用边界与注意点
- 严禁打印环境变量明文:列出项目 env 仅返回元数据;
/v1/.../env/{id}解密路由会拿到密钥——除非用户明确要求,否则不要调用;即便调用也只摘要说明,不要回显秘密。 - 本技能是 API 操作指南,不负责替你保管 Token,也不替代 Vercel 官方 CLI 的全部能力。
- 生产重部署有真实流量影响,技能明确要求先确认再执行。
使用场景
- CI 流水线绿了但 Vercel 预览/生产部署标红,需要对照 API 查该次 deployment 状态与错误信息
- 团队在 Vercel 上维护多个 project,要按 team 列出资源并核对最近一次成功部署时间
- 生产域名解析已改但站点未更新,需查 domain 绑定并评估是否对已上线 deployment 发起重部署
- 本地只有 Token、不想开浏览器控制台,用 curl 拉项目列表并 jq 过滤目标环境
适合人员
- 负责 Vercel 托管站点的全栈工程师,要在值班时快速判断某次部署失败是否与构建或权限有关
- DevOps/SRE 用团队 Token 巡检多项目部署状态,并避免误触生产重部署
- 技术负责人在迁移域名或切换 Git 连接后,需要 API 侧核对 project 与 deployment 是否一致
- 安全-conscious 的维护者,希望助手列出 env 元数据但不泄露解密后的密钥