ScoutQA テスティングスキル

scoutqa CLI を使用して、Web アプリケーションに対して AI パワードな探索的テストを実行します。

ScoutQA をインテリジェントなテストパートナーだと考えてください。 自動的に探索し、問題を発見し、機能を検証できます。複数の並列 ScoutQA 実行にテストをデリゲートして、時間を節約しながらカバレッジを最大化します。

このスキルを使用する場合

このスキルは 2 つのシナリオで使用します：

1. ユーザーがテストをリクエスト - ユーザーが明示的に Web サイトのテストや機能検証をリクエストした場合
2. プロアクティブな検証 - Web 機能を実装した後、自動的にテストを実行して実装が正しく機能することを確認

プロアクティブな使用例：

• ログインフォーム実装後 → 認証フローをテスト
• フォーム検証追加後 → 検証ルールとエラーハンドリングを確認
• チェックアウトフロー構築後 → エンドツーエンドの購入プロセスをテスト
• バグ修正後 → 修正が機能し、他の機能を破壊していないことを確認

ベストプラクティス： Web 機能の実装が完了したら、プロアクティブにバックグラウンドで ScoutQA テストを開始して、その間に他のタスクを続行しながら機能を検証します。

テストの実行

テストワークフロー

このチェックリストをコピーして、進行状況を追跡します：

テスト進行状況：

• 明確な期待値を持つ具体的なテストプロンプトを作成
• バックグラウンドで scoutqa コマンドを実行
• ユーザーに実行 ID とブラウザ URL を通知
• 結果を抽出し分析

ステップ 1：具体的なテストプロンプトを作成

ガイドラインについては、以下の「効果的なプロンプトの作成」セクションを参照してください。

ステップ 2：scoutqa コマンドを実行

重要：Bash ツールのタイムアウトパラメータ（5000ms = 5 秒）を使用して実行詳細をキャプチャします：

Bash ツールを呼び出す場合、パラメータとして timeout: 5000 を設定します：

• これは Claude Code の Bash ツール組み込みのタイムアウトパラメータです（Unix の timeout コマンドではありません）
• 5 秒後、Bash ツールは制御を返し、タスク ID と共にプロセスはバックグラウンドで実行を続けます
• これは Unix の timeout とは異なります。Unix の timeout はプロセスを終了しますが、ここではプロセスは実行を続けます
• 最初の 5 秒は ScoutQA の出力から実行 ID とブラウザ URL をキャプチャします
• テストはバックグラウンドタスクとして ScoutQA インフラストラクチャ上でリモート実行を続けます

scoutqa --url "https://example.com" --prompt "Your test instructions"

最初の数秒で、コマンドは以下を出力します：

• 実行 ID（例：019b831d-xxx）
• ブラウザ URL（例：https://app.scoutqa.ai/t/019b831d-xxx）
• テスト進行状況を示す初期ツール呼び出し

5 秒のタイムアウト後、Bash ツールはタスク ID を返し、コマンドはバックグラウンドで実行を続けます。テストが実行されている間、他のタスクに取り組むことができます。タイムアウトは初期出力（実行 ID とブラウザ URL）をキャプチャするためだけで、テストはバックグラウンドタスクとしてローカルで、そして ScoutQA インフラストラクチャでリモートで実行を続けます。

ステップ 3：ユーザーに実行 ID とブラウザ URL を通知

Bash ツールが（最初の 5 秒で実行詳細をキャプチャした後）タスク ID で返された後、ユーザーに以下を通知します：

• ScoutQA 実行 ID とブラウザ URL。ユーザーはブラウザでプログレスを監視できます
• ローカルコマンド出力を後で確認したい場合のバックグラウンドタスク ID

テストはバックグラウンドで実行を続け、あなたは他の作業を続けます。

ステップ 4：結果を抽出し分析

完全なフォーマットについては、以下の「結果の提示」セクションを参照してください。

コマンドオプション

• --url（必須）：テストする Web サイト URL（localhost / 127.0.0.1 をサポート）
• --prompt（必須）：自然言語のテスト指示
• --project-id（オプション）：追跡のためにプロジェクトに関連付け
• -v, --verbose（オプション）：内部を含むすべてのツール呼び出しを表示

ローカルテストサポート

ScoutQA は localhost と 127.0.0.1 URL を自動的にテストできます。手動セットアップは不要です。

# アプリを開発中にローカルで実行されているアプリをシームレスにテスト
scoutqa --url "http://localhost:3000" --prompt "Test the registration form"

各コマンドを使用する場合

