strzhao Autopilot for Codex
这是本仓库 autopilot 的 Codex 兼容入口。目标是在 Codex 中恢复与 Claude autopilot 等价的 phase-state runtime，而不是停留在“方法论兼容”。
基线文件
把以下文件当作只读基线：
plugins/autopilot/skills/autopilot/SKILL.mdplugins/autopilot/skills/autopilot/references/
Claude 专有机制只作为行为 oracle，不直接把运行时写回 .claude/。
Codex 兼容边界
- 运行时状态文件：
.codex/autopilot.local.md - 不要写入
.claude/autopilot.local.md - 可以依赖 repo-local
.codex/hooks.json的Stopruntime .autopilot/可作为只读知识库- 不恢复历史 plugin-sync、bridge、watcher
Runtime Helpers
先解析状态脚本路径：
AUTOPILOT_STATE_SCRIPT="$(git rev-parse --show-toplevel 2>/dev/null)/codex/plugins/autopilot-codex/assets/scripts/autopilot_state.py"
if [ ! -f "$AUTOPILOT_STATE_SCRIPT" ]; then
AUTOPILOT_STATE_SCRIPT="${CODEX_HOME:-$HOME/.codex}/plugins/cache/string-codex-plugins/autopilot-codex/local/assets/scripts/autopilot_state.py"
fi
统一使用它管理状态：
python3 "$AUTOPILOT_STATE_SCRIPT" start --goal "<GOAL>"
python3 "$AUTOPILOT_STATE_SCRIPT" approve [--feedback "<TEXT>"]
python3 "$AUTOPILOT_STATE_SCRIPT" revise --feedback "<TEXT>"
python3 "$AUTOPILOT_STATE_SCRIPT" status [--json]
python3 "$AUTOPILOT_STATE_SCRIPT" cancel [--reason "<TEXT>"]
用户意图映射
把当前用户请求视为以下两类之一：
- 启动新流程
- 控制已有流程：
approve/revise <反馈>/status/cancel
如果请求更像提交或诊断：
autopilot commit->$autopilot-commit-codexautopilot doctor->$autopilot-doctor-codex
状态写回规则
- 每次改
phase、gate、retry_count、qa_scope、updated_at，先写回.codex/autopilot.local.md - design 必须写完
## 目标、## 设计文档、## 实现计划、## 验证方案 - implement 必须把红队产物写回
## 红队验收测试 - qa / auto-fix 必须把每轮证据追加到
## QA 报告，不要覆盖旧轮次 - merge 结束前把最终摘要写回状态文件，再设
phase=done
工作流
1. 启动或恢复
- 新目标：运行
start，然后继续当前 phase - 控制命令：运行对应子命令；如果 phase 被推进到活跃阶段（含
auto-fix、merge），在同一轮继续推进 - 如果没有状态文件，
approve/revise/status/cancel直接说明没有活跃 autopilot
2. Design
- 读取
.autopilot/index.md；没有索引时退回读decisions.md和patterns.md - 探索代码库，识别技术栈、现有模式、测试框架、可复用模块
- 在状态文件中写入：
## 目标## 设计文档## 实现计划## 验证方案
- 设计产物至少包含：
- 目标
- 技术方案
- 文件影响范围
- 风险评估
- 测试策略
- 1-3 个真实场景验证步骤
- 必须启动 plan reviewer 子代理，最多 2 轮
- 完成后设置
gate: "design-approval"并停下等待用户审批
3. Implement
- 先基于设计产出红队验收标准，再进入编码
- 必须并行启动蓝队和红队子代理
- 红队只能看到目标 + 设计文档，不能看到实现计划和蓝队新代码
- 红队产物必须写回
## 红队验收测试 - 如果子代理不可用：
- 记录
FORCED DOWNGRADE - 红队降级为验收清单后才能继续
- 记录
- 实现完成后进入
phase=qa
4. QA
固定顺序：
- Tier 0 红队验收
- Tier 1 类型/lint/测试/构建
- Tier 1.5 真实场景验证
- Tier 2 设计 reviewer + 代码质量 reviewer，并行
- Tier 3 / Tier 4 集成与回归
如果 QA 失败：
- 先把失败证据写入
## QA 报告 - 设置
phase=auto-fix retry_count += 1- 最多 3 轮
如果 QA 通过：
- 设置
qa_scope="" - 设置
phase=merge - 设置
gate=review-accept - 向用户展示验收摘要并等待
approve或revise
5. Auto-fix
- 逐项记录失败原因、根因假设、修复动作、重跑结果
- 绝不修改红队验收标准
retry_count < max_retries：设置qa_scope="selective"，再回到phase=qaretry_count >= max_retries：记录未解决项，设置gate=review-accept，停下让用户决策
6. Merge
- 需要提交时调用
$autopilot-commit-codex - 不需要立即提交时保留状态文件，直到进入
done - 结束前把最终摘要写回状态文件，再设
phase=done
7. Cancel / Done
cancel：设为cancelled并记录原因，由 Stop hook 清理done：由 Stop hook 清理
输出要求
- 汇报保持简洁
- 审批门必须显式停下等待用户
- 不把 Codex runtime 写回
.claude/