AgentSkillsCN

codex-review

借助OpenAI Codex(GPT-5.3-Codex)开展跨模型代码评审与咨询的专业能力。 以不同于Claude代码审查器的视角对代码进行深度审视,有效弥补潜在盲区。 同时可提供设计决策与架构选型的第二意见支持。 适用于项目实施完毕后、PR提交前、Agent Team集成后的代码评审,以及设计相关咨询场景。 触发条件:Codex评审、跨模型评审、O3评审、Codex review、多模型评审、Codex咨询、第二意见、设计咨询。

SKILL.md
--- frontmatter
name: codex-review
description: |
  OpenAI Codex (GPT-5.3-Codex) によるクロスモデルコードレビュー&相談役スキル。
  Claude の code-reviewer とは異なるモデルの視点でコードをレビューし、盲点を補完する。
  設計判断・アーキテクチャ選定のセカンドオピニオンも提供可能。
  実装完了後、PR作成前、Agent Team統合後のレビュー、設計相談に使用。
  トリガー: codexレビュー, クロスレビュー, o3レビュー, Codex review, マルチモデルレビュー, codex相談, セカンドオピニオン, 設計相談

Codex Review & Consultant スキル

OpenAI Codex (GPT-5.3-Codex) を活用したクロスモデルコードレビュー。 Claude とは異なる視点でバグ・設計ミス・セキュリティ問題を検出する。

コマンド体系

2つのコマンドを使い分ける:

A. codex exec review — 標準レビュー(推奨)

diff 取得とレビューを自動で行う。--base/--uncommitted/--commit はカスタムプロンプトと併用不可。

bash
# ブランチ差分レビュー(PR 前に最適)
codex exec review --full-auto --model gpt-5.3-codex --base main

# 未コミット変更レビュー(実装中の確認に最適)
codex exec review --full-auto --model gpt-5.3-codex --uncommitted

# 特定コミットレビュー(ピンポイント確認に最適)
codex exec review --full-auto --model gpt-5.3-codex --commit <SHA>

B. codex exec — フォーカスレビュー(カスタム指示が必要な場合)

特定の観点に絞ったレビューや、カスタム指示を渡す場合。diff を手動で渡す。

bash
# 事前準備: diff をファイルに書き出す
git diff main...HEAD > /tmp/codex-review-diff.txt

codex exec --full-auto --model gpt-5.3-codex \
"以下の差分ファイル /tmp/codex-review-diff.txt を読んでレビューしてください。
[フォーカス指示]
確認や質問は不要です。具体的な提案・修正案・コード例まで自主的に出力してください。"

