ゲームテストケースジェネレーター

コア機能

ゲームの要件ドキュメント（xls/csv/テキスト/画像）を標準化されたテストケースに変換します。以下の2つの生成モードをサポートしています。

• 完全モード：前提条件、詳細な手順、期待される結果を含む、規範的なテストケース
• クイックモード：迅速なレビューに適した、簡潔なテストポイントリスト

出力形式：Markdown（Xmindにインポート可能）または Excel

使用フロー

ステップ1：生成モードの確認

ユーザーにモード選択を尋ねます。

テストケース生成モードを選択してください：
1. 完全モード - 規範的なテストケースセットを生成します（番号、前提条件、操作手順、期待される結果を含む）
2. クイックモード - テストポイントリストのみを生成します（迅速なレビュー用）

デフォルト：完全モード

ステップ2：要件資料の解析

サポートされる入力形式：

• xls/xlsx/csv ファイル
• テキスト記述
• プロトタイプ画像（UI要素、インタラクションフローを認識）
• 混合形式（テキスト＋画像）

解析戦略：

1. 構造化ドキュメント（xls/csv）：

   • 列の識別：機能モジュール、要件記述、UI説明、受け入れ基準など
   • キー情報の抽出：ゲームプレイフロー、数値設定、インタラクションロジック

2. テキスト記述：

   • 機能モジュールの分解（例：ログイン、戦闘、ソーシャル、課金）
   • コアゲームプレイの抽出（例：ガチャ、ダンジョン、クエストシステム）
   • インタラクションポイントの識別（ボタンクリック、ジェスチャー操作、ポップアップロジック）

3. プロトタイプ画像：

   • インターフェース要素の識別：ボタンの位置、テキストボックス、ポップアップスタイル
   • フローロジックの理解：タスクガイド、ページ遷移、状態変化

要件マッピング表の出力：

| 要件ID | 要件記述 | ソース | テストポイント数 | 備考 |
|--------|----------|------|-----------|------|
| REQ-001 | ユーザーログイン | 要件ドキュメント3行目 | 8 | サードパーティログインを含む |

ステップ3：テストケースの生成

完全モードフロー

1. モジュール分類 ゲームの機能モジュールごとに整理します。

• アカウントシステム（ログイン/登録/アカウントセキュリティ）
• コアゲームプレイ（戦闘/育成/ソーシャル）
• システム機能（ショップ/インベントリ/クエスト）
• パフォーマンス/互換性

2. シナリオカバレッジ原則 各機能ポイントで少なくとも3つのシナリオをカバーします。

• 正常シナリオ：標準フローの実行
• 境界シナリオ：限界値テスト（レベル上限、アイテム最大数、長文字列入力）
• 異常シナリオ：エラー処理（ネットワーク切断、不正な入力、同時操作）

3. テストケース構造（テンプレートを使用：templates/full-template.md）

## テストケース番号：モジュール-機能番号-シナリオタイプ

**テストタイプ**：機能/性能/互換性/セキュリティ
**優先度**：高/中/低
**前提条件**：
- 条件1
- 条件2

**操作手順**：
1. 具体的な操作（「XXボタンをクリック」まで正確に）
2. 具体的な操作（「XX内容を入力」まで正確に）

**期待される結果**：
- 定量化可能な検証ポイント
- 曖昧さのない判断基準

**異常分岐**：
- 異常状況の記述と期待される処理

4. テストケース番号規則

• 形式：モジュール略称-機能番号-シナリオタイプ
• 例：LOG-001-N（ログインモジュール-1番目の機能-正常シナリオ）
• シナリオタイプ：N(正常)/B(境界)/E(異常)

5. 優先度定義

• 高：コアフロー、課金プロセス、アカウントセキュリティ
• 中：常用機能、二次的なゲームプレイ
• 低：最適化機能、エッジケース

クイックモードフロー

使用テンプレート：templates/quick-template.md

出力構造：

# モジュール名

## コアテストポイント
- [ ] テストポイント記述（検証基準を含む）
- [ ] テストポイント記述（検証基準を含む）

