mcpField
C
codex-review

codex-review

github.com/jezwebテスト・品質1.1k556 回インストール3 週間前に更新
リポジトリ

codex-review について

codex-reviewは、OpenAI Codex CLIでコードレビューを実行する助言専用のスキルです。アプリ全体、未コミットの変更、ブランチ、コミットを対象にでき、指摘を日時付きレポートに保存します。

主な機能

  1. 01OpenAI Codex CLIでレビューを実行
  2. 02アプリ・変更・ブランチ・コミットを対象化
  3. 03専用のレビュープロンプトを使用
  4. 04日時付きレポートを保存
  5. 05優先度の高い指摘を提示

活用シーン

  1. 01コミットやリリース前に変更を確認
  2. 02PR作成前に自己レビュー
  3. 03特定しにくい懸念を調査
  4. 04開発中プロジェクトを定期レビュー

インストール

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

$npx skills add https://github.com/jezweb/claude-skills --skill codex-review

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

同梱ファイルprompt.md

詳細

Codex Review

OpenAI Codex CLI（codex review）を使って、独立したコードレビューを実行します。この方法の価値は、コードを書いたモデルファミリーとは異なるモデルファミリーからセカンドオピニオンを得られることです。Codex は、作者バイアスによって Claude が見落とす問題を見つけます。

brains-trust（汎用的な複数モデルによる意見）を補完します。このスキルは特化型で、Git を考慮し、調整済みのレビュー用プロンプトを使い、構造化された出力を保存します。

使用するタイミング

  • 意味のある変更を行った後、コミットまたはリリースする前
  • PR を作成する前に、独立したレビュアーによるセルフレビューを行うとき
  • 何かがおかしいと感じるものの、うまく説明できないとき
  • 開発が活発なプロジェクトで、アプリ全体を定期的にレビューするとき
  • ユーザーが「独立した」レビューや「セカンドオピニオン」を明示的に求めたとき

次の場合は使用しないでください：

  • 些細な変更（誤字、1 行の修正）
  • 調査に関する質問やアーキテクチャの議論。代わりに brains-trust を使用してください
  • 問題の自動修正。このスキルは助言のみを行います

事前確認

  1. Codex CLI がインストールされていることを確認します：

    which codex

    インストールされていない場合は、ユーザーにインストールするよう伝え（macOS では brew install codex を実行するか、https://github.com/openai/codex を参照）、停止します。続行しないでください。

  2. 認証を確認します。最初の codex review 呼び出しは、ログインしていない場合に明確なエラーを返します。その場合は、ユーザーに codex login を実行するよう伝え、停止します。

対象範囲を決定する

ユーザーの依頼に応じて、対象範囲のフラグを選択します：

ユーザーの意図フラグ
「codex review」／「アプリをレビューして」／「全体をレビューして」／指定なしフラグなし（現在の HEAD にあるアプリ全体をレビュー）
「変更をレビューして」／「直近の作業をレビューして」／「未コミットの変更をレビューして」--uncommitted
「このブランチを main と比較してレビューして」／「PR をレビューして」--base main（またはユーザーが指定したブランチ）
「コミット abc123 をレビューして」--commit abc123

デフォルトはアプリ全体のレビューです。 条件指定のない「codex review」は、未コミットの変更だけではなく、HEAD にあるコードベース全体をレビューするという意味です。ユーザーが直近の作業または未コミットの作業を具体的に指している場合に限り、--uncommitted を使用します。

曖昧な場合は、一度だけ質問してください。コミットやブランチについて推測しないでください。

レビューを実行する

標準のレビュープロンプトは、このスキルと同じディレクトリにある prompt.md に記載されています。シェルのエスケープを避けるため、標準入力経由で渡します：

mkdir -p .jez/reviews
TS=$(date +%Y-%m-%d-%H%M)
OUT=".jez/reviews/codex-${TS}.md"
SKILL_DIR="$(dirname "$0")"  # or use the skill's absolute path

# Example: uncommitted changes
cat "${SKILL_DIR}/prompt.md" | codex review --uncommitted - 2>&1 | tee "$OUT"

その他の対象範囲：

# Vs base branch
cat prompt.md | codex review --base main - 2>&1 | tee "$OUT"

# Specific commit
cat prompt.md | codex review --commit abc123 - 2>&1 | tee "$OUT"

# Current HEAD (no scope flag)
cat prompt.md | codex review - 2>&1 | tee "$OUT"

大規模な差分の場合、codex review の実行には数分かかることがあります。そのまま完了するまで待ちます。

ユーザー向けに要約する

Codex の処理が完了したら：

  1. 出力先を表示します：Report saved to .jez/reviews/codex-<timestamp>.md
  2. 保存されたレポートを読み、上位の指摘（Critical と High に該当するもの）を抽出します
  3. ファイルと行番号の参照をそのまま保ち、チャット内に表示します
  4. 指摘事項への対応を提案します：「auth.ts:42 の SQL インジェクションを修正しましょうか？」

ルール

  • 助言のみです。 Codex の提案を自動適用してはいけません。指摘を読み、ユーザーと話し合い、承認を得てから修正します。
  • Claude の推論をプロンプトに漏らさないでください。 prompt.md は意図的に中立な内容になっています。Codex にレビューさせるのはコードであり、コードに関する Claude の説明ではありません。独立性が何より重要です。
  • .jez/reviews/ に保存してください。 保護されたディレクトリである .claude/ には保存しないでください。
  • 実行ごとにレポートを 1 件作成してください。 上書きしないでください。タイムスタンプによって各実行を区別できるため、ユーザーが比較できます。
  • Codex が実際に見つけた内容を報告してください。 指摘を和らげたり、論評を加えたり、同意できない指摘を省いたりしないでください。Codex の指摘が誤っていると思う場合は、まず Codex の内容を示したうえで、独自の意見として伝えてください。

検証

次の条件を満たしていれば、このスキルは正しく動作しています：

  • 事前確認で codex バイナリがないことを正しく検出する
  • ユーザーの意図に基づいて適切な対象範囲のフラグを選ぶ
  • 適切なタイムスタンプが付いたレポートファイルが .jez/reviews/ に作成される
  • ファイルに、重大度順の指摘とファイル・行番号への参照が含まれる
  • Claude が指摘を自動修正せず、上位の指摘をユーザーに示す

コメント

Markdown 対応