ce-test-browser

概要ce-test-browser

プルリクエストやブランチの変更によって影響を受けるページに対して、agent-browser CLIのみを使用してエンドツーエンドのブラウザテストを実行するためのワークフローです。 このワークフローは、他のブラウザ自動化システムやブラウザMCPとの統合を意図的に避けています。Claude CodeではChrome MCPツールを使用せず、Codexでは他のブラウジングツールに置き換えることもありません。agent-browserは、ページの表示、要素のクリック、フォームへの入力、スクリーンショットの撮影、およびレンダリングされたコンテンツのスクレイピングに使用されます。 引数として、PR番号、ブランチ名、「current」という単語、または --port フラグを指定できます。

このワークフローはまず、agent-browser がインストールされているかを確認し、インストールされていない場合は /ce-setup を実行するよう指示して処理を停止します。その後、headed モードで実行するか headless モードで実行するかを尋ねますが、パイプラインモードの場合は、ブロックすることなくデフォルトで headless モードになります。 テスト範囲は、PR番号の場合はgh pr view、currentまたはブランチの場合はmainに対するgit diffを使用して、変更されたファイルから決定されます。 変更されたファイルは、Railsのビュー、コントローラー、Stimulusコントローラー、ViewComponents、レイアウト、スタイルシート、ヘルパー、およびNext.jsのアプリとコンポーネントのパスを網羅するパターンテーブルを介してテスト可能なルートにマッピングされ、テスト対象のURLリストが生成されます。

ポートの処理は、手動モードとパイプラインモードで異なります。明示的な `--port` 引数、コンテキスト内のプロジェクト指示、`package.json` の `dev/start` スクリプト、環境ファイル、またはデフォルトの 3000 から優先ポートを決定します。意図的に、説明文からポートを検索することはありません。 パイプラインモードでは、複数のエージェントが並行して実行される可能性があるため、利用可能なポートを上位から順にスキャンし、リスニング中のポートがない場合はバックグラウンドで開発サーバーを起動します（最大30秒待機します）。一方、手動モードでは、優先ポートを直接使用し、サーバーが実行されていない場合はユーザーにサーバーの起動を求めます。 影響を受ける各ルートについて、ナビゲーションを行い、対話型のスナップショットをキャプチャします。ユーザーが「監視」を選択した場合は `--headed` フラグを使用し、ページタイトルや見出し、主要な対話要素などの主要な要素を検証します。変更の影響を受けたページが依然として正しくレンダリングされ、動作していることを検証するために使用します。

FAQ

このスキルはどのブラウザ自動化ツールを使用していますか？

agent-browser CLIのみを使用します。Claude CodeのChrome MCPツールや、Codexの他のブラウジングツールは使用しません。

agent-browserがインストールされていない場合はどうなりますか？

ユーザーに対し、現在のインストール環境に合わせて /ce-setup を実行し、agent-browser をインストールしてから再試行するよう指示します。その後、agent-browser なしではスキルが機能しないため、処理を停止します。

テスト対象のページはどのように決定されますか？

GitHubのプルリクエストビュー（プルリクエストの場合）またはmainブランチとのgit diff（ブランチまたは現在の状態の場合）から変更されたファイルを取得し、ファイルパターンテーブルを使用してそれらのファイルをルートにマッピングし、URLのリストを作成します。

開発サーバーのポートはどのように決定されますか？

優先順位に基づいて決定されます：明示的な `--port` 引数、コンテキスト内のプロジェクト指示、`package.json` の開発スクリプト、`.env` などの環境ファイルの順で、それらが指定されていない場合はデフォルトの 3000 になります。本文からポート番号を検索することはありません。

パイプラインモードでは何が異なりますか？

headed/headlessの選択をスキップし、デフォルトでheadlessモードになります。エージェントが並行して実行される可能性があるため、上流方向にスキャンして真に空きポートを探し、リスニング中の開発サーバーがない場合はバックグラウンドで自動的に起動します。