mbx/mb-ms-doc.git

parent: 9c703f14 | patch | commit | ignore whitespace

cai

2026-06-06 37b9534c918fbefd0e4bf160c0baec8c76e9eb0e

补充 MB-X 管理体系规范模板

3 files modified

13 files added

	.gitignore	15 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/目录导读.md	40 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理事项总纲模版.md	55 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理事项计划模版.md	44 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理体系规范.md	166 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理变更记录模版.md	51 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理审计报告模版.md	65 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理执行日志模版.md	56 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理环境创建指南.md	117 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理管理员工作说明模版.md	73 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理观察员工作说明模版.md	83 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理配置清单模版.md	57 ●●●●● patch \| view \| raw \| blame \| history
	common/manage-doc/管理问题记录模版.md	48 ●●●●● patch \| view \| raw \| blame \| history
	体系说明.md	37 ●●●●● patch \| view \| raw \| blame \| history
	目录导读.md	7 ●●●●● patch \| view \| raw \| blame \| history
	管理系统说明.md	8 ●●●●● patch \| view \| raw \| blame \| history

 .gitignore

New file
@@ -0,0 +1,15 @@
# MB-X local runtime
mbx.yaml
mbx.yaml.bak
/.mbx/
管理端上下文.md
MB-X错误日志.md
/manage-doc/
/ai-*/
/work/
/project-*/
*/.mbx/
*/ai-*/
*/work/
~$*
~$$*.~vsdx

 common/manage-doc/目录导读.md

New file
@@ -0,0 +1,40 @@
# 管理体系目录导读

创建人员：Codex  
文件职责：记录 `common/manage-doc/` 下管理体系规范、模板和创建指南的作用。  
管理规范/模板：../../全局规范.md；../../管理系统说明.md；管理体系规范.md。  
引用文件：管理体系规范.md；管理环境创建指南.md。  
记录方式：维护型导读文档；本目录新增、删除、改名文件时同步更新。

## 1. 目录定位

本目录保存“管理体系”的公共规范和模板。

管理体系用于约束 MB-X 管理根目录中的管理会话、管理管理员和管理观察员，让创建项目、启用体系、创建角色、创建会话、更新 MB-X、修复框架问题等管理动作进入可追溯账本。

本目录只保存通用模板，不记录某个具体工作区的管理执行历史。具体工作区初始化后，应在管理根目录实例化 `manage-doc/` 和 `ai-<name>/`。

## 2. 文件清单

| 文件 | 作用 |
|---|---|
| `管理体系规范.md` | 定义管理体系定位、角色、权限、事项流程、审计边界和完成标准 |
| `管理环境创建指南.md` | 指导管理根目录如何实例化管理体系文档、管理角色和管理会话 |
| `管理配置清单模版.md` | 管理根目录运行态配置事实源模板 |
| `管理事项总纲模版.md` | 管理事项背景、目标、状态和结论账本模板 |
| `管理事项计划模版.md` | 管理事项步骤、执行人、输入输出和验收方式模板 |
| `管理执行日志模版.md` | 管理动作执行过程和结果日志模板 |
| `管理审计报告模版.md` | 管理观察员审计管理事项的报告模板 |
| `管理问题记录模版.md` | 非审计来源管理问题和跨轮问题索引模板 |
| `管理变更记录模版.md` | 管理根目录、MB-X 框架、角色、会话和规范变更记录模板 |
| `管理管理员工作说明模版.md` | 管理管理员会话入口卡模板 |
| `管理观察员工作说明模版.md` | 管理观察员会话入口卡模板 |

## 3. 使用口径

1. `mb-ms-doc` 作为 MB-X 管理根目录时，管理体系实例应直接创建在根目录下的 `manage-doc/`。
2. 管理会话必须登记为正式 AI，不得只作为 `mbx.yaml` 中的逻辑 session 存在。
3. 管理观察员必须独立于管理管理员，负责审核管理管理员的计划、执行、变更和修复。
4. 管理体系不替代业务子项目的项目体系；它管的是管理根目录和管理动作。
5. 管理体系的流程、校验和审核要求以本目录 Markdown 文档为准，不通过 MB-X 代码固化。


 common/manage-doc/管理事项总纲模版.md

New file
@@ -0,0 +1,55 @@
# 管理事项总纲

创建人员：<创建人员>  
文件职责：作为管理体系滚动账本，记录管理事项背景、目标、状态、来源聊天记录和当前结论。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理事项总纲模版.md。  
引用文件：管理配置清单.md；管理事项计划.md；管理执行日志.md；管理审计报告.md；管理问题记录.md；管理变更记录.md。  
记录方式：append-only 管理事项总纲；新增管理事项、状态变化或结论变化时追加。

## 1. 当前事项总览

| 字段 | 内容 |
|---|---|
| 管理根目录 ID | <WORKSPACE-ID> |
| 管理管理员 | <admin-name> |
| 管理观察员 | <observer-name> |
| 当前状态 | 未开始 / 进行中 / 待审 / 需修复 / 完成 / 暂停 / 取消 |
| 当前结论 | <当前能确认什么> |

## 2. 事项记录

### <YYYY-MM-DD HH:mm:ss> <MGMT-ITEM-ID>：<事项标题>

背景：  
<为什么要做这个管理事项>

来源聊天记录或上游依据：

```text
<关键来源聊天记录，或可追溯路径>
```

目标：

1. <目标 1>
2. <目标 2>

边界：

1. <本事项不做什么>

状态：  
未开始 / 进行中 / 待审 / 需修复 / 完成 / 暂停 / 取消

当前结论：  
<当前结论>

相关计划：  
<管理事项计划.md 中的 PLAN-ID>

相关执行日志：  
<管理执行日志.md 中的 LOG-ID>

审计入口：  
<管理审计报告.md 中的 AUDIT-ID>


 common/manage-doc/管理事项计划模版.md

New file
@@ -0,0 +1,44 @@
# 管理事项计划

创建人员：<创建人员>  
文件职责：记录管理事项的步骤、执行人员、输入输出、验收方式、风险和计划审计入口。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理事项计划模版.md。  
引用文件：管理事项总纲.md；管理执行日志.md；管理审计报告.md；管理变更记录.md；管理问题记录.md。  
记录方式：append-only 管理事项计划；新计划、新步骤或计划变化时追加。

## 1. 计划记录

### <YYYY-MM-DD HH:mm:ss> <PLAN-ID>：<计划标题>

关联事项：  
<MGMT-ITEM-ID>

计划类型：  
工作区初始化 / 项目创建 / 体系启用 / 角色调整 / 会话创建 / 框架更新 / 规范同步 / 错误修复 / 其他

执行人员：  
<管理管理员>

是否高风险：  
是 / 否

是否需要管理观察员计划审计：  
是 / 否

输入：

1. <输入文档、命令、上游要求>

步骤：

| 步骤 ID | 步骤名 | 执行人 | 输入 | 输出 | 验收方式 | 状态 |
|---|---|---|---|---|---|---|
| <STEP-ID> | <步骤名> | <执行人> | <输入> | <输出> | <验收方式> | 未开始 |

风险与回退：

1. <风险和回退方式>

计划审计入口：  
<管理审计报告.md 中的 AUDIT-ID>


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

New file
@@ -0,0 +1,166 @@
# 管理体系规范

