docs: require management review result message closure

cai

2026-07-19 8bff546905a9f9de48b110be9f73b7d3ad577056

docs: require management review result message closure

 common/manage-doc/管理体系规范.md

@@ -24,6 +24,7 @@
6. MB-X 只提供 CLI、runtime、daemon、通信、session、skill context 和错误日志能力。
7. 管理体系不得替代 `project-*` 子项目内部的项目体系、需求体系、开发体系、实验体系或案例分析体系。
8. 管理根目录中的真实业务子项目应以 `project-` 开头，并使用独立 Git 仓库。
9. 管理观察员审核管理管理员事项时，必须形成“管理审计报告 + MB-X 审核结果消息回告”双闭环；审计报告和消息互相引用。

## 3. 管理角色

@@ -42,6 +43,7 @@
7. 同步 `mb-ms-doc` 规范更新，并判断对当前工作区的影响。
8. 处理 MB-X 框架错误日志中的管理级问题。
9. 维护管理配置清单、管理事项、管理执行日志和管理变更记录。
10. 接收并处理管理观察员的审核结果消息，按结论关闭、返修、升级或记录 blocked。

写权限：

@@ -63,6 +65,7 @@
5. 审核 MB-X 错误是否进入 `MB-X错误日志.md` 或管理问题记录。
6. 对管理管理员的越权、遗漏、未记录或不一致问题提出返修。
7. 反复返修或高风险问题需要升级给人类确认。
8. 审核完成后，除写入 `manage-doc/管理审计报告.md` 外，还必须通过 MB-X 消息链向 `management.admin` 回告审核结果。

写权限：

@@ -106,6 +109,8 @@
-> 管理管理员写管理执行日志
-> 如改变配置、角色、会话、目录、框架或规范，写管理变更记录
-> 管理观察员做执行审计
-> 管理观察员写管理审计报告，并向管理管理员发送审核结果消息
-> 管理管理员接收并处理审核结果消息
-> 如有问题，退回管理管理员修复
-> 修复后复审
-> 管理事项关闭，并回写管理事项总纲和计划
@@ -130,6 +135,17 @@

管理观察员不替代业务子项目审核员。业务需求、代码、实验、案例分析的专业审计仍进入对应子项目体系。

### 6.1 管理审计结果消息回告

管理观察员对 `management.admin` 的管理计划、执行、变更、框架更新、错误修复或高风险事项完成审核后，必须执行双闭环：

1. 将审计结论写入 `manage-doc/管理审计报告.md`。
2. 通过 MB-X 消息链向 `management.admin` 发送 `review_result`、`review_feedback` 或等价管理审核结果消息。
3. 审核结果消息最低包含：管理事项 ID、审计入口、审核结论、阻断问题、非阻断建议、下一步动作、保留边界、是否允许关闭事项。
4. 审计报告必须记录发出的审核结果消息 ID；审核结果消息必须引用审计报告入口。
5. `management.admin` 关闭、返修或升级管理事项时，必须以已收到并处理该审核结果消息为依据；不得只依赖人工轮询 `manage-doc/管理审计报告.md`。
6. 如果当前 MB-X CLI、interaction route 或 runtime 暂不支持 `management.observer -> management.admin` 的审核结果消息，管理观察员或管理管理员必须记录 blocked：写明失败命令、能力缺口、影响范围和恢复路径，并形成管理、项目或开发修复事项；不得静默把“已写审计报告”视为完整闭环。

## 7. 必须阻断的问题

以下问题必须阻断管理事项关闭：
@@ -143,6 +159,7 @@
7. 管理动作绕过文档驱动口径，把流程、校验或审核规则固化为 MB-X 代码。
8. 管理动作导致 `mbx.yaml`、`mbx.project.yaml`、消息 JSONL 或 inbox 无法解析。
9. 关键审计证据路径不存在、乱码或不可读。
10. 需要管理观察员审计的事项只有审计报告结论，没有审核结果消息回告，且没有记录 CLI / route 能力 blocked 与恢复路径。

## 8. 不应阻断的问题