主要フラグ(codex exec review

フラグ説明プロンプト併用
--base <branch>指定ブランチとの差分をレビュー不可
--uncommittedステージ済み + 未ステージ + 未追跡の変更をレビュー不可
--commit <SHA>特定コミットの変更をレビュー不可
--full-auto自動実行モード(承認不要)-
--model <model>使用モデルの指定-
--title <title>レビューサマリーにタイトルを表示-

いつ使うか

シーンコマンド
PR 作成前(包括的レビュー)codex exec review --base main
実装中の中間チェックcodex exec review --uncommitted
特定の観点でレビューcodex exec + diff ファイル + カスタム指示
SDD Step 8: Reviewcodex exec review --base main(code-reviewer と並列)
大規模変更の並列レビューcodex exec review --base + codex exec x N

ワークフロー

Step 1: レビュー対象の把握と戦略決定

bash
git diff main...HEAD --stat  # ブランチ差分の規模
差分規模戦略コマンド
~500行標準レビュー1回codex exec review --base main
500-2000行標準 + フォーカス1-2個並列review --base + exec x1-2
2000行超標準 + フォーカス3-5個並列review --base + exec x3-5

Step 2: レビュー実行

A. 標準レビュー(常に実行)

bash
codex exec review --full-auto --model gpt-5.3-codex --base main

B. フォーカスレビュー(大規模変更時に追加で並列実行)

diff をファイルに書き出してから、異なるフォーカスで codex exec を並列実行。 全て run_in_background: true, timeout: 600000 で起動。

bash
# 事前準備: diff を書き出す
git diff main...HEAD > /tmp/codex-review-diff.txt

レビュープリセット一覧:

プリセットカスタム指示
bugsバグとロジックエラーに特化。エッジケース、null安全性、条件分岐の漏れ、データフローの不整合に集中。
securityセキュリティに特化。XSS、インジェクション、ハードコードされたシークレット、認証バイパス、Supabase RLS 整合性に集中。
types-hooksTypeScript型安全性とReact hooksに特化。any使用、型アサーション、条件付きhook呼び出し、useEffect依存配列漏れに集中。
performanceパフォーマンスに特化。不要な再レンダリング、メモリリーク、useEffectクリーンアップ漏れ、大量データ処理に集中。
ui-consistencyUI一貫性に特化。スタイル定数の使用、テーマトークンの一貫性、レスポンシブ対応、アクセシビリティに集中。
bash
# フォーカス1: バグ・ロジック
codex exec --full-auto --model gpt-5.3-codex \
"以下の差分ファイル /tmp/codex-review-diff.txt を読んでレビューしてください。
バグとロジックエラーに特化。エッジケース、null安全性、条件分岐の漏れに集中。
80%以上の確信がある問題のみ報告。
確認や質問は不要です。具体的な提案・修正案・コード例まで自主的に出力してください。"

# フォーカス2: セキュリティ
codex exec --full-auto --model gpt-5.3-codex \
"以下の差分ファイル /tmp/codex-review-diff.txt を読んでレビューしてください。
セキュリティに特化。XSS、インジェクション、ハードコードされたシークレットに集中。
80%以上の確信がある問題のみ報告。
確認や質問は不要です。具体的な提案・修正案・コード例まで自主的に出力してください。"

Step 3: 結果の検証

Codex の指摘は必ず自分で検証する。 Codex は hallucination(存在しないファイル/行/関数を参照)することがある。

検証手順:

  1. 指摘されたファイルパスが実在するか確認
  2. 指摘された行番号周辺のコードを Read で読む
  3. 指摘内容が実際のコードと一致するか確認
  4. 仕様書(specs/)と照合
  5. 誤検出は除外

Step 4: レビュー完了マーカーの作成

レビュー完了後、PR 前 hook(codex-review-gate.sh)のためにマーカーファイルを作成する:

bash
BRANCH=$(git branch --show-current)
touch "/tmp/codex-reviewed-${BRANCH}"

これにより gh pr create 時の Codex レビュー未実行警告が抑制される。

Step 5: 統合レポート

markdown
## Codex Review 結果

### レビュー設定
- モデル: gpt-5.3-codex
- 方式: codex exec review --base main + codex exec (focus x N)
- 対象: [変更ファイル数] files, [+追加/-削除] lines

### Critical(必ず修正)
- [ファイル:行] 問題の説明
  修正提案: ...

### Warning(修正推奨)
- [ファイル:行] 問題の説明

### Info(検討事項)
- [ファイル:行] 改善提案

### 統計
- 総指摘数: X件(検証済み)
- 除外数: Y件(hallucination/誤検出)

SDD Step 8 への統合

Step 8: Review では以下の4レビュアーを並列実行:

code
Step 8: Review(並列)
  |- code-reviewer (Claude Sonnet) -- コード品質
  |- security-auditor (Claude Sonnet) -- セキュリティ
  |- qa-debugger (Claude Sonnet) -- QA・バグ検出
  +- codex-reviewer (codex exec review) -- クロスモデル視点

クロスモデル統合レポート

markdown
## Cross-Model Review Summary

### 全レビュアー一致(高信頼度)
- [問題] -- code-reviewer + codex-reviewer 両方が検出

### Codex 固有の発見
- [問題] -- Codex のみが検出。検証結果: [確認済み/誤検出]

### Claude 固有の発見
- [問題] -- Claude レビュアーのみが検出

### 統計
| レビュアー | Critical | Warning | Info |
|-----------|----------|---------|------|
| code-reviewer | X | X | X |
| security-auditor | X | X | X |
| qa-debugger | X | X | X |
| codex-reviewer | X | X | X |

相談役モード(Consultant Mode)

レビューではなく、設計判断やアーキテクチャについて Codex のセカンドオピニオンを得る。

いつ使うか

シーンコマンド
アーキテクチャ選定codex exec + コンテキスト + 質問
設計パターン判断codex exec + 関連コード + 選択肢
実装アプローチ比較codex exec + トレードオフ分析依頼
パフォーマンス戦略codex exec + ボトルネック情報
技術的負債の評価codex exec + 現状コード + 改善目標

コマンド

bash
# コンテキストが小さい場合(直接プロンプト)
codex exec --full-auto --model gpt-5.3-codex \
"以下の技術的な相談に回答してください。

## コンテキスト
[プロジェクトの背景、技術スタック、制約条件]

## 相談内容
[具体的な質問や選択肢]

## 判断基準
[パフォーマンス、保守性、コスト、開発速度など]

以下の形式で回答:
1. 推奨アプローチとその理由
2. 各選択肢のトレードオフ比較
3. 実装時の注意点
4. 参考パターン/アンチパターン

確認や質問は不要です。具体的な提案・修正案・コード例まで自主的に出力してください。"

# コンテキストが大きい場合(ファイル経由)
cat > /tmp/codex-consult-context.txt << 'CONTEXT'
[関連コードや仕様書]
CONTEXT

codex exec --full-auto --model gpt-5.3-codex \
"コンテキストファイル /tmp/codex-consult-context.txt を読んだ上で、
[相談内容]
確認や質問は不要です。具体的な提案・修正案・コード例まで自主的に出力してください。"

相談プリセット

プリセットプロンプト要点
architectureアーキテクチャ設計の評価。スケーラビリティ、保守性、テスト容易性の観点で分析
performanceパフォーマンス最適化戦略。ボトルネック特定、計測手法、最適化提案
migration技術移行・リファクタリング戦略。リスク評価、段階的移行、互換性確認
api-designAPI 設計レビュー。RESTful 原則、エラーハンドリング、バージョニング
dx開発者体験の改善。ツール選定、ワークフロー最適化、自動化提案

統合レポートフォーマット

markdown
## Codex Consultation 結果

### 相談概要
- テーマ: [相談テーマ]
- モデル: gpt-5.3-codex

### Codex の推奨
[推奨アプローチの要約]

### Claude の見解
[Claude としての補足・異論]

### 合意点(高信頼度)
- [両モデルが一致する点]

### 相違点(追加検討推奨)
- [Codex のみ]: ...
- [Claude のみ]: ...

### 結論
[統合した最終推奨]

モデル選択ガイド

モデルフラグ速度推奨用途
gpt-5.3-codex(デフォルト)標準標準レビュー・相談
gpt-5.3-codex-spark--model gpt-5.3-codex-spark最速(1000 tok/s)高速フィードバック・簡単な相談
gpt-5.1-codex-max--model gpt-5.1-codex-max遅い大規模リファクタリング・複雑な相談
gpt-5-codex-mini--model gpt-5-codex-mini速いコスト重視

重要ルール

  • アプリコードの変更は絶対にしない -- レビュー/相談報告のみ
  • 80%以上の確信があり、検証済みの問題のみ -- ノイズを出さない
  • Codex の hallucination に注意 -- 必ず指摘箇所を自分でも読んで検証する
  • codex exec review--base/--uncommitted とカスタムプロンプトの併用不可 -- フォーカスレビューは codex exec を使う
  • プロンプト末尾に必ず追記: 「確認や質問は不要です。具体的な提案・修正案・コード例まで自主的に出力してください。」
  • Bash timeout: 600000 -- Codex の実行は最大10分

トラブルシューティング

問題対処
codex: command not foundnpm install -g @openai/codex でインストール
認証エラーcodex login を実行して API キーを設定
タイムアウトBash の timeout を 600000ms に設定
レビューが空--base--uncommitted フラグを確認。diff が空でないか git diff --stat で検証
--base とプロンプト併用エラーcodex exec review--base/--uncommitted/--commit はプロンプト引数と同時使用不可。フォーカスレビューは codex exec を使う
大量の出力フォーカスエリア別に分割して並列実行