用途：编写、校验、执行和诊断 Maestro 端到端测试，覆盖 iOS 模拟器（macOS 主机或 Maestro Cloud）、Android 模拟器/真机及 Web（Chromium，Beta）。负责声明式 YAML 流程编写、通过 MCP 执行单个动作、离线语法检查、本地与云端/SSH 执行、产物获取、失败诊断以及构建可复用测试套件。不负责构建应用二进制、Maestro Cloud 计费或后端测试夹具。
主要能力：YAML 流程与子流程、hooks、tags、参数化 env、平台条件步骤；MCP 服务器（maestro mcp）提供 list_devices、inspect_screen、take_screenshot、run、cheat_sheet、open_maestro_viewer、list_cloud_devices、run_on_cloud、get_cloud_run_status、describe_cloud_run 等工具；离线语法检查与 JUnit 报告、日志、失败截图等产物收集。
使用方式：安装 curl -fsSL "https://get.maestro.mobile.dev" | bash（需 java、unzip、curl），要求 Java 17+。校验命令 maestro check-syntax <file>；执行示例 maestro --device "$DEVICE_ID" test .maestro/smoke.yaml --test-output-dir artifacts --format JUNIT --output artifacts/report.xml。MCP 注册：claude mcp add maestro -- maestro mcp；codex mcp add maestro -- maestro mcp；gemini mcp add -s user maestro maestro mcp。
适用场景：iOS/Android/Web 回归流程、CI 套件、按需交互式探索并沉淀为永久测试。
限制：Linux 主机无法运行本地 iOS 模拟器，需 Maestro Cloud 或受控 Mac；Maestro 2.11.0 不支持物理 iPhone；不用于单元/组件测试、无回归需求的探索式浏览器、应用源码构建；多设备时须传 --device；每个流程文件（含子流程）需 appId: 或 url: 头部与 ---。具体版本敏感规则以实际 maestro --version 为准。