agentleFS
takayoshitoyoda05takayoshitoyoda05/claude-ml-template/.claude/skills/codex-delegate/SKILL.md

codex-delegate

Skill1 starsChanged 2 months agoMITView on GitHub

定型タスクをCodexに委譲するとき、「Codexにやらせて」「Codexに委譲して」と言われたときに必ず使う。

15 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Codex への実装委譲

レビュー(cross-review)とは別レイヤーの、実装作業の委譲。 Codex は独立タスクの量産・CLI 中心の操作・長時間の自律実行に強い。 設計判断が絡む作業は委譲せず Claude(generator)が担当する。

委譲に向くタスク / 向かないタスク

詳細は .claude/skills/codex-delegate/references/task-fitness.md を必ず読むこと(この節の規律は参照先が正)。

委譲の規律(全て必須)

Codex への依頼文には必ず以下を含める。「呼べること」と「狙った作業だけを 任せられること」は別であり、範囲を依頼文で固定する。

  1. cwd の明示: 作業ディレクトリの絶対パスを依頼文に書く
  2. 対象ファイルの明示: 触ってよいファイル・ディレクトリを列挙する
  3. 触らない範囲の明示: 「上記以外のファイルは読んでよいが変更しない」と書く
  4. git 操作の禁止: 「git add / commit / push は行わない」と必ず書く (コミットは委譲結果を確認した Claude 側が行う)
  5. 完了条件の明示: 何ができたら完了か(例: 全テストがPASSする)を書く

進め方

  1. Codex CLI が使えるか確認する(インストール: codex --version、 認証: codex login status)。どちらかが通らなければ 「Codex CLI が使えません(未インストールまたは未認証)。委譲できないため、 通常の generator での実装を提案します」と報告して終了する (cross-review と同じ事前確認。Codex はこのテンプレートでは任意ツール)。
  2. 委譲は作業ツリーがクリーンな状態で開始する。クリーンでなければ先に コミットまたは退避する(巻き戻しが「委譲の取り消し」と正確に一致する ことを保証するため)。
  3. タスクが委譲に向くか上の表で判断する。向かない場合はその旨を伝え、 通常の generator での実装を提案する。
  4. 依頼文を組み立てる(規律1〜5を全て含める)。
  5. Codex を呼び出す。
    • MCP(codex)が接続されていれば MCP 経由で依頼する
    • 接続されていなければ codex exec "<依頼文>" で実行する。 環境変数 CODEX_IMPL_MODEL が設定されていれば -m $CODEX_IMPL_MODEL を付ける (実装委譲は安価なモデル、レビューは強いモデルという役割分担。 未設定なら .codex/config.toml の設定)
  6. Codex の作業完了後、変更内容を確認する。

    詳細は .claude/skills/codex-delegate/references/verification-steps.md を必ず読むこと(この節の規律は参照先が正)。

  7. 問題なければ Claude 側で規約に沿ってコミットする (<type>(delegate N): <要約> 形式。N は関連する計画のステップ番号。 計画に紐づかない単発の委譲なら 1)。
  8. 委譲した作業も evaluator / evaluator-standards のレビュー対象になる (/ml-pipeline 内で使った場合)。委譲だからといって品質ゲートを免除しない。

依頼文のテンプレート

詳細は .claude/skills/codex-delegate/references/request-template.md を必ず読むこと(この節の規律は参照先が正)。

注意

  • guard_scope.py / guard_bash.py は Claude 側のフックであり、 Codex の動作には効かない。だからこそ依頼文での範囲固定が必須
  • 委譲結果を無確認でコミットしない。git status --short と git diff HEAD の確認は省略不可

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.