⚡

Vercel平台管理技能Skill platform-vercel

此技能提供脚本工具来查询和管理Vercel云平台的部署、项目及构建日志，用于故障排查、性能监控和自动化部署，提升DevOps效率。关键词：Vercel, 云部署, CI/CD, DevOps, 构建日志, 项目查询, 自动化脚本。

CI/CD 0 次安装 0 次浏览 更新于 3/15/2026

名称: platform-vercel 描述: 查询Vercel部署、项目和构建日志。在调查Vercel部署失败、运行时错误或构建问题时使用。 允许的工具: Bash(python *)

Vercel平台

认证

重要: 凭证由代理层自动注入。不要检查环境变量中的 VERCEL_TOKEN——它对您不可见。直接运行脚本；认证是透明处理的。

您可以检查的配置环境变量（非秘密）：

  • VERCEL_TEAM_ID - Vercel团队ID（可选，用于团队范围请求）

可用脚本

所有脚本位于 .claude/skills/platform-vercel/scripts/

list_projects.py - 列出Vercel项目

python .claude/skills/platform-vercel/scripts/list_projects.py [--limit 20]

# 示例:
python .claude/skills/platform-vercel/scripts/list_projects.py
python .claude/skills/platform-vercel/scripts/list_projects.py --limit 50 --json

get_project.py - 获取项目详情

python .claude/skills/platform-vercel/scripts/get_project.py --project PROJECT_ID_OR_NAME

# 示例:
python .claude/skills/platform-vercel/scripts/get_project.py --project my-webapp
python .claude/skills/platform-vercel/scripts/get_project.py --project prj_abc123 --json

list_deployments.py - 列出部署

python .claude/skills/platform-vercel/scripts/list_deployments.py [--project PROJECT] [--state STATE] [--target TARGET] [--limit 20]

# 示例:
python .claude/skills/platform-vercel/scripts/list_deployments.py --project my-webapp
python .claude/skills/platform-vercel/scripts/list_deployments.py --project my-webapp --state ERROR
python .claude/skills/platform-vercel/scripts/list_deployments.py --project my-webapp --target production --limit 5

get_deployment.py - 获取部署详情

python .claude/skills/platform-vercel/scripts/get_deployment.py --deployment DEPLOYMENT_ID_OR_URL

# 示例:
python .claude/skills/platform-vercel/scripts/get_deployment.py --deployment dpl_abc123
python .claude/skills/platform-vercel/scripts/get_deployment.py --deployment my-webapp-abc123.vercel.app --json

get_deployment_events.py - 获取构建日志 / 部署事件

python .claude/skills/platform-vercel/scripts/get_deployment_events.py --deployment DEPLOYMENT_ID [--limit 50]

# 示例:
python .claude/skills/platform-vercel/scripts/get_deployment_events.py --deployment dpl_abc123
python .claude/skills/platform-vercel/scripts/get_deployment_events.py --deployment dpl_abc123 --limit 100 --json

create_deployment.py - 创建新部署

python .claude/skills/platform-vercel/scripts/create_deployment.py --name PROJECT_NAME --repo OWNER/REPO --ref BRANCH_OR_SHA [--target preview]

# 示例:
python .claude/skills/platform-vercel/scripts/create_deployment.py --name my-webapp --repo acme/my-webapp --ref main --target production
python .claude/skills/platform-vercel/scripts/create_deployment.py --name my-webapp --repo acme/my-webapp --ref fix/login-bug

调查工作流

部署失败调查

1. list_deployments.py --project PROJECT --state ERROR
2. get_deployment.py --deployment DEPLOYMENT_ID
3. get_deployment_events.py --deployment DEPLOYMENT_ID
4. 通过部署的git元数据关联最近提交

生产回归调查

1. list_deployments.py --project PROJECT --target production --limit 5
2. get_deployment.py --deployment LATEST_DEPLOYMENT_ID
3. 比较当前和先前生产部署的git SHA
4. get_deployment_events.py --deployment DEPLOYMENT_ID (检查构建输出)

构建超时 / 慢构建调查

1. list_deployments.py --project PROJECT --limit 10
2. get_deployment_events.py --deployment DEPLOYMENT_ID --limit 200
3. 在构建日志中查找事件时间戳之间的长间隔

快速命令参考

目标 命令
列出所有项目 list_projects.py
获取项目配置 get_project.py --project NAME
最近部署 list_deployments.py --project NAME
失败部署 list_deployments.py --project NAME --state ERROR
生产部署 list_deployments.py --project NAME --target production
部署详情 get_deployment.py --deployment ID
构建日志 get_deployment_events.py --deployment ID
触发部署 create_deployment.py --name NAME --repo OWNER/REPO --ref BRANCH

常见模式

检查部署是否仍在构建中

python .claude/skills/platform-vercel/scripts/get_deployment.py --deployment dpl_abc123 --json
# 查看 "state" 字段: BUILDING, READY, ERROR, CANCELED, QUEUED

查找特定提交的部署

python .claude/skills/platform-vercel/scripts/list_deployments.py --project my-webapp --json
# 在JSON输出中搜索提交SHA在meta.githubCommitSha中

从失败部署获取构建错误

python .claude/skills/platform-vercel/scripts/get_deployment.py --deployment dpl_abc123
# 检查errorCode和errorMessage字段
python .claude/skills/platform-vercel/scripts/get_deployment_events.py --deployment dpl_abc123
# 阅读完整构建日志以获取错误详情

反模式

  • 不要尝试从环境中读取 VERCEL_TOKEN。凭证代理会注入它。
  • 不要使用 curl 直接访问Vercel API。始终使用处理认证和代理路由的脚本。
  • 不要在紧密循环中轮询部署状态。检查一次，报告状态，并让用户决定何时重新检查。
  • 不要在没有用户明确确认的情况下创建生产部署。默认为 preview 目标。