关于 build-optimization
为分析和改进构建系统及开发工具提供指导,适合希望缩短反馈周期、提升 CI 效率的团队。内容包括性能分析、缓存、增量与并行构建,以及工具配置。
主要功能
- 01构建性能分析
- 02本地、远程和分布式缓存
- 03增量与并行构建
- 04包拆分与摇树优化
- 05开发工具与单体仓库配置
适用场景
- 01查找缓慢构建的瓶颈
- 02改善 CI 中的缓存利用
- 03缩短监听模式下的重建时间
- 04配置单体仓库构建工具
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nickcrew/ claude-cortex --skill build-optimization安装后在 Claude Code 中输入/build-optimization确认已加载。
附带文件references/build-systems.mdreferences/developer-tooling.md
详细介绍
构建优化
优化构建系统、缩短编译时间、最大限度提高缓存命中率,以及构建能在整个开发生命周期中提升效率的开发者工具的专家指南。
何时使用此技能
- 诊断构建缓慢的问题并找出瓶颈
- 配置缓存策略(本地、远程、分布式)
- 设置增量构建和并行执行
- 优化 CI/CD 流水线的性能和成本
- 设计或改进代码分割和摇树优化
- 构建 CLI、插件、代码生成器或 IDE 扩展
- 配置单体仓库工具(Nx、Turborepo、Bazel)
- 缩短开发者反馈循环(热重载、监视模式)
- 管理构建产物并确保可复现性
快速参考
| 任务 | 加载参考文档 |
|---|---|
| 编译、缓存、增量构建、CI/CD 优化 | skills/build-optimization/references/build-systems.md |
| 插件系统、代码生成、代码检查、IDE 集成、单体仓库工具 | skills/build-optimization/references/developer-tooling.md |
核心目标
- 开发构建时间低于 30 秒
- 监视模式下的重建时间低于 5 秒
- CI 中的缓存命中率高于 90%
- 生产流水线中没有不稳定构建
- 在不同环境中均可复现构建
工作流
1. 性能分析
进行更改前,先分析当前构建。
- 测量冷构建、增量重建和热重载的耗时
- 分析构建期间的 CPU、内存和 I/O 使用情况
- 绘制依赖关系图并找出瓶颈
- 评估缓存命中率和失效模式
- 检查当前工具配置,找出未启用的优化项
2. 优化
根据分析数据实施有针对性的改进。
- 启用增量编译和缓存
- 配置跨可用核心并行执行
- 设置代码分割和摇树优化
- 优化模块解析和源代码转换
- 为 CI 实施远程或分布式缓存
3. 工具
构建或配置开发者工具,加快反馈循环。
- 配置监视模式和热模块替换
- 设置清晰的错误消息和进度指示
- 集成构建分析和性能仪表板
- 添加用于格式化、代码检查和验证的提交前钩子
4. 监控
持续跟踪构建状况。
- 设置自动构建耗时跟踪和告警
- 监控缓存命中率和构建产物大小趋势
- 检测 CI 中的性能回退
- 定期根据数据进行审查和优化
常见错误
- 未先进行分析就开始优化
- 遇到间歇性问题时禁用缓存,而不是修复失效机制
- 增量构建已足够时仍运行完整构建
- 未将相互独立的构建任务并行化
- 忽视 I/O 瓶颈(磁盘速度、网络延迟)
- 不经分析便任由构建产物大小不断增长
- 开发和生产环境使用相同的构建配置
评论
支持 Markdown