Review Local
code-reviewer エージェントを使用し、現在のワークスペースの変更をレビューしてレポートを作成する。 open 引数を指定しない場合には、指摘事項の自動修正を実行する。
使用方法
/review-local [<branch>|open] [追加の指示]
引数
-
引数なし: 現在のローカル変更(staged + unstaged)をレビュー後に、自動修正と再レビューを案内する
-
<branch> : ブランチとの差分をレビュー後に、自動修正と再レビューを案内する
-
open : レビュー後にエディタでレポートを表示する。修正は手動で行う
動作モード
引数 動作
なし / ブランチ名 レビュー実施 → 自動修正 → 再レビュー案内
open を含む レビュー実施 → エディタでレポート表示
実行手順
- 情報収集
-
プロジェクトルールの読み込み
-
CLAUDE.mdがあれば読み込み、プロジェクト固有のルールを把握する
-
対象の判定と差分情報の取得: 引数($ARGUMENTS)を解析して対象を決定する
-
base_ref = 指定されたブランチ名、または main
-
変更ファイル一覧と差分の取得
-
引数なし(ローカル変更のみ)の場合:
-
git diff --name-only (unstaged)と git diff --cached --name-only (staged)の両方で対象を特定する
-
git diff と git diff --cached の両方で実際の差分を取得する
-
base_ref 指定の場合:
-
git diff --name-only [base_ref] で対象を特定し、git diff [base_ref] で実際の差分を取得する
- レビュー実行とレポート作成
-
取得した差分情報とプロジェクトルールに基づき、変更されたすべてのファイルに対して多角的なレビューを実行する
-
レビュー結果を統合した一時ファイル reviews/local-{YYYYMMDDHHMMSS}.md に保存する
-
reviews ディレクトリが存在しない場合は、mkdir -p reviews を実行し、作成する
- 後続アクションの実行
引数($ARGUMENTS )に open が含まれているかどうかで、以下の通り動作を分岐する:
A. open が含まれている場合(手動修正モード)
-
保存したレポートファイルを $EDITOR で開く(未定義時は code または macOS の open コマンドを使用)
-
処理を終了する
B. open が含まれていない場合(自動修正モード)
-
レビュー結果に指摘事項がない場合は、「指摘事項なし」とユーザーに報告して処理を完了する
-
指摘事項がある場合は、その サマリー(主要な指摘事項) をユーザーに報告する
-
指摘事項を解決するためのコード修正を、対象ファイルに 自動的に(Write や Edit を使用して)適用する
-
修正適用後、再度 /review-local を実行してレビューを受けるようユーザーに案内する
注意事項
- ローカル実行専用: GitHub API は使用しないため、ローカルの変更に対してのみレビューを行う