概要

claude-review-loopは、Claude Code環境向けのプラグインで、コマンド一つで「実装」と「独立レビュー」を順に自動実行するワークフローを提供します。ユーザーが /review-loop を呼ぶと、まずClaudeが指定タスクを実装（Task phase）し、実装完了時の停止フックでOpenAIのCodexリポジトリを使って独立したコードレビュー（Review phase）を実行。Codexからの指摘をClaudeに渡し、必要な修正を自動で行わせることで、各タスクに対して人の第二の目に相当するチェックを挟み、品質向上とレビュープロセスの自動化を目指します。導入は軽量でShellベースの構成が中心です。

リポジトリの統計情報

スター数: 43
フォーク数: 3
ウォッチャー数: 43
コミット数: 13
ファイル数: 4
メインの言語: Shell

主な特徴

/review-loop コマンドでワンコマンド起動：実装→独立レビュー→修正のループを自動化
独立レビューにCodexを利用：Claudeとは別モデルによる「第2の目」を確保
ストップフックで自動連携：タスク完了時にレビューが自動トリガーされる設計
軽量なShellベース実装で導入が容易、プラグイン定義は .claude-plugin で管理

技術的なポイント

このプラグインは概念的に二段階のライフサイクル（Task phase と Review phase）を実装している点が最大の技術的特徴です。プラグイン本体はShellスクリプト中心の軽量構成で、Claude Codeのプラグイン仕様（.claude-plugin ディレクトリ）を使ってコマンドとフックを登録します。ユーザーが /review-loop を実行すると、まずClaudeにタスクの実装を依頼し、実装完了時に定義された“stop hook”が発火します。このフックがCodexリポジトリ（openai/codex の仕組みやCLI）を呼び出して、出力コードに対する独立した静的／セマンティックなレビューを行います。

重要なのは「独立性」の担保で、レビューは元の実装を行ったClaudeとは別のレビューモデル（Codex）に委ねることでバイアスを低減します。Codexのフィードバックは構造化されたコメントや修正案として取得され、それを再びClaudeに渡してフィードバック反映と修正実行を指示することで、クローズドループが完成します。実装面では外部モデル呼び出しのためのAPIキー管理、コマンド実行の安全性（サンドボックス化）、レビュー結果の差分抽出と適用ロジックが重要です。Shell実装は導入の簡便さを優先しますが、実運用ではCI統合、ログの永続化、並列実行に備えたロックやタイムアウト処理、レビュー品質評価のためのメトリクス収集が求められる点にも注意が必要です。拡張性としては、Codex以外のレビューモデルや追加ツール（静的解析器、テストランナー）をstop hookに差し替えて多段レビューを構築することも可能です。

プロジェクトの構成

主要なファイルとディレクトリ：

.claude-plugin: dir
.gitignore: file
README.md: file
plugins: dir

（.claude-plugin はプラグイン定義とフック設定、plugins ディレクトリに実際のスクリプトやレビューツール呼び出しラッパーが配置される想定。READMEには使い方とワークフローの説明が記載されています。）

使いどころと注意点

使いどころ：個人開発や小〜中規模チームの開発フローで、人手を介さずにレビューの“第2の目”を挟みたい場合や、CIパイプラインでの自動チェックに組み込みたい場合に有効です。簡単なバグ修正や新機能の実装を素早く回しつつ、品質担保を図れます。
注意点：モデルによるレビューは誤検知や見落としがあり得るため、重要な変更は人間レビューを併用することを推奨します。外部モデル呼び出しにはAPIキーが必要で、コード・データの機密扱いに注意が必要です。また自動修正を適用する前に差分を必ず確認する運用ルールが望ましいです。

まとめ

ワンコマンドで実装→独立レビュー→修正を自動化し、開発スピードと品質の両立を狙う軽量プラグインです。

リポジトリ情報：

名前: claude-review-loop
説明: Claude Code plugin: automated code review loop with Codex
スター数: 43
言語: Shell
URL: https://github.com/hamelsmu/claude-review-loop
オーナー: hamelsmu
アバター: https://avatars.githubusercontent.com/u/1483922?v=4

READMEの抜粋：

review-loop

A Claude Code plugin that adds an automated code review loop to your workflow.

What it does

When you use /review-loop, the plugin creates a two-phase lifecycle:

Task phase: You describe a task, Claude implements it
Review phase: When Claude finishes, the stop hook automatically runs Codex for an independent code review, then asks Claude to address the feedback

The result: every task gets an independent second opinion before…

claude-review-loop — 自動コードレビューループ（Claude + Codex）