它能做什么
中文摘要
Turborepo 官方技能,用于配置和排查 Turborepo 仓库,覆盖 turbo.json、任务管道、缓存、Remote Cache、turbo CLI、过滤、环境变量、包边界、monorepo 结构与 CI 工作流。技能本身不承载框架指导:完整的 Turborepo 文档随已安装的 turbo 包一起分发,技能要求先读取与当前安装版本完全对应的内置文档,入口为 node_modules/turbo/docs/README.md,再根据其中的任务索引选择最小的相关文档页面,并在修改 Turborepo 配置、包脚本或 CI 工作流之前先阅读该页面。若包管理器使用非扁平 node_modules 布局或 workspace link,需先用 node -p "require.resolve('turbo/package.json')" 解析包位置,再读取其下的 docs/README.md。若未安装 turbo,应先检查仓库的包管理器与既有版本约束,再决定是否安装;安装后使用内置文档而非其他版本的指导。
为什么推荐
推荐理由
适合正在使用或准备接入 Turborepo 的 monorepo 项目:它把配置与排错所需的文档来源指向随 turbo 包分发的内置文档,能保证所读资料与当前安装版本一致,避免套用不同版本的过时指导。同时给出了非扁平 node_modules、workspace link 以及未安装 turbo 等情形的处理路径,便于在修改 turbo.json、包脚本或 CI 工作流前先确认正确做法。官方来源(vercel/turborepo),安装量 75879。
什么时候用
适用场景
- 编写或调整 turbo.json 中的任务管道与依赖关系
- 配置或排查 Turborepo 本地缓存与 Remote Cache
- 配置与调试基于 turbo 的 CI 工作流
- 使用 turbo CLI 的过滤(filtering)与环境变量功能
- 在 monorepo 中梳理包边界与工作区结构
- 包管理器采用非扁平 node_modules 布局或 workspace link 时定位并读取 turbo 内置文档
- 仓库尚未安装 turbo,需要先核对包管理器与版本约束再决定安装
- 需要撰写或修改与 turbo 相关的包脚本
使用前先看
主要亮点
- 01
说明完整 Turborepo 文档随已安装的 turbo 包分发,并指定入口为 node_modules/turbo/docs/README.md
- 02
要求读取与已安装版本完全对应的内置文档,而非其他版本的指导
- 03
提供任务索引用法:据此选择最小的相关文档页面
- 04
明确在修改 Turborepo 配置、包脚本或 CI 工作流前先阅读对应文档页
- 05
针对非扁平 node_modules 或 workspace link,给出 node -p "require.resolve('turbo/package.json')" 的定位方式
- 06
提示若 turbo 未安装,应先检查仓库包管理器与既有版本约束,安装后使用内置文档
- 07
技能覆盖面明确包括 turbo.json、任务管道、缓存、Remote Cache、turbo CLI、过滤、环境变量、包边界、monorepo 结构与 CI 工作流
- 08
为官方仓库 vercel/turborepo 下的技能,安装命令为 npx skills add https://github.com/vercel/turborepo --skill turborepo
原始文档
原文摘录
Turborepo The complete Turborepo documentation ships inside the installed `turbo` package. Do not rely on this skill for framework guidance. Always read the bundled docs, which match the installed version exactly. Start with: