name: xcodebuildmcp
description: 当用户需要通过 XcodeBuildMCP 工具进行 Xcode 构建/测试/运行工作流、模拟器或设备控制、UI 自动化、截图/录屏、日志收集或 LLDB 调试时使用。包括发现项目/方案、设置会话默认值以及常见的模拟器/设备工作流。

Xcodebuildmcp

概述

使用 xcodebuildmcp 工具集来构建/运行/测试应用程序，管理模拟器/设备，自动化 UI 操作，以及捕获日志和屏幕媒体。默认采用安全、可重复的流程：发现 → 设置默认值 → 执行 → 验证。

前提条件与 MCP 设置

本技能假设 XcodeBuildMCP 服务器已安装并暴露给您的 MCP 客户端，以便相关工具可用（例如 mcp__xcodebuildmcp__build_run_sim）。如果缺少这些工具，请按照以下文档中的设置步骤操作：

• references/mcp-setup.md（包含要求及 MCP 客户端配置示例）

请求示例

• “在最新的模拟器上构建并运行 iOS 应用，并截图。”
• “在模拟器上运行单元测试，并分享失败的测试日志。”
• “打开模拟器，导航到设置，并切换深色模式。”
• “在我的已连接 iPhone 上安装并启动应用。”

快速开始（通用流程）

1) 发现项目/工作区及方案：
- mcp__xcodebuildmcp__discover_projs
- mcp__xcodebuildmcp__list_schemes

2) 设置会话默认值（以便后续工具无需重复参数）：
- mcp__xcodebuildmcp__session-set-defaults（workspacePath/projectPath, scheme, simulatorId/deviceId）

3) 执行任务：
- 构建/运行：mcp__xcodebuildmcp__build_run_sim 或 mcp__xcodebuildmcp__build_run_macos
- 测试：mcp__xcodebuildmcp__test_sim / mcp__xcodebuildmcp__test_macos / mcp__xcodebuildmcp__test_device

4) 验证并收集证据：
- mcp__xcodebuildmcp__screenshot（模拟器）
- mcp__xcodebuildmcp__start_sim_log_cap → mcp__xcodebuildmcp__stop_sim_log_cap

任务索引

• 构建/运行：iOS 模拟器、macOS、设备安装
• 测试：模拟器/macOS/设备
• 模拟器管理：列出/启动/擦除/外观/位置/手势
• UI 自动化：描述 UI → 点击/输入/滑动/手势
• 日志与调试：模拟器日志、设备日志、LLDB 附加/断点
• 媒体：截图、屏幕录制

加载 references/workflows.md 以获取详细的逐步操作序列和命令模式。

操作规则

• 在执行基于坐标的点击/滑动/长按操作前，务必先调用 mcp__xcodebuildmcp__describe_ui。
• 尽早使用 mcp__xcodebuildmcp__session-set-defaults 以减少参数冗余。
• 如果用户未指定目标设备/模拟器，请列出选项并询问（或使用 useLatestOS 选择一个合理的默认值）。
• 除非用户明确要求，否则避免执行破坏性操作（如擦除模拟器、清理）。