mcpField
C
council-review

council-review

github.com/trancong12102テスト・品質7145 回インストール5 週間前に更新
リポジトリ

council-review について

Council Reviewは、Codex CLI、Claudeの`/review`、`/code-review max`を並行実行し、結果を照合して一つのレポートにまとめるコードレビュー用スキルです。同じ変更を複数の視点から確認したい開発者向けです。

主な機能

  1. 013種類のレビュアーを並行実行
  2. 02未コミット変更・ブランチ・コミットのレビュー
  3. 03指摘の照合と重複排除
  4. 04優先度順の統合レポート
  5. 05レビュアー不在時のフォールバック

活用シーン

  1. 01コミット前の未コミット作業の確認
  2. 02ベースブランチとの差分レビュー
  3. 03複数レビュアーによる特定コミットの評価

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/trancong12102/agentskills --skill council-review

インストール後、Claude Code で/council-reviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
merge-rules.md
output-format.md
scripts/
codex-review.py

詳細

レビュー会議

Codex、Claude 独自の /review、および /code-review max を並行して実行し、相互検証したうえで、統合レポートにまとめます。3 人のレビュアーが異なる視点からコードを調査し、主査の Claude が最終的な見解を示すレビュー会議のように進めます。

前提条件

  • Codex CLI：npm i -g @openai/codex でインストールし、codex login で認証します

CLI が 1 つしかインストールされていない場合は、警告を表示して利用可能なレビュアーで代替します。視点が少なくてもレビューには価値があるため、処理を完全に中断しないでください。

ワークフロー

スクリプトのソースコードは読まないでください。スクリプトを直接実行し、使い方を確認するには --help を使用してください。

ステップ 1：レビュー範囲を決める

範囲がまだ明確でない場合は、AskUserQuestion を使って次の項目を尋ねます。

  • 未コミットの変更（デフォルト）— ステージ済み、未ステージ、および未追跡の変更
  • ブランチ差分 — 現在のブランチとベースブランチを比較
  • 特定のコミット — 1 つの変更セットを監査
ステップ 2：3 つのレビューをすべて並行して実行する

3 人のレビュアーは同じ差分をそれぞれ独立して確認します。どのレビューも他のレビューの出力には依存しません。順番待ちをなくすため、1 つのメッセージで 3 つすべてを同時に起動してください。

スクリプトはこのスキルのディレクトリを基準とした scripts/ にあり、適切なモデルと読み取り専用モードが内部で適用されます。詳しい使い方は <script> --help を実行して確認してください。

Codex — scripts/codex-review.py（バックグラウンド Bash タスク）

バックグラウンド Bash タスクとして起動します（run_in_background: true）。Codex CLI の実行には最大 30 分かかる場合があります。完了したら、通知に記載された output-file のパスを Read ツールで読み込み、レビューを取得します。

python3 scripts/codex-review.py uncommitted
python3 scripts/codex-review.py branch --base main
python3 scripts/codex-review.py commit <SHA>
Claude — /review スキル（バックグラウンド Agent）

同じ範囲を /review でレビューするバックグラウンド Agent を起動します（run_in_background: true）。Agent には、Skill ツールを通じて /review スキルを呼び出し、すべての指摘事項を返すよう指示します。Agent の出力は完了通知に直接届きます。

Quality — /code-review max スキル（バックグラウンド Agent）

同じ範囲を /code-review max でレビューするバックグラウンド Agent を起動します（run_in_background: true）。Agent には、Skill ツールを通じて max の労力レベルで code-review スキルを呼び出し、分析と指摘事項のみをテキストで返すよう指示します。コードの修正は適用しないでください。Agent の出力は完了通知に直接届きます。（/code-review はデフォルトで問題を修正するため、レポートのみを返すよう指示することは必須です。）

3 つのバックグラウンドタスクをすべて起動したら、直ちにターンを終了してください。それ以外は何も出力せず、ステップ 3 に進まず、タスクの進捗も確認しないでください。各タスクが完了すると、自動的に通知されます。

ステップ 3：指摘事項を相互検証する

3 つすべてのタスクの完了通知を受け取ったら、相互検証を行います。

  1. 外部レビューの指摘事項を検証する — Codex と /code-review max の各指摘事項について、次のように対応します。
    • 確認 — Claude も問題が存在し、説明が正しいと独立して判断した場合。
    • 異議 — Claude が誤検知、または分類が不適切だと判断した場合。その理由を記載します。
    • 改善 — 問題は存在するものの、説明または修正案を改善できる場合。改善した内容を提示します。
  2. Claude 独自の指摘事項を追加する — 他のレビュアーが見つけられなかった /review の問題を含めます。
  3. レビュアー間の一致を記録する — 複数のレビュアーが指摘した問題を記録します（一致するレビュアーが多いほど確度が高くなります）。
ステップ 4：統合レポートにまとめる

自分でのレビューと検証が完了したら、すべての指摘事項を統合、重複排除し、1 人のレビュアーが書いたような一貫性のあるレポートに書き直します。元の出力をコピーして貼り付けたり、単純につなげたりしないでください。

レポートのテンプレートには references/output-format.md を読み込みます。レビュアー間の指摘事項の調整方法については references/merge-rules.md を読み込みます。

ルール

  • すべてのレビュー担当者で同じレビュー範囲を使用してください。 異なる範囲を比較しても、重複排除の意味がなくなります。
  • /code-review max エージェントは報告のみを行うようにしてください。 エージェントには、テキストで指摘事項を返し、コードの修正は行わないよう明示してください。
  • 統一された見解をまとめてください。 レポートは、1人のレビュー担当者による評価として読めるようにします。レビュー担当者ごとに指摘事項を分類しないでください（「Codex の指摘…」「Quality の指摘…」のようなセクションは設けません）。
  • 指摘事項を優先度順に並べてください — P0 → P1 → P2 → P3 → P4。
  • 信頼度の低い指摘事項は除外してください。 Claude が外部からの指摘に異議を唱えた場合や、根拠が状況証拠のみの場合は、レポートに含めないでください。評価会議の価値は相互検証にあります。検証を通らなかった指摘事項はノイズです。
  • Codex には必ずラッパースクリプトを使用してください。 このスクリプトは適切なモデルと読み取り専用モードを設定します。codex CLI を直接呼び出すと、これらの設定が適用されません。
  • 中間出力を表示しないでください。 各スキルをサブエージェントで実行し、生のレビュー結果をメインの会話に出さないようにします。ユーザーに表示するレビュー結果は、最終的な統一レポートのみです。
  • バックグラウンドタスクの出力は、完了通知にある output-file パスを Read ツールで読み取ってください。 TaskOutput ではバックグラウンド Bash タスクの ID を見つけられず、失敗します。バックグラウンド Agent の場合は、完了通知に記載された結果を直接読み取ってください。
  • レビュー担当者が実行時に失敗した場合、2人以上が成功していれば、残りのレビュー担当者で続行してください。 成功したレビュー担当者が2人未満の場合は、停止してエラーを報告してください。1人だけのレビュー結果では相互検証ができません。

コメント

Markdown 対応