Xcode MCP使用ガイドライン

--- name: xcode-mcp description: Xcode MCPツールを効率的に使用するためのガイドライン。このスキルは、Xcode MCPツールをいつ使用すべきか、標準ツールをいつ使用すべきかを理解するために使用する。Xcode MCPは多くのトークンを消費するため、ビルド、テスト、シミュレータ、プレビュー、SourceKit診断にのみ使用すること。ファイルの読み書きやgrep操作には決して使用しないこと。 --- # Xcode MCP使用ガイドライン Xcode MCPツールは多くのトークンを消費します。このスキルは、Xcode MCPをいつ使用し、標準ツールをいつ優先すべきかを定義します。 ## Xcode MCPツール完全リファレンス ### ウィンドウとプロジェクト管理 | ツール | 説明 | トークンコスト | |------|-------------|------------| | `mcp__xcode__XcodeListWindows` | 開いているXcodeウィンドウを一覧表示（tabIdentifierを取得） | 低 | ### ビルド操作 | ツール | 説明 | トークンコスト | |------|-------------|------------| | `mcp__xcode__BuildProject` | Xcodeプロジェクトをビルド | 中 | | `mcp__xcode__GetBuildLog` | エラーや警告を含むビルドログを取得 | 中 | | `mcp__xcode__XcodeListNavigatorIssues` | Issueナビゲータの課題を一覧表示 | 低 | ### テスト | ツール | 説明 | トークンコスト | |------|-------------|------------| | `mcp__xcode__GetTestList` | テストプランから利用可能なテストを取得 | 低 | | `mcp__xcode__RunAllTests` | すべてのテストを実行 | 中 | | `mcp__xcode__RunSomeTests` | 特定のテストを実行（推奨） | 中 | ### プレビューと実行 | ツール | 説明 | トークンコスト | |------|-------------|------------| | `mcp__xcode__RenderPreview` | SwiftUIプレビューのスナップショットをレンダリング | 中 | | `mcp__xcode__ExecuteSnippet` | ファイルコンテキストでコードスニペットを実行 | 中 | ### 診断 | ツール | 説明 | トークンコスト | |------|-------------|------------| | `mcp__xcode__XcodeRefreshCodeIssuesInFile` | 特定ファイルのコンパイラ診断を取得 | 低 | | `mcp__ide__getDiagnostics` | SourceKit診断を取得（開いているすべてのファイル） | 低 | ### ドキュメント | ツール | 説明 | トークンコスト | |------|-------------|------------| | `mcp__xcode__DocumentationSearch` | Apple Developerドキュメントを検索 | 低 | ### ファイル操作（高トークン・絶対に使用しないこと） | ツール | 代替手段 | 理由 | |------|-------------|-----| | `mcp__xcode__XcodeRead` | `Read`ツール | 高トークン消費 | | `mcp__xcode__XcodeWrite` | `Write`ツール | 高トークン消費 | | `mcp__xcode__XcodeUpdate` | `Edit`ツール | 高トークン消費 | | `mcp__xcode__XcodeGrep` | `rg` / `Grep`ツール | 高トークン消費 | | `mcp__xcode__XcodeGlob` | `Glob`ツール | 高トークン消費 | | `mcp__xcode__XcodeLS` | `ls`コマンド | 高トークン消費 | | `mcp__xcode__XcodeRM` | `rm`コマンド | 高トークン消費 | | `mcp__xcode__XcodeMakeDir` | `mkdir`コマンド | 高トークン消費 | | `mcp__xcode__XcodeMV` | `mv`コマンド | 高トークン消費 | --- ## 推奨ワークフロー ### 1. コード変更とビルドフロー ``` 1. コード検索 -> rg "パターン" --type swift 2. ファイル読み取り -> Readツール 3. ファイル編集 -> Editツール 4. 構文チェック -> mcp__ide__getDiagnostics 5. ビルド -> mcp__xcode__BuildProject 6. エラー確認 -> mcp__xcode__GetBuildLog（ビルド失敗時） ``` ### 2. テスト作成と実行フロー ``` 1. テストファイル読み取り -> Readツール 2. テスト作成・編集 -> Editツール 3. テスト一覧取得 -> mcp__xcode__GetTestList 4. テスト実行 -> mcp__xcode__RunSomeTests（特定テスト） 5. 結果確認 -> テスト出力を確認 ``` ### 3. SwiftUIプレビューフロー ``` 1. ビュー編集 -> Editツール 2. プレビューレンダリング -> mcp__xcode__RenderPreview 3. 反復 -> 必要に応じて繰り返す ``` ### 4. デバッグフロー ``` 1. 診断確認 -> mcp__ide__getDiagnostics（クイック構文チェック） 2. プロジェクトビルド -> mcp__xcode__BuildProject 3. ビルドログ取得 -> mcp__xcode__GetBuildLog（重大度: エラー） 4. 問題修正 -> Editツール 5. 再ビルド -> mcp__xcode__BuildProject ``` ### 5. ドキュメント検索 ``` 1. ドキュメント検索 -> mcp__xcode__DocumentationSearch 2. 結果確認 -> 実装に情報を使用 ``` --- ## フォールバックコマンド（MCPが利用できない場合） Xcode MCPが切断または利用できない場合は、以下のxcodebuildコマンドを使用してください。 ### ビルドコマンド ```bash # デバッグビルド（シミュレータ）- <SchemeName>をプロジェクトのスキームに置き換え xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # リリースビルド（デバイス） xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # ワークスペースでのビルド（CocoaPodsプロジェクト用） xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # プロジェクトファイルでのビルド xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # 利用可能なスキームを一覧表示 xcodebuild -list ``` ### テストコマンド ```bash # すべてのテストを実行 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # 特定のテストクラスを実行 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # 特定のテストメソッドを実行 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # コードカバレッジ付きで実行 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # 利用可能なシミュレータを一覧表示 xcrun simctl list devices available ``` ### クリーンビルド ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## クイックリファレンス ### Xcode MCPを使用する場合: - `BuildProject` - ビルド - `GetBuildLog` - ビルドエラー - `RunSomeTests` - 特定テストの実行 - `GetTestList` - テストの一覧表示 - `RenderPreview` - SwiftUIプレビュー - `ExecuteSnippet` - コード実行 - `DocumentationSearch` - Appleドキュメント - `XcodeListWindows` - tabIdentifierの取得 - `mcp__ide__getDiagnostics` - SourceKitエラー ### Xcode MCPを絶対に使用しない場合: - `XcodeRead` -> `Read`ツールを使用 - `XcodeWrite` -> `Write`ツールを使用 - `XcodeUpdate` -> `Edit`ツールを使用 - `XcodeGrep` -> `rg`または`Grep`ツールを使用 - `XcodeGlob` -> `Glob`ツールを使用 - `XcodeLS` -> `ls`コマンドを使用 - `XcodeRM` -> `rm`コマンドを使用 - `XcodeMakeDir` -> `mkdir`コマンドを使用 - `XcodeMV` -> `mv`コマンドを使用 - ファイル操作 -> 標準ツールを使用 --- ## トークン効率サマリー | 操作 | 最適な選択 | トークン影響 | |-----------|-------------|--------------| | クイック構文チェック | `mcp__ide__getDiagnostics` | 低 | | フルビルド | `mcp__xcode__BuildProject` | 中 | | 特定テストの実行 | `mcp__xcode__RunSomeTests` | 中 | | 全テストの実行 | `mcp__xcode__RunAllTests` | 高 | | ファイル読み取り | `Read`ツール | 高 | | ファイル編集 | `Edit`ツール | 高 | | コード検索 | `rg` / `Grep` | 低 | | ファイル一覧表示 | `ls` / `Glob` | 低 |