tdd-red-green-refactor
以红-绿-重构循环为中心的TDD专业技能。反复进行失败测试设计、最小实现和重构,平衡质量和速度。锚点:• 测试驱动开发:通过示例 / 应用:RGR循环 / 目标:重复的规律• 重构(马丁·福勒) / 应用:改进步骤 / 目标:保持行为• xUnit测试模式 / 应用:测试设计 / 目标:表达的一致性触发:当专注于红-绿-重构循环、指导TDD执行或审查循环质量时使用。红-绿-重构,TDD循环,失败测试,最小实现,重构
name: tdd-red-green-refactor description: | Red-Green-Refactorサイクルを中心にTDDを実行するための専門スキル。 失敗テストの設計、最小実装、リファクタを反復し、品質と速度を両立する。
Anchors: • Test-Driven Development: By Example / 適用: RGRサイクル / 目的: 反復の規律 • Refactoring (Martin Fowler) / 適用: 改善手順 / 目的: 振る舞い維持 • xUnit Test Patterns / 適用: テスト設計 / 目的: 表現の一貫性
Trigger: Use when focusing on the red-green-refactor cycle, coaching TDD execution, or reviewing cycle quality. red-green-refactor, TDD cycle, failing test, minimal implementation, refactoring allowed-tools: - Read - Write - Edit - Bash - Glob - Grep
tdd-red-green-refactor
概要
Red-Green-Refactorの各フェーズを明確にし、短いサイクルで品質を改善するスキル。
ワークフロー
Phase 1: Redフェーズ設計
目的: 失敗理由が明確なテストを作成する。
アクション:
- 期待する振る舞いを定義する
- 失敗するテストを記述する
- テスト命名を整える
Task: agents/red-phase.md を参照
Phase 2: Greenフェーズ実行
目的: 最小実装でテストを通す。
アクション:
- 最小実装でテストを成功させる
- 余計な最適化を避ける
- 改善候補を記録する
Task: agents/green-phase.md を参照
Phase 3: Refactorフェーズ改善
目的: 振る舞いを変えずに設計を改善する。
アクション:
- 重複や複雑性を抽出する
- 安全な改善から実施する
- サイクルログを更新する
Task: agents/refactor-phase.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| red-phase | Phase 1開始時 | 仕様・要求 | Redテスト |
| green-phase | Phase 2開始時 | Redテスト | Green実装 |
| refactor-phase | Phase 3開始時 | Green実装 | RGRログ更新 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| Redで失敗理由を明確にする | Greenの最小実装が決まりやすい |
| Greenは最小実装に徹する | 過剰設計を避ける |
| Refactorを毎サイクル実施する | 品質低下を防げる |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| Redを飛ばして実装を始める | サイクルの規律が崩れる |
| Greenで過剰な実装を行う | 改善対象が増える |
| Refactorを省略する | 技術的負債が蓄積する |
リソース参照
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|---|
scripts/validate-rgr-log.mjs |
サイクルログを検証する |
scripts/log_usage.mjs |
使用記録をLOGS.mdに記録する |
references/(詳細知識)
| リソース | パス | 読込条件 |
|---|---|---|
| 基礎 | references/Level1_basics.md | 初回利用時 |
| 実務パターン | references/Level2_intermediate.md | 実務適用時 |
| 高度改善 | references/Level3_advanced.md | 改善時 |
| エキスパート | references/Level4_expert.md | 高難度対応時 |
| Redフェーズ | references/red-phase.md | Phase 1 |
| Greenフェーズ | references/green-phase.md | Phase 2 |
| Refactorフェーズ | references/refactor-phase.md | Phase 3 |
| テスト命名 | references/test-naming.md | Phase 1 |
| アンチパターン | references/tdd-anti-patterns.md | 全フェーズ |
assets/(テンプレート)
| アセット | 用途 |
|---|---|
assets/test-template.md |
テスト設計テンプレート |
assets/rgr-cycle-log.md |
RGRサイクルログ |