Expect

Expectとは？

Expectは、開発者向けツールで、エージェントが実際のブラウザでコードをテストできるようにします。現在の作業（例: 未ステージ変更やブランチ差分）を解析し、テスト計画を生成してライブブラウザで実行します。

主な目的は、コード変更をコマンドラインから実行されるブラウザベースのテストセットに変換し、作業中に動作を検証することです。

主な機能

• コード変更からワンコマンドでテスト計画: 未ステージ変更やブランチ差分をスキャンしてテスト対象を判定し、手動でテスト計画を書く手間を削減。
• エージェント生成のテスト計画: 検知した変更に基づいてテスト計画を作成し、ブラウザ実行の構造化された出発点を提供。
• ライブブラウザで実行: 静的チェックのみでなく、実際のブラウザ環境で生成計画を実行。
• コマンドラインでの初期化と使用: expect-cli パッケージ経由で利用可能なinit ワークフローを含む。
• スキルベースの拡張性: スキル追加をサポート（例: npx skills add … --skill expect コマンド）、追加機能で拡張可能。

Expectの使い方

1. インストールと初期化: npx -y expect-cli@latest init を実行してExpectを設定。
2. スキル追加（必要時）: npx skills add https://github.com/millionco/expect --skill expect で関連スキルを追加。
3. ワンコマンドフロー実行: ツールの主コマンドで未ステージ変更やブランチ差分をスキャンし、テスト計画を生成してライブブラウザで実行。

ユースケース

• ローカル変更の小規模検証: 未ステージ変更がある場合、Expectを実行して変更をスキャン、テスト計画を生成し、実ブラウザで実行。
• レビュー前の機能ブランチテスト: ブランチ差分でExpectを実行し、ブランチの違いからブラウザベースのテスト計画を作成。
• ブラウザテストワークフローの自動化: エージェントが計画を生成してライブブラウザで実行することで、手動テスト計画を削減。
• スキルで機能拡張: Expectのスキル機構で追加動作をサポートする場合、提供CLIコマンドでスキルを追加。

FAQ

Expectはどのようにテスト対象を決定する？

未ステージ変更またはブランチ差分をスキャンし、その変更セットに基づいてテスト計画を生成します。

Expectは実ブラウザでテストを実行？

はい。記述されたワークフローは生成テスト計画をライブブラウザで実行します。

始め方は？

npx -y expect-cli@latest init で開始し、サイト内容に示す npx skills add ... --skill expect コマンドでスキルを追加。

異なるコード状態（未ステージ vs ブランチ差分）でExpectを使用可能？

ページではワンコマンドフローの入力として未ステージ変更またはブランチ差分スキャンを明記。

Expectの「スキル」とは？

CLI経由で追加可能なコンポーネント（npx skills add ... --skill ... コマンド使用）。ページ内容はGitHub URLからのスキル追加を示す。

代替ツール

• ブラウザベースE2Eテストフレームワーク: 実ブラウザでテスト実行ツールは通常テストスクリプトの直接作成・保守が必要だが、Expectはコード差分からテスト計画を生成。
• 静的解析・リンター: ブラウザ実行なしで問題検知。Expectはエージェント生成計画のブラウザ実行に特化。
• 変更ベースCIテスト自動化: 変更ファイルに基づくテスト決定ソリューションはワークフローが類似するが、同じスタイルのブラウザテスト計画生成・実行ではない場合あり。
• エージェントQA/テストツール: カテゴリ代替はエージェントで計画・実行するが、Expectの特徴はコード差分連動の明示的「実ブラウザ」実行ステップ。