TDDコマンド

このコマンドはtdd-guideエージェントを呼び出し、テスト駆動開発の方法論を徹底します。

このコマンドの機能

1. インターフェースのスキャフォールド - まず型/インターフェースを定義
2. テストを先に生成 - 失敗するテストを書く（RED）
3. 最小限のコードを実装 - テストを通すのに十分なコードを書く（GREEN）
4. リファクタリング - テストをグリーンに保ちながらコードを改善（REFACTOR）
5. カバレッジを検証 - 80%以上のテストカバレッジを確保

使用するタイミング

以下の場合に/tddを使用:

• 新機能の実装
• 新しい関数/コンポーネントの追加
• バグ修正（まずバグを再現するテストを書く）
• 既存コードのリファクタリング
• 重要なビジネスロジックの構築

動作の仕組み

tdd-guideエージェントは以下を行います:

1. 入力/出力のインターフェースを定義
2. 失敗するテストを書く（コードがまだ存在しないため）
3. テストを実行し、正しい理由で失敗することを確認
4. テストを通すための最小限の実装を書く
5. テストを実行し、通ることを確認
6. コードをリファクタリング（テストをグリーンに保ちながら）
7. カバレッジをチェックし、80%未満の場合はテストを追加

TDDサイクル

RED → GREEN → REFACTOR → REPEAT

RED:      失敗するテストを書く
GREEN:    テストを通す最小限のコードを書く
REFACTOR: テストを通したままコードを改善
REPEAT:   次の機能/シナリオへ

使用例

ユーザー: /tdd マーケットの流動性スコアを計算する関数が必要

エージェント（tdd-guide）:
# TDDセッション: マーケット流動性スコア計算機

## ステップ1: インターフェースを定義（SCAFFOLD）

