QA Game

Playwright を使用して既存のゲームプロジェクトに自動化された QA テストを追加します。テストはゲームの起動、シーンの動作、スコアリング機能、ビジュアルの破損を検証します。ゲームの安全ネットのような役割を果たします。

手順

$ARGUMENTS のゲーム (またはパスが指定されない場合は現在のディレクトリ) を分析します。

まず、game-qa スキルを読み込んで、完全なテストパターンと fixtures を入手します。

ステップ 1: テスト可能性の監査

• package.json を読み込んでエンジンと dev サーバーポートを特定する
• vite.config.js を読み込んでサーバーポートを確認する
• src/main.js を読み込んで window.__GAME__、window.__GAME_STATE__、window.__EVENT_BUS__ が公開されているか確認する
• src/core/GameState.js を読み込んで利用可能な状態を理解する
• src/core/EventBus.js を読み込んで存在するイベントを理解する
• src/core/Constants.js を読み込んでゲームパラメータ (レート、スピード、期間、最大値) を理解する
• すべてのシーンファイルを読み込んでゲームフローを理解する
• design-brief.md が存在する場合はそれを読み込む。期待されるメカニクス、大きさ、勝利/敗北の到達可能性をドキュメント化しています

ステップ 2: Playwright のセットアップ

1. 依存関係をインストール: npm install -D @playwright/test @axe-core/playwright && npx playwright install chromium
2. 正しい dev サーバーポートと webServer 設定で playwright.config.js を作成する
3. src/main.js で window.__GAME__、window.__GAME_STATE__、window.__EVENT_BUS__、window.__EVENTS__ を公開する (まだの場合)
4. テストディレクトリ構造を作成する:

   tests/
   ├── e2e/
   │   ├── game.spec.js
   │   ├── visual.spec.js
   │   └── perf.spec.js
   ├── fixtures/
   │   └── game-test.js
   └── helpers/
       └── seed-random.js
   

5. npm スクリプトを追加: test、test:ui、test:headed、test:update-snapshots

ステップ 3: テストの生成

ゲームが実際に行うことに基づいてテストを記述します:

• game.spec.js: 起動テスト、シーン遷移、入力処理、スコアリング、ゲームオーバー、再スタート
• visual.spec.js: 安定したシーン (ゲームプレイの初期状態、ゲームオーバー) のスクリーンショット回帰テスト。アクティブなゲームプレイのスクリーンショットはスキップします。動くオブジェクトは不安定になります。
• perf.spec.js: ロード時間予算、ゲームプレイ中の FPS、キャンバスのサイズ

game-qa スキルパターンに従います。gamePage fixture を使用します。page.evaluate() でゲーム状態を読み込みます。入力には page.keyboard.press() を使用します。

ステップ 4: 設計意図テスト

test.describe('Design Intent') ブロックを game.spec.js に追加します。これらのテストは、技術的には存在するが強度が不足しているメカニクスを見つけます。

1. 敗北条件: ゲームに敗北状態があるかどうかを確定的に検出します。 GameState.js を読み込みます。won、result または同様のブール値/列挙型フィールドがある場合、ゲームは勝利と敗北を区別します。また main.js の render_game_to_text() を確認します。('win' 対 'game_over' など) 異なる結果モードを返す場合、ゲームには敗北状態があります。

   敗北状態が存在する場合: ゲームを開始し、入力を提供しないでください。完了まで実行させます (page.waitForFunction を Constants.js のラウンド期間で使用)。結果が敗北のものであることをアサートします (例: won === false、mode === 'game_over')。

   このアサーションは絶対です。 プレイヤーが入力しなくても勝つようなテストを書かないでください。現在のゲームの動作が「入力なしでプレイヤーが勝つ」である場合、それはバグです。テストを書いてそれをキャッチします。

2. 相手/AI の圧力: AI 駆動のメカニクス (自動昇降バー、敵のスポーン、難易度上昇) が存在する場合、それが実質的な状態変化を生じることをテストします。プレイヤー入力なしでゲームをその期間の半分実行します。相手の状態が最大値の少なくとも 25% に達することをアサートします。design-brief.md が存在する場合は、その予想される大きさをしきい値に使用します。それ以外の場合、Constants.js から導出します: rate * duration を計算し、意味のあるレベルに達することをアサートします。

3. 勝利条件: アクティブなプレイヤー入力が勝利につながることをテストします。ラウンド中ずっと急速な入力を提供し、結果が勝利であることをアサートします。

ステップ 5: エンティティ相互作用監査

初めてのプレイヤーを混乱させる非対称性について、衝突と相互作用ロジックを監査します。

design-brief.md に "Entity Interactions" セクションがある場合、それをチェックリストとして使用します。それ以外の場合、GameScene.js を直接監査します:

1. すべての衝突ハンドラ、重なり確認、または距離ベースの相互作用を見つける
2. どのエンティティがどの他のエンティティと相互作用するかをマッピングする
3. 一方の側 (プレイヤーまたは相手のいずれか) と相互作用するが他方とは相互作用しない目に見える動くエンティティにフラグを立てる。テストファイルに // QA FLAG: asymmetric interaction コメントを追加して、エンティティ名と非対称性を記載します

これはフラグであり、ハード失敗ではありません。いくつかの非対称性は意図的です (例: プレイヤーにのみ影響するハザード)。フラグにより、その非対称性が意識的な設計選択であり、見落としではないことが保証されます。

ステップ 6: 実行と確認

1. npx playwright test を実行してすべてのテストを実行する
2. ビジュアルテストが初回実行時に失敗する場合、それは想定通りです。npx playwright test --update-snapshots でベースラインを生成します
3. すべてのテストが成功することを確認するために再度実行します
4. 結果を要約します

ステップ 7: レポート

ユーザーに平易な言語で伝えます:

• 作成されたテスト数とそれらが何をチェックするか
• 実行方法: npm test (ヘッドレス)、npm run test:headed (ブラウザを表示)、npm run test:ui (インタラクティブダッシュボード)
• 「これらのテストはあなたの安全ネットです。変更を加えた後にいつでも実行して、何も壊れていないことを確認してください。」

使用例

/qa-game examples/flappy-bird

結果: Playwright をインストール → 15 個のテストを作成 (起動、シーン遷移、入力、スコアリング、再スタート、ゲームオーバー、ビジュアル回帰、FPS、ロード時間) → fixtures とヘルパーを備えた tests/ ディレクトリを生成 → すべてのテストが成功します。変更後いつでも npm test を実行してください。

次のステップ

ユーザーに伝えます:

Your game now has automated tests! Finally, run /game-creator:review-game for a full architecture review — it checks your code structure, performance patterns, and gives you a score with specific improvement suggestions.

Pipeline progress: /viral-game → /design-game → /add-audio → /qa-game → /review-game

(This is the /viral-game one-shot pipeline — not the /make-game multi-session, milestone-driven workflow.)