Agent Skills
返回列表
🔒

Vercel 项目与部署

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 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 元数据但不泄露解密后的密钥