Communitygithub.com

chirag127/skill-tdd

Red-Green-Refactor TDD。実装前に必ず失敗するテストを書く。AIがテストを後回しにする不正を防止します。あらゆる機能追加やバグ修正に使用します。

skill-tdd とは?

このスキルは、厳格なRed-Green-RefactorのTDDサイクルを強制します。「失敗するテストなしにプロダクションコードを書くな」という鉄則のもと、AIがテストを実装後に書く不正(テストチート)をブロックします。対応プラットフォームはClaude Code、Cursor、CodexなどのAIエージェントです。仕組みとしては、Seam(公開境界)の事前合意、1テスト→1実装の垂直スライス、リファクタリングの必須化、そして「実装前に失敗するテスト出力を確認する」というアンチチートルールを厳守します。Mattt Pocockのフレームワーク(Seam、トートロジカルテスト、水平スライシングの禁止)やKent Beckの原典に基づいて設計されており、フィードバックループの短さ(60秒未満)を前提条件としています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add chirag127/skill-tdd

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

tdd — Red-Green-Refactor(レッド・グリーン・リファクタ)

鉄則

失敗するテストなしにプロダクションコードを書くな。

テストより先にコードを書いたか? 削除しろ。最初からやり直せ。 例外はない——「参考」として残すな、テストを書くときに「調整」するな、見るな。テストから新しく実装しろ。

ルールの文言に違反することは、その精神に反することだ。

トリガー

以下の場合に発動:「TDD this」・「red-green-refactor」・「test-first」・新機能・バグ修正・リファクタリング・振る舞い変更。AFKモードのタスクで、テスト基盤が存在する場合は、[[afk-vs-hitl-tasks]]に従い、自動で発動する。

例外(事前確認必須): 使い捨てプロトタイプ、生成コード、設定ファイル。

「今回だけTDDを省略しよう」と考えているか? やめろ。それは自己正当化だ——迷っているなら references/rationalizations.md を見よ。

前提条件

テストループは60秒未満([[feedback-loops-are-the-ceiling]] 参照)。ループが遅いなら、まずループを修正しろ。遅いテストを避けるためにTDDをスキップするな。

CONTEXT.md とエリアのADRを先に読め——テスト名とインターフェースの語彙はプロジェクトのドメイン言語に一致させること。(ドメイン語彙のステップは Matt Pocock 2026-07-08 による。)

Seam(シーム)——事前に合意せよ

Seam とは、内部に立ち入らずに振る舞いを観察できる公開境界のこと。テストはSeamに置かれ、内部に対しては決して書かない。コードは変わるが、Seamに固定されたテストは生き残る。

テストを書く前に、ユーザーとSeamを確認しろ。 確認されていないSeamに対してテストを書くな。作業はクリティカルパスと複雑なロジックに集中し、すべてのエッジケースを追わなくてよい。次のように尋ねよ:「どのSeamをテストすべきですか?」(Seamのフレーミングは Matt Pocock 2026-07-08 による。)

サイクル——厳密な順序

ステップアクション確認事項
RED(レッド)合意したSeamに対して、1つの失敗するテスト。最小の観測可能な振る舞い。モックはやむを得ない場合を除き使わず、実際のコードを使う。明確な名前。「and」で複数条件をつなげない。テストが期待されたエラーでFAILすること。すぐにパスした? 既存の振る舞いをテストしている——テストを修正せよ。エラーが出た? エラーを修正し、正しく失敗するまで再実行。
GREEN(グリーン)テストを通すための最小限のコード。YAGNIの選択肢はなし。未テストのエラーハンドリングは禁止。テストがPASSすること。他のテストもすべてパスのまま。出力は整っている。失敗する? コードを修正し、テストは決していじるな。
REFACTOR(リファクタ)深いモジュールに抽出せよ([[deep-modules-over-shallow]] 参照)。明確にするために名前を変更せよ。リファクタで振る舞いを追加するな。グリーンのまま。
LOOP(ループ)次の失敗するテストへ。垂直スライス——1テスト→1実装→繰り返し。それぞれ、前のサイクルが教えたことに反応するトレーサーブレット。REDに戻る。—

アンチパターン——ロック済み

  • 実装結合——内部の協調オブジェクトをモックし、プライベートメソッドをテストし、サイドチャネル(DBクエリ vs インターフェース)を通じてアサートする。兆候:振る舞いが変わっていないのにリファクタで壊れる。
  • トートロジカル——アサーションがコードと同じ方法で期待値を再計算する(expect(add(a,b)).toBe(a+b)、手作業で導出したスナップショット、定数がそれ自身と等しい)。定義上パスする。期待値は独立したソースから:既知の正しいリテラル、実例、仕様。(トートロジカルのフレーミングは Matt Pocock 2026-07-08 による。)
  • 水平スライシング——すべてのテストを先に書き、その後すべての実装を書く。想定された振る舞いを検証し、テストは実際の変更に対して鈍感になる。垂直スライスのみで作業せよ。(水平 vs 垂直のフレーミングは Matt Pocock 2026-07-08 による。)

アンチチート——ロック済み

  • プロダクションコードを書く前に、失敗するテストの出力を確認しなければならない。
  • 最初のテストがパスする前に、複数のテストを書いてはならない。
  • リファクタをスキップしてはならない。
  • 事後的に、テストを実装に合わせて書き換えてはならない。

コードの後で書かれたテスト = コードの形をしていて、仕様の形をしていない。目的に反する。

各サイクルの出力形式

SEAM:     <テスト対象の公開インターフェース>
RED:      <テスト名> → <期待される失敗メッセージ>
GREEN:    <変更されたファイル、LOCの差分>
REFACTOR: <抽出・リネームされたもの>

相互参照

関連スキル