创建人员：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` 入口。


 common/manage-doc/管理变更记录模版.md

New file
@@ -0,0 +1,51 @@
# 管理变更记录

创建人员：<创建人员>  
文件职责：记录管理根目录、管理体系、MB-X 框架、角色、会话、模板、规范和运行态事实源的管理级变更历史。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理变更记录模版.md。  
引用文件：管理配置清单.md；管理事项总纲.md；管理事项计划.md；管理执行日志.md；管理审计报告.md；管理问题记录.md。  
记录方式：append-only 管理变更记录；每次管理级变更追加到文件末尾。

## 1. 当前变更总览

| 变更 ID | 变更类型 | 变更对象 | 执行人 | 审计状态 | 时间 |
|---|---|---|---|---|---|
| <CHANGE-ID> | <类型> | <对象> | <执行人> | 待审 / 通过 / 不通过 | <YYYY-MM-DD HH:mm:ss> |

## 2. 变更记录

### <YYYY-MM-DD HH:mm:ss> <CHANGE-ID>：<变更标题>

变更类型：  
管理体系初始化 / 项目创建 / 体系启用 / 角色调整 / 会话绑定 / 框架更新 / skill 更新 / 规范同步 / 错误修复 / 其他

变更对象：  
<文件、目录、配置、角色、会话、框架模块或规范>

变更原因：  
<为什么要变更>

变更前：  
<变更前状态>

变更后：  
<变更后状态>

影响范围：  
<影响哪些管理能力、项目、角色、会话、技能或规范>

执行人员：  
<管理管理员>

关联事项 / 计划 / 日志：  
<MGMT-ITEM-ID / PLAN-ID / LOG-ID>

是否需要审计：  
是 / 否

审计入口：  
<管理审计报告.md 中的 AUDIT-ID>

当前状态：  
待审 / 已审计通过 / 需修复 / 已关闭


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

New file
@@ -0,0 +1,65 @@
# 管理审计报告

创建人员：<创建人员>  
文件职责：记录管理观察员对管理事项计划、执行、变更、框架更新、角色会话和管理错误修复的审计结论。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理审计报告模版.md。  
引用文件：管理配置清单.md；管理事项总纲.md；管理事项计划.md；管理执行日志.md；管理变更记录.md；管理问题记录.md；../MB-X错误日志.md。  
记录方式：append-only 管理审计报告；每次计划审计、执行审计、变更审计或复审追加。

## 1. 当前审计总览

| 审计 ID | 审计对象 | 审计类型 | 结论 | 时间 |
|---|---|---|---|---|
| <AUDIT-ID> | <对象> | 计划审计 / 执行审计 / 变更审计 / 复审 | 通过 / 不通过 / 暂缓 | <YYYY-MM-DD HH:mm:ss> |

## 2. 审计记录

### <YYYY-MM-DD HH:mm:ss> <AUDIT-ID>：<审计标题>

审核员：  
<管理观察员>

审计类型：  
计划审计 / 执行审计 / 变更审计 / 复审

审计对象：  
<MGMT-ITEM-ID / PLAN-ID / LOG-ID / CHANGE-ID / 错误日志 ID>

审计依据：

1. 管理体系规范.md
2. 管理事项计划.md
3. 管理执行日志.md
4. 管理变更记录.md
5. <其他证据入口>

审计范围：

1. <范围 1>

关键检查：

| 检查项 | 结论 | 证据 |
|---|---|---|
| 来源、目标和边界是否清楚 | 通过 / 不通过 / 不适用 | <证据> |
| 计划是否合理 | 通过 / 不通过 / 不适用 | <证据> |
| 执行是否按计划完成 | 通过 / 不通过 / 不适用 | <证据> |
| 配置、角色、会话或规范变化是否写变更记录 | 通过 / 不通过 / 不适用 | <证据> |
| 框架错误是否写入 MB-X错误日志.md | 通过 / 不通过 / 不适用 | <证据> |
| 是否存在越权或未记录动作 | 通过 / 不通过 / 不适用 | <证据> |

问题清单：

| 问题 ID | 严重级别 | 问题 | 影响 | 修复建议 | 是否阻断 |
|---|---|---|---|---|---|
| <ISSUE-ID> | P0/P1/P2/P3 | <问题> | <影响> | <建议> | 是 / 否 |

审计结论：  
通过 / 不通过 / 暂缓

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

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


 common/manage-doc/管理执行日志模版.md

New file
@@ -0,0 +1,56 @@
# 管理执行日志

创建人员：<创建人员>  
文件职责：记录管理管理员执行管理事项、管理命令、目录调整、配置调整、框架更新和问题修复的过程。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理执行日志模版.md。  
引用文件：管理事项总纲.md；管理事项计划.md；管理配置清单.md；管理审计报告.md；管理变更记录.md；管理问题记录.md；../MB-X错误日志.md。  
记录方式：append-only 管理执行日志；每次管理动作追加到文件末尾。

## 1. 日志记录

### <YYYY-MM-DD HH:mm:ss> <LOG-ID>：<动作标题>

关联事项：  
<MGMT-ITEM-ID>

关联计划：  
<PLAN-ID>

执行人员：  
<管理管理员>

动作类型：  
工作区初始化 / 项目创建 / 体系启用 / 角色调整 / 会话创建 / 框架更新 / 规范同步 / 错误修复 / 其他

执行目标：  
<本次动作要完成什么>

执行过程：

1. <关键步骤 1>
2. <关键步骤 2>

使用命令或 skill：  
<命令、skill 名称、关键参数摘要>

关键输入：  
<输入文档、模板、上游要求>

关键输出：  
<创建或修改的文件、目录、配置、会话 ID、日志路径>

自检结果：  
<路径、配置、日志、权限、引用和消息链检查结果>

异常 / 偏离：  
<如无写“无”；框架错误同时写 MB-X错误日志.md>

当前状态：  
完成 / 部分完成 / 失败 / 暂停

结论回写：  
<是否已回写管理事项总纲、计划或配置清单>

审计入口：  
<管理审计报告.md 中的 AUDIT-ID>


 common/manage-doc/管理环境创建指南.md

New file
@@ -0,0 +1,117 @@
# 管理环境创建指南

创建人员：Codex  
文件职责：指导 MB-X 管理根目录初始化管理体系实例、管理角色、管理会话和管理审计入口。  
管理规范/模板：../../全局规范.md；../../管理系统说明.md；管理体系规范.md。  
引用文件：管理配置清单模版.md；管理事项总纲模版.md；管理事项计划模版.md；管理执行日志模版.md；管理审计报告模版.md；管理问题记录模版.md；管理变更记录模版.md；管理管理员工作说明模版.md；管理观察员工作说明模版.md；../ai-workplace/AI工作空间创建指南.md。  
记录方式：创建指南；管理体系初始化、角色或校验口径变化时更新。

## 1. 使用场景

当 `mb-ms-doc` 或兼容目录作为 MB-X 管理根目录时，必须按本指南创建管理体系实例。

管理体系实例用于纳管管理会话。它不是 `project-*` 子项目，不使用业务子项目的独立 Git 仓库；它属于管理根目录的运行治理层。

## 2. 输入

初始化前必须明确：

1. 管理根目录。
2. 管理管理员 AI 名称。
3. 管理观察员 AI 名称。
4. 管理端真实会话是否立即创建。
5. 是否已有 `mbx.yaml`。
6. 是否已有 `MB-X错误日志.md`。
7. 当前 MB-X 源码仓库路径。
8. 当前 `mb-ms-doc` 规范仓库路径。

## 3. 创建目录

在管理根目录创建：

```text
manage-doc/
ai-<admin-name>/
ai-<observer-name>/
```

管理角色工作空间内部按 AI 工作空间规范创建：

```text
ai-<name>/tmp/
ai-<name>/draft/
ai-<name>/worklog/
ai-<name>/工作说明.md
ai-<name>/项目问题反馈.md
```

## 4. 创建管理体系文档

从本目录模板创建到管理根目录 `manage-doc/`：

1. `管理配置清单.md`
2. `管理事项总纲.md`
3. `管理事项计划.md`
4. `管理执行日志.md`
5. `管理审计报告.md`
6. `管理问题记录.md`
7. `管理变更记录.md`

管理根目录如果已经存在 `MB-X错误日志.md`，应在 `管理配置清单.md` 中登记该入口；如果不存在，应创建。

## 5. 登记管理角色

管理配置清单中至少登记：

| AI | 角色 | 工作空间 | 审计入口 |
|---|---|---|---|
| `<admin-name>` | 管理管理员 | `ai-<admin-name>/` | 管理审计报告.md |
| `<observer-name>` | 管理观察员 | `ai-<observer-name>/` | 管理审计报告.md |

管理管理员绑定管理端真实会话。管理观察员可以独立创建会话，也可以先登记为待创建。

## 6. 初始化工作说明

管理管理员使用 `管理管理员工作说明模版.md` 创建 `ai-<admin-name>/工作说明.md`。

管理观察员使用 `管理观察员工作说明模版.md` 创建 `ai-<observer-name>/工作说明.md`。

工作说明只写入口和边界，不复制管理体系规范正文。管理体系规范更新后，管理角色应重新读取 `manage-doc/管理体系规范.md`。

## 7. 初始化管理事项

初始化管理体系本身也是管理事项。必须在以下文件中记录：

1. `管理事项总纲.md`：记录为什么要纳管管理会话、目标和边界。
2. `管理事项计划.md`：记录创建目录、复制模板、登记角色、创建会话、校验和审计步骤。
3. `管理执行日志.md`：记录实际创建了哪些目录和文件。
4. `管理变更记录.md`：记录管理体系从无到有的治理结构变化。
5. `管理审计报告.md`：由管理观察员审计初始化计划和执行结果；没有独立观察员时，应标记为“待独立观察员复审”。

## 8. 校验方案

管理体系初始化完成后，检查：

1. `manage-doc/` 存在。
2. 管理七本账都存在。
3. 管理管理员和管理观察员均在管理配置清单中登记。
4. 管理管理员工作空间和管理观察员工作空间均存在。
5. 两个工作空间均有 `工作说明.md` 和 `项目问题反馈.md`。
6. 管理端真实会话绑定到管理管理员，或明确登记为待创建。
7. `MB-X错误日志.md` 入口存在。
8. 初始化事项能从管理事项总纲追到计划、执行日志、变更记录和审计报告。
9. `project-*` 子项目没有被纳入 `mb-ms-doc` 模板仓库提交。
10. 管理观察员没有直接修改管理管理员产物。

## 9. 完成汇报

管理体系创建完成后，应向人类汇报：

1. 管理根目录。
2. 管理体系实例目录。
3. 管理管理员 AI 和会话状态。
4. 管理观察员 AI 和会话状态。
5. 已创建管理账本。
6. 初始化审计结论。
7. 待补或待复审事项。


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

New file
@@ -0,0 +1,73 @@
# <AI_DISPLAY_NAME> 工作说明

创建人员：<创建人员>  
文件职责：记录管理管理员在 MB-X 管理根目录中的职责边界、权限范围、必读文档、管理动作入口和审计要求。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理管理员工作说明模版.md；../common/ai-workplace/AI工作空间创建指南.md。  
引用文件：manage-doc/管理配置清单.md；manage-doc/管理事项总纲.md；manage-doc/管理事项计划.md；manage-doc/管理执行日志.md；manage-doc/管理审计报告.md；manage-doc/管理变更记录.md；MB-X错误日志.md。  
记录方式：当前角色入口说明；管理角色、权限、会话或入口变化时覆盖更新，并在管理变更记录中保留历史。

## 1. 基本信息

| 字段 | 内容 |
|---|---|
| AI 名称 | <AI_NAME> |
| 显示名称 | <AI_DISPLAY_NAME> |
| 管理角色 | 管理管理员 |
| 工作空间 | ai-<AI_NAME>/ |
| 指派人 | <ASSIGNED_BY> |
| 指派时间 | <YYYY-MM-DD HH:mm:ss> |
| 真实会话 ID | <session-id 或待创建> |

## 2. 职责边界

管理管理员负责执行管理动作，包括工作区初始化、项目创建、体系启用、角色创建、会话创建、MB-X 更新、skill 同步、框架错误修复和管理配置维护。

管理管理员不直接替代业务子项目的产品、开发、实验、案例分析或审核角色。

## 3. 必读文档

1. `manage-doc/管理配置清单.md`
2. `manage-doc/管理体系规范.md`
3. `manage-doc/管理事项总纲.md`
4. `manage-doc/管理事项计划.md`
5. `manage-doc/管理执行日志.md`
6. `manage-doc/管理审计报告.md`
7. `manage-doc/管理变更记录.md`
8. `MB-X错误日志.md`
9. `common/project-doc/项目环境创建指南.md`
10. `common/ai-workplace/AI工作空间创建指南.md`
11. 当前任务涉及的体系文档和 MB-X 通信文档。

## 4. 操作规则

1. 接到管理需求后，先判断是否需要登记管理事项。
2. 高风险动作先写计划，并提交管理观察员审计。
3. 执行动作后写管理执行日志。
4. 改变配置、角色、会话、目录、框架或规范时写管理变更记录。
5. 框架层错误写入 `MB-X错误日志.md`。
6. 不把业务流程、校验或审核规则固化进 MB-X 代码。
7. 不把 `project-*` 子项目提交到 `mb-ms-doc` 模板仓库。

## 5. 可用技能

1. `mbx-management-control`
2. `mbx-framework-update`
3. `mbx-project-setup`
4. `mbx-ai-workspace`
5. `mbx-file-governance`
6. `mbx-governance`
7. `mbx-human-workflow`
8. `mbx-interaction-router`

## 6. 审计边界

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

## 7. 禁止事项

1. 不得绕过管理事项账本执行高风险管理动作。
2. 不得直接修改管理观察员的审计结论。
3. 不得用聊天记录替代管理执行日志。
4. 不得把框架错误写成业务问题来隐藏。
5. 不得把业务子项目私有内容写入公共模板。


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

New file
@@ -0,0 +1,83 @@
# <AI_DISPLAY_NAME> 工作说明

创建人员：<创建人员>  
文件职责：记录管理观察员在 MB-X 管理根目录中的审核职责、权限边界、必读文档和反馈方式。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理观察员工作说明模版.md；../common/ai-workplace/AI工作空间创建指南.md。  
引用文件：manage-doc/管理配置清单.md；manage-doc/管理事项总纲.md；manage-doc/管理事项计划.md；manage-doc/管理执行日志.md；manage-doc/管理审计报告.md；manage-doc/管理问题记录.md；manage-doc/管理变更记录.md；MB-X错误日志.md。  
记录方式：当前角色入口说明；管理观察员角色、权限、会话或入口变化时覆盖更新，并在管理变更记录中保留历史。

## 1. 基本信息

| 字段 | 内容 |
|---|---|
| AI 名称 | <AI_NAME> |
| 显示名称 | <AI_DISPLAY_NAME> |
| 管理角色 | 管理观察员 |
| 工作空间 | ai-<AI_NAME>/ |
| 指派人 | <ASSIGNED_BY> |
| 指派时间 | <YYYY-MM-DD HH:mm:ss> |
| 真实会话 ID | <session-id 或待创建> |

## 2. 职责边界

管理观察员负责审核管理管理员的计划、执行、变更、角色会话调整、MB-X 更新、规范同步和错误修复。

管理观察员不直接执行被审计的管理动作，不直接修改管理管理员产出的配置、执行日志和变更记录。

## 3. 必读文档

1. `manage-doc/管理体系规范.md`
2. `manage-doc/管理配置清单.md`
3. `manage-doc/管理事项总纲.md`
4. `manage-doc/管理事项计划.md`
5. `manage-doc/管理执行日志.md`
6. `manage-doc/管理变更记录.md`
7. `manage-doc/管理审计报告.md`
8. `manage-doc/管理问题记录.md`
9. `MB-X错误日志.md`
10. 被审管理动作涉及的项目、体系、角色或框架文档。

## 4. 审计规则

1. 审计以管理事项为单元。
2. 计划审计重点看目标、边界、步骤、输入输出和风险是否清楚。
3. 执行审计重点看是否按计划执行，证据链是否闭合。
4. 变更审计重点看配置、角色、会话、框架或规范变化是否记录完整。
5. 框架错误修复审计重点看错误是否进入 `MB-X错误日志.md`，修复是否可复验。
6. 只阻断影响权限、配置、证据链、运行态、项目边界或后续可追溯性的问题。

## 5. 可用技能

1. `mbx-governance`
2. `mbx-file-governance`
3. `mbx-human-workflow`
4. `mbx-interaction-router`

## 6. 输出入口

审计结论写入：

```text
manage-doc/管理审计报告.md
```

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

```text
manage-doc/管理问题记录.md
```

私有过程记录写入：

```text
ai-<AI_NAME>/worklog/
```

## 7. 禁止事项

1. 不得直接修改被审计主产物来代替反馈。
2. 不得无条件通过管理管理员自己的高风险动作。
3. 不得把格式小问题升级为阻断。
4. 不得替业务子项目审核员审核专业业务产物。
5. 不得把审计结论只留在聊天窗口中。


 common/manage-doc/管理配置清单模版.md

New file
@@ -0,0 +1,57 @@
# 管理配置清单

创建人员：<创建人员>  
文件职责：记录 MB-X 管理根目录当前管理角色、管理会话、管理体系文档、框架入口、模板仓库和运行态事实，是管理体系当前配置事实源。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理配置清单模版.md。  
引用文件：管理事项总纲.md；管理事项计划.md；管理执行日志.md；管理审计报告.md；管理问题记录.md；管理变更记录.md；../mbx.yaml；../MB-X错误日志.md。  
记录方式：管理配置清单；当前状态可覆盖更新，历史和原因写入管理变更记录.md 与管理执行日志.md。

## 1. 管理根目录

| 字段 | 内容 |
|---|---|
| 管理根目录名称 | <名称> |
| 管理根目录 ID | <WORKSPACE-ID> |
| 管理根目录路径 | <相对路径或说明> |
| MB-X 源码入口 | <mb-x 仓库路径或远端> |
| mb-ms-doc 规范入口 | <mb-ms-doc 仓库路径或远端> |
| 当前状态 | 未开始 / 进行中 / 暂停 / 完成 / 取消 |

## 2. 管理角色与会话

| AI 名称 | 角色 | 工作空间 | 真实会话 ID | 默认写权限范围 | 审计入口 | 状态 |
|---|---|---|---|---|---|---|
| <admin-name> | 管理管理员 | ai-<admin-name>/ | <session-id 或 待创建> | 管理根目录治理文档；MB-X 运行态；按事项授权的 project-* 入口 | 管理审计报告.md | active / pending |
| <observer-name> | 管理观察员 | ai-<observer-name>/ | <session-id 或 待创建> | 管理审计报告.md；管理问题记录.md；自身工作空间 | 管理审计报告.md | active / pending |

## 3. 管理文档入口

| 文档 | 作用 | 状态 |
|---|---|---|
| manage-doc/管理配置清单.md | 管理配置事实源 | 已创建 / 未创建 |
| manage-doc/管理事项总纲.md | 管理事项总账本 | 已创建 / 未创建 |
| manage-doc/管理事项计划.md | 管理事项计划账本 | 已创建 / 未创建 |
| manage-doc/管理执行日志.md | 管理动作执行日志 | 已创建 / 未创建 |
| manage-doc/管理审计报告.md | 管理观察员审计报告 | 已创建 / 未创建 |
| manage-doc/管理问题记录.md | 管理级问题记录和审计问题索引 | 已创建 / 未创建 |
| manage-doc/管理变更记录.md | 管理级变更历史 | 已创建 / 未创建 |
| MB-X错误日志.md | MB-X 框架层错误日志 | 已创建 / 未创建 |

## 4. 管理能力入口

| 能力 | 入口 | 备注 |
|---|---|---|
| 创建工作区 | mbx init；mbx-management-control | 需按管理体系记录 |
| 创建子项目 | mbx project create；mbx-project-setup | 子项目使用 project-* 和独立 Git |
| 启用体系 | mbx system enable；对应体系 skill | 文档驱动 |
| 创建角色和 AI 工作空间 | mbx role create；mbx-ai-workspace | 同步工作说明 |
| 创建会话 | mbx session create | 真实会话 ID 回写配置 |
| 更新 MB-X | mbx-framework-update | 高风险，需观察员审计 |
| 通信和 inbox | mbx send；mbx inbox；mbx-human-workflow | 失败写 MB-X错误日志 |

## 5. 变更索引

| 时间 | 变更记录 ID | 变更摘要 | 执行人 | 审计状态 |
|---|---|---|---|---|
| <YYYY-MM-DD HH:mm:ss> | <CHANGE-ID> | 初始化管理配置清单 | <创建人员> | 待审 / 通过 |


 common/manage-doc/管理问题记录模版.md

New file
@@ -0,0 +1,48 @@
# 管理问题记录

创建人员：<创建人员>  
文件职责：记录非审计来源的管理级问题、跨轮管理问题索引、反复返修问题和需要人类介入的管理阻塞。  
管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理问题记录模版.md。  
引用文件：管理事项总纲.md；管理事项计划.md；管理执行日志.md；管理审计报告.md；管理变更记录.md；../MB-X错误日志.md。  
记录方式：append-only 管理问题记录；新增问题、状态变化、复验结论时追加。

## 1. 当前问题总览

| 问题 ID | 类型 | 严重级别 | 状态 | 责任方 | 关联审计 |
|---|---|---|---|---|---|
| <ISSUE-ID> | 配置 / 权限 / 会话 / 框架 / 规范 / 流程 / 其他 | P0/P1/P2/P3 | 未处理 / 处理中 / 待复验 / 已关闭 | <责任方> | <AUDIT-ID> |

## 2. 问题记录

### <YYYY-MM-DD HH:mm:ss> <ISSUE-ID>：<问题标题>

问题来源：  
非审计发现 / 审计索引 / 管理观察员反馈 / MB-X错误日志 / 人类反馈

关联事项：  
<MGMT-ITEM-ID>

关联日志或变更：  
<LOG-ID / CHANGE-ID>

问题描述：  
<问题是什么>

证据入口：  
<文件、日志、命令输出摘要或消息 ID>

影响范围：  
<影响哪些管理能力、项目、角色、会话或框架功能>

严重级别：  
P0 / P1 / P2 / P3

修复建议：  
<建议怎么修>

当前状态：  
未处理 / 处理中 / 待复验 / 已关闭

复验结论：  
<复验结果>


 体系说明.md

@@ -32,6 +32,7 @@
4. 审核体系。
5. 数据存储体系。
6. 作业方法论体系。
7. 管理体系。

这些部分不是彼此独立的。一个事项从开始到结束，会同时经过文档、执行、数据、审计和归档。

@@ -223,8 +224,32 @@
6. `project-doc/`：项目规范和项目创建模板，包括项目规范、项目配置清单、项目事项总纲、项目事项计划、项目执行日志、项目事项审计报告、项目问题记录、项目变更记录。
7. `全局规范.md`：所有 AI 都必须遵守的全局规则。
8. `体系创建流程.md`：创建新体系时使用的通用流程和完成标准。
9. `manage-doc/`：管理体系规范和模板，用于约束 MB-X 管理根目录、管理会话、管理管理员、管理观察员和管理级事项。

公共规范应尽量通用，不绑定某一个具体项目。

### 11.0 管理事项

管理事项是一种管理根目录事项。

管理事项用于记录和审计管理会话执行的工作区初始化、项目创建、体系启用、角色创建、会话创建、MB-X 框架更新、skill 同步、规范同步、通信框架修复和错误处理。

管理事项必须至少包含：

1. `管理配置清单`：记录管理角色、管理会话、管理体系文档、MB-X 框架入口和模板仓库入口。
2. `管理事项总纲`：记录管理事项的来源、目标、状态和当前结论。
3. `管理事项计划`：记录管理步骤、输入输出、验收方式和计划审计入口。
4. `管理执行日志`：记录管理管理员实际执行过程。
5. `管理审计报告`：记录管理观察员对计划、执行、变更和复审的结论。
6. `管理问题记录`：记录非审计来源管理问题和跨轮管理问题索引。
7. `管理变更记录`：记录管理级配置、角色、会话、框架、规范和运行态事实源变化。

管理体系至少包含两个角色：

1. 管理管理员：负责执行管理动作。
2. 管理观察员：负责审核管理管理员，不直接修改被审管理产物。

管理体系不替代业务子项目的项目体系。它管的是 `mb-ms-doc` 管理根目录和 MB-X 控制面，业务子项目仍使用自己的项目体系和专业体系。

### 11.1 实验事项

@@ -437,6 +462,18 @@
54. `ana-doc/案例审核规范.md`
55. `ana-doc/案例审计报告模版.md`
56. `ana-doc/案例问题记录模版.md`
57. `manage-doc/目录导读.md`
58. `manage-doc/管理体系规范.md`
59. `manage-doc/管理环境创建指南.md`
60. `manage-doc/管理配置清单模版.md`
61. `manage-doc/管理事项总纲模版.md`
62. `manage-doc/管理事项计划模版.md`
63. `manage-doc/管理执行日志模版.md`
64. `manage-doc/管理审计报告模版.md`
65. `manage-doc/管理问题记录模版.md`
66. `manage-doc/管理变更记录模版.md`
67. `manage-doc/管理管理员工作说明模版.md`
68. `manage-doc/管理观察员工作说明模版.md`

实验体系不再强制提供实验导读模板；项目实验入口由项目总索引或 `实验总纲.md` 承担。项目默认不创建单实验独立总纲、独立设计或独立执行日志文件，而是追加到项目级三本账本。


 目录导读.md

@@ -12,6 +12,7 @@
|---|---|
| `common/` | 全局通用规范、模板和体系组件 |
| `data/` | 全局统一数据源或数据索引材料 |
| `manage-doc/` | MB-X 管理根目录实例化后的管理体系账本目录；由 `common/manage-doc/` 模板创建 |
| `project A/` | 项目 A 工作目录 |
| `project B/` | 项目 B 工作目录 |
| `project C/` | 项目 C 工作目录 |
@@ -29,3 +30,9 @@
| `AI管理体系建议.md` | AI 管理体系建议沉淀 |
| `全局存储体系.md` | 全局数据源、公共表边界和使用规范 |
| `全局数据格式.md` | 全局公共表和文件型数据的字段级 schema |

## common 关键目录

| 目录 | 作用 |
|---|---|
| `common/manage-doc/` | 管理体系公共规范和模板，用于纳管管理会话、管理管理员、管理观察员和管理级操作 |

 管理系统说明.md

@@ -42,6 +42,8 @@
5. 项目管理员：绑定路径项目根目录/
6. 审核员：审核员必须是对应上面的角色之一的审核员，不绑定任何目录，只能写对应的审核体系的审核报告.md。比如说需求审计员那只能写 /pro-doc/需求审计报告.md ，比如需求开发审核员只能写
/dev-doc/pro-doc/开发审计报告.md
7. 管理管理员：绑定路径管理根目录和 manage-doc/，负责创建项目、启用体系、创建角色、创建会话、更新 MB-X、同步技能和修复框架问题；必须写入管理事项、管理执行日志和管理变更记录。
8. 管理观察员：管理管理员的审核员，只能写 manage-doc/管理审计报告.md、manage-doc/管理问题记录.md 和自己的 AI 工作空间；不得直接修改被审计的管理配置、执行日志和变更记录。


#### AI工作空间管理
@@ -99,6 +101,7 @@
5.案例分析的文档存放在ana-doc文件夹比如：
ana-doc/案例分析规范.md
6.全局规范.md 该文件负责存储所有全局规范和全局约定，所有 AI 都应该遵守该文档
7.manage-doc 存放管理体系规范和模板，用于约束管理根目录中的管理会话、管理管理员、管理观察员和管理级事项。


### 项目文件夹
@@ -177,6 +180,9 @@
3. 实验体系
4. 案例分析体系
5. 项目体系
6. 管理体系

管理体系是 MB-X 管理根目录的体系，不是业务子项目体系。它用于纳管管理会话：管理管理员负责执行管理动作，管理观察员负责审核管理管理员。管理体系公共规范和模板放在 `common/manage-doc/`；实例化后的管理账本放在管理根目录 `manage-doc/`。

### 体系组件

@@ -278,6 +284,8 @@
9. 代码审核技能（包括编码方案设计到代码书写的审核）;（属于common\dev-doc\开发审计规范.md 以及 项目本地 dev-doc\开发审计规范.md 两个共同作用的技能 )
10. 案例分析技能（包括案例分析设计，案例分析全流程）;（属于common\ana-doc\案例分析规范.md 以及 项目本地 ana-doc\案例分析规范.md 两个共同作用的技能 )
11. 案例分析审核技能（包括案例分析设计，案例分析全流程审计）;（属于common\ana-doc\案例审核规范.md 以及 项目本地 ana-doc\案例审核规范.md 两个共同作用的技能 )
12. 管理体系创建和管理控制技能（包括管理根目录初始化、项目创建、体系启用、角色创建、会话创建、MB-X 更新和 skill 同步）;（属于common\manage-doc\管理体系规范.md、common\manage-doc\管理环境创建指南.md 与 MB-X 管理类 skill 共同作用的技能 )
13. 管理观察审核技能（包括管理事项计划审核、执行审核、变更审核、框架更新审核和复审）;（属于common\manage-doc\管理体系规范.md、common\manage-doc\管理审计报告模版.md 与管理观察员工作说明共同作用的技能 )

## 体系特殊说明
实验体系目前固定成如下：

New file
			@@ -0,0 +1,15 @@
			# MB-X local runtime
			mbx.yaml
			mbx.yaml.bak
			/.mbx/
			管理端上下文.md
			MB-X错误日志.md
			/manage-doc/
			/ai-*/
			/work/
			/project-*/
			*/.mbx/
			/ai-/
			*/work/
			~$*
			~$$*.~vsdx

New file
			@@ -0,0 +1,40 @@
			# 管理体系目录导读

			创建人员：Codex
			文件职责：记录 `common/manage-doc/` 下管理体系规范、模板和创建指南的作用。
			管理规范/模板：../../全局规范.md；../../管理系统说明.md；管理体系规范.md。
			引用文件：管理体系规范.md；管理环境创建指南.md。
			记录方式：维护型导读文档；本目录新增、删除、改名文件时同步更新。

			## 1. 目录定位

			本目录保存“管理体系”的公共规范和模板。

			管理体系用于约束 MB-X 管理根目录中的管理会话、管理管理员和管理观察员，让创建项目、启用体系、创建角色、创建会话、更新 MB-X、修复框架问题等管理动作进入可追溯账本。

			本目录只保存通用模板，不记录某个具体工作区的管理执行历史。具体工作区初始化后，应在管理根目录实例化 `manage-doc/` 和 `ai-<name>/`。

			## 2. 文件清单

			\| 文件 \| 作用 \|
			\|---\|---\|
			\| `管理体系规范.md` \| 定义管理体系定位、角色、权限、事项流程、审计边界和完成标准 \|
			\| `管理环境创建指南.md` \| 指导管理根目录如何实例化管理体系文档、管理角色和管理会话 \|
			\| `管理配置清单模版.md` \| 管理根目录运行态配置事实源模板 \|
			\| `管理事项总纲模版.md` \| 管理事项背景、目标、状态和结论账本模板 \|
			\| `管理事项计划模版.md` \| 管理事项步骤、执行人、输入输出和验收方式模板 \|
			\| `管理执行日志模版.md` \| 管理动作执行过程和结果日志模板 \|
			\| `管理审计报告模版.md` \| 管理观察员审计管理事项的报告模板 \|
			\| `管理问题记录模版.md` \| 非审计来源管理问题和跨轮问题索引模板 \|
			\| `管理变更记录模版.md` \| 管理根目录、MB-X 框架、角色、会话和规范变更记录模板 \|
			\| `管理管理员工作说明模版.md` \| 管理管理员会话入口卡模板 \|
			\| `管理观察员工作说明模版.md` \| 管理观察员会话入口卡模板 \|

			## 3. 使用口径

			1. `mb-ms-doc` 作为 MB-X 管理根目录时，管理体系实例应直接创建在根目录下的 `manage-doc/`。
			2. 管理会话必须登记为正式 AI，不得只作为 `mbx.yaml` 中的逻辑 session 存在。
			3. 管理观察员必须独立于管理管理员，负责审核管理管理员的计划、执行、变更和修复。
			4. 管理体系不替代业务子项目的项目体系；它管的是管理根目录和管理动作。
			5. 管理体系的流程、校验和审核要求以本目录 Markdown 文档为准，不通过 MB-X 代码固化。

New file
			@@ -0,0 +1,55 @@
			# 管理事项总纲

			创建人员：<创建人员>
			文件职责：作为管理体系滚动账本，记录管理事项背景、目标、状态、来源聊天记录和当前结论。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理事项总纲模版.md。
			引用文件：管理配置清单.md；管理事项计划.md；管理执行日志.md；管理审计报告.md；管理问题记录.md；管理变更记录.md。
			记录方式：append-only 管理事项总纲；新增管理事项、状态变化或结论变化时追加。

			## 1. 当前事项总览

			\| 字段 \| 内容 \|
			\|---\|---\|
			\| 管理根目录 ID \| <WORKSPACE-ID> \|
			\| 管理管理员 \| <admin-name> \|
			\| 管理观察员 \| <observer-name> \|
			\| 当前状态 \| 未开始 / 进行中 / 待审 / 需修复 / 完成 / 暂停 / 取消 \|
			\| 当前结论 \| <当前能确认什么> \|

			## 2. 事项记录

			### <YYYY-MM-DD HH:mm:ss> <MGMT-ITEM-ID>：<事项标题>

			背景：
			<为什么要做这个管理事项>

			来源聊天记录或上游依据：

			```text
			<关键来源聊天记录，或可追溯路径>
			```

			目标：

			1. <目标 1>
			2. <目标 2>

			边界：

			1. <本事项不做什么>

			状态：
			未开始 / 进行中 / 待审 / 需修复 / 完成 / 暂停 / 取消

			当前结论：
			<当前结论>

			相关计划：
			<管理事项计划.md 中的 PLAN-ID>

			相关执行日志：
			<管理执行日志.md 中的 LOG-ID>

			审计入口：
			<管理审计报告.md 中的 AUDIT-ID>

New file
			@@ -0,0 +1,44 @@
			# 管理事项计划

			创建人员：<创建人员>
			文件职责：记录管理事项的步骤、执行人员、输入输出、验收方式、风险和计划审计入口。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理事项计划模版.md。
			引用文件：管理事项总纲.md；管理执行日志.md；管理审计报告.md；管理变更记录.md；管理问题记录.md。
			记录方式：append-only 管理事项计划；新计划、新步骤或计划变化时追加。

			## 1. 计划记录

			### <YYYY-MM-DD HH:mm:ss> <PLAN-ID>：<计划标题>

			关联事项：
			<MGMT-ITEM-ID>

			计划类型：
			工作区初始化 / 项目创建 / 体系启用 / 角色调整 / 会话创建 / 框架更新 / 规范同步 / 错误修复 / 其他

			执行人员：
			<管理管理员>

			是否高风险：
			是 / 否

			是否需要管理观察员计划审计：
			是 / 否

			输入：

			1. <输入文档、命令、上游要求>

			步骤：

			\| 步骤 ID \| 步骤名 \| 执行人 \| 输入 \| 输出 \| 验收方式 \| 状态 \|
			\|---\|---\|---\|---\|---\|---\|---\|
			\| <STEP-ID> \| <步骤名> \| <执行人> \| <输入> \| <输出> \| <验收方式> \| 未开始 \|

			风险与回退：

			1. <风险和回退方式>

			计划审计入口：
			<管理审计报告.md 中的 AUDIT-ID>

New file
			@@ -0,0 +1,166 @@
			# 管理体系规范

			创建人员：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` 入口。

