xcode-build-optimization-agent-skill：为缓慢的 Xcode 构建做基准测试、规划与修复

一天点五十次的 30 秒增量构建，累积起来是实实在在的工时——README 的算法是每省 1 秒、每人每年省 3.5 小时，十人团队省 35 小时。xcode-build-optimization-agent-skill 用测量取代猜测：先基准、再分析、出计划，最后只修你批准过的项。

为什么这个 Skill 重要

这个 Antoine van der Lee（SwiftLee 和 RocketSim 的作者）维护的 1,215 星仓库提供六个技能。xcode-build-orchestrator 端到端协调整个工作流；xcode-build-benchmark 产出可复现的干净/增量基准；xcode-compilation-analyzer、xcode-project-analyzer 和 spm-build-analysis 分别负责编译热点、构建设置与目标依赖、Swift Package Manager 依赖图；xcode-build-fixer 应用批准的改动并复测。

agent 会跑 README 计数的 40 多项独立检查，逐条带出处记录在 OPTIMIZATION-CHECKS.md，类别涵盖构建设置审计、脚本阶段分析、编译热点检测、零改动构建开销、模块变体检测、SPM 依赖图分析、Swift 宏影响、SwiftUI 视图拆分和资产目录并行度等。整个工作流"先建议、后动手"：你不勾选批准框，项目里任何文件都不会被改。仓库还发布社区实测表——Helm for App Store Connect 报告其增量构建从 70 秒降到 9 秒（快 87%）——由跑过该工作流的开发者以 PR 形式贡献。

安装

一次装齐六个技能——编排器依赖各个专家技能：

npx skills add https://github.com/avdlee/xcode-build-optimization-agent-skill

Claude Code 另有插件市场路线（/plugin marketplace add AvdLee/Xcode-Build-Optimization-Agent-Skill），仓库也带 agents/openai.yaml 清单供 Codex 类工具使用。如果只需要某一个专家技能，可用 --skill 参数单独安装。

实战：从慢构建到批准的优化计划

1. 在 AI 编程工具里打开 Xcode 项目，启动分析阶段：

Use the xcode-build-orchestrator skill to analyze build performance
and come up with a plan for improvements.

2. 编排器对干净构建和增量构建做基准测试，跑三个专家分析器，把排好优先级的计划写到 .build-benchmark/optimization-plan.md。项目文件不做任何修改。

3. 读计划。每一项都带着检查项、基准中的证据和优先级。把计划文件当作证据链——README 的定位是与队友共享、放进 PR 评审、随时间做 diff。

4. 给想要的项勾选批准框，然后：

Implement the approved items from the optimization plan
at .build-benchmark/optimization-plan.md, then re-benchmark to verify.

5. fixer 只应用批准过的改动并重新基准测试，计划里的前后对比数字是测出来的，不是估出来的。

技巧

• 开启编译缓存后，首次干净构建变慢是正常的——README 提醒缓存填充期间小幅上升属于预期，收益体现在缓存后的干净构建和增量构建上。
• 即使只跟编排器对话，也把六个技能装齐——它要调用各个专家。
• 干净构建和增量构建暴露的问题不同：README 的划分是，一边是包设置与目标结构，另一边是编辑循环痛点、脚本瓶颈和缓存失效。基准报告的两列都要看，别只盯着最显眼的构建耗时数字。
• 想跨天、跨机器、跨 Xcode 版本监测趋势，README 把 RocketSim Build Insights（作者的产品）定位为这套单点工作流的互补。

何时不用这个 Skill

它只针对 Xcode——其他构建系统不在范围内。只想要一次性体检而不是完整工作流，用 --skill 单独装一个专家技能（比如 xcode-project-analyzer）就够了。而如果最近的劣化原因显而易见——已知很慢的脚本阶段、刚加的依赖——直接修它比跑一整轮基准更快。

查看 排行榜 了解更多 skill。