autopilot-codex

Autopilot for Codex

这是本仓库 autopilot 的 Codex 兼容入口。目标是在 Codex 中恢复与 Claude autopilot 等价的 phase-state runtime，而不是停留在“方法论兼容”。

基线文件

把以下文件当作只读基线：

• plugins/autopilot/skills/autopilot/SKILL.md
• plugins/autopilot/skills/autopilot/references/

Claude 专有机制只作为行为 oracle，不直接把运行时写回 .claude/。

Codex 兼容边界

• 运行时状态文件：.codex/autopilot.local.md
• 不要写入 .claude/autopilot.local.md
• 可以依赖 repo-local .codex/hooks.json 的 Stop runtime
• .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>"]

用户意图映射

把当前用户请求视为以下两类之一：

1. 启动新流程
2. 控制已有流程：approve / revise <反馈> / status / cancel

如果请求更像提交或诊断：

• autopilot commit -> $autopilot-commit-codex
• autopilot 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 子代理，最多 5 轮（0 BLOCKER 即放行）
• 完成后设置 gate: "design-approval" 并停下等待用户审批