| name | autopilot-refine |
| description | Use when an existing document or research artifact needs factual, structural, stylistic, or review-driven correction with history preserved. Not for drafting a new artifact or performing new empirical work required before the document can change. |
autopilot-refine
This is a Codex-native Skill projection generated from the portable capability
contract. It is adapter-owned output, not a legacy compatibility Skill copy.
Source
- Portable source:
capabilities/autopilot-refine.md
- Runtime check:
adapters/codex/bin/preflight.sh capability-info autopilot-refine
- Bootstrap:
adapters/codex/AGENTS.md
Use
- Before approval, route from this compact metadata and
core/WORKFLOW.md §0.2; do not read the full portable source merely to propose the route.
- Present the five-field confirmation card from
core/WORKFLOW.md §0.4 unless the same route and scope are already approved.
- After approval, direct/quick acting sessions read
capabilities/autopilot-refine.md; at standard+, the dispatch-depth-1 owner reads it and stage workers read only their assigned contracts.
- Run
adapters/codex/bin/preflight.sh capability-info autopilot-refine and obey the reported status:
instruction-only: use this Skill as Codex guidance plus explicit preflight guards.
tool-contract: report the named tool_contract, run any tool_contract_check, and obey runtime_surface / fallback before claiming full support.
unsupported: stop or use the reported fallback.
Shape
- Identifier:
autopilot-refine
- Invocation class:
entry-router
- Supported modes:
none
- Argument shape:
"<prompt>" [--intensity direct|quick|standard|strong|thorough|adversarial] [--review-only | --memo <file>] [--confirm] [--no-fact-check] [--no-style-audit]
- Portable meaning: Correct and update existing document/research artifacts while preserving snapshots and change history.
Required Guards
- Before edits:
adapters/codex/bin/preflight.sh write <file> [session-id]
- Before capability routing/spec-changing work:
adapters/codex/bin/preflight.sh route autopilot-refine [cwd] [session-id]
- Before spec-changing work:
adapters/codex/bin/preflight.sh capability autopilot-refine [cwd] [session-id]
- After actually reading a spec PRD:
adapters/codex/bin/preflight.sh read <prd.md> [session-id]
- For workflow state:
adapters/codex/bin/preflight.sh status [cwd] [session-id] and adapters/codex/bin/preflight.sh prompt-signal [cwd] [session-id]
Do not use legacy compatibility Skill files or non-native adapter Skill files
as Codex-native source. Those files are compatibility/reference surfaces only.