Xcode-Build-Optimization-Agent-Skill

1. 基本信息

项目	内容	数据来源
名称	Xcode-Build-Optimization-Agent-Skill	—
作者/维护者	Antoine van der Lee（SwiftLee 博客作者、RocketSim 创作者）	GitHub API + 作者个人网站
来源链接	https://github.com/AvdLee/Xcode-Build-Optimization-Agent-Skill	—
许可证	MIT	GitHub API + LICENSE 原文核对
GitHub Stars	1,182	GitHub API
Forks	45	GitHub API
最新版本	1.0.1（2026-04-01 发布，主分支后续仍有提交）	GitHub Releases API
安装方式	`npx skills add`、Claude Code 插件市场、pi 包管理器三种渠道	官方 README

2. 功能介绍与亮点

这是一套围绕“Xcode 构建速度”这一单一问题设计的 6 个协同技能，由一个总控技能（orchestrator）依次调度：先跑基准测试，再审计工程设置与编译热点，最后在开发者明确批准后才应用修复并重新跑分验证效果。

核心能力：

构建基准测试：分别测量全量构建、命中缓存的全量构建、零改动构建（用于分离固定开销）与增量构建，每种场景跑 3 次取值，结果存成带时间戳的 JSON，避免单次测量的偶然误差
工程设置审计：对照一份整理好的最佳实践清单，检查工程与 Target 级别的构建设置，定位常见的“设置不当拖慢构建”问题
编译热点分析：识别 Swift 类型检查耗时过长的具体函数/表达式
护栏式修复：xcode-build-fixer 明确要求“未经开发者明确批准不得修改工程文件”，且每次改动都必须跑前后基准对比留痕

主要亮点：作者是 iOS 社区知名博主（SwiftLee）与 RocketSim 工具的开发者；仓库内的“社区成果”栏目公开列出了包括 Wikipedia iOS（维基媒体官方 iOS 客户端）、Kickstarter iOS（Kickstarter 官方开源 iOS 客户端）在内的 7 个真实项目使用后的构建耗时对比数据；第三方技能质量评测平台 Tessl 对其中的 xcode-build-benchmark 子技能给出 75 分质量评分、92% 最佳实践符合度，并注明 Snyk 安全扫描未发现问题。

3. 适用场景

所属分类：工程效率与代码质量

适合任何维护中大型 Xcode 工程、苦于构建等待时间过长的 iOS/macOS 开发者与团队——尤其是想系统性定位“到底是哪个设置/哪段代码拖慢了构建”而不是凭感觉调参的场景，也适合 CI 流水线维护者用它量化每一次构建配置改动的实际收益。

4. 跨 Agent 兼容性

Claude Code：原生支持——README 提供 /plugin marketplace add + /plugin install 两条命令的插件市场安装路径，也支持通用的 npx skills add
Codex：支持——README 明确列出“OpenAI 兼容工具”渠道，随附 agents/openai.yaml 清单
OpenClaw：未验证——抓取材料未提及
Hermes Agent：未验证——抓取材料未提及
另注：README 提示 Cursor 插件支持“即将上线”，尚未正式提供

5. 推荐理由

把“测基准→审配置→找热点→经人工批准后修复→再测基准验证”这套构建优化方法固化成 AI 编码助手可直接执行的流程，避免开发者凭感觉盲改构建设置；已被 Wikipedia iOS、Kickstarter iOS 等真实开源项目使用并公开了实测收益数据。

6. 评分

维度	分数	说明
受欢迎程度	8	1,182 star、45 fork，落在 1k-5k 星区间；社区成果栏目有 7 个真实项目（含 Wikipedia iOS、Kickstarter iOS 两个知名开源项目）公开实测数据佐证，非单纯刷星
可用性	8	`npx skills add` 一条命令即可安装，另有 Claude Code 插件市场、pi 包管理器两条备选路径；第三方平台 Tessl 独立评测给出 92% 最佳实践符合度、100% 结构校验通过；但仓库最近一次推送在约 3 个月前，3 个外部贡献者在 5 月提交的 PR 至今未被合并，维护响应速度较此前有所放缓
安全性	9	见下方检查清单

