| | |
|---|
| | | # 体系说明 |
|---|
| | | # 体系说明 |
|---|
| | | |
|---|
| | | 创建人员：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. 体系定位 |
|---|
| | | |
|---|
| | |
|---|
| | | 4. 审核体系。 |
|---|
| | | 5. 数据存储体系。 |
|---|
| | | 6. 作业方法论体系。 |
|---|
| | | 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/`：数据存储、数据样本、数据库表、图片资产相关规范。 |
|---|
| | | 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 实验事项 |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | 开发体系不单独承载业务目标，它必须绑定其他体系或目标事项。常见绑定关系： |
|---|
| | | |
|---|
| | | 1. 产品开发：实现产品体系产出的产品需求、正式需求和业务规则。 |
|---|
| | | 1. 需求开发：实现需求体系产出的需求、正式需求和业务规则。 |
|---|
| | | 2. 实验开发：实现实验脚本、数据处理、回测、图表、校验工具。 |
|---|
| | | 3. 案例分析开发：实现案例图表、账本、回放、审计辅助工具。 |
|---|
| | | 4. 项目工具开发：实现项目初始化、索引、检查、归档工具。 |
|---|
| | |
|---|
| | | |
|---|
| | | 例如： |
|---|
| | | |
|---|
| | | 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/`。 |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | 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` |
|---|
| | |
|---|
| | | 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` 承担。项目默认不创建单实验独立总纲、独立设计或独立执行日志文件，而是追加到项目级三本账本。 |
|---|
| | | |
|---|