新しいテストを開始？ → scoutqa --url --prompt を使用 既知の問題を確認？ → scoutqa issue-verify --issue-id <id> を使用 実行から問題 ID を検索？ → scoutqa list-issues --execution-id <id> を使用 エージェントがより多くコンテキストが必要？ → scoutqa send-message を使用（「スタックした実行のフォローアップ」を参照）

効果的なプロンプトの作成

何を探索して検証するか に焦点を当てます。規定的なステップには焦点を当てません。ScoutQA は自動的にテスト方法を決定します。

例：ユーザー登録フロー

scoutqa --url "https://example.com" --prompt "
Explore the user registration flow. Test form validation edge cases,
verify error handling, and check accessibility compliance.
"

例：e-commerce チェックアウト

scoutqa --url "https://shop.example.com" --prompt "
Test the checkout flow. Verify pricing calculations, cart persistence,
payment options, and mobile responsiveness.
"

例：包括的なカバレッジのための並列テストの実行

複数の Bash ツール呼び出しを 1 つのメッセージで実行して、並列にテストを起動します。各メッセージについて、Bash ツールの timeout パラメータを 5000（ミリ秒）に設定します：

# テスト 1：認証とセキュリティ
scoutqa --url "https://app.example.com" --prompt "
Explore authentication: login/logout, session handling, password reset,
and security edge cases.
"

# テスト 2：コア機能（並列で実行）
scoutqa --url "https://app.example.com" --prompt "
Test dashboard and main user workflows. Verify data loading,
CRUD operations, and search functionality.
"

# テスト 3：アクセシビリティ（並列で実行）
scoutqa --url "https://app.example.com" --prompt "
Conduct accessibility audit: WCAG compliance, keyboard navigation,
screen reader support, color contrast.
"

実装： 3 つの Bash ツール呼び出しを含む 1 つのメッセージを送信します。各 Bash ツール呼び出しについて、timeout パラメータを 5000 ミリ秒に設定します。5 秒後、各 Bash 呼び出しはタスク ID で返され、プロセスはバックグラウンドで実行を続けます。これにより初期出力から各テストの実行 ID とブラウザ URL がキャプチャされ、その後 3 つすべてが並列で実行を続けます（ローカルのバックグラウンドタスクとして、そして ScoutQA インフラストラクチャでリモートで）。

主要ガイドライン：

• どのようにテストするか ではなく 何をテストするか を説明します（ScoutQA がステップを理解します）
• 目標、エッジケース、懸念事項に焦点を当てます
• 異なるテスト領域用に複数の並列実行を実行します
• ScoutQA が自動的に探索し問題を発見することを信頼します
• scoutqa コマンドを呼び出す際は、常に Bash ツールの timeout パラメータを 5000 ミリ秒に設定します（これにより 5 秒後に制御が返され、プロセスはバックグラウンドで実行を続けます）
• 並列テストの場合、1 つのメッセージで複数の Bash ツール呼び出しを実行します
• 覚えておく：Bash ツールタイムアウト ≠ Unix timeout コマンド（Bash タイムアウトはプロセスをバックグラウンドで続行、Unix タイムアウトは終了）

一般的なテストシナリオ

デプロイ後のスモークテスト：

scoutqa --url "$URL" --prompt "
Smoke test: verify critical functionality works after deployment.
Check homepage, navigation, login/logout, and key user flows.
"

アクセシビリティ監査：

scoutqa --url "$URL" --prompt "
Audit accessibility: WCAG 2.1 AA compliance, keyboard navigation,
screen reader support, color contrast, and semantic HTML.
"

e-commerce テスト：

scoutqa --url "$URL" --prompt "
Explore e-commerce functionality: product search/filtering,
cart operations, checkout flow, and pricing calculations.
"

SaaS アプリケーション：

scoutqa --url "$URL" --prompt "
Test SaaS app: authentication, dashboard, CRUD operations,
permissions, and data integrity.
"

フォーム検証：

scoutqa --url "$URL" --prompt "
Test form validation: edge cases, error handling, required fields,
format validation, and successful submission.
"

モバイルレスポンシブ対応：

scoutqa --url "$URL" --prompt "
Check mobile experience: responsive layout, navigation,
touch interactions, and viewport behavior.
"

既知の問題の検証：

# 最初に、以前の実行から問題 ID を検索
scoutqa list-issues --execution-id <executionId>

# その後、問題を検証（新しい検証実行を自動作成）
scoutqa issue-verify --issue-id <issueId>

issue-verify コマンドは以下を実行します：

1. 問題の検証実行を作成
2. 実行 ID とブラウザ URL を表示
3. エージェントの検証進行状況をリアルタイムでストリーム
4. 結果へのリンク付きの完了サマリーを表示

機能検証（実装後）：

scoutqa --url "$URL" --prompt "
Verify the new [feature name] works correctly. Test core functionality,
edge cases, error handling, and integration with existing features.
"

