edit | blame | history | raw

管理体系规范

创建人员：Codex
文件职责：定义管理体系的定位、角色、权限、事项流程、审计边界、问题闭环和完成标准。
管理规范/模板：../../全局规范.md；../../管理系统说明.md；../project-doc/项目规范.md；../ai-workplace/AI工作空间创建指南.md。
引用文件：管理环境创建指南.md；管理配置清单模版.md；管理事项总纲模版.md；管理事项计划模版.md；管理执行日志模版.md；管理审计报告模版.md；管理问题记录模版.md；管理变更记录模版.md。
记录方式：管理体系公共规范；管理体系角色、权限、流程或审计口径变化时更新。

1. 定位

管理体系用于治理 MB-X 管理根目录中的管理动作。

它解决的问题是：管理会话不能成为不受治理的控制窗口。管理会话创建项目、启用体系、创建角色、创建会话、更新 MB-X、同步 skill、修复通信框架、调整模板或处理跨项目问题时，都必须能被记录、审计和追溯。

管理体系不是业务子项目的项目体系。项目体系管某个 project-* 子项目；管理体系管 mb-ms-doc 管理根目录、MB-X 框架控制面和所有管理级操作。

2. 核心原则

  1. 管理会话必须登记为正式 AI，并拥有自己的 ai-<name>/ 工作空间。
  2. 管理动作必须进入管理事项、计划、执行日志、变更记录或审计报告。
  3. 高风险管理动作必须由管理观察员审核。
  4. 管理观察员不得直接修改被审计的管理配置、计划、执行日志或变更记录。
  5. 管理体系的流程、校验和审核口径来自本目录 Markdown 文档，不由 MB-X 代码固化。
  6. MB-X 只提供 CLI、runtime、daemon、通信、session、skill context 和错误日志能力。
  7. 管理体系不得替代 project-* 子项目内部的项目体系、需求体系、开发体系、实验体系或案例分析体系。
  8. 管理根目录中的真实业务子项目应以 project- 开头，并使用独立 Git 仓库。
  9. 管理观察员审核管理管理员事项时，必须形成“管理审计报告 + MB-X 审核结果消息回告”双闭环；审计报告和消息互相引用。

3. 管理角色

3.1 管理管理员

管理管理员负责执行管理动作。

典型职责：

  1. 初始化 MB-X 管理根目录。
  2. 创建、刷新或修复 manage-doc/ 管理体系实例。
  3. 创建 project-* 子项目。
  4. 按文档启用子项目体系。
  5. 创建或调整角色、AI 工作空间和可见会话。
  6. 更新 MB-X 框架代码、安装包和内置 skill。
  7. 同步 mb-ms-doc 规范更新，并判断对当前工作区的影响。
  8. 处理 MB-X 框架错误日志中的管理级问题。
  9. 维护管理配置清单、管理事项、管理执行日志和管理变更记录。
  10. 接收并处理管理观察员的审核结果消息，按结论关闭、返修、升级或记录 blocked。

写权限：

  1. 管理根目录的管理体系实例文档。
  2. mbx.yaml、.mbx/ 等 MB-X 运行态配置。
  3. 按管理事项授权创建或维护的 project-* 子项目入口。
  4. 自己的 ai-<name>/ 工作空间。

3.2 管理观察员

管理观察员负责审核管理管理员。

典型职责：

  1. 审核管理事项计划是否合理。
  2. 审核管理动作是否按计划执行。
  3. 审核项目创建、体系启用、角色创建、会话创建、框架更新和规范同步是否留下证据链。
  4. 审核管理变更是否写入管理变更记录。
  5. 审核 MB-X 错误是否进入 MB-X错误日志.md 或管理问题记录。
  6. 对管理管理员的越权、遗漏、未记录或不一致问题提出返修。
  7. 反复返修或高风险问题需要升级给人类确认。
  8. 审核完成后，除写入 manage-doc/管理审计报告.md 外，还必须通过 MB-X 消息链向 management.admin 回告审核结果。

写权限：

  1. manage-doc/管理审计报告.md。
  2. manage-doc/管理问题记录.md 中的审计问题索引或观察员反馈。
  3. manage-doc/管理体系规范.md 中的审计章节或等价本地管理审核规范，仅限修正管理审核流程、审计口径和阻断标准。
  4. 自己的 ai-<name>/ 工作空间。

禁止：

  1. 直接修改被审计的管理配置清单。
  2. 直接改写管理管理员已经记录的执行日志或变更记录来掩盖问题。
  3. 无条件批准管理管理员自己的高风险动作。
  4. 用边角料问题阻断不影响证据链、权限、配置或结果的管理动作。
  5. 以管理观察员身份直接修改被审的管理执行规范、配置、计划、日志或主产物；如确需修改，应创建规范维护事项或由管理管理员授予明确维护角色。

