deno-gemini-grounding-mcp-server: Command for Claude Code

t-wada流TDDによるテスト作成

GEMINI.mdの「テスト戦略」セクションで定義されているt-wada流のテスト駆動開発（TDD）に従って、高品質なテストを作成します。

TDDの基本サイクル

1. 🔴 Red: 失敗するテストを書く
2. 🟢 Green: テストを通す最小限の実装
3. 🔵 Refactor: リファクタリング

実行手順

1. TODOリストの作成

実装したい機能をリストアップし、最小単位に分解します：

[ ] 基本的な機能の動作確認
[ ] エッジケースの処理
[ ] エラーハンドリング
[ ] パフォーマンスが重要な場合はベンチマーク

2. テストファイルの配置

tests/
├── unit/            # 単体テスト
├── property/        # プロパティベーステスト（Hypothesis使用）
├── integration/     # 統合テスト
└── conftest.py      # pytestフィクスチャ

3. テストの命名規則

日本語で意図を明確に表現します：

def test_正常系_有効なデータで処理成功():
    """chunk_listが正しくチャンク化できることを確認。"""

def test_異常系_不正なサイズでValueError():
    """チャンクサイズが0以下の場合、ValueErrorが発生することを確認。"""

def test_エッジケース_空リストで空結果():
    """空のリストをチャンク化すると空の結果が返されることを確認。"""

4. templateディレクトリの参考例

単体テスト (@template/tests/unit/test_example.py)

• 関数・クラスの基本動作
• 正常系・異常系・エッジケース
• パラメトライズテストの活用

プロパティベーステスト (@template/tests/property/test_helpers_property.py)

• Hypothesisによる自動テストケース生成
• 不変条件の検証
• エッジケースの自動発見

統合テスト (@template/tests/integration/test_example.py)

• コンポーネント間の連携
• ファイルI/Oやデータ処理パイプライン
• エラーのカスケード処理

三角測量の実践例

# Step 1: 最初のテスト（仮実装で通す）
def test_add_正の数():
    assert add(2, 3) == 5

def add(a, b):
    return 5  # 仮実装

# Step 2: 2つ目のテスト（一般化を促す）
def test_add_別の正の数():
    assert add(1, 4) == 5
    assert add(10, 20) == 30  # これで仮実装では通らない

def add(a, b):
    return a + b  # 一般化

# Step 3: エッジケースを追加
def test_add_負の数():
    assert add(-1, -2) == -3
    assert add(-5, 3) == -2

TDD実践時の注意点

1. テストは1つずつ追加 - 一度に複数のテストを書かない
2. 小さく頻繁にコミット - Red→Green、Refactor完了でコミット
3. テストの粒度 - 1つのテストで1つの振る舞いをテスト
4. リファクタリングの判断 - 重複コード、可読性、設計原則
5. テストファーストの徹底 - 必ず失敗するテストから書く

実行コマンド

# テストの実行
make test              # 全テスト実行
make test-unit         # 単体テストのみ
make test-property     # プロパティベーステストのみ
make test-cov          # カバレッジ付きテスト

# 特定のテストを実行
uv run pytest tests/unit/test_example.py::TestExampleClass::test_正常系_初期化時は空のリスト -v

このコマンドを使用することで、堅牢で保守性の高いテストスイートを構築できます。