## 境界シナリオ
- [ ] テストポイント記述
- [ ] テストポイント記述

## 異常シナリオ
- [ ] テストポイント記述
- [ ] テストポイント記述

## 要確認事項
- ❓ 曖昧な要件記述 → 推奨案

ステップ4：品質チェック

必須チェック項目：

• [ ] 要件カバレッジ：すべての要件ポイントに対応するテストケースがあること
• [ ] シナリオの完全性：正常/境界/異常の3種類のシナリオが揃っていること
• [ ] 記述の明確性：「かもしれない」「おそらく」「だいたい」などの曖昧な言葉がないこと
• [ ] 実行可能性：手順が具体的で、結果が検証可能であること
• [ ] モジュール間連携：複数のモジュールが関わるシナリオがカバーされていること

要確認事項の処理： 曖昧/競合/欠落している要件にマークを付けます。

## 要確認事項

### 問題1：ログイン方法が不明確
**記述**：要件でサードパーティログインをサポートするかどうか説明されていません
**案A**：アカウントとパスワードによるログインのみをサポート
**案B**：WeChat/QQサードパーティログインをサポート
**推奨**：案B（業界慣行に合致）
**影響するテストケース**：LOG-003、LOG-004

ステップ5：形式変換

Markdown出力（デフォルト）：

• ドキュメント閲覧に直接使用可能
• Xmindへのインポートをサポート（スクリプト：scripts/convert_to_xmind.py）
• 階層構造：モジュール → 機能点 → テストケース

Excel出力（オプション）： スクリプトを使用：scripts/convert_to_excel.py

Excel表構造： | テストケース番号 | モジュール | 機能点 | テストタイプ | 優先度 | 前提条件 | 操作手順 | 期待される結果 | 異常分岐 | |---------|------|--------|---------|--------|---------|---------|---------|---------|

変換コマンド例：

# Excelに変換
python scripts/convert_to_excel.py output.md -o テスト用例集.xlsx

# Xmind形式に変換
python scripts/convert_to_xmind.py output.md -o テスト用例.xmind

出力仕様

ドキュメント構造

完全モード出力：

# [ゲーム名] テストケース集
**バージョン**：v1.0
**テストモジュール**：XXXモジュール
**生成時間**：2026-01-27

## 📋 要件マッピング表
[要件点 → テストケース番号 → カバーされるシナリオ]

## 📦 テストケース集

### モジュール1：アカウントシステム
#### 機能1.1：ユーザーログイン
##### テストケース LOG-001-N：正常ログインフロー
[完全なテストケース内容]

##### テストケース LOG-001-B：境界テスト - パスワード長上限
[完全なテストケース内容]

##### テストケース LOG-001-E：異常テスト - ネットワーク切断
[完全なテストケース内容]

## ❓ 要確認事項
[問題記述 + 案の比較 + 推奨案]

## 📊 統計情報
- 総テストケース数：XX
- 高優先度：XX
- 中優先度：XX
- 低優先度：XX
- 要確認事項：XX

クイックモード出力：

# [ゲーム名] テストポイントリスト
**バージョン**：v1.0
**生成時間**：2026-01-27

## モジュール1：アカウントシステム

### ユーザーログイン
- [ ] 正しいアカウントとパスワードでログイン成功、ゲームメイン画面に遷移
- [ ] 間違ったパスワードで「パスワードが間違っています」と表示され、ログイン不可
- [ ] パスワード32桁（上限）入力で正常ログイン
- [ ] ネットワーク切断で「ネットワーク接続に失敗しました」と表示
- [ ] 連続5回パスワード間違いでアカウントロックがトリガーされる

### サードパーティログイン
- [ ] WeChat認証ログイン成功、ゲームアカウントに自動バインド
- [ ] WeChat認証キャンセルでログインページに戻り、アカウントは作成されない
...

## ❓ 要確認事項
- ログイン方法に携帯電話番号認証ログインは含まれますか？
- アカウントロック期間が不明確（30分を推奨）

特殊シナリオ処理

要件の競合

