用途
Vercel CI Setup 用于把一个已关联 Vercel 项目的私有 GitHub Turborepo 仓库接入 Vercel CI：从本地 Git 检出出发，先选择一小组低依赖的 Turborepo 任务，再通过一个配置拉取请求完成低风险接入。
主要能力
- 解析项目输入到其关联的 GitHub 仓库，并请用户确认推断出的 owner/repo。
- 记录仓库原有的 ciEnabledAt 值，判断 Vercel CI 是否已启用。
- 本地分析根级与包级 Turborepo 配置、工作区包脚本和 GitHub Actions 工作流，不改文件、不运行 turbo。
- 按配置路径和任务名汇总可用任务及覆盖的包实例数量，最多选择五个聚焦的 lint、类型检查、格式检查或单元测试任务，且这些任务不得依赖密钥、环境变量、部署或外部服务。
- 为拉取请求摘要记录每个选择的配置路径、任务名、包数量、支撑证据、依赖与环境要求。
- 在默认分支最新状态上建分支；若 Turborepo 低于文档要求的版本，用仓库包管理器升级并重新生成锁文件，最低不低于 2.11.7，不手工编辑锁文件。
- 按当前 Vercel CI 文档语法配置任务，保留既有配置与 JSONC 注释，校验配置并确认每个所选任务仍有对应包脚本。
- 在创建 PR 前启用 Vercel CI 并验证，随后创建一个 GitHub 拉取请求。
- 用 vercel ci list 有界等待查询该 PR 分支和提交对应的 CI 调用，返回 PR URL 和调用 URL；若无调用出现，给出用户可稍后执行的查询命令。
使用方式
前置条件包括：干净的本地 Git 检出，不得丢弃无关工作；已认证的 git、GitHub CLI 和 Vercel CLI，且确认 vercel api 与 vercel ci list 可用，否则停止并提示升级；明确 Vercel 团队，以及项目 ID/名称或 GitHub owner/repo；本地检出的 GitHub 远端须与确认的仓库一致；仓库为私有、关联所选团队至少一个项目，并存在根级 turbo.json 或 turbo.jsonc 以及声明的 turbo 依赖，否则停止。开始前应阅读当前 Vercel CI 文档作为产品要求、配置语法与 CLI 行为的权威来源；文档不可用时使用随附参考并注明未能验证当前文档。还应阅读 references/local-onboarding.md，其中包含任务选择规则、命令与恢复行为。
流程为：确认目标（展示团队、项目、仓库、本地检出、默认分支和启用状态，不匹配即停止）；本地分析任务并记录选择；采用保守选择直接创建接入 PR，仅在目标仓库不明确或无法确定安全初始任务时询问；准备一个本地 PR；启用 Vercel CI 后创建 PR；报告结果。若创建 PR 确定性失败且此前启用了原本禁用的仓库，恢复 ciEnabled: false 并验证回滚；结果不确定时先检查 GitHub 上该分支是否已有 PR 再决定回滚。除非用户明确要求，不合并 PR。
适用场景
适用于需要将私有 GitHub Turborepo 仓库以最低依赖任务接入 Vercel CI 的团队，尤其是希望先用少量 lint、类型检查、格式检查和单元测试任务验证流程的场景。
限制
不适用于未使用 Turborepo 的仓库；所选初始任务不能涉及密钥、环境变量、部署或外部服务。Turborepo 版本不得低于 2.11.7，锁文件不能手工编辑。当前文档暂未提供时为不可用状态下的兜底参考；除上述内容外，其他功能细节暂未提供。