New file
			@@ -0,0 +1,51 @@
			# 管理变更记录

			创建人员：<创建人员>
			文件职责：记录管理根目录、管理体系、MB-X 框架、角色、会话、模板、规范和运行态事实源的管理级变更历史。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理变更记录模版.md。
			引用文件：管理配置清单.md；管理事项总纲.md；管理事项计划.md；管理执行日志.md；管理审计报告.md；管理问题记录.md。
			记录方式：append-only 管理变更记录；每次管理级变更追加到文件末尾。

			## 1. 当前变更总览

			\| 变更 ID \| 变更类型 \| 变更对象 \| 执行人 \| 审计状态 \| 时间 \|
			\|---\|---\|---\|---\|---\|---\|
			\| <CHANGE-ID> \| <类型> \| <对象> \| <执行人> \| 待审 / 通过 / 不通过 \| <YYYY-MM-DD HH:mm:ss> \|

			## 2. 变更记录

			### <YYYY-MM-DD HH:mm:ss> <CHANGE-ID>：<变更标题>

			变更类型：
			管理体系初始化 / 项目创建 / 体系启用 / 角色调整 / 会话绑定 / 框架更新 / skill 更新 / 规范同步 / 错误修复 / 其他

			变更对象：
			<文件、目录、配置、角色、会话、框架模块或规范>

			变更原因：
			<为什么要变更>

			变更前：
			<变更前状态>

			变更后：
			<变更后状态>

			影响范围：
			<影响哪些管理能力、项目、角色、会话、技能或规范>

			执行人员：
			<管理管理员>

			关联事项 / 计划 / 日志：
			<MGMT-ITEM-ID / PLAN-ID / LOG-ID>

			是否需要审计：
			是 / 否

			审计入口：
			<管理审计报告.md 中的 AUDIT-ID>

			当前状态：
			待审 / 已审计通过 / 需修复 / 已关闭

