Review (レビュー)

Codex に組み込みの /review コマンドは Git のチェックアウト内の変更を対象にし、Code Review プラグインはプルリクエストを対象にします。手元の変更を見直す場面や、プルリクエストを承認する前に内容を確かめる場面で使います。

/review は Git のチェックアウト内の変更を対象にします。

• アプリ: composer に /review と入力し、Review against a base branch (ベースブランチとの比較) または Review uncommitted changes (未コミットの変更) を選びます。Codex は作業ツリーを変更せずに、優先度付きの指摘を返します。レビューペインには Git リポジトリ内のプロジェクトが必要で、Git リポジトリでない場合はアプリが作成を促します。
• CLI: /review と入力するとレビューのプリセットが開きます。Codex は選択した差分を読む専用のレビュアーを起動し、作業ツリーを変更せずに、優先度付きで対応可能な指摘を返します。
• IDE 拡張機能: composer に /review と入力し、Review against a base branch または Review uncommitted changes を選びます。/review コマンドは、開いているプロジェクトが Git リポジトリ内にある場合だけ表示されます。

CLI で選べるレビューの範囲は次の 4 つです。

• Review against a base branch: マージベースを見つけ、ブランチの差分をレビューします。
• Review uncommitted changes: ステージ済み・未ステージ・未追跡のファイルを含めます。
• Review a commit: 選んだコミットの変更セットをレビューします。
• Custom review instructions: 指定した基準にレビューを絞ります。

アプリではレビューは既定で現在のチャットで実行されます。Settings (設定) > General (一般) > Code review (コードレビュー) で Detached (分離) を選ぶと、別のレビュー用チャットが始まります。CLI では config.toml に review_model を設定すると、現在のセッションとは別のモデルでレビューできます。IDE 拡張機能では chatgpt.reviewDelivery を detached にすると、/review が別のレビュー用チャットを始めます。

アプリのレビューペインは、Codex が編集した内容だけでなく、Git リポジトリの状態を反映します。Codex による変更、自分で加えた変更、その他の未コミットの変更が含まれます。

• 既定では Unstaged (未ステージ) の変更を表示します。Staged (Git のインデックス)、Commit (選んだコミット)、Branch (ベースブランチとの差分)、Last turn (直近のアシスタントのターン) にも切り替えられます。
• ローカルのプロジェクトが別々の Git リポジトリに属する複数のフォルダを含む場合、各リポジトリの変更を表示できます。複数フォルダのプロジェクトで Review を選ぶと、個別のレビュー画面を切り替えずに複数リポジトリにまたがる差分を確認できます。
• レビューの指摘は、レビューペインにインラインのコメントとして表示されます。
• 自分でインラインのコメントを残すには、レビューペインを開き、コメントしたい行にカーソルを合わせ、表示される + ボタンを選んでフィードバックを書いて送信します。書き終えたら、チャットにメッセージを送り返します。

• アプリの個人用の受信箱で、リポジトリをまたいで GitHub のプルリクエストを探せます。Assigned to me (自分に依頼されたもの)、Assigned to my team (チームへの依頼)、Authored by me (自分の作成したもの) で絞り込めます。
• ChatGPT Codex connector、必要なリポジトリの権限、自動レビューの有効化がそろっていれば、Codex は GitHub のプルリクエストを開く前にレビューでき、コメントは GitHub と Code Review の両方に表示されます。このクラウドレビューでは、クラウド環境の作成や管理は不要です。
• アプリで Review with Codex を選ぶと、新しいチャットでレビューが始まります。指摘を選ぶと、その説明と Changes 内の該当行を確認できます。
• Review with Codex の横にある Review instructions (レビュー指示) の歯車、または Settings > Code Review でレビュー指示を編集できます。Comic book・Visualization・PDF を選ぶと、その形式で変更を説明するための指示の候補を追加でき、編集後に Save または Run review を選びます。指示は Review with Codex で始めるレビューにリポジトリをまたいで適用され、実行中のレビューの途中で変えた内容は次のレビューから適用されます。
• Codex で開いているプルリクエストの Checks で Fix を選ぶと、失敗しているチェックがチャットに添付され、送信前のメッセージが用意されます。

• チャットでのプルリクエストのレビューは、コメントの投稿・承認・マージを行いません。どの指摘を共有するかは利用者が選びます。
• 見つかった修正を Codex に適用させる場合は、通常のサンドボックスと承認の設定が適用されます。
• 新しい --approve-for-me CLI フラグで、自動レビューされた承認を有効にできます。
• Guardian レビューには、ポリシー上の承認理由が含まれます。MCP のエリシテーション (elicitation) に対しては厳格な自動レビューが行われます。
• サイバー能力を持つモデルには、より安全な自動レビューの既定値が適用され、権限の変更はターミナル画面で説明されます。
• Auto-review 専用のドキュメントページがあり、レビュアーのライフサイクル、発動条件、失敗時の挙動、ローカルまたは管理された設定を扱っています。

対象プランについては、公式のリリースノートには記載がありません。

ここでは、アプリでプルリクエストを表示する流れを示します。

1. サイドバーから Code Review を開きます。
2. 求められたら、レビューしたいリポジトリにアクセスできるアカウントでソースのアカウントを接続します。
3. サイドバーでプルリクエストを選ぶか、検索欄にプルリクエストのリンクを入力します。
4. Summary (概要) で説明・アクティビティ・コメント・チェックを確認し、Changes (変更) を開いて差分と並べて変更ファイルとコメントを確認します。