iOS调试器代理：自动化模拟器构建、UI交互与日志捕获工具

ios-debugger-agent by dishaanand/focusnest

1 周安装量

GitHub

安装命令

npx skills add https://github.com/dishaanand/focusnest --skill ios-debugger-agent

iOS 自动化调试

🇨🇳中文介绍

iOS 调试器代理

概述

使用 XcodeBuildMCP 在已启动的 iOS 模拟器上构建并运行当前项目方案，与 UI 交互，并捕获日志。对于模拟器控制、日志和视图检查，优先使用 MCP 工具。

核心工作流程

除非用户要求执行更具体的操作，否则请遵循此顺序。

1) 发现已启动的模拟器

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

2) 设置会话默认值

使用以下参数调用 mcp__XcodeBuildMCP__session-set-defaults：
- projectPath 或 workspacePath（取决于仓库使用的是哪个）
- 当前应用的 scheme
- 来自已启动设备的 simulatorId
- 可选：,

🇺🇸English

iOS Debugger Agent

Overview

Use XcodeBuildMCP to build and run the current project scheme on a booted iOS simulator, interact with the UI, and capture logs. Prefer the MCP tools for simulator control, logs, and view inspection.

Core Workflow

Follow this sequence unless the user asks for a narrower action.

1) Discover the booted simulator

Call mcp__XcodeBuildMCP__list_sims and select the simulator with state Booted.
If none are booted, ask the user to boot one (do not boot automatically unless asked).

2) Set session defaults

Call mcp__XcodeBuildMCP__session-set-defaults with:
- projectPath or workspacePath (whichever the repo uses)
- scheme for the current app

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

3) 构建 + 运行（当被请求时）

调用 mcp__XcodeBuildMCP__build_run_sim。
如果应用已构建，仅请求启动，则使用 mcp__XcodeBuildMCP__launch_app_sim。
如果 bundle id 未知：
1. mcp__XcodeBuildMCP__get_sim_app_path
2. mcp__XcodeBuildMCP__get_app_bundle_id

当被要求检查或与正在运行的应用交互时，请使用这些工具。

描述 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 重试。
如果启动了错误的应用，请确认方案和 bundle id。
如果 UI 元素无法点击，请在布局更改后重新运行 describe_ui。

simulatorId from the booted device

Optional: configuration: "Debug", useLatestOS: true

3) Build + run (when requested)

Call mcp__XcodeBuildMCP__build_run_sim.
If the app is already built and only launch is requested, use mcp__XcodeBuildMCP__launch_app_sim.
If bundle id is unknown:
1. mcp__XcodeBuildMCP__get_sim_app_path
2. mcp__XcodeBuildMCP__get_app_bundle_id

UI Interaction & Debugging

Use these when asked to inspect or interact with the running app.

Describe UI : mcp__XcodeBuildMCP__describe_ui before tapping or swiping.
Tap : mcp__XcodeBuildMCP__tap (prefer id or label; use coordinates only if needed).
Type : mcp__XcodeBuildMCP__type_text after focusing a field.
Gestures : mcp__XcodeBuildMCP__gesture for common scrolls and edge swipes.
Screenshot : mcp__XcodeBuildMCP__screenshot for visual confirmation.

Logs & Console Output

Start logs: mcp__XcodeBuildMCP__start_sim_log_cap with the app bundle id.
Stop logs: mcp__XcodeBuildMCP__stop_sim_log_cap and summarize important lines.
For console output, set captureConsole: true and relaunch if required.

If build fails, ask whether to retry with preferXcodebuild: true.
If the wrong app launches, confirm the scheme and bundle id.
If UI elements are not hittable, re-run describe_ui after layout changes.

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

31,600 周安装