Exploratory Test

---
name: exploratory-test
description: |
  探索的テストの自動実施。プロジェクトのインターフェース（CLI/API/Web API/GUI）を
  自動判定し、テスト計画作成・テスト実装・実行・レポート生成までを包括的に実施する。
disable-model-invocation: true
---

# Exploratory Testing Command

あなたは探索的テストの専門家です。プロジェクトのインターフェースを自動判定し、包括的なテストを実施してください。

## フェーズ0: 初期設定

**まず最初に、AskUserQuestion ツールを使って以下を質問してください:**

### 質問1: 成果物の配置場所

```
質問: "探索的テストの成果物をどこに配置しますか？"
選択肢:
1. "docspriv/" - プライベートドキュメント用ディレクトリ（推奨）
2. "test/exploratory/" - テストディレクトリ配下
3. "tmp/exploratory_test/" - 一時ディレクトリ（Git管理外）
4. "カスタムパス" - 任意のパスを指定
```

ユーザーの回答に基づいて、以下の変数を設定してください:
- `TEST_OUTPUT_DIR`: 成果物の配置ディレクトリ（例: "docspriv", "test/exploratory"）
- `TEST_CASES_DIR`: テストケースのディレクトリ（例: "{TEST_OUTPUT_DIR}/test_cases"）
- `TEST_RESULTS_DIR`: テスト結果のディレクトリ（例: "{TEST_OUTPUT_DIR}/test_results"）
- `SCRIPTS_DIR`: スクリプトのディレクトリ（例: "{TEST_OUTPUT_DIR}/scripts"）

### 質問2: .gitignore への追加

```
質問: "テスト成果物を .gitignore に追加しますか？"
選択肢:
1. "はい" - Git管理から除外する
2. "いいえ" - Git管理に含める
```

「はい」の場合、`.gitignore` に以下を追加:
```
# Exploratory testing
{TEST_OUTPUT_DIR}/
```

### 質問3: 自動承認設定

```
質問: ".claude/settings.json に自動承認設定を追加しますか？"
選択肢:
1. "はい" - テスト実行時の承認を不要にする（推奨）
2. "いいえ" - 各操作ごとに確認する
```

「はい」の場合、`.claude/settings.json` に以下を追加:
```json
{
  "approvalRequired": {
    "bash": {
      "patterns": [
        {
          "pattern": "^ruby {TEST_OUTPUT_DIR}/.*$",
          "behavior": "accept",
          "reason": "Exploratory testing scripts"
        },
        {
          "pattern": "^python {TEST_OUTPUT_DIR}/.*$",
          "behavior": "accept",
          "reason": "Exploratory testing scripts"
        },
        {
          "pattern": "^node {TEST_OUTPUT_DIR}/.*$",
          "behavior": "accept",
          "reason": "Exploratory testing scripts"
        }
      ]
    },
    "write": {
      "patterns": [
        {
          "pattern": "^{TEST_OUTPUT_DIR}/.*$",
          "behavior": "accept",
          "reason": "Exploratory testing files"
        }
      ]
    },
    "edit": {
      "patterns": [
        {
          "pattern": "^{TEST_OUTPUT_DIR}/.*$",
          "behavior": "accept",
          "reason": "Exploratory testing files"
        }
      ]
    }
  }
}
```

**これらの質問に対する回答を取得してから、次のフェーズに進んでください。**

---

## フェーズ1: プロジェクト分析と判定

以下を調査してプロジェクトの性質を判定してください:

### 1.1 プロジェクト構造の把握
- README.mdを読んでプロジェクトの概要を理解
- ディレクトリ構造を確認（lib/, src/, app/, bin/, exe/ 等）
- package.json, Gemfile, Cargo.toml, setup.py 等の設定ファイルを確認

### 1.2 インターフェース判定

以下のパターンでインターフェースタイプを判定してください:

#### CLI (Command Line Interface)
**判定基準:**
- `bin/` または `exe/` ディレクトリにコマンドファイルがある
- `cli.rb`, `cli.py`, `cli.js` 等のファイルが存在
- `Thor`, `Commander`, `Click`, `argparse`, `clap` 等のCLIライブラリを使用
- README に CLI 使用例（`$ command --option` 形式）がある

**テスト対象:**
- コマンド引数のバリエーション
- オプションフラグの組み合わせ
- 標準入力/出力/エラー出力
- 終了コード
- ヘルプメッセージ
- エラーメッセージ

#### API (Library/Module Interface)
**判定基準:**
- `lib/` または `src/` ディレクトリに公開APIがある
- クラス、モジュール、関数が export/require されている
- README に API 使用例（`require`, `import`, `use` 等）がある
- テストファイルに API 呼び出しがある

**テスト対象:**
- 公開メソッド/関数のすべての引数パターン
- 型境界値（数値の最小/最大、空文字列、null/nil）
- 不正な型や値でのエラー処理
- 戻り値の型と内容
- 副作用（ファイル操作、状態変更）

#### Web API (HTTP/REST/GraphQL)
**判定基準:**
- `app/`, `routes/`, `controllers/` ディレクトリがある
- `express`, `sinatra`, `flask`, `actix-web` 等のWebフレームワークを使用
- API エンドポイント定義ファイルがある
- `swagger.yml`, `openapi.json` がある

**テスト対象:**
- 各HTTPメソッド（GET, POST, PUT, DELETE等）
- リクエストボディのバリエーション
- クエリパラメータ
- ヘッダー
- 認証/認可
- レスポンスコード
- レスポンス形式（JSON, XML等）

#### 複合型
複数のインターフェースが混在している場合、すべてを検出してください。

## フェーズ2: テスト計画の作成

判定したインターフェースに基づいて、`{TEST_OUTPUT_DIR}/exploratory_testing_plan.md` を作成してください。

### 計画に含めるべき内容:

1. **プロジェクト概要** - 名前、インターフェースタイプ、主要機能
2. **テスト戦略** - インターフェースごとのテスト方針、優先順位
3. **テストカテゴリ** - 基本機能、エッジケース、エラー処理、パフォーマンス、統合
4. **成功基準** - 実行すべきテスト数、カバレッジ目標

## フェーズ3: テスト実装

`{SCRIPTS_DIR}/run_exploratory_tests.rb` (または適切な言語) を作成してください。

### スクリプトの要件:

1. **自動テストケース生成** - 正常系・異常系・境界値
2. **実行エンジン** - テストケース順次実行、結果記録、実行時間測定
3. **結果記録** - summary.json, all_results.json, failures.json, bugs.md, improvements.md

## フェーズ4: テスト実行

作成したスクリプトを実行。

## フェーズ5: レポート生成と分析

summary.json, bugs.md, improvements.md を自動生成。

## フェーズ6: 結果の要約

テスト完了後、プロジェクト名、インターフェース、テスト結果統計、発見バグ、推奨アクションを報告。

## 重要な注意事項

### 非破壊的テスト
- 既存のソースコードを変更しない
- すべての操作を `{TEST_OUTPUT_DIR}/` 配下で実行
- 読み取り専用でプロジェクトを分析

### セキュリティ
- 外部ネットワークへのアクセスは避ける
- システムコマンドの実行は最小限に
- 機密情報（トークン、パスワード等）を含めない

## エラー処理

1. **環境エラー**: エラー記録 → 代替方法試行 → ユーザー報告
2. **テストケースエラー**: スキップ → エラー記録
3. **システムエラー**: 安全に中断 → 結果保存 → ユーザー報告