# 管理体系规范

创建人员：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 仓库。

## 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. 维护管理配置清单、管理事项、管理执行日志和管理变更记录。

写权限：

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. 反复返修或高风险问题需要升级给人类确认。

写权限：

1. `manage-doc/管理审计报告.md`。
2. `manage-doc/管理问题记录.md` 中的审计问题索引或观察员反馈。
3. 自己的 `ai-<name>/` 工作空间。

禁止：

1. 直接修改被审计的管理配置清单。
2. 直接改写管理管理员已经记录的执行日志或变更记录来掩盖问题。
3. 无条件批准管理管理员自己的高风险动作。
4. 用边角料问题阻断不影响证据链、权限、配置或结果的管理动作。

## 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. 管理事项流程

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

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

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

## 6. 管理审计边界

管理观察员重点审计：

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

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

## 7. 必须阻断的问题

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

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

## 8. 不应阻断的问题

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

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

## 9. 完成标准

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

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