識別基準：要件ドキュメントの異なるセクションで記述が矛盾している場合 処理方法：

## ⚠️ 要件の競合

**競合点**：ユーザーレベル上限
- 要件第3章の記述：レベル上限100
- プロトタイプ図の表示：レベル上限150

**調整案**：
- 案A：100を採用（ドキュメントを優先）
- 案B：150を採用（プロトタイプを優先）

**推奨**：案A、補足説明として「将来のバージョンで上限が引き上げられる場合、UI表示範囲の変更が必要」

**一時的な処理**：2つの境界テストケース（100と150）を生成

画像情報抽出

要件にプロトタイプ図が含まれる場合：

1. UI要素の識別：ボタン、テキストボックス、アイコンの位置とスタイル
2. インタラクションロジックの抽出：クリックフロー、ページ遷移、状態変化
3. UIテストポイントの生成：

   
   ### UIテストポイント（プロトタイプ図に基づく）

• [ ] 「今すぐログイン」ボタンは画面下部にあり、青い背景に白い文字
• [ ] アカウント入力欄には「アカウントを入力してください」というヒントテキストが灰色で表示
• [ ] パスワード入力欄の内容は丸点で表示され、平文/暗号文切り替えアイコンをサポート
• [ ] パスワードを忘れた場合のリンクはパスワード欄の右側にあり、フォントサイズ12px、青色

性能指標

要件に性能要件が含まれる場合：

### 性能テストケース PERF-001-N
**テストタイプ**：性能
**優先度**：高

**テストシナリオ**：100人が同時にオンラインで戦闘
**性能指標**：
- サーバー応答時間 ≤ 200ms
- クライアントフレームレート ≥ 30fps
- メモリ使用量 ≤ 512MB

**テスト手順**：
1. 性能監視ツールを起動
2. 100人のプレイヤーが同時に戦闘シーンに入るのをシミュレート
3. 5分間テストを継続
4. 性能データを記録

**期待される結果**：
- すべての指標が閾値範囲内であること
- クラッシュなし、カクつきなし

上級テクニック

テストケースの再利用

類似機能（異なるアイテムの使用ロジックなど）の場合、パラメータ化を使用します。

### テストケーステンプレート：アイテム使用 ITEM-USE-N
**パラメータ**：アイテムタイプ、使用効果、クールダウン時間

**テストデータ**：
| アイテムタイプ | 使用効果 | クールダウン時間 |
|---------|---------|---------|
| ライフポーション | HPを50%回復 | 30秒 |
| マナポーション | MPを50%回復 | 30秒 |
| 復活石 | その場で復活 | なし |

自動化識別

自動化可能なテストケースにタグを追加します。

**自動化度**：🤖 自動化可能 / ⚠️ 半自動化 / 👤 手動のみ

テストケース LOG-001-N：正常ログインフロー 🤖
テストケース COMBAT-005-N：戦闘エフェクト表現 👤

注意事項

1. 用語の統一：文書全体で一貫した用語を使用します（例：「プレイヤー」と「ユーザー」を混用しない）
2. 手順の具体性：「機能が正常か確認」ではなく、「HP値が100から50に減少したことを確認」のように具体的に記述します
3. 曖昧な言葉の禁止：「かもしれない」「おそらく」「だいたい」などの言葉は使用しません
4. モジュール間テストケース：複数のモジュールが連携するシナリオは個別にリストアップします
5. バージョンマーク：要件がバージョンごとに反復される場合、テストケースの所属バージョンを明記します

品質基準

合格基準：

• ✅ 要件カバレッジ ≥ 95%
• ✅ 各機能点で少なくとも3つのシナリオ（正常/境界/異常）
• ✅ コアフローのテストケースの優先度が「高」であること
• ✅ 曖昧な記述がないこと
• ✅ すべての要確認事項がマークされていること

補助リソース

• 完全テストケーステンプレート：templates/full-template.md
• クイックテストポイントテンプレート：templates/quick-template.md
• Excel変換スクリプト：scripts/convert_to_excel.py
• Xmind変換スクリプト：scripts/convert_to_xmind.py