New file
			@@ -0,0 +1,65 @@
			# 管理审计报告

			创建人员：<创建人员>
			文件职责：记录管理观察员对管理事项计划、执行、变更、框架更新、角色会话和管理错误修复的审计结论。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理审计报告模版.md。
			引用文件：管理配置清单.md；管理事项总纲.md；管理事项计划.md；管理执行日志.md；管理变更记录.md；管理问题记录.md；../MB-X错误日志.md。
			记录方式：append-only 管理审计报告；每次计划审计、执行审计、变更审计或复审追加。

			## 1. 当前审计总览

			\| 审计 ID \| 审计对象 \| 审计类型 \| 结论 \| 时间 \|
			\|---\|---\|---\|---\|---\|
			\| <AUDIT-ID> \| <对象> \| 计划审计 / 执行审计 / 变更审计 / 复审 \| 通过 / 不通过 / 暂缓 \| <YYYY-MM-DD HH:mm:ss> \|

			## 2. 审计记录

			### <YYYY-MM-DD HH:mm:ss> <AUDIT-ID>：<审计标题>

			审核员：
			<管理观察员>

			审计类型：
			计划审计 / 执行审计 / 变更审计 / 复审

			审计对象：
			<MGMT-ITEM-ID / PLAN-ID / LOG-ID / CHANGE-ID / 错误日志 ID>

			审计依据：

			1. 管理体系规范.md
			2. 管理事项计划.md
			3. 管理执行日志.md
			4. 管理变更记录.md
			5. <其他证据入口>

			审计范围：

			1. <范围 1>

			关键检查：

			\| 检查项 \| 结论 \| 证据 \|
			\|---\|---\|---\|
			\| 来源、目标和边界是否清楚 \| 通过 / 不通过 / 不适用 \| <证据> \|
			\| 计划是否合理 \| 通过 / 不通过 / 不适用 \| <证据> \|
			\| 执行是否按计划完成 \| 通过 / 不通过 / 不适用 \| <证据> \|
			\| 配置、角色、会话或规范变化是否写变更记录 \| 通过 / 不通过 / 不适用 \| <证据> \|
			\| 框架错误是否写入 MB-X错误日志.md \| 通过 / 不通过 / 不适用 \| <证据> \|
			\| 是否存在越权或未记录动作 \| 通过 / 不通过 / 不适用 \| <证据> \|

			问题清单：

			\| 问题 ID \| 严重级别 \| 问题 \| 影响 \| 修复建议 \| 是否阻断 \|
			\|---\|---\|---\|---\|---\|---\|
			\| <ISSUE-ID> \| P0/P1/P2/P3 \| <问题> \| <影响> \| <建议> \| 是 / 否 \|

			审计结论：
			通过 / 不通过 / 暂缓

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

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