安全检查清单：

shell 命令执行范围：仅调用本地 xcodebuild、git log 与仓库自带 Python 脚本分析构建产物，不涉及系统级权限
联网外发：全部操作在本地工程目录内完成，未见任何网络请求或数据外发
API key/凭据：不需要任何密钥或账号
可疑指令：抓取总控技能 SKILL.md 全文，未发现隐蔽指令；反而明确写有“未经开发者明确批准不得修改工程文件”的护栏式约束
作者信誉：具名个人开发者，为 iOS 社区知名博客 SwiftLee 与 RocketSim 工具的作者，身份可公开核实；第三方 Tessl 平台的 Snyk 安全扫描结果显示未发现已知问题
License：MIT，已核对仓库 LICENSE 原文
最近维护：最近一次推送在近 6 个月窗口内，但 3 个外部 PR 已挂起超过 2 个月未处理，维护活跃度较此前减弱

7. 跟同类 Skills 相比的优势

同类 Skill	定位	与本 skill 的差异
Swift-Concurrency-Agent-Skill（同作者）	聚焦 Swift 6 严格并发迁移、数据竞争诊断	解决的是运行时并发安全问题，与本 skill 关注的编译期构建速度是完全不同的环节
Xcode Build Performance Optimizer（作者 CharlesWiltgen，收录于 mcpmarket.com 技能市场）	通过单条 `/axiom:optimize-build` 命令自动扫描并直接应用“速赢”式修复	是一步到位的自动扫描+自动修复模式；本 skill 则拆成基准测试、配置审计、热点分析、人工批准后修复四个独立阶段，每步都有留痕数据，改动前后都跑分对比，更适合看重可验证性、不想让 AI 自动改工程文件的团队

两者定位有交集，但工作流哲学不同：本 skill 用“分阶段 + 强制人工批准”换取可审计性与安全边界，代价是单次交互步骤更多。

8. 用户评价

GitHub Issue #19 中，用户 red-beeard 留言：“Hello Antoine! First of all — great skill, really appreciate the work that went into this! 🙌 I’ve been enjoying using it on our project.”，随后提交了一份关于构建设置误报的详细技术反馈（对照 xcodebuild -showBuildSettings 实际输出核实平台默认值），作者已在后续 PR #20 中据此修复。这是目前唯一可核实的具名第三方用户评价。

9. 其他补充

作者名下还有另外两个已发布的 Apple 生态技能——SwiftUI 界面开发规范、Swift 6 并发迁移，分别覆盖界面层与运行时并发安全，与本 skill 关注的构建期性能形成互补，可按需搭配安装。仓库内“社区成果”表格会随外部项目提交而持续更新，是核实实际使用效果的可靠位置。

10. 安装使用方式

推荐方式（skills.sh 平台，适配多种 Agent）：
```
npx skills add https://github.com/avdlee/xcode-build-optimization-agent-skill
```
也可加 --skill <子技能名> 只安装其中一个（如 --skill xcode-project-analyzer）

Claude Code 插件市场：

/plugin marketplace add AvdLee/Xcode-Build-Optimization-Agent-Skill
/plugin install xcode-build-skills@xcode-build-skills

pi 包管理器：

pi install https://github.com/AvdLee/Xcode-Build-Optimization-Agent-Skill

安装后无需重启，在 Xcode 工程根目录下让 AI 助手“使用 xcode-build-orchestrator 技能分析构建性能并给出优化方案”即可触发，产出的优化计划会写入 .build-benchmark/optimization-plan.md

11. 注意事项

xcode-build-fixer 会在应用修改前要求开发者明确批准，首次使用建议先在测试分支上跑一遍完整流程
目前 3 个外部贡献者提交的功能改进 PR 尚未被合并，反映出维护响应速度较此前放缓，长期依赖前建议关注仓库后续活跃度
Cursor 插件支持仍在筹备中，尚未正式提供；在 OpenClaw、Hermes Agent 上的兼容性未经验证
仅适用于 Xcode/Swift 工程，对其他构建系统（如 Gradle、CMake）不适用