変更差分から不足テストを見つける回帰テストスキル

---

name: regression-test-guard
description: CodexやClaude Codeでコード変更後に差分と既存テストを照合し、不足している正常系・異常系・境界値テストを追加して回帰を防ぐスキル。機能追加、バグ修正、リファクタリング後に使う。

Regression Test Guard

目的

変更したコードだけを見て「テストが通ったから完了」とせず、差分が壊しうる振る舞いを特定して必要なテストを補う。

手順

1. git diff などで今回の変更範囲を確認する。
2. 変更した関数、API、状態遷移、例外処理に対応する既存テストを探す。
3. 次の観点で不足ケースを洗い出す。
   • 主要な正常系
   • 入力なし・空・null相当
   • 最小値・最大値・境界値
   • 不正入力・権限不足・外部失敗
   • バグ修正なら元の再現ケース
4. プロジェクト既存のテスト構造・命名・fixture・mock方針に合わせて追加する。
5. 最も狭い対象テストから実行し、通ったら関連テストへ広げる。
6. テストが実装詳細ではなく外部から見える振る舞いを確認しているか見直す。

ルール

• カバレッジ率を上げること自体を目的にしない。
• 意味の薄いassertや、常に通るmock中心のテストを増やさない。
• 既存仕様と矛盾する期待値を勝手に作らない。
• flakyな待ち時間依存テストは避け、可能なら決定的にする。
• 全テストが重い場合は、実行した範囲と未実行範囲を明示する。

完了条件

変更によって壊れうる主要な振る舞いがテストで保護され、バグ修正では再現ケースが修正前に失敗・修正後に成功する。