レビューループ (Review Loop)
同一セッション内で反復的なワーカー・レビューサイクルを実行します。作業を行い、レビュー用のサブエージェントを起動して批評を受け、フィードバックに基づいて修正し、品質ゲートを満たすまで繰り返します。
核となる原則: 初稿が最終稿になることはありません。反復的な批評は、1回のパスよりも優れた成果を生み出します。
プラットフォームに関する注意: このスキルは、サブエージェントの起動をサポートするエージェントで最も効果的に機能します。 その機能がないプラットフォームでは、新しいチャットコンテキストを開き、過去の推論を含めずにワークプロダクトのみを貼り付け、1〜10のスコアと具体的なフィードバックを求めることで、レビュアーのステップをシミュレートできます。
クイックスタート
- 「
Xを実装して、review-loopを使って」または「今書いたファイルに対してreview-loopを実行して」と指示します。 - エージェントが作業を実行(または既存の作業を読み込み)します。
- 別の批評サブエージェントが1〜10のスコアと具体的なフィードバックを提供します。
- エージェントが修正し、スコアが8以上(デフォルトの品質ゲート)になるまで繰り返します。
- ループのサマリーが最終出力とともに提供されます。
使用すべき場面
- ユーザーが「use review-loop」、「polish this」、「iterate on this」、「/review-loop」と言った場合
- 速度よりも品質が重要な複雑な実装
- 設計書、仕様書、技術文書
- 堅牢性が求められるコード(セキュリティ、データパイプライン、金融ロジック)
- ユーザーがプロセスに批判的な批評を組み込むことを望む場合
使用すべきでない場面
- 単純な修正、クイック編集、1行の変更
- テストが品質ゲートとなるタスク(代わりにTDD + CIを使用)
- ユーザーがとにかく素早く終わらせたい場合
- 学習が目的であり、リリースが目的ではない探索的/スパイク的な作業
- 明確な受け入れ基準がないタスク — 最初にそれらを定義してから、review-loopを使用します
デフォルト設定
| 設定項目 | デフォルト値 |
|---|---|
| 最小ループ数 | 2 |
| 最大ループ数 | 4 |
| 品質ゲート | 8/10 |
| ワーカーモデル | (現在のモデル) |
| レビュアーモデル | (現在のモデル、または高速/バランスの取れた代替) |
モデル選択
レビュアーのタスクはロジックと制約を評価することです。ワーカーのタスクはコードを書き、修正することです。それに応じてサブエージェントの能力を選択してください。
重要なルール: レビュアーは常にワーカーと同等以上でなければなりません。レビュアーがワーカーよりも弱い場合、複雑なロジックを適切に批評したり、微妙な退行を見つけたりすることができません。
| タスクの複雑さ | ワーカーの能力 | レビュアーの能力 | 根拠 |
|---|---|---|---|
| 単純/機械的 (CRUD、フォーマット、ボイラープレート) | 高速 / 軽量 | バランス型 | 軽量ワーカーは高速、バランス型レビュアーで問題を容易に発見可能 |
| 標準 (機能、リファクタリング、ドキュメント) | バランス型 | バランス型 | コスト、速度、品質のバランスが良い |
| 複雑 (マルチファイル、統合、設計) | バランス型 | 高度 / 推論型 | 高度レビュアーが微妙なアーキテクチャ問題を発見、バランス型ワーカーが実装可能 |
| 非常に複雑 (セキュリティ、量子、分散システム) | 高度 / 推論型 | 高度 / 推論型 | 両方に完全なコンテキストと推論能力が必要。レビュアーはワーカーの能力に一致する必要がある |
黄金律: ワーカーはレビュアーのフィードバックに基づいて行動できるほど賢くなければなりません。レビュアーが「チャネルベースのセマフォで競合状態を修正してください」と言ったのに、ワーカーが並行処理について推論できない場合、ループは収束しません。
エスカレーションシグナル: 同じフィードバックで2回連続のループでスコアが改善しない場合、ワーカーモデルが弱すぎます。エスカレーション方法:
- オプションA: ユーザーにより高性能なモデルに切り替えるよう依頼する
- オプションB: 一時的に品質ゲートを下げ、その差をユーザーに伝える
- オプションC: タスクをより小さなサブタスクに分割し、それぞれでreview-loopを実行する
デフォルトの動作: あなた(メインエージェント)はワーカーであるため、現在の能力に基づいて、タスクに応じてレビューサブエージェントを起動します:
- ほとんどのタスク → 標準/バランス型レビュアー
- 特殊/難しいタスク → 高度/推論型レビュアー
- クイックチェック → 高速/軽量レビュアー (軽量ワーカーとしても動作する場合のみ)
ユーザーによる上書き
ユーザーはリクエスト内で任意のデフォルトをインラインで上書きできます。これらを自然に解析してください:
「Xを実装して、review-loopを使用、品質ゲート9、レビューにはアドバンストモデルを使用、最大5ループ」
「polish this、最小2ループ、ゲート8」
「fastレビュアーでreview-loopを実行、最大2ループ」
「review-loopを使用、推論型レビュアー、品質ゲート9、最小3最大6」
解析ルール:
- 「quality gate N」または「gate N」 → quality_gate = N
- 「[model] reviewer」または「review with [model]」 → レビュアーモデルの上書き
- 「max N loops」 → max_loops = N
- 「min N loops」 → min_loops = N
- ユーザーが指定しない場合はデフォルトを使用
- ユーザーが「thorough」または「strict」と言った場合 → quality_gate 8, min_loops 2 と解釈
- ユーザーが「quick」または「fast」と言った場合 → max_loops 2, quality_gate 6 と解釈
プロセス
flowchart TD
A[作業を実行] --> B[レビューサブエージェントを起動]
B --> C{最小ループ数に達したか?}
C -- いいえ、常に続行 --> E[フィードバックに基づいて修正]
C -- はい --> D{スコア >= 品質ゲート?}
D -- はい --> F[最終ポリッシュパス]
D -- いいえ --> G{最大ループ数に達したか?}
G -- はい、そこで停止 --> F
G -- いいえ --> E
E --> B
F --> H([完了])
ステップバイステップ
ステップ 1: 作業を実行
通常通りタスクを完了します。コードを書き、仕様を作成し、機能を実装します。ためらわずに、最善の初回アプローチを生成してください。
ステップ 2: レビューサブエージェントを起動
エージェントツールを使用してレビュアーを派遣します。レビュアーは以下を満たす必要があります:
- 独立したサブエージェントであること(新しいコンテキスト、あなたの推論に影響されない)
- ワークプロダクト(ファイル、差分)のみを受け取ること — あなたの思考プロセスは渡さない
- 1〜10のスコアと具体的で実用的なフィードバックを提供すること
- デフォルトではバランス型/標準モデルを使用すること(複雑/特殊なタスクでは高度推論モデルを使用してもよい)
レビュアープロンプトテンプレート:
あなたは批評的なレビュアーです。以下の作業を1〜10でスコア付けし、具体的で実用的なフィードバックを提供してください。
## 行われたこと
{タスクの簡単な説明}
## レビュー基準
{タスク固有の基準 — このタスクで重要なこと}
適切に書かれた基準の例:
REST APIエンドポイントの場合:
- 正しいHTTPステータスコードが使用されている
- すべてのパラメータに入力バリデーションが存在する
- 認証が適用されている; 認証されていないアクセスがない
- N+1クエリパターンがない
設計文書の場合:
- 問題の記述が曖昧でない
- 代替案がトレードオフとともに検討されている
- 実装の複雑さについてごまかしていない
- 成功指標が測定可能である
データパイプラインの場合:
- べき等性がある — 再実行しても安全
- スキーマ変更が適切に処理される
- 障害モードが文書化されている
- PIIの取り扱いが対処されている
## 指示
1. 作業を注意深く読んでください
2. 1〜10でスコア付け:
- 1-3: 根本的に壊れているか、主要な要件が欠落している
- 4-6: 動作するが重大な問題がある
- 7-8: 良い、軽微な問題のみ
- 9-10: 優秀、出荷準備完了
3. 該当する場合はファイル:行参照とともに具体的な問題をリストアップ
4. 各問題について、**なぜ**それが重要で、**何を**修正すべきかを説明
5. 礼儀正しくしないでください — 正直かつ率直に
6. スコアを「Score: N/10」と明確に記述
## レビューするファイル
{ファイルの内容を貼り付けるか、関連する抜粋とともにファイルパスをリストアップ}
ステップ 3: フィードバックを解析
レビュアーの応答から以下を抽出:
- スコア (数値)
- 問題点 (重大 / 重要 / 軽微 に分類)
- 具体的な修正 (何を変更すべきか)
ユーザーに報告:
ループ {N}/{max}: スコア {X}/10
- {主要なフィードバックポイントのサマリー}
ステップ 4: 停止条件を確認
以下の順序で:
- 完了したループ数 < 最小ループ数 → 継続 (常に)
- スコア >= 品質ゲート → 停止、最終ポリッシュへ
- 完了したループ数 >= 最大ループ数 → 停止、最終ポリッシュへ
- それ以外 → 修正してループ
ステップ 5: 修正
レビュアーのフィードバックに対応します。重大および重要な問題を修正します。軽微な問題は任意です。その後、ステップ2に戻ります。
重要: 各修正は的を絞ったものにしてください。すべてを書き直さないでください — レビュアーが指摘した箇所を修正します。以前のすべてのフィードバックを頭の中でリスト化し、退行を防ぎます。
ステップ 6: 最終ポリッシュ
ループが終了したら(品質ゲートに達するか最大ループ数に達した場合):
- 残っている軽微な問題があれば、簡単に修正可能なものに対処
- 最終出力に一貫性があることを確認(修正サイクルによるアーティファクトがないこと)
- 最終スコアとループ数をユーザーに報告
タスクタイプ別のレビュー基準の適応
| タスクタイプ | レビュアーが注力すべき点 |
|---|---|
| コード | 正確性、エッジケース、エラー処理、可読性、セキュリティ問題がないこと |
| 仕様/設計 | 完全性、実現可能性、ごまかしがないこと、実装可能性 |
| リファクタリング | 動作変更なし、退行なし、以前よりクリーンであること |
| 文書作成 | 明確さ、構成、対象読者に適切、冗長でないこと |
| バグ修正 | 根本原因に対処、退行テストあり、副作用なし |
| インフラ/IaC | べき等性、最小権限、ハードコードされたシークレットなし、破棄の安全性 |
| データベースマイグレーション | 可逆性、インデックス戦略、データ損失リスク、大規模時のパフォーマンス |
| API設計 | 後方互換性、認証、バージョニング、エラーコントラクト |
| テストスイート | エッジケースカバレッジ、テスト間の依存なし、意味のあるアサーション |
2つの運用モード
モード A: 「実行とレビュー」 (フルサイクル)
ユーザーがタスクを与え、review-loopの使用を指示します。作業を実行し、レビューループも実行します。
ユーザー: 「キャッシュレイヤーを実装して。review-loopを使って、品質ゲート8。」
あなた:
1. キャッシュレイヤーを実装
2. レビュアーを起動 → スコア 6、フィードバック: 削除機構がない、TTLがない
3. 修正: 削除機構とTTLを追加
4. レビュアーを起動 → スコア 8、フィードバック: 軽微な命名に関する指摘
5. 最終ポリッシュ、完了
モード B: 「既存のものをレビュー」 (レビューのみ)
ユーザーが既に作業を行ったか、あなたが既に作業を行いました。既存のものに対してレビューループを実行するだけです。
ユーザー: 「今書いた認証モジュールに対してreview-loopを実行して」
あなた:
1. 認証モジュールを読み込む
2. レビュアーを起動 → スコア 5、フィードバック: SQLインジェクション、レート制限なし
3. 修正: クエリをパラメータ化、レート制限を追加
4. レビュアーを起動 → スコア 8、承認
5. 完了
レッドフラグ
絶対に避けるべきこと:
- サブエージェントを起動せずに自己レビュー(アンカリングバイアス)
- 正当な理由なく「フィードバックが間違っている」と修正サイクルをスキップ
- 自分のスコアを水増しする(「これは実際には9だと思う」)
- ユーザーの同意なしに最大ループ数を超えて継続
- 完全な推論/履歴をレビュアーに渡す(レビュアーはあなたの意図ではなく、WORKをレビューすべき)
レビュアーが間違っている場合:
- 証拠を示して反論する(フィードバックを否定するコード/テストを示す)
- 修正時にその特定のポイントをスキップする
- ユーザーへの報告にその旨を記す
- 品質の基準を下げて補償しない
レポート形式の例
--- レビューループ: {タスク名} ---
ループ 1/4: スコア 6/10
レビュアー: 入力バリデーション欠如、ネットワークタイムアウトのエラー処理なし、
関数が長すぎる(80行)。
アクション: 3つの問題すべてを修正中。
ループ 2/4: スコア 8/10
レビュアー: クリーン。軽微: 変数名 `d` はより説明的にすべき。
アクション: 品質ゲート達成 (8 >= 8)。最終ポリッシュ。
結果: 2ループで8/10。完了。
既知の制限
- レビューサブエージェントは以前のループの記憶を持ちません — 解決済みの問題を繰り返し指摘されないように、各レビュアープロンプトに以前のフィードバックコンテキストを明示的に含めてください
- レビュアープロンプトの基準があいまいすぎると、スコアのインフレが発生する可能性があります — 具体的で測定可能な基準を書くことに時間を投資してください
- このスキルは、セキュリティクリティカルまたはコンプライアンスに敏感なコードに対する人間によるコードレビューを代替しません。出力は強力な最初のパスとして扱ってください
- タスクの指定が不十分な場合、ループの収束は保証されません — 開始前に明確な受け入れ基準を定義してください
コストと速度
- 各ループ = 1回のレビューサブエージェント呼び出し
- 3ループのフルサイクルでは、単一実装パスの約1〜2倍の時間を見積もってください
- これは、バグのあるコードをリリースしたり、あいまいな仕様を作成したり、後期のレビューサイクルを引き起こしたりするよりも安上がりです
- ほとんどのレビューにはデフォルト/標準モデルを使用してください。特殊なドメイン(セキュリティ監査、分散システム、クオンツファイナンス)にのみ、高度推論モデルにアップグレードしてください
ライセンス
MIT — どのAIツールやプラットフォームでも自由に使用、適応、再配布できます。帰属表示をいただければ幸いです。コントリビューションを歓迎します。