```typescript
// lib/liquidity.ts
export interface MarketData {
  totalVolume: number
  bidAskSpread: number
  activeTraders: number
  lastTradeTime: Date
}

export function calculateLiquidityScore(market: MarketData): number {
  // TODO: 実装
  throw new Error('Not implemented')
}

ステップ2: 失敗するテストを書く（RED）

// lib/liquidity.test.ts
import { calculateLiquidityScore } from './liquidity'

describe('calculateLiquidityScore', () => {
  it('流動性の高いマーケットに高スコアを返す', () => {
    const market = {
      totalVolume: 100000,
      bidAskSpread: 0.01,
      activeTraders: 500,
      lastTradeTime: new Date()
    }

    const score = calculateLiquidityScore(market)

    expect(score).toBeGreaterThan(80)
    expect(score).toBeLessThanOrEqual(100)
  })

  it('流動性の低いマーケットに低スコアを返す', () => {
    const market = {
      totalVolume: 100,
      bidAskSpread: 0.5,
      activeTraders: 2,
      lastTradeTime: new Date(Date.now() - 86400000) // 1日前
    }

    const score = calculateLiquidityScore(market)

    expect(score).toBeLessThan(30)
    expect(score).toBeGreaterThanOrEqual(0)
  })

  it('エッジケースを処理: ボリュームゼロ', () => {
    const market = {
      totalVolume: 0,
      bidAskSpread: 0,
      activeTraders: 0,
      lastTradeTime: new Date()
    }

    const score = calculateLiquidityScore(market)

    expect(score).toBe(0)
  })
})

ステップ3: テストを実行 - 失敗を確認

npm test lib/liquidity.test.ts

FAIL lib/liquidity.test.ts
  ✕ 流動性の高いマーケットに高スコアを返す (2 ms)
    Error: Not implemented

1 test failed, 0 passed

✅ 期待通りテストが失敗。実装の準備完了。

ステップ4: 最小限のコードを実装（GREEN）

// lib/liquidity.ts
export function calculateLiquidityScore(market: MarketData): number {
  // ボリュームゼロのエッジケースを処理
  if (market.totalVolume === 0) {
    return 0
  }

  // 各コンポーネントのスコアを計算（0-100スケール）
  const volumeScore = Math.min(market.totalVolume / 1000, 100)
  const spreadScore = Math.max(100 - (market.bidAskSpread * 1000), 0)
  const traderScore = Math.min(market.activeTraders / 10, 100)

  // 最近のアクティビティボーナス
  const hoursSinceLastTrade = (Date.now() - market.lastTradeTime.getTime()) / (1000 * 60 * 60)
  const recencyScore = Math.max(100 - (hoursSinceLastTrade * 10), 0)

  // 加重平均
  const score = (
    volumeScore * 0.4 +
    spreadScore * 0.3 +
    traderScore * 0.2 +
    recencyScore * 0.1
  )

  return Math.min(Math.max(score, 0), 100) // 0-100にクランプ
}

ステップ5: テストを実行 - 成功を確認

npm test lib/liquidity.test.ts

PASS lib/liquidity.test.ts
  ✓ 流動性の高いマーケットに高スコアを返す (3 ms)
  ✓ 流動性の低いマーケットに低スコアを返す (2 ms)
  ✓ エッジケースを処理: ボリュームゼロ (1 ms)

3 tests passed

✅ 全テスト合格！

ステップ6: リファクタリング（IMPROVE）

// lib/liquidity.ts - 定数と可読性を改善してリファクタリング
const WEIGHTS = {
  VOLUME: 0.4,
  SPREAD: 0.3,
  TRADERS: 0.2,
  RECENCY: 0.1,
} as const

const SCALE_FACTORS = {
  VOLUME: 1000,
  SPREAD: 1000,
  TRADERS: 10,
  RECENCY_PENALTY: 10,
} as const

function clamp(value: number, min: number, max: number): number {
  return Math.min(Math.max(value, min), max)
}

export function calculateLiquidityScore(market: MarketData): number {
  if (market.totalVolume === 0) return 0

  const volumeScore = Math.min(market.totalVolume / SCALE_FACTORS.VOLUME, 100)
  const spreadScore = clamp(100 - (market.bidAskSpread * SCALE_FACTORS.SPREAD), 0, 100)
  const traderScore = Math.min(market.activeTraders / SCALE_FACTORS.TRADERS, 100)

  const hoursSinceLastTrade = (Date.now() - market.lastTradeTime.getTime()) / (1000 * 60 * 60)
  const recencyScore = clamp(100 - (hoursSinceLastTrade * SCALE_FACTORS.RECENCY_PENALTY), 0, 100)

  const weightedScore =
    volumeScore * WEIGHTS.VOLUME +
    spreadScore * WEIGHTS.SPREAD +
    traderScore * WEIGHTS.TRADERS +
    recencyScore * WEIGHTS.RECENCY

  return clamp(weightedScore, 0, 100)
}

ステップ7: テストがまだ通ることを確認

npm test lib/liquidity.test.ts

PASS lib/liquidity.test.ts
  ✓ 流動性の高いマーケットに高スコアを返す (3 ms)
  ✓ 流動性の低いマーケットに低スコアを返す (2 ms)
  ✓ エッジケースを処理: ボリュームゼロ (1 ms)

3 tests passed

✅ リファクタリング完了、テストは引き続き合格！

ステップ8: カバレッジをチェック

npm test -- --coverage lib/liquidity.test.ts

File           | % Stmts | % Branch | % Funcs | % Lines
---------------|---------|----------|---------|--------
liquidity.ts   |   100   |   100    |   100   |   100

Coverage: 100% ✅（目標: 80%）

✅ TDDセッション完了！

## TDDベストプラクティス

**推奨:**
- ✅ 実装の前にテストを先に書く
- ✅ テストを実行し、実装前に失敗することを確認
- ✅ テストを通す最小限のコードを書く
- ✅ テストがグリーンになった後にのみリファクタリング
- ✅ エッジケースとエラーシナリオを追加
- ✅ 80%以上のカバレッジを目指す（重要なコードは100%）

**非推奨:**
- ❌ テストの前に実装を書く
- ❌ 各変更後のテスト実行をスキップ
- ❌ 一度に多くのコードを書く
- ❌ 失敗するテストを無視
- ❌ 実装の詳細をテスト（動作をテスト）
- ❌ すべてをモック（統合テストを優先）

## 含めるべきテストタイプ

**ユニットテスト**（関数レベル）:
- ハッピーパスシナリオ
- エッジケース（空、null、最大値）
- エラー条件
- 境界値

**統合テスト**（コンポーネントレベル）:
- APIエンドポイント
- データベース操作
- 外部サービス呼び出し
- フック付きReactコンポーネント

**E2Eテスト**（`/e2e`コマンドを使用）:
- 重要なユーザーフロー
- マルチステッププロセス
- フルスタック統合

## カバレッジ要件

- **80%最低**（すべてのコードに対して）
- **100%必須**:
  - 金融計算
  - 認証ロジック
  - セキュリティクリティカルなコード
  - コアビジネスロジック

## 重要な注意事項

**必須**: テストは実装の前に書かなければなりません。TDDサイクルは:

1. **RED** - 失敗するテストを書く
2. **GREEN** - 通るように実装
3. **REFACTOR** - コードを改善

REDフェーズをスキップしないでください。テストの前にコードを書かないでください。

## 他のコマンドとの統合

- `/plan`を最初に使用して何を構築するか理解
- `/tdd`を使用してテストと共に実装
- ビルドエラーが発生した場合は`/build-and-fix`を使用
- `/code-review`を使用して実装をレビュー
- `/test-coverage`を使用してカバレッジを検証

## 関連エージェント

このコマンドは以下にある`tdd-guide`エージェントを呼び出します:
`~/.claude/agents/tdd-guide.md`

また、以下にある`tdd-workflow`スキルを参照できます:
`~/.claude/skills/tdd-workflow/`