New file
			@@ -0,0 +1,56 @@
			# 管理执行日志

			创建人员：<创建人员>
			文件职责：记录管理管理员执行管理事项、管理命令、目录调整、配置调整、框架更新和问题修复的过程。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理执行日志模版.md。
			引用文件：管理事项总纲.md；管理事项计划.md；管理配置清单.md；管理审计报告.md；管理变更记录.md；管理问题记录.md；../MB-X错误日志.md。
			记录方式：append-only 管理执行日志；每次管理动作追加到文件末尾。

			## 1. 日志记录

			### <YYYY-MM-DD HH:mm:ss> <LOG-ID>：<动作标题>

			关联事项：
			<MGMT-ITEM-ID>

			关联计划：
			<PLAN-ID>

			执行人员：
			<管理管理员>

			动作类型：
			工作区初始化 / 项目创建 / 体系启用 / 角色调整 / 会话创建 / 框架更新 / 规范同步 / 错误修复 / 其他

			执行目标：
			<本次动作要完成什么>

			执行过程：

			1. <关键步骤 1>
			2. <关键步骤 2>

			使用命令或 skill：
			<命令、skill 名称、关键参数摘要>

			关键输入：
			<输入文档、模板、上游要求>

			关键输出：
			<创建或修改的文件、目录、配置、会话 ID、日志路径>

			自检结果：
			<路径、配置、日志、权限、引用和消息链检查结果>

			异常 / 偏离：
			<如无写“无”；框架错误同时写 MB-X错误日志.md>

			当前状态：
			完成 / 部分完成 / 失败 / 暂停

			结论回写：
			<是否已回写管理事项总纲、计划或配置清单>

			审计入口：
			<管理审计报告.md 中的 AUDIT-ID>

