QA Nightmare Test Generator

対象: $ARGUMENTS

トリガー条件

以下のいずれかに該当する場合に発動する:

発動しない場合:

• 単体の軽微なバグ修正確認 → 通常のテスト作成で対応
• ユニットテストのみの依頼 → TDDスキルを使用
• $ARGUMENTS が空の場合 → 対象機能と画面URLをユーザーに確認してから開始

前提条件

禁止事項・制約

概要

QAベテランが「これを見落とすと本番障害になる」と考える悪夢テストケースを、 網羅的チェックリストから対象機能に当てはめて生成し、e2e-browser スキルで自動実行する。

チェックリスト一覧

以下の9カテゴリ・90+パターンを対象機能に適用する。 各チェックリストは ~/.claude/skills/qa-nightmare/checklists/ に格納。

Phase 1: 機能分析

対象機能について以下を把握する。ユーザーに確認するか、コードを読んで推測する。

ステップ

1. $ARGUMENTS から対象機能名・画面URLを読み取る
2. 情報が不足している場合はユーザーに確認する（以下の「把握すべき情報」を参照）
3. 把握した情報を箇条書きでまとめてから次フェーズに進む

把握すべき情報

1. 画面構成: URL一覧、画面遷移図(一覧 → 詳細 → 編集 等)
2. CRUD操作: どのテーブルに対してどの操作があるか
3. 入力フィールド: 各フィールドの型・制約・必須/任意
4. 状態遷移: ステータス値とその遷移パス(下書き→承認→完了等)
5. 権限モデル: どのロールがどの操作を実行可能か
6. 外部連携: 他テーブル・API・バッチとの依存
7. ビジネスルール: 計算ロジック、バリデーションルール

Phase 2: チェックリスト適用

ステップ

1. 全チェックリストファイルを読み込む:

ls ~/.claude/skills/qa-nightmare/checklists/*.md

2. 各カテゴリのファイルを順番に読む
3. 各パターンを対象機能に当てはめ、該当するパターンのみを抽出する
4. スキップしたパターンはスキップ理由を記録する

適用判定基準

該当しないパターンの例

• ファイルアップロードがない機能に BH-11(ファイルアップロード境界)
• 状態遷移がないマスタCRUDに ST-01(逆方向遷移)
• シングルテナントに AB-08(マルチテナントのデータ分離)

Phase 3: ランク付け

ステップ

1. 抽出したテストケースを「嫌度」で評価する
2. 各ケースに S / A / B / C ランクを付与する
3. 下記フォーマットで一覧を作成する

嫌度 = 発見困難度 × 被害度

出力フォーマット

## 悪夢テストケース一覧: <対象機能>

### S ランク(必ず実施)
| ID | カテゴリ | シナリオ | 攻撃手法 | 壊れ方 |
|----|---------|---------|---------|--------|
| TC-001 | SC-07 | カスケード削除漏れ | 親レコード削除→子テーブル確認 | 孤児レコード残存 |

### A ランク(強く推奨)
...

### B ランク(推奨)
...

### C ランク(余裕があれば)
...

合計: XX ケース (S: X, A: X, B: X, C: X)

Phase 4: ユーザー確認

⚠️ このフェーズは必須。スキップ禁止。

テストケース一覧をユーザーに提示し、以下を確認する:

1. 実行するランクの範囲(S+A のみ? 全部?)
2. 除外したいケースはあるか
3. 追加したい独自ケースはあるか

ユーザーの確認・承認を得てから Phase 5 に進む。

Phase 5: e2e-browser 自動連携

確定したテストケースを /e2e-browser の形式で自動実行する。

5-1. workspace準備

e2e-browser と同じ workspace を使う:

E2E_WORK="/tmp/e2e-browser-$(echo "$PWD" | md5sum | cut -c1-12)"

e2e-browser の Phase 0(環境チェック)を実行。 .env.e2e / docker-compose.e2e.yml が未生成ならここで生成する。

5-2. テストコード一括生成

各テストケースについて:

1. Fixture JSON を $E2E_WORK/fixtures/nightmare/<TC-ID>.json に生成
2. テストコードを $E2E_WORK/tests/nightmare/<TC-ID>.spec.ts に生成

テストコードは e2e-browser の必須ルールに従う:

• captureStep / captureState で全ステップスクショ
• dbAssert でDB検証
• beginCapture / destroyDb 必須

5-3. 実行

全ケース一括実行:

docker compose -f "$E2E_WORK/docker-compose.e2e.yml" \
  run --rm --service-ports e2e-runner \
  bun run playwright test tests/nightmare/ \
  --reporter=list --project=chrome

5-4. 結果レポート

## 悪夢テスト結果: <対象機能>

### Summary
- Total: XX ケース
- Pass: XX
- Fail: XX
- 所要時間: XXs

### 失敗ケース詳細
| ID | ランク | シナリオ | 失敗理由 | スクショ |
|----|:------:|---------|---------|---------|
| TC-001 | S | カスケード削除漏れ | 子テーブルに3件残存 | screenshots/TC-001_step03_*.png |

### 推奨対応
1. [S] TC-001: ON DELETE CASCADE の追加 or アプリ層での削除処理
2. [A] TC-005: ...

Phase 6: クリーンアップ

e2e-browser の Phase 5 と同様:

docker compose -f "$E2E_WORK/docker-compose.e2e.yml" down -v
rm -rf "$E2E_WORK"

チェックリスト拡張

新しいパターンを追加する場合:

1. 該当カテゴリの .md に追記(IDは連番)
2. または新カテゴリの .md を checklists/ に追加
3. 上記テーブルに反映

パターンのフォーマット:

### XX-NN: タイトル
- 攻撃: 具体的な操作手順
- 検証: 何を確認するか
- 壊れ方: 発生する障害
- スクショ箇所: (UI系のみ)
- 嫌度: ★☆☆☆☆ 〜 ★★★★★