用途
test-xcode 是一个 iOS QA 测试命令，专门用于在模拟器上构建、安装和测试 iOS 应用。它基于 XcodeBuildMCP 工具集运行，目标是捕获截图、日志并验证应用行为。
主要能力
- 检查 XcodeBuildMCP 是否已安装并可用。
- 发现可用的 Xcode 项目与 scheme。
- 列出并启动模拟器（推荐 iPhone 15 Pro）。
- 为 iOS 模拟器构建应用，并在构建失败时捕获错误、创建 P1 待办并报告具体错误。
- 将应用安装到模拟器并启动，同时开始捕获日志。
- 对每个关键界面截图，检查 UI 元素渲染、错误信息、内容显示和布局，并检查日志中的崩溃、异常、错误级日志和失败的网络请求。
- 在涉及外部流程时暂停并请求人工验证，包括 Sign in with Apple、推送通知、应用内购买、相机/照片、定位等。
- 处理测试失败：记录失败（截图、日志、复现步骤），并让用户选择立即修复、创建待办或跳过。
- 输出测试汇总，包含项目、scheme、模拟器、构建状态、已测界面表格、控制台错误、人工验证、失败项、创建的待办和最终结果（PASS / FAIL / PARTIAL）。
- 测试结束后停止日志捕获，并可选关闭模拟器。
使用方式
首先需确认 XcodeBuildMCP 已安装。若未安装，需先添加该 MCP 服务器：
claude mcp add XcodeBuildMCP -- npx xcodebuildmcp@latest
然后重启 Claude Code 并再次运行 /xcode-test。在 XcodeBuildMCP 确认可用之前不应继续。
命令用法示例：
# 使用默认 scheme 测试
/xcode-test
# 测试指定 scheme
/xcode-test MyApp-Debug
# 在修改后测试
/xcode-test current
执行流程依次为：验证 XcodeBuildMCP 安装、发现项目与 scheme、启动模拟器、构建应用、安装并启动、测试关键界面、按需人工验证、处理失败、输出测试汇总、清理。
适用场景
- 在模拟器上对 iOS/macOS 应用进行基于模拟器的 QA 测试。
- 在代码变更后快速验证应用能否构建、启动并正常显示关键界面。
- 审查涉及 iOS 代码的 PR 时，可由
/workflows:review命令将其作为子代理调用，例如：
Task general-purpose("Run /xcode-test for scheme [name]. Build, install on simulator, test key screens, check for crashes.")
限制
- 依赖 XcodeBuildMCP，未安装时无法运行。
- 涉及 Sign in with Apple、推送通知、应用内购买、相机/照片、定位等外部流程时需要人工介入验证。
- 资料未提供其他平台支持、收费或价格信息。