用途:在原生 Omnigent 会话中驱动一个完整功能,从预检到产出经过验证的候选提交(candidate commit),并组织评审与端到端门禁。使用前应先阅读 references/methodology.md(完整生命周期)与 references/omnigent-mechanics.md(Omnigent 机制),并以已安装 Omnigent 技能及其 --help 为语法依据。
主要能力与流程:预检 →(可选,用户同意时)mo-reuse 作为独立顶层智能体 → 执行器会话,目标以提示文本承载 → 冻结 SHA → 评审 A 与评审 B 独立在同一 SHA 上运行(mo-review)→ 同一 SHA 上适用的 E2E(mo-e2e)→ 任何修复产生新 SHA 并重跑所有适用门禁 → 输出 STATUS / CANDIDATE / SUMMARY。角色以 <slug>-exec、<slug>-review-a、<slug>-review-b、<slug>-e2e 称呼,但 Omnigent 不存储这些名称。
用法要点:无参数调用时不要随意开工,应读取仓库状态,提出继续当前工作或询问要运行哪个 spec。执行器用 -c/--continue 继续最近一次会话;评审用无头 omnigent run … -p "<prompt>" 单次运行,stdout 重定向到文件。评审证据需用 omnigent session export --id <full id>,但该路由不提供完整 id,前缀会被拒绝,因此评审轮次通常只能标记 needs_attention,需用户从 Omnigent 选择器提供 id。
限制:Omnigent 0.6.0 实测 REPL 中 /goal 返回 Unknown command,斜杠命令不进入 harness,因此本路由没有原生 goal,需使用 methodology §6 的降级方案(每角色一个持久会话、以完成导向的首个提示携带 <SPEC_PATH> 与 <BUSINESS_PATH>、过早空闲用普通追问处理),并在交接中说明该降级较弱。不要用自建状态机模拟 goal,也不要声称 goal 生效。评审不得落在执行器的 harness 上,否则 -c 会静默进入错误角色。模型偏好通过 scripts/mo-models.mjs 管理,支持 --show、--set、--catalog、--check-upgrades;--set 会先对照路由目录校验,--force 可跳过校验。若该脚本不在技能目录中,说明安装不完整。