iOS/Swift/Xcode ビルド・テスト・実行コマンド群 - SPMパッケージ構成のiOSアプリ開発をサポート

version
2.0.0
GitHub stars
5

Install

/plugin install ios-dev@no-problem-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add no-problem-dev/claude-code-plugins.

Contents

Discovered from source

Skills 5

iOS 開発ワークフロー(v3.0 — XcodeBuildMCP + サブエージェント隔離)

XcodeBuildMCP の MCP ツールをフォアグラウンドサブエージェント経由で呼び出し、 ビルドログ等のコンテキスト消費をサブエージェント内に隔離する。

設計原則

  1. XcodeBuildMCP 必須 — CLI フォールバックなし。未設定時はエラー返却
  2. フォアグラウンドサブエージェント — MCP ツールにアクセス可能。バックグラウンドは不可
  3. コンテキスト隔離 — ビルドログ・テストログはサブエージェント内で消費、親にはサマリーのみ
  4. 結果駆動 — 途中の推論は不要。成功/失敗 + エラー詳細のみが価値
  5. セッションキャッシュ — 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-verifyUI 検証(スクショ + ビュー階層 + 操作)「画面確認して」「ボタン押して」

タスク判定 → サブエージェント振り分け

ビルド要求

  • キーワード: 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-replSwiftUI プレビュー・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 が利用できません」と通知し、セットアップ手順を案内:

  1. Xcode 26.3 以降がインストールされていることを確認
  2. Xcode を起動してプロジェクトを開く
  3. claude mcp add xcode -- xcrun mcpbridge
  4. Claude Code を再起動

XcodeBuildMCP との関係

機能XcodeBuildMCPXcode ネイティブ 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 を決定する。上位で確定したら下位はスキップ:

  1. prompt で scheme が指定されている → そのまま使用(即 Step 3 へ)
  2. session_show_defaults を呼び出し → scheme が設定済みなら使用(即 Step 3 へ)
  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>

ルール

  1. フルビルドログは絶対に出力しない — エラーとサマリーのみ
  2. エラーはファイルパス・行番号付きで構造化
  3. 警告は件数のみ(詳細は求められた場合のみ)
  4. scheme が prompt またはセッションデフォルトで判明済みなら discover/list をスキップ
  5. XcodeBuildMCP 未設定時はエラーで即終了 — CLI フォールバックしない
  6. ファイルの編集・作成は行わない — ビルド実行と結果報告のみ

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>

ルール

  1. セッションデフォルト設定は必須 — これが主目的
  2. 既にデフォルトが設定済みなら再検出せず既存を報告
  3. 必要な情報のみ返却(全ダンプしない)
  4. スキームは種別(app / test / framework / extension)で分類
  5. シミュレータは起動中のものを優先選択
  6. XcodeBuildMCP 未設定時はエラーで即終了
  7. ファイルの編集・作成は行わない

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 を決定する。上位で確定したら下位はスキップ:

  1. prompt で scheme が指定されている → そのまま使用(即 Step 3 へ)
  2. session_show_defaults を呼び出し → scheme が設定済みなら使用(即 Step 3 へ)
  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>

ルール

  1. ビルドログは出力しない — 成功/失敗とエラーのみ
  2. スクリーンショットは要求された場合のみ取得
  3. アプリ起動後の UI 操作は行わない(UI 操作は xbm-ui-verify の責務)
  4. scheme が prompt またはセッションデフォルトで判明済みなら discover/list をスキップ
  5. XcodeBuildMCP 未設定時はエラーで即終了
  6. ファイルの編集・作成は行わない

iOS テストエージェント(XcodeBuildMCP)

XcodeBuildMCP の MCP ツールでテストを実行し、結果サマリーのみを親に返却する。

前提

  • XcodeBuildMCP が MCP サーバーとして登録済みであること
  • フォアグラウンドサブエージェントとして実行されること

ワークフロー

Step 1: MCP ツール検出

ToolSearch("select:mcp__XcodeBuildMCP__test_sim,mcp__XcodeBuildMCP__session_show_defaults")

ツールが見つからない場合 → エラー返却して即終了。

Step 2: テストコンテキスト解決(高速パス優先)

以下の優先順位で scheme を決定する。上位で確定したら下位はスキップ:

  1. prompt で scheme が指定されている → そのまま使用(即 Step 3 へ)
  2. session_show_defaults を呼び出し → scheme が設定済みなら使用(即 Step 3 へ)
  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>

ルール

  1. フルテストログは出力しない — 失敗テストの詳細とサマリーのみ
  2. 失敗テストはファイルパス・行番号・アサーション内容を構造化
  3. パスしたテストの個別結果は出力しない
  4. scheme が prompt またはセッションデフォルトで判明済みなら discover/list をスキップ
  5. XcodeBuildMCP 未設定時はエラーで即終了
  6. ファイルの編集・作成は行わない

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>

ルール

  1. スクリーンショットは各操作後に必ず取得
  2. ビュー階層は要素が多い場合、重要な要素のみ抜粋
  3. UI 操作はアクセシビリティ ID/ラベル優先(座標指定は最終手段)
  4. UI 操作が失敗した場合は snapshot_ui でビュー階層を確認し原因を報告
  5. ファイルの編集・作成は行わない — UI 検証と報告のみ

Sponsors

Details

Marketplace
no-problem-dev/claude-code-plugins
Source
plugins/ios-dev
Category
Development

More from no-problem-dev/claude-code-plugins

All 9