vercel

Vercel 技能为 Web 项目的部署生命周期提供了完善的命令行接口，专为使用 AI 辅助工作流的开发者和 DevOps 工程师设计。该工具打通了本地开发环境与 Vercel 云平台，通过自然语言或指令直接处理仓库链接、环境变量注入与域名管理。利用此技能，AI Agent 可以在 IDE 或代理工作空间内直接执行 Vercel 基础设施管理任务，显著降低部署运维时的上下文切换开销，特别适用于需要维持多环境部署一致性的工程团队。

• 自动化项目链接：通过 vercel link 将本地目录与 Vercel 项目快速关联。

• Git 深度集成：连接 GitHub、GitLab 或 Bitbucket 仓库，支持自动触发构建与持续部署。

• 安全环境变量管理：使用特定命令行工具安全注入生产、预览和开发环境变量，避免 shell 使用 echo 命令时引入不必要的换行符。

• 域名管理：使用 vercel domains ls 等指令查询、验证并监控已绑定的自定义域名。

• 多环境支持：有效区分生产环境与预览环境部署，保障测试与发布流程的安全性。

• 前置要求：工作目录必须包含有效的 .git 文件夹，以确保项目映射和根路径的完整性。

• 使用说明：请务必在仓库根目录执行 vercel git connect 以激活自动部署触发器。

• 最佳实践：设置环境变量时，建议优先使用 printf 命令而非 echo，以防止因末尾换行符导致的值异常。

• 约束条件：本技能依赖于已安装并认证的 Vercel CLI，请确保本地环境具备正确的访问权限及稳定的 API 连接。

• 故障排除：在查询域名信息或更新部署配置前，请使用 cd 命令切换至目标 Vercel 项目目录。