管理环境创建指南

创建人员：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. 创建目录

在管理根目录创建：

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

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

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. 登记管理角色

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

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

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. 待补或待复审事项。