用途：maestro-odyssey 是一个长时迭代循环，单一入口覆盖七种模式（debug|improve|planex|review|security|defensive|ui），各模式共享后半段流程（INTAKE 门 → GENERALIZE → DISCOVER → RECORD → END），前半段按模式执行考古/审计→修复→验证→归纳。
模式选择：优先级为显式 --mode <name> > 意图关键词自动检测 > request_user_input（Normal）/ 错误 E000（-y）。关键词按顺序匹配，如 bug/crash/error 对应 debug，requirement/implement 对应 planex，ui/visual/layout 对应 ui，OWASP/vulnerability/CVE 对应 security，防御性编程对应 defensive，improve/optimize 对应 improve，review/audit 对应 review。无匹配则请求输入或在 -y 下报 E000。
主要能力：debug 做症状→根因→修复→确认；improve 做六维质量审计；planex 做需求→计划→执行→验证循环；review 做多维深度评审并零残留修复；security 与 defensive 为只读审计（安全审计出严重度矩阵，防御审计做业务锚定、反向切片、8 模式扫描、前向传播与风险评分）；ui 做视觉调查、六维审计、发散后修复。
通用参数：--mode 选择模式，--skip-fix 仅审计，--skip-generalize 跳过归纳与发现，-y 跳过确认交互，-c 恢复同一模式最近未完成的 Session（模式不符报 E003）。各模式另有专属参数，如 --dimensions、--fix-threshold、--tier、--sink-depth、--max-iterations、--method、--executor、--skip-verify、--heartbeat。
使用方式与产物：依赖 ~/.maestro/workflows/run-mode.md 与 codex-run-mode.md 等文件，需按模式读取 deferred workflow 文件与 odyssey-base.md。Session 产物输出到 {run_dir}/outputs/，包括 session.json、evidence.ndjson、understanding.md、explore.json（debug/review）、anchors.json（defensive）；.workflow/state.json 与会话协议文件由运行时拥有，工作流不得写入。提交约定为 "odyssey-{mode}({slug}): {STATE} — {summary}"，证据只能追加。
限制：security 与 defensive 为只读，绝不修改源码、配置或依赖，修复需转 --mode improve；improve/review/ui 要求零残留，禁止只报告不处理；planex 验收标准不可随意放宽；ui 以真实渲染为准。缺失：本地安装方式、收费与价格、平台支持等信息暂未提供。