Xcode 构建优化 Agent 技能
通过基准测试和构建设置优化，加速 Xcode 干净构建与增量构建。
证据显示：README明确说明'No project files are modified until you explicitly approve changes'，且工作流分为分析和修复两个阶段，修复阶段要求用户批准，这支持了最小权限和用户确认。数据流透明度方面，README描述了工作流和产物（.build-benchmark/optimization-plan.md），但未详细说明脚本如何处理项目数据或是否上传外部。敏感数据处理未提及，但作为构建优化工具，可能接触项目文件，但未说明如何处理敏感信息。依赖安全性：未提供依赖清单或安全审计，但作为Agent Skill，依赖可能较少。外部影响：明确说明修改前需批准，且提供回滚机制（重新基准测试），但未提供自动回滚。来源归属：README明确作者为Antoine van der Lee，且提供个人网站，但发布者未验证。扣分原因：数据流透明度不足，敏感数据处理未说明，依赖安全性未评估，回滚机制不完整。
证据显示：README和技能结构一致，多个技能共享参考文件，但未提供测试或验证结果。依赖可用性：技能依赖外部工具（如Xcode、npx），但未说明版本要求或故障处理。失败消息：未提供错误处理或用户提示的示例。扣分原因：缺乏测试证据，依赖可用性未明确，失败消息未说明。
证据显示：README明确目标受众（iOS/macOS团队），并列出多种安装方式（skills.sh、Claude Code、Codex等），适应不同环境。能力边界：README列出检查项和技能用途，但未明确限制（如不支持某些项目类型）。触发精度：提供了明确的用户提示示例，但未说明技能如何被触发。环境适配：提供多种安装选项，但未说明系统要求（如Xcode版本）。扣分原因：能力边界和触发精度描述不够详细。
证据显示：README结构清晰，包含快速开始、工作原理、检查项、安装选项等，信息架构良好。安装说明详细，提供多种方式。命名稳定：技能名称一致，但未提供版本历史。示例和FAQ：提供社区结果表格，但未提供FAQ。已知限制：未明确列出。许可证：MIT许可证明确。版本和变更日志：有release workflow，但未提供CHANGELOG。维护责任：作者明确，且有贡献指南。扣分原因：缺少已知限制和变更日志。
证据显示：输出为优化计划文件，可共享和审查，输出可用性高。边际价值：提供超过40项检查，针对常见构建性能问题，价值明显。成本效益：安装和使用成本低，但需要用户手动批准和验证，可能耗时。扣分原因：成本效益评估基于静态分析，未实际运行。
证据显示：README引用Apple文档和WWDC，但未提供具体链接。社区结果表格提供外部链接，但未验证。事实与推断分离：README区分了检查项和社区结果，但未明确哪些是推断。扣分原因：引用未提供具体链接，社区结果未验证，事实与推断分离不够清晰。
- 发布者身份未验证，需谨慎对待来源。
- 数据流透明度不足，脚本如何处理项目数据未说明。
- 敏感数据处理未提及，可能涉及项目文件。
- 依赖安全性未评估，需检查依赖清单。
- 回滚机制不完整，仅依赖重新基准测试。
- 社区结果未验证，可能夸大效果。
这个 Agent 能做什么，适合哪些场景？
这是一个开源的 Agent 技能包，用于分析和优化 Xcode 构建性能。它由六个技能组成：一个编排器（xcode-build-orchestrator）负责协调五个专家技能：基准测试、编译分析、项目分析、SPM 分析和构建修复。这些技能通过基准测试干净构建和增量构建、审计构建设置、检测编译热点以及分析 Swift 包依赖来工作。所有分析均以"建议优先"的方式进行，不修改任何项目文件，直到用户明确批准。优化计划生成在 .build-benchmark/optimization-plan.md 中。该仓库还包含一个共享支持层，包含脚本、参考文档和模式。根据社区结果，增量构建时间平均可减少 5% 至 87%。
该 Agent 技能执行端到端的构建优化工作流。首先，xcode-build-orchestrator 运行 xcode-build-benchmark 来测量干净构建和增量构建的时间，生成带时间戳的产物。然后，xcode-compilation-analyzer 分析编译热点，xcode-project-analyzer 审计构建设置、脚本阶段和依赖关系，spm-build-analysis 检查 Swift 包图。这些分析结果汇总为优化计划，列出超过 40 项检查项，包括构建设置、脚本阶段、编译热点、零改动构建开销、目标依赖、模块变体、SPM 图、Swift 宏影响、SwiftUI 视图分解、资源目录并行性、访问控制和增量构建诊断。生成计划后，用户审查并批准项目，xcode-build-fixer 应用更改并重新基准测试以验证改进。整个流程不直接修改项目文件，直到用户批准。
- iOS 或 macOS 开发者在本地构建循环中遇到增量构建缓慢，希望识别并消除瓶颈。
- 团队调查最近构建时间回归，需要证据驱动的优化而非猜测。
- 有大量脚本阶段或复杂依赖的项目所有者希望审计构建配置以达到最佳实践。
- 开发者希望跨机器、团队或 Xcode 版本进行长期构建性能监控，并结合 RocketSim Build Insights 使用。
- 在无头或 CI 环境中，开发者希望自动化基准测试和优化工作流，而无需手动配置。
这个 Agent 有哪些优点和局限？
- 提供端到端的推荐优先工作流，不会在批准前修改任何项目文件。
- 涵盖 40 多项检查，从构建设置到 Swift 宏，提供全面分析。
- 社区结果展示了真实的改进，例如增量构建提升 87%。
- 包含可共享的证据文件（optimization-plan.md），便于协作和 PR 审查。
- 需要 npx 和 Node.js 来使用技能安装器，对于非 Node 用户可能带来障碍。
- 技能可能无法完全覆盖非常规的构建配置或自定义脚本。
- 编排器需要所有技能安装，这增加了安装面积。
- 实际收益可能因项目而异，某些改进可能需要手动调整。
如何安装或部署这个 Agent？
通过 npx 安装所有六个技能：npx skills add https://github.com/avdlee/xcode-build-optimization-agent-skill。或者，使用 --skill 标志安装单个技能，例如 npx skills add https://github.com/avdlee/xcode-build-optimization-agent-skill --skill xcode-project-analyzer。其他方法包括 Claude Code 插件市场、Codex/OpenAI 兼容工具（复制技能文件夹到 $CODEX_HOME/skills/）以及 pi 包管理器。有关手动安装，请克隆仓库并将技能文件夹符号链接到你的 AI 工具。
如何使用这个 Agent？
在你的 AI 编码工具中打开 Xcode 项目，并发出命令：使用 /xcode-build-orchestrator 技能分析构建性能并提出改进计划。Agent 将基准测试干净和增量构建，审计设置，检测编译热点，并生成优化计划在 .build-benchmark/optimization-plan.md。审查计划，选中要批准的项，然后要求 Agent 实施：实施优化计划中已批准的项，并重新基准测试以验证改进。确保所有六个技能已安装，因为编排器依赖其他技能。
这个 Agent 与同类方案有什么区别？
该仓库与 RocketSim Build Insights 互补，后者提供长期性能监控。它还与其他 Agent 技能包（如 Swift Concurrency Expert、SwiftUI Expert）共存，这些技能关注特定领域，而非构建性能。