tdd-refactor
严格执行TDD的重构(REFACTOR)阶段。在保持所有测试为GREEN的同时,改善内部结构,如消除重复、改进命名、关注点分离等。如果需要更改规格,先更新Spec和测试期望值,然后调整实现。
📖 中文导读:严格执行TDD的重构(REFACTOR)阶段。在保持所有测试为GREEN的同时,改善内部结构,如消除重复、改进命名、关注点分离等。如果需要更改规格,先更新Spec和测试期望值,然后调整实现。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: tdd-refactor description: TDDのリファクタ(REFACTOR)フェーズを厳密に実行する。全テストGREENを維持したまま、重複排除・命名改善・関心分離など内部構造を改善する。仕様変更が必要なら先にSpecとテスト期待値を更新してから実装を調整する。
tdd-refactor(リファクタリング:設計と表現を改善する)
このスキルの目的
- テストがGREENの安全網で、コード/テスト/仕様表現を改善する。
- “変更容易性”を上げるために、内部構造の負債を計画的に返す。
前提(満たさない場合は停止)
- 全テストがGREENである(直前に確認済み)。
- 変更は「仕様変更」ではなく「内部改善」である。
- もし仕様変更が必要なら:ユーザーの了承のもと先にSpecとテスト期待値を更新してから(=別のREDとして扱う)。
必ず取り組むべき内容
- 変更範囲にRustコードが含まれる場合
cargo fixでの機械的な修正cargo fmt -allでのフォーマットcargo clippy --workspace --all-targets --all-features -- -D warningsで指摘された内容の修正
- 変更範囲にMarkdown文書が含まれる場合
markdownlint-cli2 --fixでの機械的な修正
手順(厳守)
- フェーズ宣言
Current Phase: REFACTOR
- リファクタ対象を限定(やりすぎ防止)
- 直前のGREENで記録したTODO(最大3つ)から着手順を決める。
- 小さく刻んで改善 → すぐテスト
- 変更は小さく、意図が説明できる単位で行う。
- 1〜3ステップごとにテストを実行し、常にGREENを維持する。
- 対象例(必要に応じて)
- 重複排除(DRY)、命名改善、責務分離(SoC)、副作用の分離、複雑条件の単純化、不要依存の縮小
- テストコード側も対象:振る舞いベースに寄せ、実装に引きずられたテストを減らす(ただし期待値=振る舞いは変えない)
- Spec表現の改善(必要な範囲で)
- Spec-IDとテストの対応が読み取れる状態を保つ(トレーサビリティ維持)。
ガードレール(やってはいけない)
- 期待値(振る舞い)を変える変更を“リファクタ”と呼んで混ぜない。
- 大規模な再設計を始めない(別PR/別Specに分割)。
- 選択肢を大量に提示して議論を増やさない。デフォルト案で進め、例外のみ明示する。
出力フォーマット(返答はこれに従う)
Current Phase: REFACTORリファクタの目的:実施内容:(箇条書き。どの改善を何のために行ったか)影響範囲:(主要ファイルパス)実行コマンド:(実際に走らせたコマンド)結果:(全テストGREENの要約)次:(次のRED候補があればSpec-IDレベルで1つだけ)