jpskill.com
🛠️ 開発・MCP コミュニティ 🔴 エンジニア向け 👤 エンジニア・AI開発者

🛠️ IosDebuggerエージェント

ios-debugger-agent

起動中のiPhoneやiPadの仮想環境（シミュレーター

⚡ ⏱ RAG構築 1週間 → 1日

📺 まず動画で見る(YouTube)

▶ 【衝撃】最強のAIエージェント「Claude Code」の最新機能・使い方・プログラミングをAIで効率化する超実践術を解説! ↗

※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。

📜 元の英語説明(参考)

Debug the current iOS project on a booted simulator with XcodeBuildMCP.

🇯🇵 日本人クリエイター向け解説

一言でいうと

起動中のiPhoneやiPadの仮想環境（シミュレーター

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o ios-debugger-agent.zip https://jpskill.com/download/3030.zip && unzip -o ios-debugger-agent.zip && rm ios-debugger-agent.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/3030.zip -OutFile "$d\ios-debugger-agent.zip"; Expand-Archive "$d\ios-debugger-agent.zip" -DestinationPath $d -Force; ri "$d\ios-debugger-agent.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して ios-debugger-agent.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → ios-debugger-agent フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-17
同梱ファイル
1

💬 こう話しかけるだけ — サンプルプロンプト

  • › Ios Debugger Agent を使って、最小構成のサンプルコードを示して
  • › Ios Debugger Agent の主な使い方と注意点を教えて
  • › Ios Debugger Agent を既存プロジェクトに組み込む方法を教えて

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

iOSデバッガーエージェント

概要

XcodeBuildMCPを使用して、起動中のiOSシミュレーターで現在のプロジェクトスキームをビルドおよび実行し、UIと対話し、ログをキャプチャします。シミュレーターの制御、ログ、およびビューの検査には、MCPツールを使用することを推奨します。

使用する場面

  • ユーザーがシミュレーターでiOSアプリを実行、デバッグ、または検査するよう求めた場合。
  • シミュレーターのUI操作、スクリーンショット、またはXcodeBuildMCPを介したランタイムログが必要な場合。

コアワークフロー

ユーザーがより限定的なアクションを要求しない限り、以下の順序に従ってください。

1) 起動中のシミュレーターを検出する

  • mcp__XcodeBuildMCP__list_simsを呼び出し、Booted状態のシミュレーターを選択します。
  • 起動中のシミュレーターがない場合は、ユーザーに起動を依頼します（要求されない限り自動で起動しないでください）。

2) セッションのデフォルトを設定する

  • mcp__XcodeBuildMCP__session-set-defaultsを以下の引数で呼び出します。
    • projectPathまたはworkspacePath（リポジトリが使用している方）
    • 現在のアプリのscheme
    • 起動中のデバイスのsimulatorId
    • オプション: configuration: "Debug", useLatestOS: true

3) ビルド + 実行（要求された場合）

  • mcp__XcodeBuildMCP__build_run_simを呼び出します。
  • ビルドが失敗した場合は、エラー出力を確認し、再試行するか（オプションでpreferXcodebuild: trueを使用）、UI操作を試みる前にユーザーにエスカレートしてください。
  • ビルドが成功した後は、UI操作に進む前にmcp__XcodeBuildMCP__describe_uiまたはmcp__XcodeBuildMCP__screenshotを呼び出してアプリが起動したことを確認してください。
  • アプリがすでにビルドされており、起動のみが要求された場合は、mcp__XcodeBuildMCP__launch_app_simを使用します。
  • バンドルIDが不明な場合:
    1. mcp__XcodeBuildMCP__get_sim_app_path
    2. mcp__XcodeBuildMCP__get_app_bundle_id

UI操作とデバッグ

実行中のアプリを検査または操作するよう求められた場合に使用します。

  • UIを記述する: タップまたはスワイプする前にmcp__XcodeBuildMCP__describe_uiを使用します。
  • タップ: mcp__XcodeBuildMCP__tap（idまたはlabelを推奨します。座標は必要な場合のみ使用してください）。
  • 入力: フィールドにフォーカスした後、mcp__XcodeBuildMCP__type_textを使用します。
  • ジェスチャー: 一般的なスクロールやエッジスワイプにはmcp__XcodeBuildMCP__gestureを使用します。
  • スクリーンショット: 視覚的な確認のためにmcp__XcodeBuildMCP__screenshotを使用します。

ログとコンソール出力

  • ログを開始する: アプリのバンドルIDを指定してmcp__XcodeBuildMCP__start_sim_log_capを使用します。
  • ログを停止する: mcp__XcodeBuildMCP__stop_sim_log_capを使用し、重要な行を要約します。
  • コンソール出力の場合、captureConsole: trueを設定し、必要に応じて再起動します。

トラブルシューティング

  • ビルドが失敗した場合、preferXcodebuild: trueで再試行するかどうかを尋ねます。
  • 間違ったアプリが起動した場合、スキームとバンドルIDを確認します。
  • UI要素がヒットできない場合、レイアウト変更後にdescribe_uiを再実行します。

制限事項

  • このスキルは、タスクが上記の範囲と明確に一致する場合にのみ使用してください。
  • 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
  • 必要な入力、権限、安全境界、または成功基準が不足している場合は、停止して説明を求めてください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

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.

When to Use

  • When the user asks to run, debug, or inspect an iOS app on a simulator.
  • When you need simulator UI interaction, screenshots, or runtime logs via XcodeBuildMCP.

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.

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.