例：コーディング後の機能のプロアクティブなテスト

ユーザー登録フォームを実装した後、自動的に機能を検証します：

scoutqa --url "http://localhost:3000/register" --prompt "
Test the newly implemented registration form. Verify:
- Form validation (email format, password strength, required fields)
- Error messages display correctly
- Successful registration flow
- Edge cases (duplicate emails, special characters, etc.)
"

これにより、実装がコンテキストに新しい間に問題をすぐに発見できます。

問題の一覧表示

scoutqa list-issues を使用して、以前の実行で見つかった問題を参照します。これは issue-verify で使用する問題 ID を見つけるのに便利です。

scoutqa list-issues --execution-id <executionId>

オプション：

• --execution-id（必須）：実行 ID（/t/<executionId> URL または CLI 出力から取得）

出力例：

Showing 3 issues:

🔴 019c-abc1
   Login button unresponsive on mobile
   Severity: critical | Category: usability | Status: open

🟠 019c-abc2
   Missing form validation on email field
   Severity: high | Category: functional | Status: open

🟡 019c-abc3
   Color contrast insufficient on footer links
   Severity: medium | Category: accessibility | Status: resolved

結果の提示

即座の提示（テスト開始後）

scoutqa コマンド実行直後、実行詳細をユーザーに提示します：

**ScoutQA テスト開始**

実行 ID: `019b831d-xxx`
ライブ表示: https://app.scoutqa.ai/t/019b831d-xxx

テストはリモートで実行されています。上記のリンクでブラウザのリアルタイムプログレスを確認できます。その間に他のタスクを続けます。

最終結果（完了後）

実行が完了したら、このフォーマットを使用して検出結果を提示します：

**ScoutQA テスト結果**

実行 ID: `ex_abc123`

**検出された問題：**

[高] アクセシビリティ：ロゴ画像に代替テキストがありません

- 影響：スクリーンリーダーがロゴを説明できません
- 場所：ヘッダーナビゲーション

[中] ユーザビリティ：送信ボタンがモバイルビューポートに表示されません

- 影響：ユーザーはモバイルデバイスでフォームを完了できません
- 場所：お問い合わせフォーム、ページ下部

[低] 機能：有効なクエリに対して検索が結果を返しません

- 影響：検索機能が壊れているように見えます
- 場所：メイン検索バー

**概要：** アクセシビリティ、ユーザビリティ、機能カテゴリーにわたって 3 つの問題が見つかりました。スクリーンショット付きの完全なインタラクティブレポートについては、上記の URL を参照してください。

常に以下を含める：

• 実行 ID（例：ex_abc123）参照用
• 検出された問題 。重大度、カテゴリ（アクセシビリティ、ユーザビリティ、機能）、影響、場所を含む

スタックした実行のフォローアップ

リモートエージェントがスタックしたか、明確化が必要な場合、send-message を使用して続行します：

# 例：エージェントがログインでスタック、ユーザーが認証情報を提供
scoutqa send-message --execution-id ex_abc123 --prompt "
Use these test credentials: username: testuser@example.com, password: TestPass123
"

# 例：エージェントが次にテストするフローを尋ねる
scoutqa send-message --execution-id ex_abc123 --prompt "
Focus on the checkout flow next, skip the wishlist feature
"

テスト結果の確認

ScoutQA テストは ScoutQA インフラストラクチャでリモート実行されます。短いタイムアウトでテストを開始して実行 ID をキャプチャした後：

1. テストはリモートで実行を続けます（ローカルのバックグラウンドではなく）
2. すぐに他の作業に進むことができます
3. 結果を後で確認するには、テスト開始時に提供されたブラウザ URL にアクセスします
4. または、scoutqa get-execution --execution-id <id> を使用して CLI 経由で結果を取得します

ベストプラクティス： Bash ツールの timeout パラメータを 5000 ミリ秒に設定してテストを開始します。5 秒後、Bash ツールはタスク ID と実行詳細（実行 ID とブラウザ URL）で制御を返し、テストはバックグラウンドで実行を続けます。その後、他の作業を続けて、必要に応じて ScoutQA の Web サイトまたは CLI 経由で結果を確認できます。

トラブルシューティング

問題	ソリューション
command not found: scoutqa	CLI をインストール：npm i -g @scoutqa/cli@latest
Auth 期限切れ / 未認可	scoutqa auth login を実行
テストがハング / 入力が必要	scoutqa send-message --execution-id を使用
テスト結果を確認	ブラウザ URL または scoutqa get-execution --execution-id にアクセス
検証用の問題 ID が必要	scoutqa list-issues --execution-id <id> を実行