iOS Agent Skill 是一个面向 AI 编程代理的开源项目，为代理提供构建和审查 iOS 应用所需的 Apple 参考资料、Swift 源码和本地工具。
用途 该项目旨在让 AI 编程代理能够规划、编写和验证 iOS 应用。通过一句话描述应用，/ios-build 代理会规划应用、编写 SwiftUI 代码和 Xcode 工程，并应用能力模块（如登录、存储、支付、地图等），然后在 iOS 模拟器中构建、运行并截图，最终报告哪些部分需要用户自己的账户或付费。对于已有项目，同一套包为代理提供代码审查、本地 Apple 参考资料和模拟器工具，以检查其工作成果。
主要能力
- 一句话构建应用：/ios-build "<需求>" 命令让 Claude Code 规划 iOS 应用，编写 SwiftUI 代码和 Xcode 工程，应用能力模块，并在模拟器中构建、运行和截图。
- 代码审查：为已有项目提供静态审查工具（属启发式规则，非编译器诊断）。
- 能力模块：每个能力是 capabilities/ 下的一个文件夹，包含 manifest、recipe、Swift 模板、apply hook 和 verify hook。目录包含 162 个条目、31 个分类。
- 工具集：已发布的 npm 2.10.1 包包含构建代理工具和 80 个统一工具，其中包括 7 个 Apple 系统集成工具和 9 个 Screenshot Studio 工具。
- 本地 Apple 文档：安装 Xcode 中的文档归档后，通过 Window → Developer Documentation 阅读，使用 xcrun mcpbridge 桥接，归档由 Xcode 管理。提供版本感知的文档检索，优先使用 Xcode MCP DocumentationSearch，其次为有界 SDK 证据。
- 模拟器工具：使用 xcode-mcp 工具发现 Xcode schema，使用 doctor xcode 诊断设置。
- 发布流程：ios-agent-mcp ship 准备截图集和元数据，然后提供单独批准的签名/归档和 TestFlight 上传步骤（在线签名分发尚未验证，npm 未更新）。
- 远程构建：GitHub 源码包含 build --remote，用于在 GitHub Actions 上进行未签名构建和模拟器截图，需要目标仓库、GitHub CLI 认证和固定工具链/Xcode 版本。
使用方式 安装已发布的服务器和 Claude Code 命令后，在装有 Xcode 16 或更高版本的 Mac 上，于任意 Claude Code 会话中使用。也可为 ChatGPT/Codex、Gemini CLI 或 Muse 设置连接。需 Node.js 20+；本地 iOS 构建需 macOS 和 Xcode；远程通道在 Actions 上运行。 可以直接创建 starter：--xcodegen 写出 project.yml，由 XcodeGen 转为工程。完整应用请使用 /ios-build。 可选命令：ios-agent-mcp environment 查看实际 Xcode/SDK/模拟器清单；ios-agent-mcp ai models 和 ai doctor 查看目录及账户/本地可用性。文本生成默认使用设备端 Apple 模型；云端提供商和回退需显式配置。 本地 Apple 文档需在 Xcode → Settings → Components → Developer Documentation 安装归档。
适用场景
- 从一句话描述快速搭建 iOS 应用原型（SwiftUI + Xcode 工程）。
- 对已有 iOS 项目进行聚焦代码审查。
- 为 AI 代理提供本地 Apple 框架参考资料和版本感知文档检索。
- 在模拟器中构建、运行、截图并收集验证证据。
- 通过能力模块快速集成登录、存储、支付、地图等功能。
限制
- 需要用户账户：代理在模拟器中无需账户即可构建和运行；需要服务的能力在 manifest 中声明密钥，客户端密钥放在项目的 gitignored .env 文件中，通过生成的 xcconfig 传入应用，未设置时为 REPLACE_ME 占位符。服务器密钥不会放入应用。在设备上运行、使用 TestFlight 或发布需要 Apple Developer Program 会员。
- 设计系统、firebase-auth、firebase-firestore、google-sign-in、stripe-payments、rive-animation 和 webview-animation 能力已通过隔离 Mac 编译验证；提供商账户和运行时交易尚未验证，组合编译检查不能替代各模块的 verify 运行。
- 代理的构建、模拟器启动和逐屏截图阶段在 Mac 上对四个已有示例运行过；原始规划和代码生成会话是分开的，全新的一句话端到端生成尚未在 Mac 上运行。
- 代理自身截图期间的点击和滚动，以及设备构建，尚未完成。在食品配送示例中，StoreKit 购买和 Live Activity 未被执行。
- 静态审查是启发式规则，不是编译器诊断。Apple 目录是参考地图，不是 Apple 专有框架源码，也不证明有 405 个可用集成。令牌节省未经基准测试。
- XcodeGen 是可选的：没有它，代理自行编写文件夹同步的 Xcode 工程。
- 配对基准测试工具包含 20 个 Swift 微任务；结果未发布，且尚未衡量完整应用构建。
- prepare_issue_report 允许 AI 在 iOS Agent 工具失败时准备本地报告，仅接受固定分类，显示预览和重复搜索链接，公开提交由用户完成，不收集应用源码或日志。private_feedback 为实验性工具，托管未配置，私有提交未上线。
- 项目聚焦四个客户端家族，其他客户端可提交支持请求，现有实验性适配器未积极维护。
- install.sh 是可选的，为选定的本地客户端安装源码指导，不是 MCP 服务器或浏览器插件。
- Apple 目录跟踪 99 项技术，覆盖 99，覆盖率 100%，但覆盖计数描述文档而非编译集成。下载计数每日刷新，不代表唯一用户。
- 许可证：MIT。
