tdd

Q: What does the tdd skill do?

テスト駆動開発（TDD）ワークフローを実行するスキル。 使用タイミング: (1) 新機能の実装開始時 (2) バグ修正時 (3) リファクタリング前 (4) 「テストから書いて」と言われた時 (5) 品質重視の実装が必要な時。 トリガー例: 「TDDで実装して」「テスト駆動で」「テストから書いて」 「RED-GREEN-REFACTORで」「UserServiceのテストを書いて」

Q: How do I install tdd?

Run npx skills add https://github.com/kimny1143/claude-code-template --skill tdd in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tdd/ (personal) or .claude/skills/tdd/ (project).

by kimny1143Testing & QA

テスト駆動開発（TDD）ワークフローを実行するスキル。使用タイミング: (1) 新機能の実装開始時 (2) バグ修正時 (3) リファクタリング前 (4) 「テストから書いて」と言われた時 (5) 品質重視の実装が必要な時。トリガー例: 「TDDで実装して」「テスト駆動で」「テストから書いて」「RED-GREEN-REFACTORで」「UserServiceのテストを書いて」

Installs: 66
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/kimny1143/claude-code-template --skill tdd

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads tdd automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

/tdd - Test-Driven Development

テスト駆動開発ワークフローを実行する。

使い方

/tdd                    # 対話的にTDDを開始
/tdd UserService        # UserServiceのテストから開始
/tdd handlePayment edge # handlePaymentのエッジケーステスト

TDDサイクル

┌─────────────────────────────────────────────────┐
│  1. RED    → テストを書く（失敗することを確認） │
│  2. GREEN  → 最小限のコードで通す               │
│  3. REFACTOR → リファクタ（テストは通ったまま）│
└─────────────────────────────────────────────────┘

ワークフロー

Step 1: RED（テストを書く）

テスト対象を特定
- 新機能: 期待する入出力を定義
- バグ修正: バグを再現するテストを書く

テストファイルを作成/更新

// tests/unit/services/user.service.test.ts
describe('UserService', () => {
  describe('createUser', () => {
    it('should create user with valid data', async () => {
      const result = await userService.createUser({
        email: 'test@example.com',
        name: 'Test User',
      });
      expect(result.id).toBeDefined();
      expect(result.email).toBe('test@example.com');
    });

    it('should throw error for duplicate email', async () => {
      // エッジケース
      await expect(
        userService.createUser({ email: 'existing@example.com', name: 'Test' })
      ).rejects.toThrow('Email already exists');
    });
  });
});

テスト実行 → 失敗を確認

npm run test -- --watch tests/unit/services/user.service.test.ts

Step 2: GREEN（実装する）

最小限の実装で通す
- 完璧を目指さない
- ハードコードでもOK（後でリファクタ）
- テストが通ることだけに集中
テスト実行 → 成功を確認

Step 3: REFACTOR（改善する）

テストが通った状態で:
- 重複を排除
- 命名を改善
- 構造を整理
テスト実行 → まだ通ることを確認
満足したら次のテストへ（Step 1に戻る）

テストの書き方ガイド

命名規則

describe('[対象]', () => {
  describe('[メソッド/機能]', () => {
    it('should [期待する動作] when [条件]', () => {
      // ...
    });
  });
});

カバーすべきケース

ケース	例
正常系	有効な入力で期待通り動作
境界値	0, 空文字, 配列の最初/最後
エラー系	無効な入力、null/undefined
エッジケース	並行アクセス、タイムアウト

モックの使い方

// 外部依存はモック
vi.mock('@/db', () => ({
  db: {
    select: vi.fn().mockReturnValue({
      from: vi.fn().mockReturnValue({
        where: vi.fn().mockResolvedValue([{ id: '1', name: 'Test' }]),
      }),
    }),
  },
}));

テストコマンド例

Vitest

npm run test                           # 全テスト
npm run test -- --watch               # ウォッチモード
npm run test -- tests/unit/specific   # 特定ディレクトリ
npm run test -- --coverage            # カバレッジ

Jest

npm test                              # 全テスト
npm test -- --watch                   # ウォッチモード
npm test -- --coverage                # カバレッジ

Playwright (E2E)

npm run test:e2e                      # 全E2E
npx playwright test --grep "login"    # 特定テスト

チェックリスト

TDD完了時の確認:

テストが先に書かれた（実装より前）
テストが一度失敗した（REDフェーズ）
最小限の実装で通した（GREEN）
リファクタ後もテストが通る
エッジケースがカバーされている
テスト名が動作を説明している

FAQ

What does the tdd skill do?

How do I install tdd?

Run npx skills add https://github.com/kimny1143/claude-code-template --skill tdd in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tdd/ (personal) or .claude/skills/tdd/ (project).

Which AI agents can use tdd?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is tdd safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains tdd?

It is published by kimny1143 in kimny1143/claude-code-template. It has 66 recorded installs.