ios-debugger-agent

iOS Debugger Agent 是一个围绕 XcodeBuildMCP 的智能体技能，用于在已启动的 iOS 模拟器上构建和运行当前项目 scheme，并与 UI 交互、捕获日志。

用途

适用于需要启动 iOS 应用、检查模拟器 UI 或日志、诊断运行时行为的场景。在执行这些操作时，优先使用 MCP 工具进行模拟器控制、日志获取和视图检查。

核心工作流

除非用户要求更窄的操作范围，否则按以下顺序执行：

1. 发现已启动的模拟器：调用 mcp__XcodeBuildMCP__list_sims，选择状态为 Booted 的模拟器。如果没有已启动的模拟器，请让用户启动一个（除非用户要求，否则不要自动启动）。

2. 设置会话默认值：调用 mcp__XcodeBuildMCP__session-set-defaults，设置 projectPath 或 workspacePath（取决于仓库使用哪种）、当前应用的 scheme、来自已启动设备的 simulatorId。可选：configuration: "Debug"、useLatestOS: true。

3. 构建并运行（在被请求时）：调用 mcp__XcodeBuildMCP__build_run_sim。如果构建失败，检查错误输出并重试（可选使用 preferXcodebuild: true），或在尝试任何 UI 交互之前上报给用户。构建成功后，先调用 mcp__XcodeBuildMCP__describe_ui 或 mcp__XcodeBuildMCP__screenshot 验证应用已启动，再继续 UI 交互。如果应用已经构建且仅被请求启动，则使用 mcp__XcodeBuildMCP__launch_app_sim。如果 bundle id 未知，可调用 mcp__XcodeBuildMCP__get_sim_app_path 和 mcp__XcodeBuildMCP__get_app_bundle_id。

UI 交互与调试

当被要求检查或与正在运行的应用交互时使用以下工具：

描述 UI：在点击或滑动之前调用 mcp__XcodeBuildMCP__describe_ui。

点击：mcp__XcodeBuildMCP__tap（优先使用 id 或 label；仅在必要时使用坐标）。

输入：在聚焦字段后调用 mcp__XcodeBuildMCP__type_text。

手势：使用 mcp__XcodeBuildMCP__gesture 执行常见滚动和边缘滑动。

截图：使用 mcp__XcodeBuildMCP__screenshot 进行视觉确认。

日志与控制台输出

开始日志：使用应用 bundle id 调用 mcp__XcodeBuildMCP__start_sim_log_cap。

停止日志：调用 mcp__XcodeBuildMCP__stop_sim_log_cap 并汇总重要行。

对于控制台输出，设置 captureConsole: true，并在需要时重新启动。

故障排除

如果构建失败，询问是否使用 preferXcodebuild: true 重试。

如果启动了错误的应用，确认 scheme 和 bundle id。

如果 UI 元素无法命中，在布局变化后重新运行 describe_ui。

适用场景与限制

该技能面向 iOS 模拟器环境，依赖 XcodeBuildMCP 提供的 MCP 工具集。资料未提供具体的收费、价格、平台支持范围或效果数据。使用时需注意模拟器需已启动，且构建失败时应先处理错误再继续 UI 交互。