技能 turborepo-caching
📦

turborepo-caching

安全

优化 Turborepo 构建性能

也可从以下获取: wshobson

没有适当的缓存,Monorepo 构建会变得缓慢且低效。本技能提供生产级 Turborepo 配置,支持本地和远程缓存,可显著减少构建时间。

支持: Claude Codex Code(CC)
🥉 75 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“turborepo-caching”。 创建带有缓存 dist 和 .next 输出的构建流水线的 turbo.json

预期结果:

包含构建任务配置的完整 turbo.json,包括输出、依赖项和环境变量

正在使用“turborepo-caching”。 如何使用 Vercel 设置远程缓存?

预期结果:

运行 npx turbo login、npx turbo link 以及在 CI 中配置 TURBO_TOKEN 的分步说明

安全审计

安全
v1 • 2/25/2026

All 47 static findings are false positives. The skill contains Turborepo documentation and configuration templates with CLI command examples. The flagged patterns (external commands, network URLs, filesystem operations) are legitimate documentation showing Turborepo usage patterns, not actual code execution risks. No malicious intent or security vulnerabilities confirmed.

1
已扫描文件
422
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
85
内容
50
社区
100
安全
100
规范符合性

你能构建什么

初始 Turborepo 设置

从第一天起就设置具有优化缓存的新 monorepo

CI/CD 性能优化

通过远程缓存和受影响的包过滤将 CI 构建时间减少 50-90%

自托管缓存基础设施

为没有 Vercel 的组织部署私有缓存服务器

试试这些提示

基础 turbo.json 设置
创建包含 build、test、lint 和 dev 任务的 turbo.json 配置。包括适当的输出和依赖。
远程缓存配置
展示如何为我的 Turborepo 项目配置 Vercel 远程缓存,并使用 CI 环境变量。
使用受影响包的 CI 流水线
创建 GitHub Actions 工作流,仅使用 turbo 过滤构建当前更改影响的包。
自托管缓存服务器
创建用于自托管 Turborepo 远程缓存的 Express.js 服务器实现,包含工件存储。

最佳实践

  • 始终定义明确的输出以避免缓存不必要的文件
  • 在 CI 中使用远程缓存在所有开发者之间共享构建结果
  • 正确配置 dependsOn 以防止任务之间的竞态条件

避免

  • 不要缓存持久化任务(如 dev 服务器),而是使用 persistent: true
  • 不要将 secrets 包含在 turbo 缓存的环境变量中
  • 不要跳过 dependsOn,因为这可能导致依赖包中的构建失败

常见问题

什么是 Turborepo 远程缓存?
远程缓存在云端(Vercel 或自托管)存储构建工件,这样团队成员和 CI 可以重用之前的构建,而无需重新构建。
如何调试缓存未命中?
使用 turbo build --dry-run 查看将要执行的内容,或使用 turbo build --summarize 查看每个任务的缓存命中/未命中状态。
我可以在没有 Vercel 的情况下使用 Turborepo 吗?
是的,您可以使用 Turborepo HTTP API 自托管远程缓存。本技能提供了示例实现。
dependsOn 在 turbo.json 中做什么?
dependsOn 定义任务依赖。使用 ^build 等待依赖项先构建完成,或指定必须完成的具体任务。
如何仅过滤已更改的包的构建?
使用 turbo build --filter='...[origin/main]' 仅构建自 main 分支以来更改的包。
.env 文件是否包含在缓存键中?
是的,如果列在 turbo.json 的 globalDependencies 中。这确保在环境配置更改时重新运行构建。

开发者详情

文件结构

📄 SKILL.md