codex-review

このスキルは外部レビュアーをオーケストレーションするため、規律を守る必要があります。

譲れないルール：

1. Codex への指示を書く前に、実際の差分を読みます。
2. 変更箇所と、想定されるリスクに合わせて具体的な指示を作成します。
3. レビュー指示にシークレットや認証情報の値を決して含めません。
4. 以降のラウンドでも除外リストを引き継ぎます。
5. 返された指摘事項は、対応する前に検証します。

Codex レビュー

入力

• $request：last commit、uncommitted、auth focus、round 2 など、任意のスコープヒント

目標

codex review を使って外部レビューを実施し、以下を実現します。

• 適切な差分スコープを読み取る
• 変更セット内の実際のリスク領域に焦点を当てる
• 一般的なコメントではなく、構造化された指摘事項を返す

ステップ 0：Codex が利用可能か確認する

以下を確認します。

• which codex
• 現在のセットアップに必要な最小限の認証または環境の確認

CLI を利用できない、または認証されていない場合は、問題を説明して停止します。

成功基準：現在のリポジトリから Codex を正常に呼び出せます。

ステップ 1：レビューのスコープを決定する

以下のどれをレビューするか決定します。

• ベースとの差分を含むブランチ全体
• 未コミットの変更
• 特定のコミット

指示を作成する前に、実際の差分の概要と変更ファイル一覧を確認します。

差分がない場合は、停止してその旨を明確に伝えます。

成功基準：実際の差分に基づいて、レビュー対象が明確になっています。

ステップ 2：焦点を絞ったレビュー指示を書く

以下を含む短い一時的な指示ファイルを作成します。

• 変更内容
• 最も関連性の高いリスク領域
• 以降のラウンドで除外する、以前に修正済みの問題
• 実際のコードに照らして指摘事項を検証する指示
• 簡潔な出力形式

具体的な指示にします。一般的なプロンプトでは、質の低いレビューになります。

成功基準：指示ファイルが実際の変更セットに即したものになっています。

ステップ 3：codex review を実行する

選択したスコープに合った呼び出し形式を使用します。

• ブランチレビューには --base <branch>
• 作業ツリーのレビューには --uncommitted
• 単一コミットのレビューには --commit <sha>

主なフラグ：

• sandbox_permissions — 指摘事項の検証に Codex がディスク読み取りアクセスを必要とします： -c 'sandbox_permissions=["disk-full-read-access","disk-full-write-access","network-full-access"]'
• instructions — ステップ 2 で作成した、焦点を絞った指示ファイルを指定します： -c 'instructions="/tmp/codex-review-instructions.md"'
• --title "<description>" — 説明的なレビュータイトル

必ず 2>&1 で標準エラー出力を取得します（Codex は標準エラー出力にログを出します）。

レビューに時間がかかる見込みの場合は、バックグラウンドでの実行も可能です。

成功基準：Codex が意図したスコープをレビューし、解析可能な出力を返します。

ステップ 4：指摘事項をまとめる

以下を報告します。

• レビューのスコープ
• 優先度別の指摘事項
• 入手できる場合はファイルと行番号の参照
• 重要な指摘事項がなかった場合は、その旨を明確に示す

ユーザーが修正を希望する場合は、コードを変更する前に各指摘事項をローカルで検証します。

成功基準：生の CLI 出力ではなく、明確にスコープを定めたレビューの要約をユーザーに提示します。

ステップ 5：除外事項を引き継いで反復する

以降のラウンドでは、次のようにします。

• 修正済みの指摘事項を除外セクションに追加する
• 可能であれば、新しい変更にスコープを絞る
• 一般的なブランチ全体のレビューを繰り返してコストをかけるのを避ける

成功基準：フォローアップラウンドでは、過去の問題を再報告するのではなく、新しい問題を探します。

ガードレール

• このスキルを自発的に実行しないでください。ユーザーが明示的に求めた場合にのみ実行します。
• 指示ファイルにシークレット、トークン、非公開の設定値を含めないでください。
• ローカルで検証せずに、指摘事項を鵜呑みにしないでください。
• 差分を先に読むことの代わりとして Codex レビューを使わないでください。

出力の契約

以下を報告します。

1. レビューのスコープ
2. Codex に指示した主な重点領域
3. 優先度別の指摘事項と、入手できる場合はその場所
4. 重要な問題が見つからなかった場合は、その旨を明確に示す
5. 次のラウンドで以前に修正した問題を除外する必要があるか