メインコンテンツへスキップ
見出し画像

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` として配置します。

     
     
    経歴:宇宙学→機械学習→生成AI(現在)→起業(未来) 実績:Signateグランドマスター / 総合7位。 「再現性ある成果を出し続けるエンジニア」になるための 実践知を発信しています。 特に生成AIツールの活用・AI実装を発信しています。

    あなたへのおすすめ