用途:该技能面向 Turborepo 构建优化,适用于新建 Turborepo 项目、配置构建流水线、实现远程缓存、优化 CI/CD 性能、从其他 monorepo 工具迁移以及调试缓存未命中。
主要能力:围绕 turbo.json 配置展开,涉及 dependsOn、cache、outputs、inputs、persistent 等流水线概念;提供根级与包级流水线模板、Vercel 远程缓存、自托管远程缓存、过滤与作用域、高级流水线配置及根 package.json 设置等模板。
使用方式:通过 turbo.json 定义任务依赖与缓存输出,例如 build 使用 dependsOn: ["^build"] 并声明 outputs;远程缓存可执行 npx turbo login、npx turbo link,或使用 turbo build --remote-only,并设置 TURBO_TOKEN、TURBO_TEAM;CI 中可用 npx turbo build --filter='...[origin/main]' 只构建受影响包;自托管缓存可用 turbo build --api="http://localhost:3000" --token="my-token" --team="my-team"。
调试与最佳实践:可用 turbo build --dry-run、--verbosity=2、--graph、--force、--summarize 排查缓存;建议显式定义 inputs、使用 workspace 协议、启用远程缓存、在 CI 中过滤;不要缓存 dev 服务器(persistent: true)、不要把密钥放入 env、不要忽略 dependsOn、不要过度过滤。
限制:仅适用于 Turborepo 缓存相关任务;输出不能替代针对具体环境的验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。其他细节暂未提供。