利用 AI 智能 Agent 自动化调试 iOS 模拟器应用 #

解决 iOS 开发中频繁手动操作模拟器的低效问题：通过 XcodeBuildMCP 插件，让 AI 能够自动执行构建、启动应用、操作 UI 界面并分析运行日志。

为什么需要这个技能 #

在传统的 iOS 开发流程中，开发者需要频繁在 Xcode 和模拟器之间切换：点击 Build $\to$ 等待启动 $\to$ 手动点击界面 $\to$ 观察控制台日志。当需要复现某个 UI Bug 或验证小范围修改时，这种重复劳动非常枯燥。

本技能将这些操作原子化，允许 AI 直接接管模拟器。AI 可以通过 describe_ui 像人类一样“看见”界面，通过 tap 和 type 进行交互，并实时截屏或捕获日志，将原本手动重复的调试过程转变为简单的对话指令。

适用场景 #

• 快速验证修改：修改代码后，让 AI 自动重新构建并运行，验证特定功能点。
• 自动化 UI 探索：让 AI 尝试在模拟器中执行一系列操作路径，以检查界面跳转是否正常。
• 远程/自动化 Bug 复现：通过描述步骤，让 AI 自动在模拟器中操作并截屏，捕捉崩溃现场。
• 运行日志分析：自动启动日志捕获，并在应用崩溃或报错时快速总结关键堆栈信息。

核心工作流 #

1. 设备发现与初始化：

   • 调用 mcp__XcodeBuildMCP__list_sims 寻找状态为 Booted 的模拟器。
   • 使用 mcp__XcodeBuildMCP__session-set-defaults 配置项目路径、Scheme 和模拟器 ID。

2. 构建与运行：

   • 执行 mcp__XcodeBuildMCP__build_run_sim。若构建失败，AI 会分析错误并尝试使用 preferXcodebuild: true 重新构建。
   • 通过 mcp__XcodeBuildMCP__describe_ui 或截屏确认 App 已成功启动。

3. UI 交互与调试：

   • 观察：调用 describe_ui 获取当前页面的元素 ID 和标签。
   • 操作：使用 tap 点击元素，type_text 输入文本，或通过 gesture 执行滑动操作。
   • 验证：通过 screenshot 确认操作结果。

4. 日志采集：

   • 使用 mcp__XcodeBuildMCP__start_sim_log_cap 启动日志捕获，在操作完成后停止并总结关键日志行。

下载和安装 #

下载 ios-debugger-agent 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要 #

暂无推荐