该技能用于通过 Vercel CLI 部署与管理 Vercel 项目,适合部署应用、管理环境变量、配置域名或推送密钥时使用。
使用前提:bun add -g vercel,然后 vercel login 登录。
主要能力与用法:
- 项目关联:在 Turborepo 中可用 vercel link --repo 一次关联所有应用,或进入 apps/web 执行 vercel link --project support-web;首次创建可用 vercel --yes。
- 部署:vercel 生成预览部署,vercel --prod 生产部署;也支持 vercel --cwd apps/web、--no-wait、--force、--logs。
- 环境变量:vercel env ls 列出,vercel env add 添加,vercel env pull 拉取到本地,vercel env run 直接带环境变量运行命令,vercel env rm 删除。注意没有更新命令,需先删除再添加。资料特别强调:绝不要用 heredoc 或普通 echo 管道传值,因为会加入尾随换行并静默破坏密钥;应使用 echo -n 'secret' | vercel env add MY_VAR production。
- 项目与域名:vercel project ls/inspect/rm 管理项目,vercel domains ls/add 管理域名,vercel alias 将部署指向自定义域名。
- 日志与 CI/CD:vercel logs <deployment-url> 查看日志,支持 --follow;CI 中可用 VERCEL_TOKEN 或 --token,如 vercel --token $VERCEL_TOKEN --prod。
- Monorepo:每个应用可有自己的 vercel.json,根目录可配置 ignoreCommand,如 npx turbo-ignore。
- 作用域:可用 vercel --scope skillrecordings 或 vercel switch skillrecordings 指定组织。
- 排查:rm -rf .vercel 后 vercel link 清除本地缓存,vercel --force --logs 重新部署。
限制:域名 webhook 地址不支持通配符,需使用精确的 Vercel 应用域名;环境变量不存在直接更新命令。其他细节资料暂未提供。