ce-test-xcode

ce-test-xcode について

Ce-test-xcode は、XcodeBuildMCP サーバーを使用して、シミュレーター上で iOS アプリのビルド、インストール、テストを実行し、スクリーンショットとログをキャプチャして、アプリの動作を検証します。スキーム名を任意の引数として指定できます。または、「current」を指定して、デフォルトまたは最後に使用されたスキームを使用します。前提条件には、コマンドラインツール付きの Xcode、接続された XcodeBuildMCP MCP サーバー、有効な Xcode プロジェクトまたはワークスペース、および少なくとも 1 つの利用可能な iOS シミュレーターが必要です。モデルの呼び出しは無効化されているため、これは明示的なコマンドとして実行されます。

ワークフローはまず、list_simulators ツールを呼び出して XcodeBuildMCP が接続されていることを確認し、接続されていない場合はインストールガイド付きで停止します。その後、プロジェクトとスキームを検出し（discover_projs、list_schemes）、UUID によって iPhone 15 Pro などの優先シミュレーターを起動し、build_ios_sim_app でアプリをビルドします。失敗した場合は特定のエラーを報告します。成功した場合、アプリをインストールして起動し（install_app_on_simulator、launch_app_on_simulator）、ログのキャプチャを開始します。各主要画面について、説明的なスクリーンショットを取得し、レンダリングとコンテンツを確認し、ログからクラッシュ、例外、エラーレベルのメッセージ、および失敗したネットワークリクエストをチェックします。

このスキルは、既知のプラットフォーム制限を文書化しています。シミュレータでのタップは、インライン AttributedString リンクを含む SwiftUI Text ビューのジェスチャー認識子をトリガーできないため、手動タップを促すか、代替手段として xcrun simctl openurl を提供します。Apple でのサインイン、プッシュ通知、アプリ内購入、カメラと写真、位置情報など、デバイスの操作を必要とするフローについては、プラットフォームのブロッキング質問ツール（AskUserQuestion など）を使用して人間の確認を待機します。テストに失敗した場合、スクリーンショットとログでエラーを文書化し、今すぐ修正するかスキップするかを問いかけます。最後に、構造化されたテストサマリーテーブルと、ログのキャプチャを停止し、オプションでシミュレーターをシャットダウンするクリーンアップステップで終了します。また、ce-code-review ワークフローと統合されており、iOS コードに触れる PR に対してこのスキルを実行するエージェントを起動できます。

よくある質問

このスキルに必要な MCP サーバーはどれですか？

XcodeBuildMCP MCP サーバーが接続されている必要があります。ワークフローは list_simulators ツールを呼び出して利用可能性を確認し、XcodeBuildMCP が動作するまで処理を進めません。不足している場合は、Homebrew および npx のインストール手順を提供します。

テストするスキームをどのように選択しますか？

スキーム名を引数として渡すか、「current」を渡してデフォルトまたは最後に使用されたスキームを使用します。このスキルは discover_projs と list_schemes を使用してプロジェクトとスキームを検出し、引数が指定されている場合はそれを使用します。

なぜシミュレーター上の SwiftUI テキストリンクへのタップが機能しないのですか？

インライン AttributedString リンクを含む SwiftUI Text ビューでは、それらのリンクがアクセシビリティツリー内で個別の要素として公開されていないため、シミュレータでのタップはジェスチャー認識子をトリガーしません。このスキルは手動でタップするよう促し、代替手段として xcrun simctl openurl を使用して既知のターゲット URL を直接開くことができます。

人間の入力を待機するのはいつですか？

Apple でのサインイン、プッシュ通知、アプリ内購入、カメラと写真、位置情報など、実際のデバイスの操作を必要とするフローについては、プラットフォームのブロッキング質問ツールを使用して問いかけ、検証を黙ってスキープすることはありません。

テストが失敗した場合、どのように処理しますか？

エラー状態のスクリーンショット、キャプチャされたコンソールログ、再現手順を文書化して失敗を記録し、今すぐ修正するか（デバッグ、修正案の提案、ビルドの再実行、再テスト）、スキップして他の画面のテストを続けるかを問いかけます。