Claude Codeでテストコードを自動生成する実践ガイド

// Claudeが生成した「テスト」の実態
vi.mock('../utils/fetchUser')
vi.mock('../utils/validateInput')
vi.mock('../lib/database')

it('should work', () => {
  expect(mockFetchUser).toHaveBeenCalled()
})

## テスト方針

### 使用ツール
- テストランナー: Vitest
- アサーション: Vitest built-in (expect)
- モックライブラリ: vi.fn(), vi.spyOn() — ただし最小限に
- カバレッジ: @vitest/coverage-v8

### テスト作成のルール
1. 外部IO（DB・API・ファイルシステム）のみモック対象とする
2. ユーティリティ関数・純粋関数はモックしない
3. テストケース名は「〇〇のとき、〇〇を返す」の形式で書く
4. エッジケース（空配列・null・境界値）を必ず含める
5. テストファイルは実装ファイルと同じディレクトリに置く（`*.test.ts`）

### カバレッジ閾値
- statements: 80%
- branches: 75%
- functions: 80%
- lines: 80%

### 禁止事項
- `as any` の使用
- 実装の詳細（内部変数名・private メソッド）をテストしない
- テストのためだけにコードを変更しない

`src/utils/calculateDiscount.ts` のテストをVitestで書いてください。

外部依存はありません。モックは使わないでください。
純粋関数なので、入力と出力の組み合わせを網羅的にテストしてください。

以下のケースを必ずカバーしてください：
- discountRate が 0 のとき
- discountRate が 1.0（100%引き）のとき
- price が 0 のとき
- price が負の値のとき（エラーを期待）

テスト名は「〇〇のとき、〇〇を返す」の日本語形式で統一してください。

import { describe, it, expect } from 'vitest'
import { calculateDiscount } from './calculateDiscount'

describe('calculateDiscount', () => {
  describe('正常系', () => {
    it('discountRateが0.2のとき、価格の80%を返す', () => {
      expect(calculateDiscount(1000, 0.2)).toBe(800)
    })

    it('discountRateが0のとき、元の価格をそのまま返す', () => {
      expect(calculateDiscount(1000, 0)).toBe(1000)
    })

    it('discountRateが1.0のとき、0を返す', () => {
      expect(calculateDiscount(1000, 1.0)).toBe(0)
    })
  })

  describe('境界値', () => {
    it('priceが0のとき、0を返す', () => {
      expect(calculateDiscount(0, 0.2)).toBe(0)
    })
  })

  describe('異常系', () => {
    it('priceが負の値のとき、Errorをスローする', () => {
      expect(() => calculateDiscount(-100, 0.2)).toThrow('Price must be non-negative')
    })

    it('discountRateが1を超えるとき、Errorをスローする', () => {
      expect(() => calculateDiscount(1000, 1.5)).toThrow('Discount rate must be between 0 and 1')
    })
  })
})

以下の仕様に基づいてVitestのテストを書いてください。実装はまだ作りません。

仕様:
- `parseJapaneseDate(str: string): Date` 関数を作る
- "2026年2月26日" 形式の文字列をDateオブジェクトに変換する
- 不正なフォーマットのときはInvalidDateErrorをスローする
- タイムゾーンはJST（UTC+9）で固定

npx vitest run src/utils/parseJapaneseDate.test.ts

`src/utils/parseJapaneseDate.test.ts` のテストをすべてパスする実装を書いてください。
テストを変更せずに実装側だけで解決してください。

npx vitest --watch src/utils/parseJapaneseDate.test.ts

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

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    coverage: {
      provider: 'v8',
      reporter: ['text', 'json', 'html'],
      thresholds: {
        statements: 80,
        branches: 75,
        functions: 80,
        lines: 80,
      },
      exclude: [
        'node_modules/**',
        'src/**/*.d.ts',
        'src/**/*.stories.tsx',
        'src/app/**', // Next.js App Routerのページは除外
      ],
    },
  },
})

# .github/workflows/test.yml
name: Test

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run test:coverage
      - name: Upload coverage
        uses: codecov/codecov-action@v4
        with:
          files: ./coverage/coverage-final.json

# テストを実行して失敗ログを取得
npx vitest run 2>&1 | tee /tmp/test-output.txt

以下のテスト失敗ログを見て、実装コードを修正してください。
テスト自体は変更しないでください。

---
[/tmp/test-output.txt の内容をペースト]
---

修正対象: src/utils/parseJapaneseDate.ts

{
  "scripts": {
    "test:fix": "vitest run 2>&1 | npx claude-code 'テストが失敗しています。実装コードのみを修正してテストをパスさせてください。テストファイルは変更しないでください。'"
  }
}

以下のユーザーストーリーに基づいてPlaywrightのテストを書いてください。

ユーザーストーリー:
- ユーザーがログインページにアクセスする
- メールアドレスとパスワードを入力してSubmitボタンをクリックする
- ダッシュボードページに遷移することを確認する
- ページタイトルが「ダッシュボード」であることを確認する

前提:
- ベースURL: http://localhost:3000
- テストユーザー: test@example.com / password123
- セレクターはdata-testidを使う（クラス名やid属性は使わない）

import { test, expect } from '@playwright/test'

test.describe('ログイン機能', () => {
  test('正しい認証情報でダッシュボードに遷移する', async ({ page }) => {
    await page.goto('/login')

    await page.getByTestId('email-input').fill('test@example.com')
    await page.getByTestId('password-input').fill('password123')
    await page.getByTestId('submit-button').click()

    await expect(page).toHaveURL('/dashboard')
    await expect(page).toHaveTitle('ダッシュボード')
  })
})

このユーティリティ関数は副作用がありません。
vi.mock() は使わないでください。

テストを書く前に、どの依存関係をモックするか、しないかの方針を説明してください。
その方針を確認してから実装に進んでください。

## モックの判断基準

モックする対象:
- データベース接続
- 外部HTTP API
- ファイルシステム操作
- メール送信・SMS送信

モックしない対象:
- 純粋関数（入力と出力だけを持つ関数）
- 日付処理（Date.now()以外）
- 文字列・数値操作
- 配列・オブジェクト操作