コンテンツにスキップ

Codex Web多機能並列開発ワークフロー — 個人開発でもPRを量産する全体像

Codex CLI 完全ガイド

Codex Web並列開発を前提にしたワークフローを先に設計しておくと、1人でも毎日複数PRを安全に流せます。この記事は「ブランチ設計 → Codex Webタスク → 自動レビュー → マージ」の一連を俯瞰し、Codex Web並列開発をどのように回せば良いかを整理します。

この記事の対象者

  • 読者: Codex CLI/Webを日常的に触り、速度最優先で個人開発を進めたい中級者。
  • ゴール: 3本以上のフィーチャーブランチを同時に走らせつつ、Codex Webに実装とセルフレビューを委譲できるようになること。
  • 成果: (1) ブランチ設計テンプレを入手 (2) Codex Webタスク分解の指針を理解 (3) GitHub自動レビューとの連携コツを把握。

用語と表記ルール

  • Codex Web: chatgpt.com/codex から起動するクラウド実行環境。タスクごとに独立したコンテナが割り当てられる。
  • Codex CLI: codex コマンドを指し、--profile などのオプションは DEVガイド に準拠。
  • Codexタスク: Codex WebまたはCLIから指示した単一の実行単位で、基本的に1ブランチ＝1タスクで扱う。

ワークフロー全体像

flowchart TD
    A[Backlog / TodoWrite] -->|feature/login| B[Codex Web Task 1]
    A -->|feature/dashboard| C[Codex Web Task 2]
    A -->|feature/api| D[Codex Web Task 3]
    B --> E[Draft PR #101]
    C --> F[Draft PR #102]
    D --> G[Draft PR #103]
    E & F & G --> H[Codex GitHub App Auto Review]
    H --> I[Human final check]
    I --> J[Merge & Release Notes]

この図で押さえるポイント

① ブランチとタスクは1対1
役割が重なると差分が肥大化し、コンフリクトが増えます。

② Codex Webはタスクごとに独立コンテナ
ブラウザを閉じても裏側で作業が継続します。

③ GitHub連携で自動レビューが走る
人間は最終意思決定だけに集中できます。

ステップ1: ブランチ設計と依存の棚卸し

  1. TodoWriteやIssueで機能を3〜5個に分割し、優先度順に並べる。
  2. 依存関係を見て「同じファイルに触る可能性が高いもの」を同グループへまとめ、同時実行数を調整。
  3. 各ブランチに「完成条件（Definition of Done）」を短く添える。Codexに指示するとき、そのまま貼り付けられる形にしておく。

推奨フォーマット

feature/login-form
  - 完成条件: UI + Supabase認証、テスト: `npm run test:auth`
feature/atlas-sync
  - 完成条件: MCPからのWebhook同期、テスト: `pytest sync`

ステップ2: Codex Webタスクを並列に走らせる

2-1 クラウドタスクの起動

  • chatgpt.com/codex でGitHubリポジトリを連携し、"Start cloud task" から対象ブランチを選択。
  • プロンプト冒頭で「ブランチ名」「完成条件」「必要なツールや環境変数」「触れてよいディレクトリ」をまとめて渡す。
  • タスクごとに独立コンテナが割り当てられ、完了時はドラフトPRとサマリコメントがGitHubに投稿されます。

Codexへの指示テンプレート

Context: feature/login-form (branch already pushed)
Goal: Implement Supabase auth + UI polish, run npm run test:auth
Deliverable: Draft PR with summary + checklist
Scope: docs/generative-ai/chatgpt/**

2-2 ローカル作業との並走

  • 端末で即応したい場合は codex --profile dev "<prompt>" を使い、同じブランチ上で小さな修正を適用します（0.50系CLIで提供、上記DEV記事参照）。
  • クラウドとローカルが混在する際は git pull --rebase origin feature/<name> で最新差分を取り込み、Codexタスクを再開する前に整合を取ります。

Codex CLIのコマンド例について

--profile オプションや codex --profile quick などの切り替え機能は Codex CLI v0.50.0+ でサポートされています。利用環境が古い場合は codex --help で対応バージョンを確認してください。

ステップ3: 自動レビューと人力の連携

  • GitHubにCodexアプリをインストールし、リポジトリ単位で「PR作成時に自動レビュー」を有効化すると、ドラフトPRにもコメントが付きます。
  • PRテンプレートに「チェック済みテスト」「残課題」「Codexレビュー再実行トリガー」欄を置くと、1人でも進捗が把握しやすくなります。
Codex Web自動レビューで確認される主な項目
  • Lint/テスト結果: タスクで実行したログを基に、再現手順と失敗ポイントがコメントされる。
  • セキュリティ/危険コマンド: rm -rf / のような高リスク操作が差分に含まれる場合、赤字で警告。
  • 依存ファイルの不整合: package-lock.json などが未更新のとき、自動で追加修正PRを提案。
  • 人間の確認では「ストーリー通りか」「命名やログの一貫性はあるか」のみを見て、必要なら @codex rerun review コメントで再チェックを依頼します。

ステップ4: マージと振り返りルーチン

  1. gh pr checkout で手元に差分を取り込み、軽い動作確認を実行。
  2. Merge前後でCodex Webの「Summarize PR」アクション（もしくはCLI 0.53.0+ の codex summarize --pr <ID>）を呼び、TodoWriteログやCHANGELOGに転記します。
  3. 1日単位で「どのタスク組み合わせが衝突したか」をメモし、次スプリントの分割ルールに反映します。

よくある落とし穴と回避策

PRコンフリクトが頻発する場合

  • 同じ設定ファイルを複数ブランチが触っていないか？→ .env.example や mkdocs.yml を専用タスクにまとめる。
  • Codexタスクに「対象ディレクトリ」を明記しているか？→ Scope: docs/generative-ai/... only のように指示を限定。
  • ブランチ開始前に最新mainへ追従しているか？→ git pull --rebase origin main などで差分を解消してからCodexを走らせる。
  • 自動レビューだけに頼ると、ユーザー体験の確認や文言チェックが漏れがち。リリース前のミニデモ（画面録画30秒）を自分宛に送り、ユーザー目線で1回見ると安心です。
  • CLAやセキュリティチェックを入れている場合、Codexの自動コミットが署名ルールに従っているか確認してください。

次に深掘りしたいテーマ

  • 多重PR間でのコンフリクトを抑えるgit rerereテンプレ。
  • Codex WebのタスクテンプレをJSON化し、TodoWriteと同期する方法。
  • Claude Code / Codex Webの役割分担による効率比較。

関連コンテンツ

参考リンク