Codex Delegate

繁體中文

codex-delegate is a Claude-oriented skill for using Codex CLI as an execution specialist for implementation-heavy coding work while keeping planning, review, and acceptance in Claude.

Positioning

This skill is for tasks that are expensive in tokens but cheap in judgment:

• multi-file implementation
• mechanical refactors
• boilerplate generation
• test scaffolding
• large batch edits

It is not meant for architecture, root-cause debugging, security review, or ambiguous product decisions.

What Changed In This Version

• clearer routing boundary between Claude, Codex, and Gemini
• explicit supervisor acceptance gate
• machine-readable wrapper output via <log>.result.json
• regression tests for bash and PowerShell wrappers

Core Pattern

1. Claude writes a task file describing scope and constraints.
2. Claude launches Codex synchronously through the wrapper.
3. The wrapper emits sentinel files plus result.json.
4. Claude reviews the diff and runs verification before accepting the result.

Wrapper success is not final acceptance. Claude still owns the judgment.

Repository Layout

codex-delegate/
├── SKILL.md
├── README.md
├── README_zh-TW.md
├── scripts/
│   ├── run_codex.sh
│   └── run_codex.ps1
├── tests/
│   └── test_wrappers.py
└── references/

Testing

python -m pytest -q

Current wrapper tests cover:

• success-path result.json generation
• PowerShell wrapper contract behavior

Installation

Codex CLI must be available in your environment:

npm install -g @openai/codex
codex --version

License

MIT