Codex operation management

Codex作業ステータスの分け方

Codex作業の状態を、未着手、作業中、完了、保留、停止、人間確認待ち、翌日確認で分ける方法です。

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

このページで分かること

Codex作業の状態を、未着手、作業中、完了、保留、停止、人間確認待ち、翌日確認で分ける方法です。

使う場面

作業数が増え、今どの作業がどの状態か分からなくなった時に使います。

管理の考え方

作業状態の管理で重要なのは、5つの状態の「境界」をあいまいにしないことです。特に「完了」の定義がゆるいと、未検証の作業が完了扱いになり、後から不具合として跳ね返ってきます。

状態定義あいまいにすると起きること
未着手まだ頼んでいない作業「頼んだつもり」の作業が放置される
作業中Codexが進めている作業同じ作業を二重に依頼して差分が混線する
完了公開URLで検証まで済んだ作業報告書だけ見て完了にすると、未反映の作業が完了扱いになる
保留理由つきで意図的に止めた作業理由なしの保留は、再開時に「なぜ止めたか」が分からなくなる
停止危険条件に該当して中断した作業保留と混ぜると、危険の記録が埋もれて同じ危険を繰り返す

ポイントは「完了=検証済み」と「保留=理由つき」の2つの縛りです。この2つさえ守れば、作業が増えても状態管理は崩れません。

よくある失敗

  • 確認前に完了にする
  • 保留と停止を混ぜる
  • 翌日確認を忘れる
  • 人間確認待ちを放置する

Codexに頼む時の指示例

Codex作業一覧を、未着手、作業中、完了、保留、停止、人間確認待ち、翌日確認に分類してください。それぞれ理由と次の行動も付けてください。

確認チェックリスト

  • 状態が1つに決まっている
  • 保留理由がある
  • 停止理由がある
  • 翌日確認がある
  • 次の行動がある

状態を見直すタイミング

状態管理は、書いた時点で終わりではありません。放っておくと「作業中のまま止まっている作業」や「保留にしたまま忘れた作業」が溜まっていきます。決まったタイミングで棚卸しすると、この滞留を防げます。

タイミング見る状態判断すること
作業開始時人間確認待ち・翌日確認自分がボールを持っている作業を先に片付ける
作業終了時作業中今日中に完了しないものは、保留か翌日確認へ移す
週の終わり保留・停止再開するか、やらないと決めて閉じるか判断する

特に「保留」は最も溜まりやすい状態です。保留にした時の理由がすでに解消していることも多いため、週に一度は見直して、再開するか、やらないと決めて閉じるかのどちらかに動かしてください。保留のまま何週間も残っている作業は、実質的に「やらない」と決まっているのと同じです。

停止条件

  • 状態が曖昧
  • 停止条件なのに作業中になっている
  • 人間確認待ちを飛ばしている

実際の分類イメージ

複数の作業を同時に頼んでいる時、状態を書き出すと次のように整理できます。

作業内容状態理由・次の行動
新規ページ追加完了公開URLで200・表示確認済み
画像差し替え作業中Codexが対応中、途中経過なし
cron設定変更停止危険操作に該当したため人間の判断待ち
タイトルタグ調整保留他ページの方針確定後にまとめて実施

このように書き出すと、「完了と言われたが実は未検証」「保留のつもりが忘れられていた」といった食い違いに気づきやすくなります。

GitHubの実行状態と終了結果を読み分ける

2026年11月18日時点の公式ヘルプでは、GitHubのチェックには進行を表すstatusと、終了後の結果を表すconclusionがあります。queuedはキュー内、in_progressは実行中、completedは終了して結果を持つ状態です。completedという値だけでは成功を意味せず、success、failure、cancelled、timed_outなどの終了結果を合わせて読む仕組みです。

skippedは処理が省略された結果で、GitHub Actionsの依存するチェックでは成功として扱われます。neutralも同様に成功扱いとなるため、画面で先へ進める状態と、必要な検査を実際に実行した状態は区別が必要です。チェックの詳細にはログ、テスト結果、注釈などが含まれ、PRのChecksタブから通過や失敗の理由をたどれると説明されています。

GitHub Actionsがワークフロー実行時に生成するものはChecksで、簡易なCommit statusesとは種類が異なります。また、チェックのデータは設定された保持期間に従って保存され、期間が過ぎると削除されるため、過去の結果を読む際には保存期間も関係する条件です。

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

実行履歴から作業中の箇所をたどる

2026年11月18日時点の公式ヘルプでは、GitHub Actionsの実行履歴に、ワークフロー内のジョブとステップそれぞれの状態が記録されると案内されています。リポジトリのActionsを開き、対象ワークフローを選び、実行名から概要へ進む流れです。閲覧にはリポジトリへの読み取り権限が必要です。

CLIではgh run listで最近の実行を表示し、--workflowで対象を絞れます。gh run viewに実行IDを渡すとその回の詳細を開き、--verboseではステップも含めて表示できます。--jobでジョブを指定し、--logでそのログを見る操作も掲載されています。依頼一覧の作業名と、実際のワークフロー名・実行ID・ジョブを結び付けると、どの処理の状態を報告しているかを特定できる情報になります。

出典:GitHub『Viewing workflow run history』(2026年11月18日確認)https://docs.github.com/en/actions/how-tos/monitor-workflows/view-workflow-run-history

レビューの承認とコメントを区別する

2026年11月18日時点の公式ヘルプでは、GitHubのPRレビューの判断はComment、Approve、Request changesに分かれています。Commentは一般的な意見を残すもので、明示的な承認でも修正要求でもありません。Approveはマージできる状態であるという判断、Request changesはマージ前に対応すべき指摘を示す判断です。

特定の行へのコメントや具体的な修正提案も可能で、レビューの会話はPRのタイムラインに表示されます。レビューを依頼する操作には書き込み権限が必要で、読み取り権限を持つ人やチームを依頼先に指定できます。作業の報告で「コメントを受けた」と「承認された」を同じ状態へまとめず、判断の種類と指摘内容を分けて扱う根拠になる仕様です。

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

接続設定と定期タスクの実行状態の違い

2026年11月18日時点の公式ヘルプでは、Scheduledからタスクの内容、予定、一時停止などを管理できると案内されています。接続アプリのイベントで動くタスクが応答しなくなった場合には、一時停止や承認の必要な状態、アカウントの接続と権限を調べる説明があります。

アプリを接続したりプラグインを導入したりする操作だけで、イベント型のタスクが作られるわけではありません。タスク自体を作成し、トリガー、条件、指示文を確認する流れです。接続済みという状態、実行のきっかけが設定された状態、個々の処理が動いた状態を、同じ進捗として扱わないための区別になります。

出典:OpenAI『Scheduled tasks in ChatGPT』(2026年11月18日確認)https://help.openai.com/en/articles/10291617-scheduled-tasks-in-chatgpt

次に読むページ

EDITED & REVIEWED

編集・検証情報

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

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