关于 add
用于在现有仓库中添加 Turborepo,同时保留原有命令和包结构。该技能指导仓库分析、任务配置、安装与等效性验证,并在前提条件或任务行为不明确时停止。
主要功能
- 01分析仓库与 CI
- 02选择行为明确的任务
- 03谨慎配置 Turborepo
- 04比较现有命令与 turbo 命令
- 05前提不明时停止
适用场景
- 01为工作区添加任务编排
- 02配置单包仓库中的任务
- 03检查 turbo 是否保留原有行为
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ vercel/ turborepo --skill add安装后在 Claude Code 中输入/add确认已加载。
详细介绍
添加 Turborepo
将 Turborepo 添加到现有仓库,用于选定任务,同时不改变现有命令的行为。在工作区仓库中,配置工作区包任务;在单包仓库中,配置根任务。
文档
修改文件前请阅读以下文档,并将其作为配置语法和工具链前置条件的权威依据:
安装 turbo 后,优先使用它内置的 docs/README.md,该文档与已安装的版本相匹配。如果无法核实文档,请停止操作,不要依赖记忆中的语法。
何时停止
如果出现以下情况,请停止操作并说明原因,保持仓库不变:
- Git 检出中有未提交的更改;
- Turborepo 无法从仓库现有的清单文件中发现包;
- 添加 Turborepo 需要引入新的工具链、包管理器或清单文件类型,或需要移动包;
- 某个工具链存在相互冲突的锁文件;
- 无法从仓库和 CI 判断任何选定任务的执行顺序、输出内容或所需环境。
工作流
1. 分析
阅读清单文件、工作区定义、锁文件、根脚本或任务运行器目标、包依赖关系以及 CI 配置。总结工具链、布局、候选任务、观察到的依赖关系、输出、环境变量,以及无法推断的信息。
用户直接要求添加 Turborepo 即可继续操作。仅当请求含糊不清,或会扩大下文所述范围时,才先询问用户。
2. 选择任务
仅配置行为明确的任务,并优先选择仓库已经运行的 lint、类型检查、格式检查、单元测试和构建任务。
不要:
- 重命名或移动包,也不要更改工具链、包管理器或工作区成员;
- 重写包级任务命令;
- 添加远程缓存;
- 除非用户提出要求,否则不要配置部署、端到端、集成或环境配置任务。
保留现有的根入口。按照仓库惯例,为根级任务编排器的 turbo 版本另取名称,例如 <task>:turbo。只有在证明 turbo 命令等效时,才替换原命令。
3. 添加 Turborepo
按照工具链指南安装 turbo。如果仓库固定了工具版本,则以相同方式将 turbo 固定到确切版本。使用负责管理锁文件的工具重新生成锁文件。切勿手动编辑锁文件。
补齐工具链指南要求但当前缺失的前置项,例如工作区名称或工具链声明。版本应从锁文件或工具链自身的命令中获取,不要猜测。
创建根目录下的 turbo.json,且仅配置选定任务:
- 仅启用这些任务所需的工具链支持,包括任何必需的
futureFlags。如果该支持处于实验阶段,请告知用户。 - 仅在仓库表明确有必要时添加
dependsOn、inputs、outputs和环境变量。 - 如果添加自定义
inputs,请包含"$TURBO_DEFAULT$"。使用"$TURBO_ROOT$/<path>"引用包外的根目录文件。 - 对有副作用的任务以及无法捕获输出的任务禁用缓存。
工具链支持可能会注册你未选择的内置任务。应将它们报告为延期配置,而非已验证任务。
如果依赖目录和 .turbo 尚未列入 .gitignore,请将它们添加进去。不要更改其他忽略规则。
4. 验证
以冻结或不可变模式安装依赖。然后检查每个任务的 turbo run <task> --dry 输出:
- 选中的仅为预期的软件包和任务,且没有遗漏定义了任务的软件包。
- 任务顺序与仓库当前的执行顺序一致。
- 对于有共享根输入的任务:先运行一次,确认第二次运行命中缓存;更改一个根输入,确认缓存未命中,然后还原更改。
接着运行每条现有命令及其对应的 turbo 命令,并比较软件包覆盖范围、执行顺序、退出状态和输出。仅凭 turbo 运行成功并不能证明两者等效。如果行为不同,请收紧配置或停止。切勿通过删除旧命令来掩盖差异。
5. 报告
总结:
- 配置的任务及其软件包覆盖范围;
- 保留的命令以及替换的根入口;
- 推断出的依赖项、输入、输出和环境变量;
- 对比现有命令与
turbo命令的验证结果; - 延后处理或不受支持的任务。
仅当用户要求时才提交、更改推送或创建拉取请求。创建的拉取请求应为草稿。
其他技能调用此技能时
在调用方的分支上工作,不要创建拉取请求,并向调用方返回差异、验证结果和延后处理的任务。如果更改需要超出选定任务的范围,请停止,而不要扩大范围。