Codex Bridge
Package context, run Codex with a fixed sandbox, validate its response, and synthesize verified findings.
Replace <skill-dir> with this skill's literal directory. On Windows, py -3 may replace python.
Scenarios
| Scenario |
Purpose |
Sandbox |
Default model |
plan-review |
Review an explicit plan |
read-only |
gpt-5.6-sol |
codify |
Implement approved work |
workspace-write |
gpt-5.6-sol |
review-iteration |
Apply focused review; round 2 is final |
workspace-write |
gpt-5.6-terra |
verification-round |
Verify extrapolated instances |
read-only |
gpt-5.6-sol |
Sandbox is code-owned. Only model and effort accept project or CLI overrides.
Workflow
- Confirm explicit Codex intent and select one scenario.
- Create a round:
python "<skill-dir>/scripts/create_bundle.py" <scenario> "<project-root>".
- Distill decisions, rejected approaches, unknowns, and session provenance into
conversation.md.
- Copy required sources into
files/ as a file-backed fixture.
- Fill every placeholder in
request.md. Do not omit referenced plans, conventions, or reviewed files.
- Set manifest session, previous-round, and verification-purpose fields.
- Run
python "<skill-dir>/scripts/validate_bundle.py" "<bundle>" --phase preflight; fix every failure.
- For workspace-write, preserve unrelated changes and enforce the authorized scope.
- Run
python "<skill-dir>/scripts/run_bundle.py" "<bundle>". Add --output-schema only when the active Codex endpoint supports protocol-level schema validation.
- Run
python "<skill-dir>/scripts/validate_bundle.py" "<bundle>" --phase post-response.
- Compare
files_changed with the working tree; synthesize accepted, rejected, and uncertain points.
- Record pattern extraction; verify only concrete lateral candidates. Never recurse or create round 3.
Read workflow detail, bundle conventions, and the scenario prompt-notes.md before filling a bundle. Use checklist.md before execution and jsonl-guide.md when locating source conversations. Routing review cases live under evals/ and load only for route evaluation.
Governance
owner: lyh; review cadence: quarterly and whenever the Codex model family changes.input_files: user-authorized plans, source files, project rules, and distilled conversation fixtures.output contract: a retained bundle, validated response.json, and a primary-agent synthesis with real working-tree verification.rollback boundary: remove this skill directory, then run just docs-sync to remove generated catalog entries.trust report: reports/trust-report.md; output evidence: reports/output_quality_scorecard.md. Unrun telemetry, live Codex benchmarks, and approval metrics remain missing evidence.
Model names evolve. Verify current availability against the official Codex models page before changing models.json; do not silently fall back to an obsolete model.
1---2name: codex-bridge3description: Use when the user explicitly asks the current agent to involve Codex CLI by reviewing a plan, implementing code, revising an implementation after review, or verifying extrapolated findings. Supports "让 Codex 审一下", "交给 Codex 实现", and explicit Claude-to-Codex collaboration through portable file-backed bundles. Do not use for ordinary code review, generic multi-agent orchestration, session handoff, or any request that does not explicitly ask Codex to participate.4---56# Codex Bridge78Package context, run Codex with a fixed sandbox, validate its response, and synthesize verified findings.910> Replace `<skill-dir>` with this skill's literal directory. On Windows, `py -3` may replace `python`.1112## Scenarios1314| Scenario | Purpose | Sandbox | Default model |15| --- | --- | --- | --- |16| `plan-review` | Review an explicit plan | `read-only` | `gpt-5.6-sol` |17| `codify` | Implement approved work | `workspace-write` | `gpt-5.6-sol` |18| `review-iteration` | Apply focused review; round 2 is final | `workspace-write` | `gpt-5.6-terra` |19| `verification-round` | Verify extrapolated instances | `read-only` | `gpt-5.6-sol` |2021Sandbox is code-owned. Only model and effort accept project or CLI overrides.2223## Workflow24251. Confirm explicit Codex intent and select one scenario.262. Create a round: `python "<skill-dir>/scripts/create_bundle.py" <scenario> "<project-root>"`.273. Distill decisions, rejected approaches, unknowns, and session provenance into `conversation.md`.284. Copy required sources into `files/` as a `file-backed fixture`.295. Fill every placeholder in `request.md`. Do not omit referenced plans, conventions, or reviewed files.306. Set manifest session, previous-round, and verification-purpose fields.317. Run `python "<skill-dir>/scripts/validate_bundle.py" "<bundle>" --phase preflight`; fix every failure.328. For workspace-write, preserve unrelated changes and enforce the authorized scope.339. Run `python "<skill-dir>/scripts/run_bundle.py" "<bundle>"`. Add `--output-schema` only when the active Codex endpoint supports protocol-level schema validation.3410. Run `python "<skill-dir>/scripts/validate_bundle.py" "<bundle>" --phase post-response`.3511. Compare `files_changed` with the working tree; synthesize accepted, rejected, and uncertain points.3612. Record pattern extraction; verify only concrete lateral candidates. Never recurse or create round 3.3738Read [workflow detail](references/workflow-detail.md), [bundle conventions](conventions.md), and the scenario `prompt-notes.md` before filling a bundle. Use [checklist.md](checklist.md) before execution and [jsonl-guide.md](jsonl-guide.md) when locating source conversations. Routing review cases live under `evals/` and load only for route evaluation.3940## Governance4142- `owner`: lyh; `review cadence`: quarterly and whenever the Codex model family changes.43- `input_files`: user-authorized plans, source files, project rules, and distilled conversation fixtures.44- `output contract`: a retained bundle, validated `response.json`, and a primary-agent synthesis with real working-tree verification.45- `rollback boundary`: remove this skill directory, then run `just docs-sync` to remove generated catalog entries.46- `trust report`: `reports/trust-report.md`; output evidence: [reports/output_quality_scorecard.md](reports/output_quality_scorecard.md). Unrun telemetry, live Codex benchmarks, and approval metrics remain `missing evidence`.4748Model names evolve. Verify current availability against the official Codex models page before changing `models.json`; do not silently fall back to an obsolete model.
bahayonghang