From 77eb070046dfac05931f6ddd9cbf681cf09577f2 Mon Sep 17 00:00:00 2001 From: 1 <wentingyear@gmail.com> Date: Mon, 08 Jun 2026 03:00:02 +0800 Subject: [PATCH] 的 --- 体系说明.md | 71 +++++++++++++++++++++++++++-------- 1 files changed, 54 insertions(+), 17 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 9e35e9a..080f483 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" @@ -1,9 +1,9 @@ -# 体系说明 +# 体系说明 创建人员：Codex 文件职责：说明 AI 管理体系的总体结构、核心流程、关键文档、关键角色和审计闭环。 管理规范/模板：管理体系总说明文档；用于解释 `管理体系说明.vsdx` 的文字含义。 -引用文件：管理系统说明.md；管理体系说明.vsdx；全局规范.md；common/pro-doc/产品规范.md；common/pro-doc/需求规范.md；common/dev-doc/编码规范.md；common/exp-doc/实验规范.md。 +引用文件：管理系统说明.md；管理体系说明.vsdx；全局规范.md；common/pro-doc/需求规范.md；common/pro-doc/需求规范.md；common/dev-doc/编码规范.md；common/exp-doc/实验规范.md。 ## 1. 体系定位 @@ -32,6 +32,7 @@ 4. 审核体系。 5. 数据存储体系。 6. 作业方法论体系。 +7. 管理体系。 这些部分不是彼此独立的。一个事项从开始到结束，会同时经过文档、执行、数据、审计和归档。 @@ -215,7 +216,7 @@ 当前规划： -1. `pro-doc/`：产品、策略、需求相关规范。 +1. `pro-doc/`：需求、策略、需求相关规范。 2. `dev-doc/`：开发体系、编码、测试、自检相关规范。开发体系默认随项目创建，但开发必须绑定目标体系或目标事项；代码按 `dev/<target>-dev/` 分账，开发文档按 `dev-doc/<target>-doc/` 分账。 3. `exp-doc/`：实验体系规范和实验文档模板，包括实验总纲、实验设计、执行日志、实验存储体系创建指南、实验审核规范、审计报告、问题记录。项目内应创建本地 `实验规范.md` 和 `实验审计规范.md`，分别引用 common 全局规范。 4. `data-doc/`：数据存储、数据样本、数据库表、图片资产相关规范。 @@ -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 实验事项 @@ -287,7 +312,7 @@ 开发体系不单独承载业务目标，它必须绑定其他体系或目标事项。常见绑定关系： -1. 产品开发：实现产品体系产出的产品需求、正式需求和业务规则。 +1. 需求开发：实现需求体系产出的需求、正式需求和业务规则。 2. 实验开发：实现实验脚本、数据处理、回测、图表、校验工具。 3. 案例分析开发：实现案例图表、账本、回放、审计辅助工具。 4. 项目工具开发：实现项目初始化、索引、检查、归档工具。 @@ -300,7 +325,7 @@ 例如： -1. 产品开发：`dev/pro-dev/`，`dev/pro-dev/test/`，`dev-doc/pro-doc/`。 +1. 需求开发：`dev/pro-dev/`，`dev/pro-dev/test/`，`dev-doc/pro-doc/`。 2. 实验开发：`dev/exp-dev/`，`dev/exp-dev/test/`，`dev-doc/exp-doc/`。 3. 案例分析开发：`dev/ana-dev/`，`dev/ana-dev/test/`，`dev-doc/ana-doc/`。 @@ -383,19 +408,19 @@ 1. `体系创建流程.md` 2. `pro-doc/目录导读.md` -3. `pro-doc/产品规范.md` -4. `pro-doc/产品环境创建指南.md` -5. `pro-doc/产品审核规范.md` +3. `pro-doc/需求规范.md` +4. `pro-doc/需求环境创建指南.md` +5. `pro-doc/需求审核规范.md` 6. `pro-doc/需求规范.md` -7. `pro-doc/产品总纲模版.md` -8. `pro-doc/产品设计模版.md` -9. `pro-doc/产品方案文档范本.md` -10. `pro-doc/产品架构文档范本.md` -11. `pro-doc/产品模块说明文档范本.md` -12. `pro-doc/产品核心流程文档范本.md` -13. `pro-doc/产品执行日志模版.md` -14. `pro-doc/产品审计报告模版.md` -15. `pro-doc/产品问题记录模版.md` +7. `pro-doc/需求总纲模版.md` +8. `pro-doc/需求设计模版.md` +9. `pro-doc/需求方案文档范本.md` +10. `pro-doc/需求架构文档范本.md` +11. `pro-doc/需求模块说明文档范本.md` +12. `pro-doc/需求核心流程文档范本.md` +13. `pro-doc/需求执行日志模版.md` +14. `pro-doc/需求审计报告模版.md` +15. `pro-doc/需求问题记录模版.md` 16. `pro-doc/需求文档范本.md` 17. `dev-doc/目录导读.md` 18. `dev-doc/编码规范.md` @@ -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` 承担。项目默认不创建单实验独立总纲、独立设计或独立执行日志文件，而是追加到项目级三本账本。 -- Gitblit v1.9.3