CodexのGitHub連携によるコードレビュー機能
Codexは、GitHubのプルリクエストに直接組み込む形でコードレビューを実行できる。
開発者はGitHubを離れることなく、AIによるレビューを通常のチームメンバーによるレビューと同じワークフローで受け取ることができる。
この機能はCodex cloudの設定を前提とし、リポジトリ単位で有効化する。
利用クレジット
ChatGPTのサブスクリプションを契約していると,Codexとは独立に「コードレビュー」の利用量が付与される
(issueで @codex を用いて指示した場合は、通常のCodex呼び出し利用量から消費される)
Cf. Claude Code・Codexのusage(利用残量確認ページ)
レビューの起動方法
1. 手動トリガー
PRのコメント欄に @codex review と記述することでCodexが反応し、GitHubの標準的なコードレビュー形式で指摘を投稿する。
2. 自動レビュー
Codex設定の「Automatic reviews」を有効にすると、新しいPRが作成されるたびに自動でレビューが実行される。
Cf. Codexの自動レビューの設定方法
指摘の優先度とデフォルト動作
Codexはデフォルトでは重大度の高いP0・P1の問題のみを指摘する。
ドキュメントの誤字や軽微なスタイル上の問題は、設定を変更しない限り報告されない。
この動作はレビューノイズを抑える設計上の選択であり、報告範囲を広げたい場合は後述のガイドラインで調整する。
レビュー基準のカスタマイズ
レビュー内容はリポジトリ内の AGENTS.md ファイルで制御できる。ルートに配置したファイルがリポジトリ全体に適用され、ディレクトリ階層の深い場所に別のファイルを置くと、そのパッケージ固有のルールが優先される。
code:簡単な例 (markdown)
## Review guidelines
- PIIをログに記録しない。
- 認証ミドルウェアがすべてのルートをラップしていることを確認する。
実運用の例:my-web-page/AGENTS.md at main · tomiokario/my-web-page
一時的な指示はコメントに直接添えることもできる。
code:_
@codex review for セキュリティ上のリグレッション
レビュー以外のタスク実行
@codex へのメンションは、コードレビュー以外の用途にも使える。review 以外の文言でメンションすると、PRの内容を文脈としたクラウドタスクとして実行される。CI失敗の修正やリファクタリングなど、自律的な作業の依頼が可能であり、レビューワークフローの延長線上にエージェント的な操作を組み込める点がこの連携の特徴となっている。
code:_
@codex CIの失敗を修正して