tdd-development

d-kishi 的头像作者 d-kishi

使用TDD(测试驱动开发)的Red-Green-Refactor循环进行代码实现。在实现‘实体’、‘服务’、‘API’、‘功能’时使用。通过测试驱动和TDD保证质量。

📖 中文导读:使用TDD(测试驱动开发)的Red-Green-Refactor循环进行代码实现。在实现‘实体’、‘服务’、‘API’、‘功能’时使用。通过测试驱动和TDD保证质量。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: tdd-development description: TDD(テスト駆動開発)のRed-Green-Refactorサイクルでコードを「実装」する。「エンティティ」「サービス」「API」「機能」の実装時に使用。「テスト駆動」「TDD」で品質を担保する。

TDD開発ワークフロー

基本サイクル: Red-Green-Refactor

実装作業では以下のサイクルを繰り返す:

  1. Red: 失敗するテストを先に書く
  2. Green: テストを通す最小限のコードを書く
  3. Refactor: コードを整理する(テストは通ったまま)

ワークフロー手順

Step 1: テスト作成(Red)

  1. 実装したい機能・振る舞いをテストとして記述
  2. テストを実行し、失敗することを確認
  3. 失敗理由が「未実装」であることを確認

Step 2: 最小実装(Green)

  1. テストを通すための最小限のコードを書く
  2. 過度な設計・最適化は行わない
  3. テストを実行し、成功することを確認

Step 3: リファクタリング(Refactor)

  1. コードの重複を除去
  2. 命名・構造を改善
  3. テストを実行し、引き続き成功することを確認

実装の粒度

  • 1サイクルは小さく保つ(5-15分程度で完了する単位)
  • 機能を細かく分割し、段階的に実装
  • 複雑な機能は複数サイクルで構築

テスト実行タイミング

  • Red: テスト作成後に必ず実行(失敗確認)
  • Green: 実装後に必ず実行(成功確認)
  • Refactor: 変更のたびに実行(回帰確認)

このプロジェクトでの適用

  • ユニットテスト: *.spec.tsファイル
  • E2Eテスト: test/ディレクトリ
  • テスト実行: npm run test:task(ユニット)、npm run test:task:e2e(E2E)
  • 設計参照: docs/design/、テストシナリオ参照: docs/user-stories/