---

name: execution-supervision description: Claude Code や OpenClaw の実行を Codex が監督するためのスキル。cron 実行レビュー、作業逸脱の検知、改善ログ蓄積、prompt/skill の継続改善に使う。「監督して」「supervise」「worker review」「cron review」「実行を見て」などで使用。

Execution Supervision

事前確認

最初に以下を読むこと。

1. LEARNINGS.md
2. /Users/satokeita/.openclaw/supervision/README.md
3. /Users/satokeita/.openclaw/supervision/issue-codes.md

目的

Codex を常駐監視役にせず、以下だけを担当させる。

• 実行前: 監督対象の prompt / 成功条件 / 禁止事項を確認
• 実行後: compact artifact だけで accept / retry / patch を判断
• 改善: 再発した問題を prompt / skill / script に反映

監督フロー

A. OpenClaw cron / agent の監督

1. packet を作る

/Users/satokeita/.openclaw/scripts/prepare-openclaw-cron-review.sh <job-id> [--repo /abs/repo]

2. Codex review を作る

/Users/satokeita/.openclaw/scripts/review-openclaw-cron-packet.sh <packet-dir>

3. outcome を ledger に記録する

/Users/satokeita/.openclaw/scripts/record-supervision-outcome.sh --packet-dir <packet-dir>

4. 必要なら backlog を手動再生成する

/Users/satokeita/.openclaw/scripts/build-supervision-backlog.sh

record-supervision-outcome.sh は標準で backlog 再生成と AI PM sync まで行う。ローカルだけで止めたいときだけ --skip-sync を使う。

B. Claude worker の監督

既存の supervision pattern を使う。

/Users/satokeita/.openclaw/scripts/supervise-claude-task.sh ...
/Users/satokeita/.openclaw/scripts/review-worker-run.sh ...

必要なら、review 結果を同じ ledger に handoff する。

判断基準

Accept

• 目的が達成されている
• 禁止事項を破っていない
• 成果物と summary が一致している
• 次の人が読んで追える

Accept With Follow-up

• 主タスクは達成
• ただし prompt か運用ルールの改善余地がある

Retry

• 実行結果が不完全
• 情報不足ではなく実行手順の問題
• 同じ prompt を改善したうえで再実行する価値がある

Reject / Manual Check

• 外部副作用が危険
• 実行内容と summary が食い違う
• 監督だけで正否を決めるのが危険

自律改善ループ

監督で問題を見つけたら、その場限りで終わらせない。

1. issue-codes.md から issue code を選ぶ
2. record-supervision-outcome.sh で記録する
3. 自動更新された improvement-backlog.md と AI PM task を確認する
4. 再発が 2 回以上あるなら prompt / skill / script を修正する
5. 修正内容を LEARNINGS.md に短く追記する

どこを直すか

• prompt の曖昧さ: cron/jobs.json や task prompt
• 監督観点の不足: このスキル
• review artifact 不足: supervision/ 配下の script / schema
• 実行時の手順不足: worker 側 skill / script
• AI PM task claim mismatch: verifier script か worker prompt

完了チェック

• 監督対象の目的・禁止事項を確認した
• compact artifact から review を作成した
• outcome を ledger に記録した
• backlog を更新した
• 再発課題があれば prompt / skill / script に反映した
• LEARNINGS.md に学びを追記した

⚠️ よくある落とし穴

• review 結果を会話だけで終える: 構造化された ledger に記録しないと、改善が蓄積せず再発傾向を拾えない。必ず record-supervision-outcome.sh で JSONL ledger に落とす
• worker の raw transcript 全体を Codex に読ませる: token 効率が悪く、review の精度も下がる。session-tail.jsonl は圧縮抜粋にし、prompt + run summary + session tail + repo status の 4 点に絞る
• packet 作成のタイミングが早すぎる: repo status は「今の状態」を取るため、実行完了に近いタイミングで packet を作成する。実行途中の状態では正確な review ができない
• review-openclaw-cron-packet.sh の timeout 設定が短すぎる: MCP 起動コストがあるため、短すぎる timeout だと fallback になりやすい。余裕を持った timeout を設定する
• 「気づき」レベルで改善を終わらせる: 再発が 2 回以上あるなら prompt / skill / script を実際に修正する。issue code の付与と backlog 更新まで行い、仕組みとして対策する