/xcode:test Skill | Agent Skills

/xcode:test

Xcodeプロジェクトのテストを実行する。

コマンド構文

/xcode:test [scheme-name] [test-target]

| 引数 | 内容 | | ----------- | ----------------------------------------------------------------- | | scheme-name | スキーム名（省略時は .xcodeproj から自動検出） | | test-target | テストターゲット（例: LibraryTests/FooTests。省略時は全テスト） |

Step 1: プラットフォーム判定 [MANDATORY]

以下の順序でプラットフォームを判定する:

プロジェクト内の .xcconfig ファイルから SDKROOT を検索:

grep -r "^SDKROOT" . --include="*.xcconfig" | head -5

見つかった場合、SDKROOT の値でプラットフォームを決定:

| SDKROOT | プラットフォーム | | ---------- | ---------------- | | iphoneos | iOS | | macosx | macOS |

.xcconfig が見つからない場合: AskUserQuestion で iOS / macOS を確認
SDKROOT が上記以外の値の場合: AskUserQuestion で確認

Step 2: スキーム・テストターゲット決定

$ARGUMENTS を解析する:

| パターン | スキーム | テストターゲット | | ----------------------------- | ------------------------- | ----------------------- | | 引数なし | .xcodeproj から自動検出 | 全テスト | | MyApp | MyApp | 全テスト | | MyApp LibraryTests/FooTests | MyApp | LibraryTests/FooTests |

スキーム自動検出:

find . -maxdepth 1 -name "*.xcodeproj" -type d | head -1 | xargs -I{} basename {} .xcodeproj

検出できない場合は AskUserQuestion で確認。

Step 3: テスト環境セットアップ

iOS の場合

シミュレーター検出スクリプトを実行する:

DEVICE_ID=$(${CLAUDE_PLUGIN_ROOT}/skills/test/scripts/resolve_simulator.sh)

成功（exit 0）: stdout に UUID が返る → {DEVICE_ID} として使用
失敗（exit 1）: stderr にエラーメッセージと利用可能なデバイス一覧が表示される → AskUserQuestion でデバイスを選択してもらい、手動で UUID を指定

macOS の場合

セットアップ不要。次の Step へ進む。

Step 4: テスト実行

テストスクリプトを実行する。タイムアウトは 600000ms（10分）を設定すること。

macOS

${CLAUDE_PLUGIN_ROOT}/skills/test/scripts/test.sh "{SCHEME}" "platform=macOS"

iOS（テストターゲット指定あり）

${CLAUDE_PLUGIN_ROOT}/skills/test/scripts/test.sh "{SCHEME}" "id={DEVICE_ID}" --sdk iphonesimulator --only-testing "{TEST_TARGET}"

iOS（全テスト）

${CLAUDE_PLUGIN_ROOT}/skills/test/scripts/test.sh "{SCHEME}" "id={DEVICE_ID}" --sdk iphonesimulator

Step 5: 結果報告

全テスト成功: スクリプト出力の成功件数を報告
テスト失敗: スクリプト出力のエラー内容を分析し、修正案を提示

Agent Skills: /xcode:test

Install this agent skill to your local

Skill Files