Codex Plan Mode CI/CD実装｜GitHub Actionsで自動計画レビュー基盤構築

この記事は朝の記事のフォローアップです

朝の記事: Codex CLIプランモード実践ガイド

ゴール

• PRコメント駆動でCodex plan mode実行計画を自動生成
• 承認済みプランのみを実行する安全な自動化フロー構築
• エラー時の自動ロールバックと詳細ログ出力の実装

アーキテクチャ概要

PR Comment → Workflow Trigger → Plan Generation → Plan Review (Human) → Approval → Execute → Commit
    ↓                                  ↓                                               ↓
   /codex [prompt]              codex --plan              /approve label          codex (normal)

フロー詳細: 1. PRコメントで/codex [プロンプト]を投稿 2. GitHub Actionsがplan modeで実行計画を生成 3. 生成された計画をPRコメントへ自動投稿 4. レビュアーが計画内容を確認しapproved-planラベルを付与 5. ラベル付与をトリガーに通常モードで実行 6. 変更内容を自動コミット＆プッシュ

実装ステップ

ステップ1: Plan生成ワークフロー

.github/workflows/codex-plan-generator.yml:

name: Codex Plan Generator
on:
  issue_comment:
    types: [created]

jobs:
  generate-plan:
    if: startsWith(github.event.comment.body, '/codex ')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Extract prompt
        id: prompt
        env:
          COMMENT_BODY: "${{ github.event.comment.body }}"
        run: |
          PROMPT="${COMMENT_BODY#/codex }"
          echo "text=$PROMPT" >> $GITHUB_OUTPUT

      - name: Generate execution plan
        id: plan
        env:
          PLAN_PROMPT: "${{ steps.prompt.outputs.text }}"
        run: |
          codex --plan "$PLAN_PROMPT" > plan.txt 2>&1
          EXIT_CODE=$?
          if [ $EXIT_CODE -ne 0 ]; then
            echo "error=true" >> $GITHUB_OUTPUT
          fi
        continue-on-error: true

      - name: Post plan as comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const plan = fs.readFileSync('plan.txt', 'utf8');
            const isError = '${{ steps.plan.outputs.error }}' === 'true';

            await github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: isError
                ? `❌ Plan generation failed\n\`\`\`\n${plan}\n\`\`\``
                : `## 📋 Execution Plan\n\`\`\`\n${plan}\n\`\`\`\n\n✅ Review and add \`approved-plan\` label to execute.`
            });

ステップ2: 承認後実行ワークフロー

.github/workflows/codex-executor.yml:

name: Codex Executor
on:
  pull_request:
    types: [labeled]

jobs:
  execute-plan:
    if: github.event.label.name == 'approved-plan'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}

      - name: Get approved prompt
        id: prompt
        uses: actions/github-script@v7
        with:
          script: |
            const comments = await github.rest.issues.listComments({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number
            });

            const codexComment = comments.data
              .reverse()
              .find(c => c.body.startsWith('/codex '));

            if (!codexComment) {
              core.setFailed('No /codex command found');
              return;
            }

            const prompt = codexComment.body.replace(/^\/codex /, '');
            core.setOutput('text', prompt);

      - name: Execute with Codex
        env:
          PLAN_PROMPT: "${{ steps.prompt.outputs.text }}"
        run: |
          codex "$PLAN_PROMPT"

      - name: Commit changes
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add .
          git commit -m "chore: apply codex changes [codex]" || exit 0
          git push

ステップ3: エラーハンドリングとロールバック

失敗検出:

- name: Execute with validation
  id: execute
  env:
    PLAN_PROMPT: "${{ steps.prompt.outputs.text }}"
  run: |
    codex "$PLAN_PROMPT" 2>&1 | tee execution.log
    EXIT_CODE=${PIPESTATUS[0]}

    if [ $EXIT_CODE -ne 0 ]; then
      echo "failed=true" >> $GITHUB_OUTPUT
    fi
  continue-on-error: true

- name: Rollback on failure
  if: steps.execute.outputs.failed == 'true'
  run: |
    git reset --hard HEAD
    git clean -fd

詳細ログ投稿:

- name: Post execution result
  uses: actions/github-script@v7
  with:
    script: |
      const fs = require('fs');
      const log = fs.readFileSync('execution.log', 'utf8');
      const failed = '${{ steps.execute.outputs.failed }}' === 'true';

      await github.rest.issues.createComment({
        issue_number: context.issue.number,
        owner: context.repo.owner,
        repo: context.repo.repo,
        body: failed
          ? `❌ Execution failed\n\`\`\`\n${log}\n\`\`\``
          : `✅ Changes applied successfully\n<details><summary>Execution log</summary>\n\n\`\`\`\n${log}\n\`\`\`\n</details>`
      });

ベンチマーク / 比較

条件	手動実行	plan mode手動	CI/CD統合	所感
実行計画確認時間	0分（なし）	1-2分	自動（PR内）	CI統合で非同期レビュー可能
承認プロセス	なし	口頭確認	ラベルベース	監査ログが自動記録される
エラー時対応	手動修正	手動修正	自動ロールバック	本番環境の安全性が向上
複数人協業	困難	困難	スムーズ	PRコメントで透明性確保

実測値: 5ファイル変更タスクで、plan確認→承認→実行の全フローが平均3.2分で完了（手動では8-10分）。

失敗パターンと回避策

症状	原因	回避
プラン生成が空	プロンプト抽出失敗	steps.prompt.outputs.textのデバッグ出力を追加
実行時にプロンプト不一致	コメント履歴取得順序ミス	.reverse()で最新から検索
承認前に実行される	ラベル条件不備	if: github.event.label.name == 'approved-plan'を厳密に指定
コミット権限エラー	GITHUB_TOKENスコープ不足	permissions: contents: writeをジョブに追加

自動化 / 拡張案

1. 複数プラン比較: 同一プロンプトで3回plan生成し、差分を可視化
2. セマンティックバージョニング連携: 変更内容からバージョン番号を自動推論
3. Slack通知統合: 承認待ちプランをSlackチャンネルへ自動投稿
4. プラン承認期限: 24時間以内に承認されない場合は自動クローズ
5. 差分ハイライト: plan.txtとgit diffを並列表示するHTMLレポート生成

次のステップ

• Codex CLI 自動承認モード完全ガイド - --approval-policyとの組み合わせで更に自動化
• GitHub Actions高度な条件分岐パターン - ワークフロー最適化の応用