New file
			@@ -0,0 +1,117 @@
			# 管理环境创建指南

			创建人员：Codex
			文件职责：指导 MB-X 管理根目录初始化管理体系实例、管理角色、管理会话和管理审计入口。
			管理规范/模板：../../全局规范.md；../../管理系统说明.md；管理体系规范.md。
			引用文件：管理配置清单模版.md；管理事项总纲模版.md；管理事项计划模版.md；管理执行日志模版.md；管理审计报告模版.md；管理问题记录模版.md；管理变更记录模版.md；管理管理员工作说明模版.md；管理观察员工作说明模版.md；../ai-workplace/AI工作空间创建指南.md。
			记录方式：创建指南；管理体系初始化、角色或校验口径变化时更新。

			## 1. 使用场景

			当 `mb-ms-doc` 或兼容目录作为 MB-X 管理根目录时，必须按本指南创建管理体系实例。

			管理体系实例用于纳管管理会话。它不是 `project-*` 子项目，不使用业务子项目的独立 Git 仓库；它属于管理根目录的运行治理层。

			## 2. 输入

			初始化前必须明确：

			1. 管理根目录。
			2. 管理管理员 AI 名称。
			3. 管理观察员 AI 名称。
			4. 管理端真实会话是否立即创建。
			5. 是否已有 `mbx.yaml`。
			6. 是否已有 `MB-X错误日志.md`。
			7. 当前 MB-X 源码仓库路径。
			8. 当前 `mb-ms-doc` 规范仓库路径。

			## 3. 创建目录

			在管理根目录创建：

			```text
			manage-doc/
			ai-<admin-name>/
			ai-<observer-name>/
			```

			管理角色工作空间内部按 AI 工作空间规范创建：

			```text
			ai-<name>/tmp/
			ai-<name>/draft/
			ai-<name>/worklog/
			ai-<name>/工作说明.md
			ai-<name>/项目问题反馈.md
			```

			## 4. 创建管理体系文档

			从本目录模板创建到管理根目录 `manage-doc/`：

			1. `管理配置清单.md`
			2. `管理事项总纲.md`
			3. `管理事项计划.md`
			4. `管理执行日志.md`
			5. `管理审计报告.md`
			6. `管理问题记录.md`
			7. `管理变更记录.md`

			管理根目录如果已经存在 `MB-X错误日志.md`，应在 `管理配置清单.md` 中登记该入口；如果不存在，应创建。

			## 5. 登记管理角色

			管理配置清单中至少登记：

			\| AI \| 角色 \| 工作空间 \| 审计入口 \|
			\|---\|---\|---\|---\|
			\| `<admin-name>` \| 管理管理员 \| `ai-<admin-name>/` \| 管理审计报告.md \|
			\| `<observer-name>` \| 管理观察员 \| `ai-<observer-name>/` \| 管理审计报告.md \|

			管理管理员绑定管理端真实会话。管理观察员可以独立创建会话，也可以先登记为待创建。

			## 6. 初始化工作说明

			管理管理员使用 `管理管理员工作说明模版.md` 创建 `ai-<admin-name>/工作说明.md`。

			管理观察员使用 `管理观察员工作说明模版.md` 创建 `ai-<observer-name>/工作说明.md`。

			工作说明只写入口和边界，不复制管理体系规范正文。管理体系规范更新后，管理角色应重新读取 `manage-doc/管理体系规范.md`。

			## 7. 初始化管理事项

			初始化管理体系本身也是管理事项。必须在以下文件中记录：

			1. `管理事项总纲.md`：记录为什么要纳管管理会话、目标和边界。
			2. `管理事项计划.md`：记录创建目录、复制模板、登记角色、创建会话、校验和审计步骤。
			3. `管理执行日志.md`：记录实际创建了哪些目录和文件。
			4. `管理变更记录.md`：记录管理体系从无到有的治理结构变化。
			5. `管理审计报告.md`：由管理观察员审计初始化计划和执行结果；没有独立观察员时，应标记为“待独立观察员复审”。

			## 8. 校验方案

			管理体系初始化完成后，检查：

			1. `manage-doc/` 存在。
			2. 管理七本账都存在。
			3. 管理管理员和管理观察员均在管理配置清单中登记。
			4. 管理管理员工作空间和管理观察员工作空间均存在。
			5. 两个工作空间均有 `工作说明.md` 和 `项目问题反馈.md`。
			6. 管理端真实会话绑定到管理管理员，或明确登记为待创建。
			7. `MB-X错误日志.md` 入口存在。
			8. 初始化事项能从管理事项总纲追到计划、执行日志、变更记录和审计报告。
			9. `project-*` 子项目没有被纳入 `mb-ms-doc` 模板仓库提交。
			10. 管理观察员没有直接修改管理管理员产物。

			## 9. 完成汇报

			管理体系创建完成后，应向人类汇报：

			1. 管理根目录。
			2. 管理体系实例目录。
			3. 管理管理员 AI 和会话状态。
			4. 管理观察员 AI 和会话状态。
			5. 已创建管理账本。
			6. 初始化审计结论。
			7. 待补或待复审事项。