4. 高风险管理动作

以下动作默认需要管理观察员审核：

  1. 初始化或重建管理根目录。
  2. 新建、删除、移动或重命名 project-* 子项目。
  3. 启用、停用或重建子项目体系。
  4. 新增、删除或调整角色、AI 工作空间、会话绑定、审核员身份或写权限。
  5. 更新 MB-X 框架代码、安装方式、内置 skill 或 provider 会话策略。
  6. 修改 mb-ms-doc 全局规范、体系规范、管理体系规范或项目创建指南。
  7. 清理、迁移或修复 .mbx/、mbx.yaml、mbx.project.yaml 等运行态事实源。
  8. 处理跨项目消息、跨项目角色协作或管理端转发规则。
  9. 删除、归档或批量 ack 消息、日志、错误记录或未读 inbox。

5. 管理事项流程

管理事项默认按以下流程执行：

用户或系统提出管理需求
-> 管理管理员登记管理事项总纲
-> 管理管理员编写管理事项计划
-> 高风险事项交给管理观察员做计划审计
-> 管理管理员执行
-> 管理管理员写管理执行日志
-> 如改变配置、角色、会话、目录、框架或规范，写管理变更记录
-> 管理观察员做执行审计
-> 管理观察员写管理审计报告，并向管理管理员发送审核结果消息
-> 管理管理员接收并处理审核结果消息
-> 如有问题，退回管理管理员修复
-> 修复后复审
-> 管理事项关闭，并回写管理事项总纲和计划

低风险动作可以合并计划和执行记录，但仍必须留下执行日志或变更记录。

6. 管理审计边界

管理观察员重点审计：

  1. 管理事项是否有来源、目标、边界和证据入口。
  2. 管理计划是否能满足管理目标。
  3. 管理动作是否按计划执行。
  4. 是否修改了应记录的配置、目录、角色、会话、框架或规范。
  5. 是否更新了管理配置清单和相关导读。
  6. 是否写入管理执行日志和管理变更记录。
  7. 是否存在未记录的管理动作。
  8. 是否存在越权写入、错误目录、绕过 project-* Git 边界或把运行态提交到模板仓库。
  9. MB-X 框架错误是否进入 MB-X错误日志.md。
  10. 管理动作是否污染业务子项目的正式体系账本。

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

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. 必须阻断的问题

以下问题必须阻断管理事项关闭：

  1. 管理会话没有登记为正式 AI。
  2. 管理管理员或管理观察员没有工作说明。
  3. 高风险管理动作没有计划、执行日志或审计结论。
  4. 项目、体系、角色、会话或框架更新改变了事实源，但没有写管理变更记录。
  5. 管理观察员和管理管理员职责混用，导致无人审核管理动作。
  6. 管理动作把 project-* 子项目提交到 mb-ms-doc 模板仓库。
  7. 管理动作绕过文档驱动口径，把流程、校验或审核规则固化为 MB-X 代码。
  8. 管理动作导致 mbx.yaml、mbx.project.yaml、消息 JSONL 或 inbox 无法解析。
  9. 关键审计证据路径不存在、乱码或不可读。
  10. 需要管理观察员审计的事项只有审计报告结论，没有审核结果消息回告，且没有记录 CLI / route 能力 blocked 与恢复路径。

8. 不应阻断的问题

以下问题通常不阻断管理事项关闭：

  1. 管理日志措辞可优化但不影响追溯。
  2. 非关键导读描述暂未细化。
  3. 后续才需要启用的业务体系没有创建。
  4. 低风险命令输出摘要不够详细，但能从日志和变更记录追踪到结果。

9. 完成标准

管理体系实例可用的最低标准：

  1. 管理根目录存在 manage-doc/。
  2. 管理配置清单、管理事项总纲、管理事项计划、管理执行日志、管理审计报告、管理问题记录、管理变更记录均存在。
  3. 管理管理员和管理观察员均登记在管理配置清单中。
  4. 管理管理员和管理观察员均拥有 ai-<name>/ 工作空间和 工作说明.md。
  5. 管理端真实会话绑定到管理管理员。
  6. 管理观察员能审核管理管理员的计划和执行。
  7. 管理动作能从管理事项总纲追到计划、执行日志、变更记录和审计报告。
  8. MB-X 框架错误有 MB-X错误日志.md 入口。
  9. 管理观察员审核结论能通过管理审计报告和 MB-X 审核结果消息双向追溯。