From bf157a136d9b08c14b4da2997dc5a03b1a1af33d Mon Sep 17 00:00:00 2001 From: Cai <cai@nbcai.cc> Date: Mon, 07 Sep 2026 12:59:24 +0800 Subject: [PATCH] docs: update governance and operations guidance --- 体系说明.md | 44 +++++++++++++++++++++++++++++++++++++++++--- 1 files changed, 41 insertions(+), 3 deletions(-) diff --git "a/\344\275\223\347\263\273\350\257\264\346\230\216.md" "b/\344\275\223\347\263\273\350\257\264\346\230\216.md" index 2005d25..9f19a8e 100644 --- "a/\344\275\223\347\263\273\350\257\264\346\230\216.md" +++ "b/\344\275\223\347\263\273\350\257\264\346\230\216.md" @@ -32,6 +32,7 @@ 4. 审核体系。 5. 数据存储体系。 6. 作业方法论体系。 +7. 管理体系。 这些部分不是彼此独立的。一个事项从开始到结束,会同时经过文档、执行、数据、审计和归档。 @@ -220,11 +221,36 @@ 3. `exp-doc/`:实验体系规范和实验文档模板,包括实验总纲、实验设计、执行日志、实验存储体系创建指南、实验审核规范、审计报告、问题记录。项目内应创建本地 `实验规范.md` 和 `实验审计规范.md`,分别引用 common 全局规范。 4. `data-doc/`:数据存储、数据样本、数据库表、图片资产相关规范。 5. `ana-doc/`:案例分析体系规范和模板,包括案例分析规范、案例审核规范、案例总纲、案例分析设计、案例执行日志、案例存储体系创建指南、案例审计报告、案例问题记录。 -6. `project-doc/`:项目规范和项目创建模板,包括项目规范、项目配置清单、项目事项总纲、项目事项计划、项目执行日志、项目事项审计报告、项目问题记录、项目变更记录。 -7. `全局规范.md`:所有 AI 都必须遵守的全局规则。 -8. `体系创建流程.md`:创建新体系时使用的通用流程和完成标准。 +6. `ops-doc/`:运维体系规范和模板,包括运维规范、环境创建指南、运维事项账本、执行日志、变更记录、操作手册、审核规范、审计报告和问题记录。 +7. `project-doc/`:项目规范和项目创建模板,包括项目规范、项目配置清单、项目事项总纲、项目事项计划、项目执行日志、项目事项审计报告、项目问题记录、项目变更记录。 +8. `全局规范.md`:所有 AI 都必须遵守的全局规则。 +9. `体系创建流程.md`:创建新体系时使用的通用流程和完成标准。 +10. `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 +463,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` 承担。项目默认不创建单实验独立总纲、独立设计或独立执行日志文件,而是追加到项目级三本账本。 -- Gitblit v1.9.3