name: codex-orchestrator
description: "Codex CLIをバックグラウンドで実行し、確実に完了まで待機する。"
Codex Orchestrator Skill
Codex CLIをバックグラウンドで実行し、確実に完了まで待機するスキル。
概要
- 目的: codexの長時間タスクを確実に監視・完了待機
- セッション永続化: セッション情報をファイルに記録し、エージェント再起動後も継続可能
- 待機ループ: sleep + poll で完了まで待ち続ける
セッション情報の保存先
保存先: ~/.openclaw/codex-sessions.json
構造の例: → references/example-session.json
ワークフロー
起動 → 待機ループ → 完了確認 → 報告の4ステップ。
詳細手順・コマンド例・待機間隔の目安・使用例: → references/workflow-details.md
待機ループの鉄則:
- pollの結果が "Process still running" なら必ず次のsleepへ
- "Process exited" が出るまで絶対に止めない
Hook連携
before_agent_start
エージェント起動時に既存codexセッションを確認するフックスクリプト:
→ scripts/before-agent-start.js
禁止事項
- pollが "still running" なのに待機を中断
- セッション情報を記録せずに起動
- ユーザー確認なしでセッションをkill
- 完了報告をせずにタスク終了
チェックリスト
起動時:
待機中:
完了時:
よくある落とし穴
- poll が "still running" なのに待機を中断する: Codex タスクは完了まで時間がかかる。"Process exited" が出るまで絶対に待機ループを止めないこと
- セッション情報を記録せずに起動する: エージェント再起動後にセッションを見失う。必ず
~/.openclaw/codex-sessions.json に記録すること
- ユーザー確認なしでセッションを kill する: 処理途中で kill すると中途半端な変更が残る。明示的な指示がある場合のみ kill する
- workdir が git リポジトリでない場所で実行する: Codex はファイル変更を行うため、git 管理下でないと変更の追跡・復元ができない
- 重いタスクに短い待機間隔を設定する: 大規模リファクタに 5 秒間隔で poll すると無駄な負荷がかかる。タスク種類に応じて 5〜60 秒を使い分けること
作成: 2026-02-12