New file
			@@ -0,0 +1,73 @@
			# <AI_DISPLAY_NAME> 工作说明

			创建人员：<创建人员>
			文件职责：记录管理管理员在 MB-X 管理根目录中的职责边界、权限范围、必读文档、管理动作入口和审计要求。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理管理员工作说明模版.md；../common/ai-workplace/AI工作空间创建指南.md。
			引用文件：manage-doc/管理配置清单.md；manage-doc/管理事项总纲.md；manage-doc/管理事项计划.md；manage-doc/管理执行日志.md；manage-doc/管理审计报告.md；manage-doc/管理变更记录.md；MB-X错误日志.md。
			记录方式：当前角色入口说明；管理角色、权限、会话或入口变化时覆盖更新，并在管理变更记录中保留历史。

			## 1. 基本信息

			\| 字段 \| 内容 \|
			\|---\|---\|
			\| AI 名称 \| <AI_NAME> \|
			\| 显示名称 \| <AI_DISPLAY_NAME> \|
			\| 管理角色 \| 管理管理员 \|
			\| 工作空间 \| ai-<AI_NAME>/ \|
			\| 指派人 \| <ASSIGNED_BY> \|
			\| 指派时间 \| <YYYY-MM-DD HH:mm:ss> \|
			\| 真实会话 ID \| <session-id 或待创建> \|

			## 2. 职责边界

			管理管理员负责执行管理动作，包括工作区初始化、项目创建、体系启用、角色创建、会话创建、MB-X 更新、skill 同步、框架错误修复和管理配置维护。

			管理管理员不直接替代业务子项目的产品、开发、实验、案例分析或审核角色。

			## 3. 必读文档

			1. `manage-doc/管理配置清单.md`
			2. `manage-doc/管理体系规范.md`
			3. `manage-doc/管理事项总纲.md`
			4. `manage-doc/管理事项计划.md`
			5. `manage-doc/管理执行日志.md`
			6. `manage-doc/管理审计报告.md`
			7. `manage-doc/管理变更记录.md`
			8. `MB-X错误日志.md`
			9. `common/project-doc/项目环境创建指南.md`
			10. `common/ai-workplace/AI工作空间创建指南.md`
			11. 当前任务涉及的体系文档和 MB-X 通信文档。

			## 4. 操作规则

			1. 接到管理需求后，先判断是否需要登记管理事项。
			2. 高风险动作先写计划，并提交管理观察员审计。
			3. 执行动作后写管理执行日志。
			4. 改变配置、角色、会话、目录、框架或规范时写管理变更记录。
			5. 框架层错误写入 `MB-X错误日志.md`。
			6. 不把业务流程、校验或审核规则固化进 MB-X 代码。
			7. 不把 `project-*` 子项目提交到 `mb-ms-doc` 模板仓库。

			## 5. 可用技能

			1. `mbx-management-control`
			2. `mbx-framework-update`
			3. `mbx-project-setup`
			4. `mbx-ai-workspace`
			5. `mbx-file-governance`
			6. `mbx-governance`
			7. `mbx-human-workflow`
			8. `mbx-interaction-router`

			## 6. 审计边界

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

			## 7. 禁止事项

			1. 不得绕过管理事项账本执行高风险管理动作。
			2. 不得直接修改管理观察员的审计结论。
			3. 不得用聊天记录替代管理执行日志。
			4. 不得把框架错误写成业务问题来隐藏。
			5. 不得把业务子项目私有内容写入公共模板。

New file
			@@ -0,0 +1,83 @@
			# <AI_DISPLAY_NAME> 工作说明

			创建人员：<创建人员>
			文件职责：记录管理观察员在 MB-X 管理根目录中的审核职责、权限边界、必读文档和反馈方式。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理观察员工作说明模版.md；../common/ai-workplace/AI工作空间创建指南.md。
			引用文件：manage-doc/管理配置清单.md；manage-doc/管理事项总纲.md；manage-doc/管理事项计划.md；manage-doc/管理执行日志.md；manage-doc/管理审计报告.md；manage-doc/管理问题记录.md；manage-doc/管理变更记录.md；MB-X错误日志.md。
			记录方式：当前角色入口说明；管理观察员角色、权限、会话或入口变化时覆盖更新，并在管理变更记录中保留历史。

			## 1. 基本信息

			\| 字段 \| 内容 \|
			\|---\|---\|
			\| AI 名称 \| <AI_NAME> \|
			\| 显示名称 \| <AI_DISPLAY_NAME> \|
			\| 管理角色 \| 管理观察员 \|
			\| 工作空间 \| ai-<AI_NAME>/ \|
			\| 指派人 \| <ASSIGNED_BY> \|
			\| 指派时间 \| <YYYY-MM-DD HH:mm:ss> \|
			\| 真实会话 ID \| <session-id 或待创建> \|

			## 2. 职责边界

			管理观察员负责审核管理管理员的计划、执行、变更、角色会话调整、MB-X 更新、规范同步和错误修复。

			管理观察员不直接执行被审计的管理动作，不直接修改管理管理员产出的配置、执行日志和变更记录。

			## 3. 必读文档

			1. `manage-doc/管理体系规范.md`
			2. `manage-doc/管理配置清单.md`
			3. `manage-doc/管理事项总纲.md`
			4. `manage-doc/管理事项计划.md`
			5. `manage-doc/管理执行日志.md`
			6. `manage-doc/管理变更记录.md`
			7. `manage-doc/管理审计报告.md`
			8. `manage-doc/管理问题记录.md`
			9. `MB-X错误日志.md`
			10. 被审管理动作涉及的项目、体系、角色或框架文档。

			## 4. 审计规则

			1. 审计以管理事项为单元。
			2. 计划审计重点看目标、边界、步骤、输入输出和风险是否清楚。
			3. 执行审计重点看是否按计划执行，证据链是否闭合。
			4. 变更审计重点看配置、角色、会话、框架或规范变化是否记录完整。
			5. 框架错误修复审计重点看错误是否进入 `MB-X错误日志.md`，修复是否可复验。
			6. 只阻断影响权限、配置、证据链、运行态、项目边界或后续可追溯性的问题。

			## 5. 可用技能

			1. `mbx-governance`
			2. `mbx-file-governance`
			3. `mbx-human-workflow`
			4. `mbx-interaction-router`

			## 6. 输出入口

			审计结论写入：

			```text
			manage-doc/管理审计报告.md
			```

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

			```text
			manage-doc/管理问题记录.md
			```

			私有过程记录写入：

			```text
			ai-<AI_NAME>/worklog/
			```

			## 7. 禁止事项

			1. 不得直接修改被审计主产物来代替反馈。
			2. 不得无条件通过管理管理员自己的高风险动作。
			3. 不得把格式小问题升级为阻断。
			4. 不得替业务子项目审核员审核专业业务产物。
			5. 不得把审计结论只留在聊天窗口中。

New file
			@@ -0,0 +1,57 @@
			# 管理配置清单

			创建人员：<创建人员>
			文件职责：记录 MB-X 管理根目录当前管理角色、管理会话、管理体系文档、框架入口、模板仓库和运行态事实，是管理体系当前配置事实源。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理配置清单模版.md。
			引用文件：管理事项总纲.md；管理事项计划.md；管理执行日志.md；管理审计报告.md；管理问题记录.md；管理变更记录.md；../mbx.yaml；../MB-X错误日志.md。
			记录方式：管理配置清单；当前状态可覆盖更新，历史和原因写入管理变更记录.md 与管理执行日志.md。

			## 1. 管理根目录

			\| 字段 \| 内容 \|
			\|---\|---\|
			\| 管理根目录名称 \| <名称> \|
			\| 管理根目录 ID \| <WORKSPACE-ID> \|
			\| 管理根目录路径 \| <相对路径或说明> \|
			\| MB-X 源码入口 \| <mb-x 仓库路径或远端> \|
			\| mb-ms-doc 规范入口 \| <mb-ms-doc 仓库路径或远端> \|
			\| 当前状态 \| 未开始 / 进行中 / 暂停 / 完成 / 取消 \|

			## 2. 管理角色与会话

			\| AI 名称 \| 角色 \| 工作空间 \| 真实会话 ID \| 默认写权限范围 \| 审计入口 \| 状态 \|
			\|---\|---\|---\|---\|---\|---\|---\|
			\| <admin-name> \| 管理管理员 \| ai-<admin-name>/ \| <session-id 或待创建> \| 管理根目录治理文档；MB-X 运行态；按事项授权的 project-* 入口 \| 管理审计报告.md \| active / pending \|
			\| <observer-name> \| 管理观察员 \| ai-<observer-name>/ \| <session-id 或待创建> \| 管理审计报告.md；管理问题记录.md；自身工作空间 \| 管理审计报告.md \| active / pending \|

			## 3. 管理文档入口

			\| 文档 \| 作用 \| 状态 \|
			\|---\|---\|---\|
			\| manage-doc/管理配置清单.md \| 管理配置事实源 \| 已创建 / 未创建 \|
			\| manage-doc/管理事项总纲.md \| 管理事项总账本 \| 已创建 / 未创建 \|
			\| manage-doc/管理事项计划.md \| 管理事项计划账本 \| 已创建 / 未创建 \|
			\| manage-doc/管理执行日志.md \| 管理动作执行日志 \| 已创建 / 未创建 \|
			\| manage-doc/管理审计报告.md \| 管理观察员审计报告 \| 已创建 / 未创建 \|
			\| manage-doc/管理问题记录.md \| 管理级问题记录和审计问题索引 \| 已创建 / 未创建 \|
			\| manage-doc/管理变更记录.md \| 管理级变更历史 \| 已创建 / 未创建 \|
			\| MB-X错误日志.md \| MB-X 框架层错误日志 \| 已创建 / 未创建 \|

			## 4. 管理能力入口

			\| 能力 \| 入口 \| 备注 \|
			\|---\|---\|---\|
			\| 创建工作区 \| mbx init；mbx-management-control \| 需按管理体系记录 \|
			\| 创建子项目 \| mbx project create；mbx-project-setup \| 子项目使用 project-* 和独立 Git \|
			\| 启用体系 \| mbx system enable；对应体系 skill \| 文档驱动 \|
			\| 创建角色和 AI 工作空间 \| mbx role create；mbx-ai-workspace \| 同步工作说明 \|
			\| 创建会话 \| mbx session create \| 真实会话 ID 回写配置 \|
			\| 更新 MB-X \| mbx-framework-update \| 高风险，需观察员审计 \|
			\| 通信和 inbox \| mbx send；mbx inbox；mbx-human-workflow \| 失败写 MB-X错误日志 \|

			## 5. 变更索引

			\| 时间 \| 变更记录 ID \| 变更摘要 \| 执行人 \| 审计状态 \|
			\|---\|---\|---\|---\|---\|
			\| <YYYY-MM-DD HH:mm:ss> \| <CHANGE-ID> \| 初始化管理配置清单 \| <创建人员> \| 待审 / 通过 \|

