このページで分かること
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


