103kaz/claude-code-loops

review-loop

現在のブランチ上で開発ループを実行します：検証、差分のレビュー、修正を行い、ラップで何も見つからなくなるまで繰り返します。スコープは差分のみであり、コードベース全体ではありません。このスキルはプッシュやプルリクエストの作成は行いません。それらはユーザーに委ねられます。

手順

1. .claude/verify.sh を実行します。失敗した場合は、まずそれを修正します。ファイルが存在しない場合はユーザーに伝え、/code-loops:init-verify を指摘し、検証なしで続行し、レポートでその旨を報告します。
2. 差分を決定します。最初のラップ：ベースブランチとの差分（git diff origin/HEAD...HEAD に加え、未コミットの変更については git diff HEAD、git status --short から直接読み取る追跡対象外ファイル）。origin/HEAD が設定されていない場合は origin/main または origin/master を試します。どちらも存在しない場合はベースをユーザーに尋ねます。差分が空の場合（たとえばベースブランチ上にいる場合）、レビューするものが何もないことを報告して停止します。未コミットの変更がブランチの作業に関連していないように見える場合は、修正せず、レポートでその旨を述べます。後のラップ：前のラップで変更した内容のみを対象とします。
3. 差分をレビューする。
   • コードを変更している場合は、code-review スキルを中程度の労力で使用します。そのスキルが利用できない場合は、自分で差分を読んでバグを見つけます：誤った結果、欠落したエラーパス、変更によって壊れる呼び出し元。
   • ドキュメント（.md など）のみを変更している場合は、代わりに /code-loops:doc-code-consistency を差分に対して使用します。
4. 指摘事項を修正します。コミットはせず、ユーザーに委ねます。各修正後、手順1に戻ります。ラップで何も見つからなくなるまで繰り返します。修正しないことにした指摘事項には、1行の理由を付けます。3回連続でラップが指摘事項を見つけ続けた場合（verify.sh の失敗も含む）、停止し、残っているものを報告して続行しません。
5. 差分がドキュメントで説明されているコードを変更した場合、最後に /code-loops:doc-code-consistency を差分に対して1度実行し、見つかった問題を修正します。
6. 独立したレビューを1度提供します（差分がドキュメントのみの場合は除く）。ユーザーに（AskUserQuestion で）実行するかどうかを尋ね、この差分に見合うかどうか（サイズ、リスクのある領域）を1行でメモします。デフォルトは「いいえ」です。「はい」の場合、その差分だけを見て、それがどのように構築されたかは見ないサブエージェントを起動します。読み取り専用エージェントタイプが存在する場合はそれを使用し（例：Explore）、存在しない場合はファイルを編集しないように指示します。サブエージェントに、変更を壊す入力、状態、順序を探させ、それぞれをファイル:行の証拠とともに報告させます。.claude/review/checklist.md が存在する場合は、それに照らしてチェックも行わせます。見つかった問題を修正し、それらの修正のみに対して手順1と3を実行します。サブエージェントが利用できない場合は、この手順をスキップし、レポートでその旨を述べます。
7. 数行で報告します：「結果：指摘事項なし」、または「結果：維持された指摘事項」と、各指摘事項とその理由を記載します。verify.sh が成功したかどうか、かかったラップ数、独立したレビューが実行されたかどうかを追加します。

各ラップは静かに保ちます：リポジトリ全体ではなく差分を読み、以前のラップの指摘事項を繰り返さないようにします。