株式会社オブライト
AI2026-04-07

OpenAI Codex実践ワークフロー — タスク委任からGitHub PRマージまでの完全図解ガイド【2026年版】

OpenAI Codexでタスクを委任してGitHub PRをマージするまでの全ステップを図解します。並列タスク実行、効果的なプロンプトの書き方、GitHub Actions連携、MCP外部ツール接続、チーム運用のベストプラクティスまで網羅した実践ガイドです。


Codexワークフロー全体図 — 8ステップで完結

Codexを使ったタスク委任からPRマージまでのフロー全体を把握することが、効率化の第一歩です。 ⑥のレビュー時に「この部分を修正して」と追加指示を出すと、Codexが再度サンドボックスを起動して差分を更新します。何度でも往復できるのがエージェント型の強みです。

Loading diagram...

並列タスク実行 — 複数タスクを同時に処理する仕組み

Codexは複数のタスクを独立したサンドボックスで同時実行できます。 それぞれのサンドボックスは完全に独立しており、互いに干渉しません。Proプランでは10以上のタスクを同時実行できるため、スプリント中に複数のissueを一括処理するような使い方が可能です。タスクが完了すると通知が届くため、待機時間ゼロで別作業を進められます。

Loading diagram...

効果的なプロンプトの書き方 — 良い例・悪い例

Codexへの指示の質が、成果物の品質を直接左右します。

観点悪い例良い例
具体性「バグを直して」「`src/api/auth.ts`の`validateToken`でnullを渡すとクラッシュする。nullの場合はfalseを返すように修正して」
検証条件指定なし「既存の`tests/auth.test.ts`が全て通ることを確認して」
スコープ「コードを改善して」「`utils/`ディレクトリ内のファイルのみリファクタリング。他のファイルは変更しないで」
前提情報「エラーが出る」「Node 20、TypeScript 5.4環境。`npm test`でTypeErrorが発生する」

黄金ルール: 「誰が・どこで・何が起きているか・どう直すべきか・どう検証するか」の5点を1〜3文で書くと最も安定した結果が得られます。

タスク種別と所要時間の目安

タスクの種類によって所要時間と難易度が異なります。適切なモデルを選ぶことでコストと速度を最適化できます。

タスク種別所要時間難易度推奨モデル
バグ修正2〜5分GPT-5.3-Codex
テスト追加5〜10分GPT-5.3-Codex
コードレビュー1〜3分GPT-5.3-Codex-Spark
ドキュメント生成3〜8分GPT-5.3-Codex
リファクタリング10〜20分GPT-5.4
新機能実装15〜30分GPT-5.4
大規模解析・移行20〜60分GPT-5.4

高速タスク(コードレビュー等)にはCerebrasチップ搭載のGPT-5.3-Codex-Sparkが有効です。

GitHub PR連携とGitHub Actions統合

PR作成の流れ

[Codexがタスク完了]
        ↓
[新規ブランチ作成: codex/fix-auth-null-check]
        ↓
[変更内容をコミット(意味のあるメッセージ付き)]
        ↓
[GitHubへpush → PR open(タイトル・説明・テスト結果を自動生成)]
        ↓
[ユーザーがPRをレビュー → 追加修正 or Approve & Merge]

GitHub Actionsとの連携例(issueラベルでCodexを自動起動)

yaml
# .github/workflows/codex-auto-fix.yml
on:
  issues:
    types: [labeled]
jobs:
  codex-fix:
    if: contains(github.event.label.name, 'codex-auto')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx @openai/codex-cli fix "${{ github.event.issue.body }}"
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

活用例: issueに`codex-auto`ラベルを付けるとCodexが自動でPRを作成。PRに`codex-review`ラベルを付けるとCodexがコードレビューコメントを投稿します。

MCP連携 — Figma・Linear・Jira等の外部ツールと接続する

Model Context Protocol(MCP)を使うと、Codexが外部ツールのデータを参照しながらタスクを実行できます。

[Codex]
  ├─→ [Figma MCP]  → デザインデータ・コンポーネント仕様を取得
  ├─→ [Linear MCP] → issueの詳細・優先度・担当者を参照
  ├─→ [Jira MCP]   → チケット内容・受け入れ条件を読み込み
  └─→ [Slack MCP]  → チャンネルのスレッドからコンテキストを取得

具体的なワークフロー例: - LinearのissueをCodexに渡すと、要件を読み取ってコードを実装 - Figmaのデザインカンプを参照してReactコンポーネントを生成 - Jiraのバグチケットを渡すと再現手順を解析して自動修正 MCPサーバーは自社ツール向けにカスタム実装することも可能で、社内Wikiやドキュメントをコンテキストとして与えることができます。

コードレビュー機能とチーム運用のベストプラクティス

Codex Security(自動セキュリティスキャン)

機能内容
自動PRレビューバグ・ロジックエラーをPRコメントで指摘
Codex SecuritySQLインジェクション・XSS・認証欠落等を検出
依存関係スキャン既知のCVEを持つパッケージを警告
シークレット検出APIキー・パスワードのハードコードを検出

チーム運用の分担指針

[人間が担当]
  ・要件定義・設計・アーキテクチャ判断
  ・最終レビュー・マージ承認

[Codexに委任]
  ・バグ修正・テスト追加・ドキュメント生成
  ・リファクタリング・定型的な機能実装

品質管理のルール: Codexが生成したPRは必ず人間がレビューしてからマージする。`AGENTS.md`をリポジトリルートに置き、Codexへの指示・禁止事項を明記する。

よくある質問(FAQ)

Q1. タスクが途中で止まった場合はどうすればよいですか? Codexパネルからタスクを「再試行」できます。エラーログが表示されるため、プロンプトを修正して再投入することで多くのケースは解決します。 Q2. 並列タスクでコンフリクトが発生しますか? 各サンドボックスは独立したクローンで動作するため並列タスク自体でコンフリクトは発生しません。ただし複数PRを同じファイルに対して作成した場合、マージ時に通常のgitコンフリクトが生じる可能性があります。 Q3. AGENTS.mdにはどんな内容を書けばよいですか? リポジトリの構成説明、使用禁止ライブラリ、コーディング規約、テスト実行コマンド、絶対に変更してはいけないファイル等を記載します。Codexはタスク開始時にAGENTS.mdを自動で読み込みます。 Q4. Codexが生成したコードの著作権はどうなりますか? OpenAIの利用規約上、Codexが生成したコードの著作権はユーザーに帰属します。企業利用の場合は法務部門と確認することを推奨します。 Q5. GitHub以外のGitホスティングサービスには対応していますか? 2026年4月時点ではGitHubが主なインテグレーション対象です。GitLabやBitbucketへの対応は一部CLI経由で可能ですが、公式UIからの直接連携はGitHubのみです。 Q6. Codexに機密情報を含むコードを渡しても大丈夫ですか? OpenAIのEnterprise契約ではデータが学習に使用されないことが保証されています。機密コードを扱う場合はEnterpriseプランを利用し、APIキーやシークレットはリポジトリから除外してください。

Codexワークフロー設計はOflightにご相談ください

「Codexをチームに導入したいが社内承認プロセスが分からない」「GitHub Actionsとの連携を設計してほしい」「MCP経由でJiraやFigmaと接続する実装を依頼したい」といったご要望は、OflightのAIコンサルティングサービスへお気軽にどうぞ。 Oflightでは要件ヒアリングから設計・実装・チームトレーニングまで一貫して支援します。まずは無料相談から始めましょう。 → AIコンサルティングサービスの詳細を見る

お気軽にご相談ください

お問い合わせ