用途:在任务、PR 或变更集功能完成后,于请求合并审批前做一次“人能否解释这次变更”的检查。它不实现代码、不做代码审查,也不执行或批准 Git 合并。
主要能力:按深度档位(--quick 正确率≥0.70、最多3题;--standard 默认≥0.80、最多5题;--deep≥0.90、最多8题)收集本地 Git diff、变更文件及 test/spec/qa 等命名产物作为证据;生成五段式解释文档(Why、What Changed、Tradeoffs、Risks Considered、Team Understanding)与单选 MCQs;逐轮呈现题目并客观评分;结果分为 pass、paused、blocked,另支持 maintainer override 与 cancelled。缺失证据会明确记录,不会被解释文档掩盖。
使用方式:先调用 merge_readiness_start 初始化,再用 merge_readiness_set_content 提交文档与题目,通过 AskUserQuestion 逐题作答并用 merge_readiness_record_answer 记录,用 merge_readiness_report 渲染审计记录。状态存于 .omc/state/merge-readiness-state.json(会话级路径 .omc/state/sessions/<sessionId>/)。
限制:v1 为建议性门禁,未接入 Stop 钩子,不会阻塞会话;不替代测试、QA、代码审查、安全审查或维护者审批,也不代表变更已获批准。--from-pr 不支持,仅用本地证据。缺失 diff/变更信号即 blocked。overide 需由 MCP 启动器注入的已认证主体且在该会话维护者允许列表中。