ios-debugger-agent — скилл для Codex: сборка и отладка iOS-приложений
Скилл для Codex, который собирает и запускает iOS-приложение на симуляторе через XcodeBuildMCP, а потом даёт агенту потыкать в интерфейс и почитать логи.
npx skills add openai/plugins --skill ios-debugger-agent -a codexЧто делает ios-debugger-agent
Скилл описывает порядок работы с симулятором через инструменты XcodeBuildMCP. Сначала агент ищет загруженный симулятор вызовом mcp__XcodeBuildMCP__list_sims и берёт тот, у которого состояние Booted. Если загруженных нет, скилл велит спросить вас, а не поднимать симулятор самому.
Дальше задаются параметры сессии: projectPath или workspacePath, схема приложения и simulatorId. Сборка и запуск идут через mcp__XcodeBuildMCP__build_run_sim. После успешной сборки агент проверяет, что приложение действительно открылось, через describe_ui или screenshot. Если сборка упала, скилл предлагает повторить с preferXcodebuild: true или вернуть вопрос вам.
Для работы с интерфейсом есть tap, type_text, gesture и screenshot. Логи снимаются парой start_sim_log_cap и stop_sim_log_cap по bundle id приложения. Нужен установленный XcodeBuildMCP и загруженный симулятор. Скилл стоит ставить, если вы гоняете iOS-сборки из Codex и хотите, чтобы агент сам проверял результат в симуляторе, а не только компилировал код.
Какие задачи решает
- собрать и запустить схему проекта на загруженном симуляторе
- посмотреть, что реально на экране, через скриншот или describe_ui
- нажать на элемент по id или label вместо координат
- снять логи приложения и вычленить из них важные строки
- разобраться, почему после сборки открылось не то приложение
Примеры запросов агенту
- Собери и запусти текущую схему на загруженном симуляторе
- Посмотри UI запущенного приложения и нажми на кнопку логина
- Включи захват логов и покажи, что падает при старте
Как установить ios-debugger-agent
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill ios-debugger-agent -a codex2Вручную: положить файлы
.agents/skills/ios-debugger-agent/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill ios-debugger-agent -a claude-code2Вручную: положить файлы
~/.claude/skills/ios-debugger-agent/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ios-debugger-agent/
Вручную: положить файлы
.cursor/skills/ios-debugger-agent/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins ios-debugger-agent2Вручную: положить файлы
.github/skills/ios-debugger-agent/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/build-ios-apps/skills/ios-debugger-agentВручную: положить файлы
.devin/skills/ios-debugger-agent/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора201
Весь набор →Похожие
Вопросы о ios-debugger-agent
Как установить ios-debugger-agent в Claude?
Выполните npx skills add openai/plugins --skill ios-debugger-agent -a codex. Файл скилла окажется в .agents/skills/ios-debugger-agent/SKILL.md.
Что делает ios-debugger-agent?
Задаёт агенту порядок сборки и запуска iOS-приложения на симуляторе через XcodeBuildMCP, а также работу с UI и логами.
Что нужно для работы скилла?
XcodeBuildMCP и загруженный симулятор. Если ни один не загружен, скилл просит поднять его вручную.
Исходный текст
SKILL.md · MIT
--- name: ios-debugger-agent description: Build, run, and debug iOS apps on Simulator with XcodeBuildMCP. Use when launching an app, inspecting simulator UI or logs, or diagnosing runtime behavior. --- # 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 - `simulatorId` from the booted device - Optional: `configuration: "Debug"`, `useLatestOS: true` ### 3) Build + run (when requested) - Call `mcp__XcodeBuildMCP__build_run_sim`. - **If the build fails**, check the error output and retry (optionally with `preferXcodebuild: true`) or escalate to the user before attempting any UI interaction. - **After a successful build**, verify the app launched by calling `mcp__XcodeBuildMCP__describe_ui` or `mcp__XcodeBuildMCP__screenshot` before proceeding to UI interaction. - 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. ## Troubleshooting - 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.
© OpenAI · MIT · openai/plugins
