mcpField
A
add

add

github.com/vercel开发31.3k122 次安装2 天前更新
代码仓库

关于 add

用于在现有仓库中添加 Turborepo,同时保留原有命令和包结构。该技能指导仓库分析、任务配置、安装与等效性验证,并在前提条件或任务行为不明确时停止。

主要功能

  1. 01分析仓库与 CI
  2. 02选择行为明确的任务
  3. 03谨慎配置 Turborepo
  4. 04比较现有命令与 turbo 命令
  5. 05前提不明时停止

适用场景

  1. 01为工作区添加任务编排
  2. 02配置单包仓库中的任务
  3. 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 命令的验证结果;
  • 延后处理或不受支持的任务。

仅当用户要求时才提交、更改推送或创建拉取请求。创建的拉取请求应为草稿。

其他技能调用此技能时

在调用方的分支上工作,不要创建拉取请求,并向调用方返回差异、验证结果和延后处理的任务。如果更改需要超出选定任务的范围,请停止,而不要扩大范围。

评论

支持 Markdown