Codex operation management

Codexで複数作業を並行する時の管理

Codexで複数作業を並行する時に、作業を分け、報告書を管理し、混線を避けるための考え方を整理します。

このページは公式ページではなく、実務ガイドです。Codexの報告は人間が確認し、重要な判断は人間が行ってください。
operation.md
tasks:
  - status
  - report
  - next_order
verify:
  - human_check

このページで分かること

Codexで複数作業を並行する時に、作業を分け、報告書を管理し、混線を避けるための考え方を整理します。

使う場面

複数スレッド、複数ページ、複数サイトの作業が同時に動き始めた時に使います。

管理の考え方

複数作業を並行させる時に起きる事故は、ほぼすべて「作業同士の境界が溶ける」ことから始まります。Aの作業のつもりでBのファイルを触る、どの作業の変更か分からない差分が残る──境界を保つ仕組みを先に作るのが、並行作業の前提条件です。

原則具体的には守らないと起きること
1作業1目的で分ける「リンク修正と本文追記」は2作業に分割する1つの差分に複数の意図が混ざり、部分的に戻せなくなる
作業名を固定する依頼・報告書・バックアップ名で同じ作業名を使い続ける後から「どの作業の変更か」を突き合わせられない
完了・保留・停止を分ける作業ごとに状態を記録する(状態管理の基本参照)やりかけ作業が「終わったつもり」に紛れ込む
報告書を作業ごとに保存する複数作業をまとめた1本の報告にしない特定の作業だけ見直したい時に、全部読み直すはめになる
次作業を1つずつ決める同時に指示するのは1作業。終わってから次を出す同じファイルを複数作業が触って差分が衝突する

並行数の上限も決めておくと安全です。目安は「自分が確認しきれる本数」で、多くの場合2〜3本です。それ以上は並行ではなく「順番待ちリスト」に載せる方が、総合的には速く回ります。

よくある失敗

  • 別作業の報告書を混ぜる
  • 完了前に次の修正を重ねる
  • 同じファイルを複数作業で同時に触る
  • 保留理由を残さない

Codexに頼む時の指示例

複数のCodex作業を管理するため、作業名、目的、対象ページ、変更ファイル、状態、停止条件、次作業を一覧化してください。混線しそうな作業は分けて報告してください。

確認チェックリスト

  • 作業名がある
  • 目的が1つに絞られている
  • 状態が分かる
  • 変更ファイルが分かる
  • 次作業が分かる

停止条件

  • 同じ対象を複数作業で同時に触りそう
  • 報告書が混ざっている
  • 完了確認前に次作業へ進みそう

並行してよい作業と、してはいけない作業

複数作業を同時に進める時の判断基準は、作業数ではなく触るファイルが重なるかどうかです。重ならなければ何本でも並行できますが、重なる作業は必ず順番に進めます。

組み合わせ判断理由
別ページの本文修正×2本並行OK触るファイルが完全に別。互いに影響しない
ページ追加+sitemap更新順番にsitemapを両方が書き換えると、片方の追記が消える
本文修正+共通CSSの変更順番に表示崩れが起きた時、どちらが原因か切り分けられない
調査だけの作業+修正作業並行OK調査はファイルを変更しないため衝突しない

特に見落としやすいのが、sitemap.xmlのようなサイト全体で1つしかないファイルです。複数の作業がそれぞれ「自分の分を追記」すると、後から書いた方が前の内容を消してしまいます。共通ファイルを触る作業は、必ず1本ずつ完了させてから次へ進んでください。

作業ごとの変更をプルリクエストで見分ける

2026年11月18日時点の公式ヘルプでは、プルリクエストは、あるブランチのコード変更を別のブランチへ取り込むための提案です。変更内容をプロジェクトへ含める前に、共同作業者が議論し、行単位でレビューする場所として説明されています。ブランチやフォークの変更を提案し、テスト、ビルド、コードスキャンなどの自動チェックを変更に対して実行する流れも挙げられています。

画面ごとの役割も分かれています。Conversationには説明、コメント、レビュー、活動の履歴、Commitsにはブランチの変更履歴、Checksには自動テストやビルドなどの検証結果、Files changedにはコメント対象となる差分がまとまります。取り込み欄では、必要なレビューやチェックなど、取り込み前に残る条件を確認できます。複数作業の報告を読む場合、説明文だけでなく変更ファイルと検証結果を別々にたどれる構成です。

出典:GitHub『About pull requests』(2026年11月18日確認)https://docs.github.com/en/pull-requests/get-started/about-pull-requests

競合がある場合に取り込みが止まる仕組み

2026年11月18日時点の公式ヘルプでは、Gitは異なる行や異なるファイルの変更を自動で統合できる場合がある一方、同じファイルの同じ行を別々に編集した場合や、一方が編集し他方が削除した場合に競合が起こりやすいと説明されています。競合は、残すべき内容をGitが安全に選べない状態です。

比較元と取り込み先のブランチ間に競合があると、GitHubのMerge pull requestボタンは無効になります。統合前にはすべての競合の解消が必要です。解消とは、統合後に残す内容を選ぶ作業を指し、単純な行の競合はGitHub上、複雑なものはローカルの複製で直し、作業ブランチへ反映する方法が示されています。コマンドラインでも、自動統合できない場合にはGitから通知され、競合の解消とその記録が必要になります。

出典:GitHub『Merge conflicts』(2026年11月18日確認)https://docs.github.com/en/pull-requests/reference/merge-conflicts

Issueとの関連付けで進行中と完了を追う

2026年11月18日時点の公式ヘルプでは、Issueとプルリクエストは手動、または説明文の対応キーワードで関連付けられます。関連があると、共同作業者はそのIssueへの対応が進んでいることを把握できます。関連するプルリクエストを既定のブランチへ取り込むと、対応するIssueが自動で閉じる仕組みです。

説明文の特別なキーワードは、取り込み先が既定のブランチである場合だけ解釈されます。別のブランチ向けでは無視され、キーワードによる関連付けも、取り込みによるIssueの終了も起こりません。同じリポジトリならCloses #10、別のリポジトリならFixes owner/repository#100のように対象を指定する構文が示されています。複数のIssueを指定する場合は、それぞれに完全な構文が必要です。

キーワードで作った関連を外す場合は、説明文のキーワードを削除する扱いです。また、コミットメッセージにも終了用キーワードを使えますが、そのコミットを含むプルリクエストは、Issueの関連プルリクエストとしては一覧に載らないと説明されています。

手動の関連付けにはリポジトリへの書き込み権限が必要です。プルリクエスト側のDevelopmentから関連付ける場合は同じリポジトリ内のIssueが対象で、1件のプルリクエストに最大10件まで関連付けられます。Issue側のサイドバーから操作する方法も掲載され、こちらは異なるリポジトリのプルリクエストやブランチも対象です。関連付けを始める画面によって、選べる対象の範囲が異なります。

出典:GitHub『Linking a pull request to an issue』(2026年11月18日確認)https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue

次に読むページ

複数作業はチャット分離もセットで考える

並行作業では、対象サイト、対象ファイル、危険度ごとにチャットやCodex作業スレッドを分けると管理しやすくなります。

Codex作業で新しいチャットを使うタイミングを見る

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。