内容
<p align="center">
<img src="assets/build-ios-apps-small.svg" width="96" alt="构建 iOS 应用">
</p>
# 构建 iOS 应用 — Claude Code 插件
使用 Claude Code 构建、完善和调试 iOS 应用：设计 **应用意图** 和应用快捷方式，构建和重构 **SwiftUI** UI，采用 **iOS 26 液体玻璃**，审计运行时性能，捕获 **ETTrace** 配置文件，调查 **内存泄漏**，并通过 XcodeBuildMCP 驱动 **iOS 模拟器**。
> 从 OpenAI 的 [`build-ios-apps`](https://github.com/openai/plugins/tree/main/plugins/build-ios-apps) Codex 插件（MIT）移植到 Claude Code。参见 [致谢](#attribution)。
## 技能
| 技能 | 功能描述 |
| --- | --- |
| `ios-app-intents` | 设计和实现应用意图、应用实体和应用快捷方式，用于快捷方式、Siri、Spotlight、部件和控件。 |
| `ios-debugger-agent` | 通过 XcodeBuildMCP 在启动的模拟器上构建、运行、启动和调试当前项目 — UI 自动化、屏幕状态、日志和截图。 |
| `ios-ettrace-performance` | 捕获和解释单个流程的符号化 ETTrace 启动/运行时火焰图。 |
| `ios-memgraph-leaks` | 使用苹果的 `leaks`/memgraph 工具捕获、比较和查找内存图泄漏，并提供前后证据。 |
| `swiftui-liquid-glass` | 使用 iOS 26+ 液体玻璃 API 实现、重构或审查 SwiftUI。 |
| `swiftui-performance-audit` | 从代码审查和架构中审计 SwiftUI 运行时性能，并指导用户运行 Instruments 配置文件。 |
| `swiftui-ui-patterns` | 示例驱动的 SwiftUI 模式：导航、布局、列表、表格、网格、搜索等。 |
| `swiftui-view-refactor` | 将 SwiftUI 视图重构为小型专用子视图、MV-over-MVVM 数据流和正确的观察用法。 |
Claude 在请求匹配时自动调用技能，或您可以显式调用技能 — 插件技能按插件名称命名，例如 `/build-ios-apps:ios-debugger-agent`。
## 要求
- **带有 Xcode 的 macOS** 和至少一个 iOS 模拟器运行时。液体玻璃技能针对 **iOS 26+**。
- **Node.js / `npx`** — 捆绑的 MCP 服务器使用 `npx -y xcodebuildmcp@latest` 启动。
- 按需安装的每个技能命令行工具：
- `ios-ettrace-performance` — [`ettrace`](https://github.com/EmergeTools/ETTrace)：`brew install emergetools/homebrew-tap/ettrace`。
- `ios-memgraph-leaks` — 苹果的 `leaks`（包含在 Xcode 命令行工具中）。
## 安装
```sh
/plugin marketplace add spokvulcan/claude-code-build-ios-apps
/plugin install build-ios-apps@spokvulcan-plugins
```
对于没有市场的功能本地开发，请将 Claude Code 指向一个checkout：
```sh
claude --plugin-dir /path/to/claude-code-build-ios-apps
```
## 捆绑的 MCP 服务器
插件附带一个 `.mcp.json` 文件，启动 **XcodeBuildMCP**（[`xcodebuildmcp`](https://www.npmjs.com/package/xcodebuildmcp) npm 包），启用 `simulator,ui-automation,debugging,logging` 工作流。当插件启用时，它会自动启动，`ios-debugger-agent` 技能驱动它。不需要全局安装 — `npx`会在首次运行时获取它。
## 致谢
本仓库中的技能、参考文档和脚本来自 OpenAI 的
[`build-ios-apps`](https://github.com/openai/plugins/tree/main/plugins/build-ios-apps)
Codex 插件（MIT）。本仓库将该插件适配到 Claude Code 插件格式：`.claude-plugin/` 清单和市场、捆绑的 MCP 配置，以及将帮助脚本路径重连接到 `${CLAUDE_PLUGIN_ROOT}`。原始的 Codex-only 表面元数据（`.codex-plugin/`、`agents/openai.yaml`）未包含。
## 许可证
[MIT](LICENSE) — 原始作品 © OpenAI；Claude Code 移植 © spokvulcan。
