
GitHub ActionsでCodexにPRレビューさせる設定と運用。レビュー待ち4日を短くしたワークフロー
はじめに: PRレビューの「待ち時間」がボトルネックだった
コードレビューが詰まる。エンジニアチームなら一度は経験している問題です。
私のチームは4人で1つのリポジトリを共同開発していました。PRを出してからレビューが来るまで平均1〜3日。全員が自分の開発タスクを抱えながら他のPRをレビューするため、どうしても後回しになります。レビュアーがいないのではなく、レビューに使える「まとまった時間」がない——それが実態でした。
ある週、私はフィーチャーブランチを5日間開発し、PRを出しました。マージまでさらに4日。待機中に別のPRがマージされ、コンフリクト解消で半日潰れる。この体験をきっかけに動きました。
試したのがGitHub ActionsへのCodex組み込みです。「AIが一次スクリーニングし、人間が最終判断する」体制に切り替えた結果、PR作成から人間のレビュー着手までの時間が目に見えて短縮しました。
この記事では、実際に構築したCIパイプラインのYAML全文・プロンプト設計のポイント・2ヶ月の運用でわかった失敗談・コスト試算を共有します。GitHub Actionsで自動コードレビューを組みたい方は、codex-review.ymlの全文から順に読めます。
全体アーキテクチャ: 3ステップのフロー
システム全体の構成は以下のとおりです。
PR作成・更新
↓
GitHub Actions 起動(pull_requestイベント)
↓
openai/codex-action@v1 が差分を取得
↓
Codex API(GPT-5.6 Terra)にプロンプト送信
↓
レビューコメントをPRに自動投稿追加のサーバーもデプロイも不要。GitHubのCI環境だけで完結します。
使用コンポーネントは3つです。
openai/codex-action@v1: OpenAI公式のGitHub Action。CodexをCI環境から呼び出す
GPT-5.6 Terra: コードレビュー用途のバランス型モデル。Solより速く、コストも半分以下
GitHub Token: PRへのコメント投稿に必要な書き込み権限
GitHub Actionsワークフロー定義(YAML全文)
`.github/workflows/codex-review.yml` として配置します。