iOS/Swift/Xcode ビルド・テスト・実行コマンド群 - SPMパッケージ構成のiOSアプリ開発をサポート
- version
- 2.0.0
- GitHub stars
- 5
Install
/plugin install ios-dev@no-problem-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add no-problem-dev/claude-code-plugins.
Contents
Discovered from sourceSkills 5
iOS 開発ワークフロー(v3.0 — XcodeBuildMCP + サブエージェント隔離)
XcodeBuildMCP の MCP ツールをフォアグラウンドサブエージェント経由で呼び出し、 ビルドログ等のコンテキスト消費をサブエージェント内に隔離する。
設計原則
- XcodeBuildMCP 必須 — CLI フォールバックなし。未設定時はエラー返却
- フォアグラウンドサブエージェント — MCP ツールにアクセス可能。バックグラウンドは不可
- コンテキスト隔離 — ビルドログ・テストログはサブエージェント内で消費、親にはサマリーのみ
- 結果駆動 — 途中の推論は不要。成功/失敗 + エラー詳細のみが価値
- セッションキャッシュ — scheme/simulator は初回で確定し、以降は prompt 経由で渡す
プロジェクトコンテキストのキャッシュ戦略
毎回のスキーム・シミュレータ検出を避けるため、2層のキャッシュを活用する:
層 1: XcodeBuildMCP セッションデフォルト(MCP サーバー内)
session_set_defaults で設定された scheme/simulator/workspace は、
同一 MCP セッション内の全ツール呼び出しで自動適用される。
サブエージェントも同じ MCP サーバーを共有するため、一度設定すれば全サブエージェントで有効。
層 2: オーケストレーターの prompt 引き渡し(確実な引き継ぎ)
初回のビルド/テストで判明した scheme/simulator をメインコンテキストで記憶し、
以降のサブエージェント起動時に prompt に含める。
サブエージェントは prompt に scheme が含まれていれば、
session_show_defaults すら呼ばずに即実行できる。
初回フロー(プロジェクトコンテキスト未確定時)
1. xbm-project-setup を起動
→ プロジェクト検出 + session_set_defaults + 結果返却
2. 返却された scheme/simulator をメインコンテキストで記憶
3. 以降のサブエージェント起動時に prompt に含める
2回目以降のフロー(高速パス)
1. メインコンテキストで記憶済みの scheme/simulator を prompt に含めて起動
→ サブエージェントは discover/list をスキップして即実行
サブエージェント一覧
| エージェント | 責務 | 使いどころ |
|---|---|---|
| xbm-build | ビルド実行 & エラー報告 | 「ビルドして」「コンパイルして」 |
| xbm-test | テスト実行 & 結果報告 | 「テストして」「テスト走らせて」 |
| xbm-run | ビルド & シミュレータ実行 & スクショ | 「実行して」「動かして」「見せて」 |
| xbm-project-setup | プロジェクト検出 & セッション設定 | 初回 / 「スキーム教えて」 |
| xbm-ui-verify | UI 検証(スクショ + ビュー階層 + 操作) | 「画面確認して」「ボタン押して」 |
タスク判定 → サブエージェント振り分け
ビルド要求
- キーワード: build, compile, ビルド, コンパイル
- → xbm-build をフォアグラウンドで起動
Agent(
subagent_type: "ios-dev:xbm-build",
prompt: "ビルドしてください。\nプロジェクトパス: /path/to/project\nスキーム: MyApp\nシミュレータ: iPhone 16 Pro"
)
重要: scheme/simulator が判明済みなら必ず prompt に含める。 未確定の場合は「スキーム: 自動検出」とし、サブエージェントに検出を任せる。
テスト要求
- キーワード: test, テスト, XCTest
- → xbm-test をフォアグラウンドで起動
Agent(
subagent_type: "ios-dev:xbm-test",
prompt: "テストを実行してください。\nプロジェクトパス: /path/to/project\nスキーム: MyApp\n対象テスト: 全テスト"
)
ビルド & 実行要求
- キーワード: run, 実行, 動かして, launch
- → xbm-run をフォアグラウンドで起動
Agent(
subagent_type: "ios-dev:xbm-run",
prompt: "ビルドしてシミュレータで実行してください。\nプロジェクトパス: /path/to/project\nスキーム: MyApp\nスクリーンショット: yes"
)
プロジェクト情報要求 / 初回セットアップ
- キーワード: scheme, スキーム, simulator, プロジェクト構成
- または初回のビルド/テスト要求時に scheme が未確定の場合
- → xbm-project-setup をフォアグラウンドで起動
Agent(
subagent_type: "ios-dev:xbm-project-setup",
prompt: "プロジェクトを検出し、セッションデフォルトを設定してください。\nプロジェクトパス: /path/to/project"
)
xbm-project-setup の結果から scheme/simulator を記憶し、以降の prompt に含める。
UI 検証要求
- キーワード: 画面確認, スクショ, screenshot, UI 確認, タップ
- → xbm-ui-verify をフォアグラウンドで起動
コード変更後の自動フィードバックループ
1. コード変更完了
↓
2. xbm-build(scheme を prompt で渡す → 即ビルド)
↓ 成功
3. xbm-test(scheme を prompt で渡す → 即テスト)
↓ 全パス
4. 完了報告
↓ 失敗
5. エラー分析 → コード修正 → Step 2 に戻る
2回目以降のループでは scheme/simulator が確定済みなので、 各サブエージェントは discover/list をスキップして即実行する。
他のスキルとの関係
| スキル | 用途 | このワークフローとの関係 |
|---|---|---|
| ios-diagnostics | エラー・警告の簡易チェック | xbm-build を使用 |
| ios-preview-repl | SwiftUI プレビュー・REPL・Apple ドキュメント | Xcode ネイティブ MCP(別系統) |
| ios-project-info | プロジェクト情報表示 | xbm-project-setup に委譲 |
| ios-maintenance | クリーン・シミュレータ管理 | XcodeBuildMCP の clean / sim 管理ツール使用 |
XcodeBuildMCP セットアップ
未設定の場合、サブエージェントがエラーを返す。以下を案内:
# インストール
brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp
# Claude Code に MCP サーバーとして登録
claude mcp add XcodeBuildMCP -- xcodebuildmcp mcp
関連プラグイン
- ios-architecture: iOS クリーンアーキテクチャの設計原則
- swift-design-system: Swift Design System を使った UI 実装
iOS 診断(XcodeBuildMCP)
プロジェクトのエラー・警告を検出するための軽量診断。
方式
xbm-build サブエージェントを使用してビルドを実行し、エラー・警告を検出する。 ビルドログはサブエージェント内で消費され、構造化された診断結果のみが返却される。
ワークフロー
エラー・警告チェック
xbm-build をフォアグラウンドで起動:
Agent(
subagent_type: "ios-dev:xbm-build",
prompt: "以下のプロジェクトをビルドし、エラーと警告を報告してください。\n警告も詳細に報告してください。\nプロジェクトパス: <path>"
)
結果の解釈
- エラーあり → コード修正を提案
- 警告のみ → 重要度を判定し、修正すべきものを提案
- 問題なし → 「診断結果: 問題なし」と報告
iOS メンテナンス(XcodeBuildMCP)
ビルドキャッシュのクリアとシミュレータの管理。 軽量操作のためメインコンテキストで直接 MCP ツールを呼び出す。
ビルドクリーン
XcodeBuildMCP でクリーン
ToolSearch("select:mcp__XcodeBuildMCP__clean")
clean(scheme: "<scheme>")
DerivedData 削除(XcodeBuildMCP 外)
XcodeBuildMCP では DerivedData 直接削除は未サポート。Bash で実行:
# プロジェクト固有
ls ~/Library/Developer/Xcode/DerivedData/ | grep "<ProjectName>"
rm -rf ~/Library/Developer/Xcode/DerivedData/<ProjectName>-*
# 全削除(確認後のみ)
rm -rf ~/Library/Developer/Xcode/DerivedData
シミュレータ管理
シミュレータ一覧
ToolSearch("select:mcp__XcodeBuildMCP__list_sims")
list_sims()
シミュレータ起動
ToolSearch("select:mcp__XcodeBuildMCP__boot_sim,mcp__XcodeBuildMCP__open_sim")
boot_sim(simulator_name: "iPhone 16 Pro")
open_sim()
シミュレータリセット
ToolSearch("select:mcp__XcodeBuildMCP__erase_sims")
erase_sims(simulator_name: "iPhone 16 Pro")
注意事項
rm -rf系のコマンドは実行前にユーザーに確認すること- DerivedData 全削除は他プロジェクトにも影響する
- シミュレータリセットはアプリデータが全て消える
- simulator-management ワークフローの有効化が必要な操作がある
SwiftUI プレビュー・REPL・ドキュメント(Xcode ネイティブ MCP)
Xcode ネイティブ MCP サーバー(xcrun mcpbridge)経由でのみ利用可能な機能群。
XcodeBuildMCP では提供されない機能のため、別系統として維持。
前提
Xcode ネイティブ MCP が登録済みであること:
claude mcp add xcode -- xcrun mcpbridge
機能
1. SwiftUI プレビュー描画
ToolSearch("select:mcp__xcode__RenderPreview")
RenderPreview(filePath: "/path/to/ContentView.swift", previewName: "ContentView")
2. Swift REPL 実行
ToolSearch("select:mcp__xcode__ExecuteSnippet")
ExecuteSnippet(code: "let x = 42\nprint(x * 2)")
3. Apple ドキュメント検索
ToolSearch("select:mcp__xcode__DocumentationSearch")
DocumentationSearch(query: "URLSession async")
MCP 未設定時
「Xcode ネイティブ MCP が利用できません」と通知し、セットアップ手順を案内:
- Xcode 26.3 以降がインストールされていることを確認
- Xcode を起動してプロジェクトを開く
claude mcp add xcode -- xcrun mcpbridge- Claude Code を再起動
XcodeBuildMCP との関係
| 機能 | XcodeBuildMCP | Xcode ネイティブ MCP |
|---|---|---|
| SwiftUI プレビュー | - | RenderPreview |
| REPL 実行 | - | ExecuteSnippet |
| ドキュメント検索 | - | DocumentationSearch |
| ビルド / テスト | build_sim / test_sim | - (ios-dev-workflow で使用) |
iOS プロジェクト情報(XcodeBuildMCP)
プロジェクトの構成情報を XcodeBuildMCP 経由で取得する。
方式
xbm-project-setup サブエージェントに委譲し、コンテキストを隔離する。
ワークフロー
プロジェクト情報取得
Agent(
subagent_type: "ios-dev:xbm-project-setup",
prompt: "以下のプロジェクトの情報を取得してください。\nプロジェクトパス: <path>\n取得内容: <schemes / simulators / build settings / bundle id / all>"
)
セッションデフォルト設定
開発セッションの開始時にデフォルトを設定し、以降のビルド・テストでパラメータ省略を可能にする:
Agent(
subagent_type: "ios-dev:xbm-project-setup",
prompt: "以下のプロジェクトのセッションデフォルトを設定してください。\nプロジェクトパス: <path>\nスキーム: <scheme>\nシミュレータ: <name>"
)
Agents 5
iOS ビルドエージェント(XcodeBuildMCP)
XcodeBuildMCP の MCP ツールでビルドを実行し、結果サマリーのみを親に返却する。
前提
- XcodeBuildMCP が MCP サーバーとして登録済みであること
- フォアグラウンドサブエージェントとして実行されること(MCP アクセスに必要)
ワークフロー
Step 1: MCP ツール検出
ToolSearch("select:mcp__XcodeBuildMCP__build_sim,mcp__XcodeBuildMCP__session_show_defaults")
ツールが見つからない場合、以下を返却して即終了:
## Error: XcodeBuildMCP 未設定
XcodeBuildMCP が MCP サーバーとして登録されていません。
セットアップ: `claude mcp add XcodeBuildMCP -- xcodebuildmcp mcp`
Step 2: ビルドコンテキスト解決(高速パス優先)
以下の優先順位で scheme を決定する。上位で確定したら下位はスキップ:
- prompt で scheme が指定されている → そのまま使用(即 Step 3 へ)
session_show_defaultsを呼び出し → scheme が設定済みなら使用(即 Step 3 へ)- 上記いずれもない場合のみ →
discover_projs+list_schemesでフル検出
ToolSearch("select:mcp__XcodeBuildMCP__discover_projs,mcp__XcodeBuildMCP__list_schemes")
discover_projs(workspace_root: "<project path>")
list_schemes(...)
→ アプリスキーム(Tests / UI Tests 接尾辞でないもの)を選択
Step 3: ビルド実行
iOS プロジェクト:
build_sim(scheme: "<scheme>")
- simulator / workspace 等はセッションデフォルトで自動解決される
Swift パッケージ:
ToolSearch("select:mcp__XcodeBuildMCP__swift_package_build")
swift_package_build(...)
Step 4: 結果返却
成功時:
## Build Succeeded
- Project: <name>
- Scheme: <scheme>
- Duration: <time>
- Warnings: <count>
失敗時:
## Build Failed
- Project: <name>
- Scheme: <scheme>
### Errors
<file>:<line>:<col>: <message>
### Fix Suggestions
<error analysis based on structured error data>
ルール
- フルビルドログは絶対に出力しない — エラーとサマリーのみ
- エラーはファイルパス・行番号付きで構造化
- 警告は件数のみ(詳細は求められた場合のみ)
- scheme が prompt またはセッションデフォルトで判明済みなら discover/list をスキップ
- XcodeBuildMCP 未設定時はエラーで即終了 — CLI フォールバックしない
- ファイルの編集・作成は行わない — ビルド実行と結果報告のみ
iOS プロジェクトセットアップエージェント(XcodeBuildMCP)
プロジェクトの検出、スキーム一覧、ビルド設定、シミュレータ一覧を取得し、 セッションデフォルトを設定する。以降のビルド・テストエージェントは discover/list をスキップして即実行できるようになる。
前提
- XcodeBuildMCP が MCP サーバーとして登録済みであること
- フォアグラウンドサブエージェントとして実行されること
ワークフロー
Step 1: MCP ツール検出
ToolSearch("select:mcp__XcodeBuildMCP__discover_projs,mcp__XcodeBuildMCP__list_schemes")
ToolSearch("select:mcp__XcodeBuildMCP__session_set_defaults,mcp__XcodeBuildMCP__session_show_defaults")
ToolSearch("select:mcp__XcodeBuildMCP__show_build_settings,mcp__XcodeBuildMCP__list_sims")
ToolSearch("select:mcp__XcodeBuildMCP__get_app_bundle_id")
ツールが見つからない場合 → エラー返却して即終了。
Step 2: 既存セッション確認
session_show_defaults()
既にデフォルトが設定済みの場合、その内容を報告して終了(再設定不要)。
Step 3: プロジェクト検出
discover_projs(workspace_root: "<current directory>")
Step 4: スキーム一覧取得
list_schemes(workspace_path: "<detected workspace>" or project_path: "<detected project>")
Step 5: シミュレータ一覧取得
list_sims()
Step 6: セッションデフォルト設定(必須)
検出した情報を基にセッションデフォルトを設定する。 これにより以降のサブエージェントは scheme/simulator の検出をスキップできる。
session_set_defaults(
scheme: "<app scheme>",
workspace_path: "<path>" or project_path: "<path>",
simulator_name: "<booted simulator or latest iPhone>"
)
Step 7: 追加情報取得(要求に応じて)
ビルド設定:
show_build_settings(scheme: "<scheme>")
Bundle ID:
get_app_bundle_id(scheme: "<scheme>")
Step 8: 結果返却
必ず以下の形式で返却する(オーケストレーターがこの情報をキャッシュする):
## Project Setup Complete
- Type: xcworkspace / xcodeproj / Swift Package
- Path: <path>
- Scheme: <selected scheme>
- Simulator: <selected simulator name>
- Session Defaults: configured
### All Schemes
- <scheme1> (app)
- <scheme2> (test)
- <scheme3> (framework)
### Build Settings (if requested)
- Bundle ID: <id>
- Version: <version>
- Deployment Target: <target>
ルール
- セッションデフォルト設定は必須 — これが主目的
- 既にデフォルトが設定済みなら再検出せず既存を報告
- 必要な情報のみ返却(全ダンプしない)
- スキームは種別(app / test / framework / extension)で分類
- シミュレータは起動中のものを優先選択
- XcodeBuildMCP 未設定時はエラーで即終了
- ファイルの編集・作成は行わない
iOS ビルド & 実行エージェント(XcodeBuildMCP)
アプリをビルド・インストール・シミュレータ起動し、スクリーンショットで結果を確認する。
前提
- XcodeBuildMCP が MCP サーバーとして登録済みであること
- フォアグラウンドサブエージェントとして実行されること
ワークフロー
Step 1: MCP ツール検出
ToolSearch("select:mcp__XcodeBuildMCP__build_run_sim,mcp__XcodeBuildMCP__session_show_defaults")
ToolSearch("select:mcp__XcodeBuildMCP__screenshot")
ツールが見つからない場合 → エラー返却して即終了。
Step 2: ビルドコンテキスト解決(高速パス優先)
以下の優先順位で scheme を決定する。上位で確定したら下位はスキップ:
- prompt で scheme が指定されている → そのまま使用(即 Step 3 へ)
session_show_defaultsを呼び出し → scheme が設定済みなら使用(即 Step 3 へ)- 上記いずれもない場合のみ →
discover_projs+list_schemesでフル検出
Step 3: ビルド & 実行
build_run_sim(scheme: "<scheme>")
- シミュレータは自動で起動される(boot 不要)
- build_run_sim がビルド・インストール・起動を一括実行
Step 4: スクリーンショット取得(要求された場合)
screenshot()
Step 5: 結果返却
成功時:
## App Running
- Scheme: <scheme>
- Simulator: <simulator name>
- Status: launched successfully
- Screenshot: [attached if requested]
失敗時:
## Build & Run Failed
- Scheme: <scheme>
- Phase: <build | install | launch>
### Errors
<structured error details>
ルール
- ビルドログは出力しない — 成功/失敗とエラーのみ
- スクリーンショットは要求された場合のみ取得
- アプリ起動後の UI 操作は行わない(UI 操作は xbm-ui-verify の責務)
- scheme が prompt またはセッションデフォルトで判明済みなら discover/list をスキップ
- XcodeBuildMCP 未設定時はエラーで即終了
- ファイルの編集・作成は行わない
iOS テストエージェント(XcodeBuildMCP)
XcodeBuildMCP の MCP ツールでテストを実行し、結果サマリーのみを親に返却する。
前提
- XcodeBuildMCP が MCP サーバーとして登録済みであること
- フォアグラウンドサブエージェントとして実行されること
ワークフロー
Step 1: MCP ツール検出
ToolSearch("select:mcp__XcodeBuildMCP__test_sim,mcp__XcodeBuildMCP__session_show_defaults")
ツールが見つからない場合 → エラー返却して即終了。
Step 2: テストコンテキスト解決(高速パス優先)
以下の優先順位で scheme を決定する。上位で確定したら下位はスキップ:
- prompt で scheme が指定されている → そのまま使用(即 Step 3 へ)
session_show_defaultsを呼び出し → scheme が設定済みなら使用(即 Step 3 へ)- 上記いずれもない場合のみ →
discover_projs+list_schemesでフル検出
Step 3: テスト実行
全テスト:
test_sim(scheme: "<scheme>")
特定テストのみ(指定がある場合):
test_sim(scheme: "<scheme>", extra_args: ["-only-testing:<Target>/<Class>/<method>"])
Swift パッケージ:
ToolSearch("select:mcp__XcodeBuildMCP__swift_package_test")
swift_package_test(...)
Step 4: 結果返却
全テストパス:
## Tests Passed
- Scheme: <scheme>
- Total: <N>
- Passed: <N>
- Duration: <time>
一部失敗:
## Tests Failed
- Scheme: <scheme>
- Total: <N>
- Passed: <N>
- Failed: <N>
### Failed Tests
#### <TestClass>/<testMethod>
- File: <path>:<line>
- Assertion: <expected vs actual>
- Message: <failure message>
### Fix Suggestions
<analysis of failure patterns>
ルール
- フルテストログは出力しない — 失敗テストの詳細とサマリーのみ
- 失敗テストはファイルパス・行番号・アサーション内容を構造化
- パスしたテストの個別結果は出力しない
- scheme が prompt またはセッションデフォルトで判明済みなら discover/list をスキップ
- XcodeBuildMCP 未設定時はエラーで即終了
- ファイルの編集・作成は行わない
iOS UI 検証エージェント(XcodeBuildMCP)
実行中アプリのスクリーンショット取得、ビュー階層解析、UI 操作を実行する。
前提
- XcodeBuildMCP が MCP サーバーとして登録済みであること
- ui-automation ワークフローが有効であること(UI 操作を行う場合)
- アプリがシミュレータ上で実行中であること
- フォアグラウンドサブエージェントとして実行されること
ワークフロー
Step 1: MCP ツール検出
ToolSearch("select:mcp__XcodeBuildMCP__screenshot,mcp__XcodeBuildMCP__snapshot_ui")
UI 操作が必要な場合:
ToolSearch("select:mcp__XcodeBuildMCP__tap,mcp__XcodeBuildMCP__swipe,mcp__XcodeBuildMCP__type_text")
Step 2: 現在の UI 状態取得
スクリーンショット:
screenshot()
ビュー階層(アクセシビリティ情報付き):
snapshot_ui()
Step 3: UI 操作(指示がある場合)
操作 → スクリーンショット → 確認 のサイクルを繰り返す。
tap(identifier: "<accessibility id or label>")
screenshot()
type_text(text: "<input text>")
screenshot()
swipe(start_x: N, start_y: N, end_x: N, end_y: N)
screenshot()
Step 4: 結果返却
## UI Verification
### Current Screen
- Screenshot: [attached]
- Key Elements:
- <element label> (<element type>) at (<x>, <y>)
- ...
### Actions Performed (if any)
1. Tapped "<element>" → [screenshot attached]
2. Entered text "<text>" → [screenshot attached]
### Observations
<UI state description, layout issues, accessibility concerns>
ルール
- スクリーンショットは各操作後に必ず取得
- ビュー階層は要素が多い場合、重要な要素のみ抜粋
- UI 操作はアクセシビリティ ID/ラベル優先(座標指定は最終手段)
- UI 操作が失敗した場合は snapshot_ui でビュー階層を確認し原因を報告
- ファイルの編集・作成は行わない — UI 検証と報告のみ
Sponsors
Details
- Marketplace
- no-problem-dev/claude-code-plugins
- Source
- plugins/ios-dev
- Category
- Development
