Claude Code テスト自動化・TDD完全ガイド｜ユニットテスト生成・Jest/Vitest/pytest連携・カバレッジ向上の実践パターン

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    globals: true,
    environment: 'node',
    coverage: {
      provider: 'v8',
      reporter: ['text', 'json', 'html'],
      thresholds: {
        lines: 80,
        functions: 80,
        branches: 80,
        statements: 80,
      },
    },
  },
})

{
  "scripts": {
    "test": "vitest run",
    "test:watch": "vitest",
    "test:coverage": "vitest run --coverage",
    "test:ui": "vitest --ui"
  }
}

[pytest]
testpaths = tests
addopts = -v --tb=short --cov=src --cov-report=term-missing --cov-fail-under=80

pip install pytest pytest-cov pytest-asyncio

# テスト実行
pytest

# カバレッジレポートをHTMLで出力
pytest --cov=src --cov-report=html

## テスト

### テストコマンド
- 単体テスト: `npm test` または `pytest`
- カバレッジ確認: `npm run test:coverage` または `pytest --cov=src`
- 特定ファイル: `npx vitest run src/utils/` または `pytest tests/test_utils.py`

### テストルール
- コードを変更したら必ずテストを実行すること
- 新機能追加時は対応するテストを必ず書くこと
- カバレッジは80%以上を維持すること
- テストは正常系だけでなく境界値・エラーケースも含めること
- テストが通るためだけのハードコーディングや条件分岐を実装コードに入れない

claude "以下の仕様を満たすコードのテストを書いてください。
実装ファイルは見ないでください（まだ存在しません）。
失敗するテストコードだけを書くことが目的です。

【仕様】
- formatPrice(price: number, currency: string): string 関数を実装する
- 価格を3桁カンマ区切りでフォーマットする
- 通貨コード（USD/JPY/EUR）に応じて記号（$/¥/€）を先頭に付ける
- 負の数は受け付けない（エラーをthrowする）
- 小数点以下はUSD/EURは2桁、JPYは0桁"

claude "次のテストコードがすべて通るように実装してください。
テストを変更することは禁止です。
最小限のコードで通してください。

$(cat tests/formatPrice.test.ts)"

claude "以下のコードをリファクタリングしてください。
テストはすべて通ったままにすること。

チェックポイント：
- 重複コードの除去
- マジックナンバー・文字列をconstに切り出す
- エラーメッセージを具体的にする
- 型定義を明示的にする"

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "cd $CLAUDE_PROJECT_DIR && npm test -- --reporter=verbose 2>&1 | tail -30"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# stdin からツール情報を受け取る
INPUT=$(cat)
CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

# git commit コマンドの場合にテストを強制
if echo "$CMD" | grep -q "git commit"; then
  echo "テスト実行中..." >&2
  cd "$CLAUDE_PROJECT_DIR"
  if ! npm test -- --run 2>&1; then
    echo "テストが失敗しています。コミット前にテストを通してください。" >&2
    exit 2  # exit 2 でコマンドをブロック
  fi
fi

exit 0

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "bash $CLAUDE_PROJECT_DIR/.claude/hooks/require-tests.sh"
          }
        ]
      }
    ]
  }
}

# カバレッジレポートをJSON形式で生成（Vitest）
npx vitest run --coverage --reporter=json

# Claudeに分析させる
claude "coverage/coverage-summary.json を読んで、
カバレッジが低い箇所を特定し、優先度が高い順にテストを追加してください。
追加後に npm run test:coverage を実行してカバレッジを確認してください"

## テスト品質基準
- カバレッジは常に80%以上を維持すること
- カバレッジが80%を下回った場合は、コード変更を完了させる前に
  追加テストを書いてカバレッジを回復すること
- `npm run test:coverage` の出力でthresholdエラーが出た場合は
  それを解消することを優先すること

// Claude への指示
// 「以下の関数に対するテストを書いてください。
//   - 正常系: 典型的な入力と期待出力
//   - 境界値: 最小値・最大値・空文字・0
//   - 異常系: null/undefined・型違い・範囲外の値
//   モック化が必要な外部依存があれば vi.mock() を使ってください」

// 生成されるテスト例
import { describe, it, expect, vi } from 'vitest'
import { formatPrice } from '../src/formatPrice'

describe('formatPrice', () => {
  // 正常系
  it('USD: 3桁カンマ区切りと$記号', () => {
    expect(formatPrice(1000, 'USD')).toBe('$1,000.00')
  })
  it('JPY: 小数なし、¥記号', () => {
    expect(formatPrice(1000, 'JPY')).toBe('¥1,000')
  })

  // 境界値
  it('0円は正常に処理される', () => {
    expect(formatPrice(0, 'USD')).toBe('$0.00')
  })

  // 異常系
  it('負の値はエラーをthrowする', () => {
    expect(() => formatPrice(-1, 'USD')).toThrow()
  })
  it('不正な通貨コードはエラーをthrowする', () => {
    expect(() => formatPrice(100, 'XXX')).toThrow()
  })
})

# Claude への指示
# 「以下の Python 関数のテストを pytest で書いてください。
#   正常系・境界値・例外系を網羅してください。
#   外部依存は pytest-mock の mocker を使ってください」

import pytest
from src.format_price import format_price

class TestFormatPrice:
    def test_usd_format(self):
        assert format_price(1000, "USD") == "$1,000.00"

    def test_jpy_no_decimal(self):
        assert format_price(1000, "JPY") == "¥1,000"

    def test_zero_price(self):
        assert format_price(0, "USD") == "$0.00"

    def test_negative_raises(self):
        with pytest.raises(ValueError, match="負の値"):
            format_price(-1, "USD")

    def test_invalid_currency_raises(self):
        with pytest.raises(ValueError, match="通貨コード"):
            format_price(100, "XXX")

    @pytest.mark.parametrize("amount,expected", [
        (1, "$1.00"),
        (999, "$999.00"),
        (1000, "$1,000.00"),
        (1000000, "$1,000,000.00"),
    ])
    def test_comma_formatting(self, amount, expected):
        assert format_price(amount, "USD") == expected

# テスト結果をファイルに保存してClaudeに渡す
npm test 2>&1 | tee test-output.txt
claude "test-output.txt の内容を確認して、テスト失敗の原因を調査・修正してください"

# または直接パイプ
npm test 2>&1 | claude "このテスト失敗を修正してください"

# ultrathink をプロンプトに含めるだけで有効
claude "ultrathink このテストが特定の環境でのみ失敗する原因を調査してください。
テストコード: tests/integration/auth.test.ts
関連ファイル: src/auth/*, src/middleware/*"