用途:对指定代码目标执行“审查+修复”闭环工作流,先做历史考古与上下文探索,再从正确性、安全、性能、架构四个维度审查,随后按严重度分级修复并确认零残留,最后做多层泛化扫描与知识沉淀。
主要能力:支持 --dimensions 过滤维度、--fix-threshold 设定修复阈值、--skip-fix 跳过修复、--skip-generalize 跳过泛化、--auto/-y/-c 自动与续跑模式。目标解析支持文件/目录路径、HEAD 与暂存区 diff、阶段号(经 state.json)、PR 号(git diff main...HEAD)。会话产物写入 .workflow/scratch/{YYYYMMDD}-review-odyssey-{slug}/ 或 .workflow/state.json,输出 session.json、evidence.ndjson、explore.json、understanding.md。流程含 Wave 1 考古(git 时间线、blame)、Wave 2 四维审查、Wave 3 泛化(语法、语义、结构、历史),并设有多道阻塞式阶段门与状态机。
使用方式:需先阅读并应用 base(odyssey-base-codex.md)的基础不变量与执行纪律;按阶段门依次推进,修复须逐动作提交,规格加载命令为 maestro load --type spec --category review。
限制:无目标会报 E001,路径不存在报 E002,无 git 历史为 W001 警告,部分维度失败为 W002 部分覆盖;禁止“只报告不处理”和“预先存在即跳过”;未提供收费、价格与平台支持信息。