# 管理环境创建指南

创建人员：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. 待补或待复审事项。