mcpField

Format Until Clean

おすすめ手動実行
テスト最大 5 ラウンド

Format Until Clean について

手動で開始するループで、Cursor 上で npm run format を繰り返し、フォーマットによる変更が出なくなるまで進めます。各ラウンドではフォーマッターを実行し、git diff で差分がないことを確認します。最大 5 ラウンドです。

主な機能

  1. 01手動トリガーで開始のタイミングを選べる
  2. 02最大 5 ラウンドで無限の繰り返しを防止
  3. 03コマンドの終了状態と git diff が空かどうかの両方を確認
  4. 04Cursor に対応

活用シーン

  1. 01大規模なリファクタリング後のコードスタイル統一
  2. 02コミットや PR の前にフォーマット漏れがないか確認
  3. 03何度も残る細かな整形差分の解消
目標
フォーマッターがエラーなく実行され、ファイルの差分が残らない状態にします。
終了条件
npm run format が成功し git diff が空になった時点、または条件を満たさないまま 5 ラウンドに達した時点で終了します。
各ラウンドの間に実行
npm run format

起動プロンプト

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

prompt.md
「Format Until Clean」ループを開始します。
目標：フォーマッターがエラーなく実行され、ファイルの差分が残らない状態にします。
最大ラウンド数：5。
ステップ 1：フォーマッターを実行 — npm run format を実行し、規則に合わないファイルを書き換えます。エラーが出た場合は、まずメッセージを記録します。 `npm run format`
ステップ 2：差分なしを確認 — フォーマッターを再度実行し、git diff --quiet で作業ツリーを確認します。コマンドが成功し差分がなければクリーンと判断し、そうでなければ変更が残っています。 `npm run format && git diff --quiet`
ステップ 3：継続を判断 — 確認に失敗し、まだ 5 ラウンド未満であれば、最新の結果をもとに次のラウンドを始めます。クリーンになったか上限に達したら終了します。
各ラウンドの間に実行：`npm run format`
終了条件：npm run format が成功し git diff が空になった時点、または条件を満たさないまま 5 ラウンドに達した時点で終了します。

手順

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

01
フォーマッターを実行

npm run format を実行し、規則に合わないファイルを書き換えます。エラーが出た場合は、まずメッセージを記録します。

$npm run format
02
差分なしを確認

フォーマッターを再度実行し、git diff --quiet で作業ツリーを確認します。コマンドが成功し差分がなければクリーンと判断し、そうでなければ変更が残っています。

$npm run format && git diff --quiet
03
継続を判断

確認に失敗し、まだ 5 ラウンド未満であれば、最新の結果をもとに次のラウンドを始めます。クリーンになったか上限に達したら終了します。

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

対応エージェント

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

Cursor

コメント

Markdown 対応