@@ -165,4 +182,5 @@
6. 管理观察员能审核管理管理员的计划和执行。
7. 管理动作能从管理事项总纲追到计划、执行日志、变更记录和审计报告。
8. MB-X 框架错误有 `MB-X错误日志.md` 入口。
9. 管理观察员审核结论能通过管理审计报告和 MB-X 审核结果消息双向追溯。


 common/manage-doc/管理审计报告模版.md

@@ -57,9 +57,11 @@
审计结论：  
通过 / 不通过 / 暂缓

审核结果消息：
已发送 / 待发送 / blocked；消息 ID：<message-id 或无>；目标：management.admin；消息类型：review_result / review_feedback / 等价管理审核结果消息

是否允许进入下一阶段：  
是 / 否

复审要求：  
<如无写“无”>


 common/manage-doc/管理管理员工作说明模版.md

@@ -47,6 +47,9 @@
5. 框架层错误写入 `MB-X错误日志.md`。
6. 不把业务流程、校验或审核规则固化进 MB-X 代码。
7. 不把 `project-*` 子项目提交到 `mb-ms-doc` 模板仓库。
8. 关闭、返修或升级需要管理观察员审核的事项前，必须收到并处理观察员通过 MB-X 消息链发送的 `review_result`、`review_feedback` 或等价管理审核结果消息。
9. 不得只靠轮询 `manage-doc/管理审计报告.md` 关闭事项；若观察员只写审计报告但未回告消息，必须记录 blocked 或要求观察员补发消息。
10. 如果 CLI、interaction route 或 runtime 暂不支持管理观察员向管理管理员发送审核结果消息，必须登记管理/项目/开发修复事项并说明临时边界。

## 5. 可用技能

@@ -63,6 +66,8 @@

管理管理员可以自检，但高风险管理动作必须交给管理观察员审计。若暂时没有独立观察员，必须在管理审计报告中标记“待独立观察员复审”。

管理观察员完成审核后，管理管理员必须处理观察员审核结果消息，并将消息 ID、审计入口和处理动作写入管理事项、计划、执行日志或变更记录。审计报告中有结论但缺少审核结果消息时，不得视为完整闭环。

## 7. 禁止事项

1. 不得绕过管理事项账本执行高风险管理动作。
@@ -70,4 +75,4 @@
3. 不得用聊天记录替代管理执行日志。
4. 不得把框架错误写成业务问题来隐藏。
5. 不得把业务子项目私有内容写入公共模板。

6. 不得绕过管理观察员审核结果消息直接关闭高风险管理事项。

 common/manage-doc/管理观察员工作说明模版.md

@@ -45,6 +45,9 @@
4. 变更审计重点看配置、角色、会话、框架或规范变化是否记录完整。
5. 框架错误修复审计重点看错误是否进入 `MB-X错误日志.md`，修复是否可复验。
6. 只阻断影响权限、配置、证据链、运行态、项目边界或后续可追溯性的问题。
7. 审核完成后，除写入 `manage-doc/管理审计报告.md` 外，必须向 `management.admin` 发送 `review_result`、`review_feedback` 或等价管理审核结果消息。
8. 审核结果消息必须包含管理事项 ID、审计入口、审核结论、阻断问题、非阻断建议、下一步动作、保留边界和是否允许关闭事项；审计报告与消息必须互相引用。
9. 如果 CLI、interaction route 或 runtime 暂不支持 `management.observer -> management.admin` 审核结果消息，必须在审计报告或管理问题记录中记录 blocked、失败命令、能力缺口和恢复路径，不得只写审计报告后静默收口。

## 5. 可用技能

@@ -60,6 +63,14 @@
```text
manage-doc/管理审计报告.md
```

审核结果消息发送给：

```text
management.admin
```

消息类型优先使用 `review_result`；需要返修时使用 `review_feedback`；CLI 不支持精确类型时可用等价管理审核结果消息，但必须在正文写明审核结论和审计入口。

需要长期跟踪或跨轮处理的问题，写入：

@@ -80,4 +91,4 @@
3. 不得把格式小问题升级为阻断。
4. 不得替业务子项目审核员审核专业业务产物。
5. 不得把审计结论只留在聊天窗口中。

6. 不得只写管理审计报告而不发送审核结果消息，除非已正式记录 CLI / route 能力 blocked 和恢复路径。