Test Doubles

概要

テストダブルは、テスト対象が依存する外部コンポーネントを置き換えるオブジェクトです。 適切なテストダブルの選択は、テストの品質と保守性に大きく影響します。

核心原則:

• 目的に応じたテストダブルの選択
• 過度なモッキングの回避
• テストの意図を明確にする

対象ユーザー:

• ビジネスロジック実装エージェント（.claude/agents/logic-dev.md）
• テスト作成者
• 外部依存を持つコードの開発者

リソース構造

test-doubles/
├── SKILL.md                              # 本ファイル
├── resources/
│   ├── types-overview.md                 # テストダブルの種類
│   ├── mock-patterns.md                  # Mockパターン
│   ├── stub-patterns.md                  # Stubパターン
│   ├── fake-patterns.md                  # Fakeパターン
│   └── verification-strategies.md        # 検証戦略
├── scripts/
│   └── test-double-analyzer.mjs          # テストダブル分析スクリプト
└── templates/
    └── test-double-selection.md          # 選択ガイドテンプレート

コマンドリファレンス

リソース読み取り

# テストダブルの種類
cat .claude/skills/test-doubles/resources/types-overview.md

# Mockパターン
cat .claude/skills/test-doubles/resources/mock-patterns.md

# Stubパターン
cat .claude/skills/test-doubles/resources/stub-patterns.md

# Fakeパターン
cat .claude/skills/test-doubles/resources/fake-patterns.md

# 検証戦略
cat .claude/skills/test-doubles/resources/verification-strategies.md

スクリプト実行

# テストダブル分析
# テストファイルからMock/Stub/Spy使用状況を分析し、改善提案を出力
node .claude/skills/test-doubles/scripts/test-double-analyzer.mjs <test-file>

# 例
node .claude/skills/test-doubles/scripts/test-double-analyzer.mjs src/__tests__/user-service.test.ts

テンプレート参照

# テストダブル選択ガイド
cat .claude/skills/test-doubles/templates/test-double-selection.md

テストダブルの種類

クイックリファレンス

選択フロー

依存をテストダブルに置き換える
  ↓
[質問] 依存は使用されるか？
  ├─ No → Dummy
  └─ Yes ↓
[質問] 戻り値の制御が必要か？
  ├─ Yes → Stub
  └─ No ↓
[質問] 呼び出しの検証が必要か？
  ├─ Yes → Mock または Spy
  └─ No ↓
[質問] 本物に近い動作が必要か？
  └─ Yes → Fake

詳細: resources/types-overview.md

ベストプラクティス

すべきこと

1. 目的を明確にする:

   • 何をテストしたいのか
   • どの検証が必要か

2. 最小限のテストダブル:

   • 必要な依存のみ置き換え
   • 過度なモッキングを避ける

3. 適切な検証方法:

   • 状態検証: 結果の正しさ
   • 振る舞い検証: 相互作用の正しさ

避けるべきこと

1. 過度なモッキング:

   • ❌ すべての依存をモック化
   • ✅ テストに必要な依存のみ

2. 実装への密結合:

   • ❌ 内部実装の詳細を検証
   • ✅ 公開インターフェースを検証

3. 不必要な振る舞い検証:

   • ❌ すべての呼び出しを検証
   • ✅ 重要な相互作用のみ

Vitest での実装

基本パターン

import { describe, it, expect, vi, beforeEach } from "vitest";

// Stub
const mockRepository = {
  findById: vi.fn().mockResolvedValue({ id: "1", name: "Test" }),
};

// Spy
const spyLogger = {
  log: vi.fn(),
};

// Mock with expectations
it("should call repository with correct id", async () => {
  await service.getUser("user-1");
  expect(mockRepository.findById).toHaveBeenCalledWith("user-1");
});

詳細: resources/mock-patterns.md

ワークフロー

テストダブル実装

1. テスト対象の依存を特定
   ↓
2. 各依存のテストダブル種類を選択
   ↓
3. テストダブルを作成
   ↓
4. テストを実装
   ↓
5. 検証方法を確認
   - 状態検証 or 振る舞い検証

関連スキル

• .claude/skills/tdd-principles/SKILL.md (.claude/skills/tdd-principles/SKILL.md): TDD 原則（.claude/agents/unit-tester.md 向け）
• .claude/skills/tdd-red-green-refactor/SKILL.md (.claude/skills/tdd-red-green-refactor/SKILL.md): TDD サイクル実装（.claude/agents/logic-dev.md 向け）
• .claude/skills/clean-code-practices/SKILL.md (.claude/skills/clean-code-practices/SKILL.md): コード品質
• .claude/skills/refactoring-techniques/SKILL.md (.claude/skills/refactoring-techniques/SKILL.md): リファクタリング
• .claude/skills/vitest-advanced/SKILL.md (.claude/skills/vitest-advanced/SKILL.md): Vitest モッキングパターン

参考文献

• 『xUnit Test Patterns』 Gerard Meszaros 著
  • 第 11 章: Using Test Doubles
• 『Growing Object-Oriented Software, Guided by Tests』 Freeman & Pryce 著
  • Mock を使った TDD

使用上の注意

このスキルが得意なこと

• テストダブル 5 種類（Mock、Stub、Spy、Fake、Dummy）の使い分け判断
• 適切なテストダブル選択による保守性の高いテスト設計
• 検証戦略（状態検証 vs 振る舞い検証）の選定

このスキルが行わないこと

• Vitest 固有のモッキング API 詳細（→ .claude/skills/vitest-advanced/SKILL.md）
• TDD サイクル全体の設計（→ .claude/skills/tdd-principles/SKILL.md）
• E2E/統合テストでのモック戦略

変更履歴