共通シナリオ

共通シナリオは、プロジェクトレベルで存在する再利用可能なシナリオテンプレートです。頻繁に使用されるテストフローを一度定義し、任意のQAプランに含めることができます。

ユースケース

共通シナリオは、多くのプランに登場するテストフローに適しています。

• ログインフロー — 機能テストの前にユーザーを認証します。
• テストデータのセットアップ — 前提となるデータ（ユーザー、リソース、設定）を作成します。
• クリーンアップルーチン — 実行後にテストデータを削除します。

共通シナリオの作成

AI エージェントに、どんな再利用可能なフローが必要かを伝えてください。エージェントが適切な MCP ツールを使って共通シナリオを作成します。

プロンプトの例:

「アプリへのログインの共通シナリオを作成して。ログインページに遷移して、メールアドレスとパスワードを入力し、ダッシュボードが表示されるまで待つようにして。認証情報は変数にして。」

エージェントは以下のようなシナリオを作成します。

{
  "name": "Standard Login",
  "description": "test_email と test_password の変数を使ってログインします。",
  "requires": ["test_email", "test_password", "web_base_url"],
  "steps": [
    {
      "step_key": "login_navigate",
      "action": "browser",
      "config": {
        "steps": [
          { "action": "goto", "url": "{{web_base_url}}/login" },
          { "action": "type", "selector": "#email", "text": "{{test_email}}" },
          { "action": "type", "selector": "#password", "text": "{{test_password}}" },
          { "action": "click", "selector": "button[type='submit']" },
          { "action": "wait_for_url", "url": "/dashboard" }
        ]
      }
    }
  ]
}

パラメーター

パラメーター	説明
name	シナリオの説明的な名前です。
description	シナリオが何を行い、いつ使用するかの説明です。
requires	（任意） シナリオの実行に必要な変数名のリストです。
steps	シナリオを構成するステップの順序付きリストです。

QA プランでの使用

AI エージェントが QA プランを作成する際、既存の共通シナリオを ID で参照して含めることができます。エージェントに指示することもできます。

「ユーザープロフィールページの QA プランを作成して。認証には Standard Login シナリオを使って。」

共通シナリオのステップはその時点でスナップショットコピーされてプランバージョンに取り込まれます。これは以下を意味します。

• プランバージョンはステップの独立したコピーを取得します。
• 共通シナリオへの将来の変更は、既存のプランバージョンに影響しません。
• プランバージョンは自己完結的で再現可能です。

共通シナリオの管理

AI エージェントに依頼して、共通シナリオの一覧表示、更新、削除ができます。

• 一覧表示 — 「共通シナリオにはどんなものがある？」— エージェントがプロジェクト内のすべての共通シナリオを取得します。
• 更新 — 「ログインシナリオのセレクタを ID ではなく CSS クラスに変更して。」— エージェントがシナリオのステップを修正します。
• 削除 — 「古いクリーンアップシナリオを削除して。」— エージェントがプロジェクトから削除します。

削除時の動作

共通シナリオを削除しても、そのステップをすでにコピーした QA プランには影響しません。ステップはプランバージョン作成時にスナップショットコピーされるため、元の共通シナリオが削除された後もプランバージョンは完全で実行可能な状態を維持します。