New file
			@@ -0,0 +1,48 @@
			# 管理问题记录

			创建人员：<创建人员>
			文件职责：记录非审计来源的管理级问题、跨轮管理问题索引、反复返修问题和需要人类介入的管理阻塞。
			管理规范/模板：../common/manage-doc/管理体系规范.md；../common/manage-doc/管理问题记录模版.md。
			引用文件：管理事项总纲.md；管理事项计划.md；管理执行日志.md；管理审计报告.md；管理变更记录.md；../MB-X错误日志.md。
			记录方式：append-only 管理问题记录；新增问题、状态变化、复验结论时追加。

			## 1. 当前问题总览

			\| 问题 ID \| 类型 \| 严重级别 \| 状态 \| 责任方 \| 关联审计 \|
			\|---\|---\|---\|---\|---\|---\|
			\| <ISSUE-ID> \| 配置 / 权限 / 会话 / 框架 / 规范 / 流程 / 其他 \| P0/P1/P2/P3 \| 未处理 / 处理中 / 待复验 / 已关闭 \| <责任方> \| <AUDIT-ID> \|

			## 2. 问题记录

			### <YYYY-MM-DD HH:mm:ss> <ISSUE-ID>：<问题标题>

			问题来源：
			非审计发现 / 审计索引 / 管理观察员反馈 / MB-X错误日志 / 人类反馈

			关联事项：
			<MGMT-ITEM-ID>

			关联日志或变更：
			<LOG-ID / CHANGE-ID>

			问题描述：
			<问题是什么>

			证据入口：
			<文件、日志、命令输出摘要或消息 ID>

			影响范围：
			<影响哪些管理能力、项目、角色、会话或框架功能>

			严重级别：
			P0 / P1 / P2 / P3

			修复建议：
			<建议怎么修>

			当前状态：
			未处理 / 处理中 / 待复验 / 已关闭

			复验结论：
			<复验结果>

			@@ -32,6 +32,7 @@
			4. 审核体系。
			5. 数据存储体系。
			6. 作业方法论体系。
			7. 管理体系。

			这些部分不是彼此独立的。一个事项从开始到结束，会同时经过文档、执行、数据、审计和归档。

			@@ -223,8 +224,32 @@
			6. `project-doc/`：项目规范和项目创建模板，包括项目规范、项目配置清单、项目事项总纲、项目事项计划、项目执行日志、项目事项审计报告、项目问题记录、项目变更记录。
			7. `全局规范.md`：所有 AI 都必须遵守的全局规则。
			8. `体系创建流程.md`：创建新体系时使用的通用流程和完成标准。
			9. `manage-doc/`：管理体系规范和模板，用于约束 MB-X 管理根目录、管理会话、管理管理员、管理观察员和管理级事项。

			公共规范应尽量通用，不绑定某一个具体项目。

			### 11.0 管理事项

			管理事项是一种管理根目录事项。

			管理事项用于记录和审计管理会话执行的工作区初始化、项目创建、体系启用、角色创建、会话创建、MB-X 框架更新、skill 同步、规范同步、通信框架修复和错误处理。

			管理事项必须至少包含：

			1. `管理配置清单`：记录管理角色、管理会话、管理体系文档、MB-X 框架入口和模板仓库入口。
			2. `管理事项总纲`：记录管理事项的来源、目标、状态和当前结论。
			3. `管理事项计划`：记录管理步骤、输入输出、验收方式和计划审计入口。
			4. `管理执行日志`：记录管理管理员实际执行过程。
			5. `管理审计报告`：记录管理观察员对计划、执行、变更和复审的结论。
			6. `管理问题记录`：记录非审计来源管理问题和跨轮管理问题索引。
			7. `管理变更记录`：记录管理级配置、角色、会话、框架、规范和运行态事实源变化。

			管理体系至少包含两个角色：

			1. 管理管理员：负责执行管理动作。
			2. 管理观察员：负责审核管理管理员，不直接修改被审管理产物。

			管理体系不替代业务子项目的项目体系。它管的是 `mb-ms-doc` 管理根目录和 MB-X 控制面，业务子项目仍使用自己的项目体系和专业体系。

			### 11.1 实验事项

			@@ -437,6 +462,18 @@
			54. `ana-doc/案例审核规范.md`
			55. `ana-doc/案例审计报告模版.md`
			56. `ana-doc/案例问题记录模版.md`
			57. `manage-doc/目录导读.md`
			58. `manage-doc/管理体系规范.md`
			59. `manage-doc/管理环境创建指南.md`
			60. `manage-doc/管理配置清单模版.md`
			61. `manage-doc/管理事项总纲模版.md`
			62. `manage-doc/管理事项计划模版.md`
			63. `manage-doc/管理执行日志模版.md`
			64. `manage-doc/管理审计报告模版.md`
			65. `manage-doc/管理问题记录模版.md`
			66. `manage-doc/管理变更记录模版.md`
			67. `manage-doc/管理管理员工作说明模版.md`
			68. `manage-doc/管理观察员工作说明模版.md`

			实验体系不再强制提供实验导读模板；项目实验入口由项目总索引或 `实验总纲.md` 承担。项目默认不创建单实验独立总纲、独立设计或独立执行日志文件，而是追加到项目级三本账本。

			@@ -12,6 +12,7 @@
			\|---\|---\|
			\| `common/` \| 全局通用规范、模板和体系组件 \|
			\| `data/` \| 全局统一数据源或数据索引材料 \|
			\| `manage-doc/` \| MB-X 管理根目录实例化后的管理体系账本目录；由 `common/manage-doc/` 模板创建 \|
			\| `project A/` \| 项目 A 工作目录 \|
			\| `project B/` \| 项目 B 工作目录 \|
			\| `project C/` \| 项目 C 工作目录 \|
			@@ -29,3 +30,9 @@
			\| `AI管理体系建议.md` \| AI 管理体系建议沉淀 \|
			\| `全局存储体系.md` \| 全局数据源、公共表边界和使用规范 \|
			\| `全局数据格式.md` \| 全局公共表和文件型数据的字段级 schema \|

			## common 关键目录

			\| 目录 \| 作用 \|
			\|---\|---\|
			\| `common/manage-doc/` \| 管理体系公共规范和模板，用于纳管管理会话、管理管理员、管理观察员和管理级操作 \|

			@@ -42,6 +42,8 @@
			5. 项目管理员：绑定路径项目根目录/
			6. 审核员：审核员必须是对应上面的角色之一的审核员，不绑定任何目录，只能写对应的审核体系的审核报告.md。比如说需求审计员那只能写 /pro-doc/需求审计报告.md ，比如需求开发审核员只能写
			/dev-doc/pro-doc/开发审计报告.md
			7. 管理管理员：绑定路径管理根目录和 manage-doc/，负责创建项目、启用体系、创建角色、创建会话、更新 MB-X、同步技能和修复框架问题；必须写入管理事项、管理执行日志和管理变更记录。
			8. 管理观察员：管理管理员的审核员，只能写 manage-doc/管理审计报告.md、manage-doc/管理问题记录.md 和自己的 AI 工作空间；不得直接修改被审计的管理配置、执行日志和变更记录。


			#### AI工作空间管理
			@@ -99,6 +101,7 @@
			5.案例分析的文档存放在ana-doc文件夹比如：
			ana-doc/案例分析规范.md
			6.全局规范.md 该文件负责存储所有全局规范和全局约定，所有 AI 都应该遵守该文档
			7.manage-doc 存放管理体系规范和模板，用于约束管理根目录中的管理会话、管理管理员、管理观察员和管理级事项。


			### 项目文件夹
			@@ -177,6 +180,9 @@
			3. 实验体系
			4. 案例分析体系
			5. 项目体系
			6. 管理体系

			管理体系是 MB-X 管理根目录的体系，不是业务子项目体系。它用于纳管管理会话：管理管理员负责执行管理动作，管理观察员负责审核管理管理员。管理体系公共规范和模板放在 `common/manage-doc/`；实例化后的管理账本放在管理根目录 `manage-doc/`。

			### 体系组件

			@@ -278,6 +284,8 @@
			9. 代码审核技能（包括编码方案设计到代码书写的审核）;（属于common\dev-doc\开发审计规范.md 以及项目本地 dev-doc\开发审计规范.md 两个共同作用的技能 )
			10. 案例分析技能（包括案例分析设计，案例分析全流程）;（属于common\ana-doc\案例分析规范.md 以及项目本地 ana-doc\案例分析规范.md 两个共同作用的技能 )
			11. 案例分析审核技能（包括案例分析设计，案例分析全流程审计）;（属于common\ana-doc\案例审核规范.md 以及项目本地 ana-doc\案例审核规范.md 两个共同作用的技能 )
			12. 管理体系创建和管理控制技能（包括管理根目录初始化、项目创建、体系启用、角色创建、会话创建、MB-X 更新和 skill 同步）;（属于common\manage-doc\管理体系规范.md、common\manage-doc\管理环境创建指南.md 与 MB-X 管理类 skill 共同作用的技能 )
			13. 管理观察审核技能（包括管理事项计划审核、执行审核、变更审核、框架更新审核和复审）;（属于common\manage-doc\管理体系规范.md、common\manage-doc\管理审计报告模版.md 与管理观察员工作说明共同作用的技能 )

			## 体系特殊说明
			实验体系目前固定成如下：