mcpField

Post-Edit Test Guard

おすすめイベント駆動

Post-Edit Test Guard について

イベントをトリガーに、ファイルの編集が一区切りするたび起動するループです。各ラウンドでは編集したファイルに関連するテストだけを実行し、終了コードから追加の修正が必要かを判断します。

主な機能

  1. 01編集イベントで起動し、手動操作は不要
  2. 02変更ファイルに関連するテストのみ実行
  3. 03テストの終了コードを合否の基準にする
  4. 04Cursor に対応

活用シーン

  1. 01Cursor で複数ファイルを続けて編集し、リグレッションを早期に見つけたいとき
  2. 02リファクタリング後に影響範囲のテストが通ることを確認したいとき
  3. 03コーディングエージェントに変更ごとのセルフチェックをさせたいとき
目標
ファイル編集の各まとまりの後、その関連テストがすべて通過してから作業を続けます。
終了条件
関連テストのコマンドが終了コード 0 で終了した時点で停止します。
各ラウンドの間に実行
npm test -- --findRelatedTests <edited files>

起動プロンプト

Cursor に貼り付けて実行すると、終了条件を満たすまでエージェントが以下の手順を繰り返します。

prompt.md
「Post-Edit Test Guard」ループを開始します。
目標:ファイル編集の各まとまりの後、その関連テストがすべて通過してから作業を続けます。
ステップ 1:関連テストを実行 — 今回編集したファイルを対象に npm test -- --findRelatedTests を実行します。終了コードが 0 なら合格、それ以外は失敗出力を確認します。 `npm test -- --findRelatedTests`
ステップ 2:失敗原因を特定 — テストが失敗した場合は、出力と直近の変更を照らし合わせ、編集内容とテストのどちらに問題があるかを判断して修正箇所を絞ります。
ステップ 3:修正して再確認 — 修正を加えたらテストの手順に戻ります。関連テストが通過するまで繰り返し、その後に次の編集へ進みます。
各ラウンドの間に実行:`npm test -- --findRelatedTests <edited files>`
終了条件:関連テストのコマンドが終了コード 0 で終了した時点で停止します。

手順

各ラウンドは順番に実行され、終了条件を満たさなければ次のラウンドへ進みます(最大 1 ラウンド)。

01
関連テストを実行

今回編集したファイルを対象に npm test -- --findRelatedTests を実行します。終了コードが 0 なら合格、それ以外は失敗出力を確認します。

$npm test -- --findRelatedTests
02
失敗原因を特定

テストが失敗した場合は、出力と直近の変更を照らし合わせ、編集内容とテストのどちらに問題があるかを判断して修正箇所を絞ります。

03
修正して再確認

修正を加えたらテストの手順に戻ります。関連テストが通過するまで繰り返し、その後に次の編集へ進みます。

未達 → 次のラウンド条件を満たせば終了

対応エージェント

この Loop をそのまま実行できるコーディングエージェントです。

Cursor
Claude Code

コメント