用途:面向需求驱动的开发闭环,把一条需求拆解为可验收标准与任务计划,执行实现后逐条客观验证,未通过的进入修复循环,直到全部通过或达到最大迭代次数后升级处理。可用于新功能开发、缺陷修复、重构、数据或 API 迁移、API 端点开发等场景(资料提供了对应模板 preset)。
主要能力:支持 --template 选择 feature、bugfix、refactor、migration、api-endpoint 等预设验收标准;支持 --max-iterations 控制验证-修复循环上限(默认 3);--auto 免确认执行 CLI 委派;--method agent|cli|auto 与 --executor 指定执行方式;--skip-generalize、--skip-verify、--heartbeat 等开关;-y 自动确认(决策记为 deferred);-c 恢复最近会话。流程含 INTAKE、PLAN、EXECUTE、VERIFY、FIX、GENERALIZE、DISCOVER、RECORD 状态,带强制阻塞式阶段闸门与 phase_goals 目标追踪,并通过 session.json、evidence.ndjson、understanding.md 记录过程与证据。
使用方式:需先阅读并应用 odyssey-base-codex.md 的基础不变量。会话产物写入 .workflow/scratch/{YYYYMMDD}-planex-odyssey-{slug}/ 或 .workflow/state.json,不得写到其他路径;执行中的源码修改须按动作提交。CLI 协助可使用 maestro delegate(如规划、实现、验证、代码审查),后台执行并等待回调;cli-review 类验收通过 spawn_agents_on_csv 并行验证(Wave 1)。结束时必须恰好调用一次 report_agent_job_result。
限制:verify_method 仅支持 test、grep、cli-review、manual;每任务自动修复最多 3 次,仍失败则标记 blocked,并使相关验收标准与阶段目标 G3 保持未完成。GENERALIZE 要求语法、语义、结构三层均须尝试,否则违反闸门。未通过且迭代达到上限时需人工决策或按 -y 记为 deferred。资料未提供具体模型依赖、收费、性能数据。