| | |
|---|
| | | #管理体系说明 |
|---|
| | | # 管理体系说明 |
|---|
| | | |
|---|
| | | ## 管理体系核心 |
|---|
| | | |
|---|
| | | ###全局管理 |
|---|
| | | ### 全局管理 |
|---|
| | | |
|---|
| | | #### 文件管理（文件增，删，改） |
|---|
| | | ##### 文件创建 |
|---|
| | |
|---|
| | | 3. 实验员：绑定路径/exp-doc /exp-data |
|---|
| | | 4. 案例分析员：绑定路径/ana-doc /ana-data |
|---|
| | | 5. 项目管理员：绑定路径项目根目录/ |
|---|
| | | 6. 审核员：审核员必须是对应上面的角色之一的审核员，不绑定任何目录，只能写对应的审核体系的审核报告.md。比如说需求审计员那只能写 /pro-doc/需求审计报告.md ，比如需求开发审核员只能写 |
|---|
| | | /dev-doc/pro-doc/开发审计报告.md |
|---|
| | | 6. 审核员：审核员必须是对应上面的角色之一的审核员，不绑定业务执行目录，主写对应审核体系的审核 / 审计报告；可维护自己审核职责对应的本地审核 / 审计规范，但不得默认修改被审体系执行规范、事项计划、执行日志、结果包或主产物。比如需求审计员主写 `/pro-doc/需求审计报告.md` 并可维护 `/pro-doc/需求审核规范.md`；需求开发审核员主写对应开发审计报告，并可维护对应开发审计规范。 |
|---|
| | | 7. 管理管理员：绑定路径管理根目录和 manage-doc/，负责创建项目、启用体系、创建角色、创建会话、更新 MB-X、同步技能和修复框架问题；必须写入管理事项、管理执行日志和管理变更记录。 |
|---|
| | | 8. 管理观察员：管理管理员的审核员，主写 `manage-doc/管理审计报告.md`，可在 `manage-doc/管理问题记录.md` 写审计问题索引或观察员反馈，可维护管理体系中的审计口径；不得直接修改被审计的管理配置、执行日志和变更记录。 |
|---|
| | | |
|---|
| | | |
|---|
| | | #### AI工作空间管理 |
|---|
| | |
|---|
| | | |
|---|
| | | ## 文件夹管理 |
|---|
| | | |
|---|
| | | ###common |
|---|
| | | ### common |
|---|
| | | 说明：所有公共文件和文档都存放在common文件夹其中包括 |
|---|
| | | 1.需求和策略相关的文档存放在pro-doc文件夹比如： |
|---|
| | | pro-doc/需求规范.md |
|---|
| | |
|---|
| | | 5.案例分析的文档存放在ana-doc文件夹比如： |
|---|
| | | ana-doc/案例分析规范.md |
|---|
| | | 6.全局规范.md 该文件负责存储所有全局规范和全局约定，所有 AI 都应该遵守该文档 |
|---|
| | | 7.manage-doc 存放管理体系规范和模板，用于约束管理根目录中的管理会话、管理管理员、管理观察员和管理级事项。 |
|---|
| | | |
|---|
| | | |
|---|
| | | ###项目文件夹 |
|---|
| | | ### 项目文件夹 |
|---|
| | | 设计核心：体系文件夹，包括项目文件夹都属于整个项目的公共文件夹，它们属于项目组里大家共有的东西， |
|---|
| | | 但是AI工作空间，不属于项目公有的东西，AI工作空间属于自己私产，包括最后项目打包上线也不会涵盖AI工作空间的内容。 |
|---|
| | | |
|---|
| | |
|---|
| | | 5. 其他 |
|---|
| | | |
|---|
| | | |
|---|
| | | ####项目配置清单 |
|---|
| | | #### 项目配置清单 |
|---|
| | | 在项目文件夹下有一个项目配置清单.md文件 |
|---|
| | | 里面的格式大概如下： |
|---|
| | | 1.AI名：Andrew |
|---|
| | |
|---|
| | | 工作空间: ai-foo/ |
|---|
| | | |
|---|
| | | |
|---|
| | | ####体系文件夹 |
|---|
| | | #### 体系文件夹 |
|---|
| | | 1.每一个项目每添加一个体系，那么该项目文件夹里就应该包含该体系所需要的文件夹 |
|---|
| | | |
|---|
| | | ####已有体系的文件夹说明 |
|---|
| | | #### 已有体系的文件夹说明 |
|---|
| | | |
|---|
| | | 1.开发体系 |
|---|
| | | /dev-doc : 存放所有开发相关的文档 |
|---|
| | |
|---|
| | | #### AI工作空间 |
|---|
| | | 每一个AI，在项目里有一个自己的工作空间，比如AI名叫Andrew,那么就在 |
|---|
| | | 项目目录下创建一个 `ai-andrew/` 文件夹，该文件夹下就是 AI 的工作空间。工作空间目录必须统一使用 `ai-<name>/` 前缀。 |
|---|
| | | AI工作空间下应该有一个 工作说明.md 通过该文档能够快速了解如下几点 |
|---|
| | | 1.AI工作空间下应该有一个 工作说明.md 通过该文档能够快速了解如下几点 |
|---|
| | | -- 他的工作职责范围 |
|---|
| | | -- 他的工作环境，以及工作方式和流程 |
|---|
| | | 2.AI工作空间里应该还有一个 叫 项目问题反馈.md 文档，该文档是让AI反馈在项目里协作问题的文档，该文档应该也是按append方式进行书写的，这个文档有几个主要作用 |
|---|
| | | -- 汇报AI在整个工作流程里遇到的重要问题（该问题一定要是影响整个项目或者体系内部进展的，小问题，不重要的问题不要在这里汇报） |
|---|
| | | -- 如果AI是审核员，发现自己审核的事项出现的问题，复返修复多次还是会出现同一个问题（最好大于等于3次），就需要汇报到这个文档里 |
|---|
| | | |
|---|
| | | |
|---|
| | | |
|---|
| | | ###data |
|---|
| | | ### data |
|---|
| | | |
|---|
| | | data里存放全局统一的数据源 |
|---|
| | | |
|---|
| | |
|---|
| | | 3. 实验体系 |
|---|
| | | 4. 案例分析体系 |
|---|
| | | 5. 项目体系 |
|---|
| | | 6. 管理体系 |
|---|
| | | |
|---|
| | | ###体系组件 |
|---|
| | | 管理体系是 MB-X 管理根目录的体系，不是业务子项目体系。它用于纳管管理会话：管理管理员负责执行管理动作，管理观察员负责审核管理管理员。管理体系公共规范和模板放在 `common/manage-doc/`；实例化后的管理账本放在管理根目录 `manage-doc/`。 |
|---|
| | | |
|---|
| | | ####核心目标和原则 |
|---|
| | | ### 体系组件 |
|---|
| | | |
|---|
| | | #### 核心目标和原则 |
|---|
| | | -- 可审计，任何人都可以审计在该体系中，该每一个AI的每一个进行中或者历史事项全景包括： |
|---|
| | | 1. 事项的状态 |
|---|
| | | 2. 事项的前因，中间关键节点，结果 |
|---|
| | |
|---|
| | | 5. 审计事项的设计和执行的过程是否和事项记录的聊天记录的需求一致，如果不一致一定要反馈出来 |
|---|
| | | 6. 审计过程发现文件有乱码一定要报告出来 |
|---|
| | | 7. 审计员不仅要审计事项的进行是否合理是否满足客户需求，还要审计事项的设计是否合理 |
|---|
| | | 8. 审计员发现自己审核的事项出现的问题，复返修复多次还是会出现同一个问题（最好大于等于3次），就需要汇报到自己项目里工作空间的 项目问题反馈.md 里，记录的信息要主要详细，保证项目管理员 |
|---|
| | | 到时候能追踪到具体的事项id以及有问题的步骤等等 |
|---|
| | | 9. 如果审核员发现的事项问题，反复修改多次还是反复出现同一个问题，那么在反馈内容里最好能附带解决问题的建议，甚至问题很麻烦的时候可以给完整的解决问题的方案(比如在修代码bug的时候的 代码修复方案） |
|---|
| | | 10. 审核员在审核事项的时候，要以事项为单元（也就是以对应的体系的总纲文档里的一个目标为单元）来整体审查，不能单审查事项的某一个步骤，如在审查过程中发现关键节点有缺失也应该反馈成问题，但是不允许层层加码和吹毛求疵。 |
|---|
| | | 所有的审核文档里都检查下一定要保证以下原则： |
|---|
| | | 1. 保证审核的内容的主要内容没问题 |
|---|
| | | 2. 对边角料非主要内容，不要吹毛求疵，层层加码，加大执行的难度 |
|---|
| | |
|---|
| | | ## 技能 |
|---|
| | | 1. 文档文件（不包含数据，代码等文件）创建，删除，修改技能(属于全局规范.md);参考章节 文件管理（文件增，删，改） |
|---|
| | | 下面所有的技能都不得违反全局规范.md的要求 |
|---|
| | | 2. 项目创建技能 以及 项目体系创建技能; 参考 章节体系管理员必须具备的能力 （属于manage_system\common\project-doc\项目环境创建指南.md) |
|---|
| | | 2. 项目创建技能 以及 项目体系创建技能; 参考 章节体系管理员必须具备的能力 （属于common\project-doc\项目环境创建指南.md) |
|---|
| | | 下面所有的技能都不得违反全局项目规范.md的要求 和 本地项目规范.md的要求 |
|---|
| | | 3. AI工作空间创建 以及 AI角色分配技能; 参考 章节体系管理员必须具备的能力（属于manage_system\common\project-doc\AI工作空间创建指南.md) |
|---|
| | | 4. 实验技能（包括实验设计，到实验执行）; （属于manage_system\common\exp-doc\实验规范.md 以及 项目本地 exp-doc\实验规范.md 两个共同作用的技能 ) |
|---|
| | | 5. 实验审核技能（包括实验设计审核，以及实验全流程审核）;（属于manage_system\common\exp-doc\实验审核规范.md 以及 项目本地 exp-doc\实验审核规范.md 两个共同作用的技能 ) |
|---|
| | | 6. 需求文档编写技能(包括需求方案文档，以及需求文档修改和书写）;（属于manage_system\common\pro-doc\需求规范.md 以及 项目本地 pro-doc\需求规范.md 两个共同作用的技能 ) |
|---|
| | | 7. 需求审核技能(包括需求方案文档以及需求文档修的审核）;（属于manage_system\common\pro-doc\需求审核规范.md 以及 项目本地 pro-doc\需求审核规范.md 两个共同作用的技能 ) |
|---|
| | | 8. 写代码技能（包括编码方案设计，到代码书写）;（属于manage_system\common\dev-doc\编码规范.md 以及 项目本地 dev-doc\编码规范.md 两个共同作用的技能 ) |
|---|
| | | 9. 代码审核技能（包括编码方案设计到代码书写的审核）;（属于manage_system\common\dev-doc\开发审计规范.md 以及 项目本地 dev-doc\开发审计规范.md 两个共同作用的技能 ) |
|---|
| | | 10. 案例分析技能（包括案例分析设计，案例分析全流程）;（属于manage_system\common\ana-doc\案例分析规范.md 以及 项目本地 ana-doc\案例分析规范.md 两个共同作用的技能 ) |
|---|
| | | 11. 案例分析审核技能（包括案例分析设计，案例分析全流程审计）;（属于manage_system\common\ana-doc\案例审核规范.md 以及 项目本地 ana-doc\案例审核规范.md 两个共同作用的技能 ) |
|---|
| | | 3. AI工作空间创建 以及 AI角色分配技能; 参考 章节体系管理员必须具备的能力（属于common\ai-workplace\AI工作空间创建指南.md) |
|---|
| | | 4. 实验技能（包括实验设计，到实验执行）; （属于common\exp-doc\实验规范.md 以及 项目本地 exp-doc\实验规范.md 两个共同作用的技能 ) |
|---|
| | | 5. 实验审核技能（包括实验设计审核，以及实验全流程审核）;（属于common\exp-doc\实验审核规范.md 以及 项目本地 exp-doc\实验审计规范.md 两个共同作用的技能 ) |
|---|
| | | 6. 需求文档编写技能(包括需求方案文档，以及需求文档修改和书写）;（属于common\pro-doc\需求规范.md 以及 项目本地 pro-doc\需求规范.md 两个共同作用的技能 ) |
|---|
| | | 7. 需求审核技能(包括需求方案文档以及需求文档修的审核）;（属于common\pro-doc\需求审核规范.md 以及 项目本地 pro-doc\需求审核规范.md 两个共同作用的技能 ) |
|---|
| | | 8. 写代码技能（包括编码方案设计，到代码书写）;（属于common\dev-doc\编码规范.md 以及 项目本地 dev-doc\编码规范.md 两个共同作用的技能 ) |
|---|
| | | 9. 代码审核技能（包括编码方案设计到代码书写的审核）;（属于common\dev-doc\开发审计规范.md 以及 项目本地 dev-doc\开发审计规范.md 两个共同作用的技能 ) |
|---|
| | | 10. 案例分析技能（包括案例分析设计，案例分析全流程）;（属于common\ana-doc\案例分析规范.md 以及 项目本地 ana-doc\案例分析规范.md 两个共同作用的技能 ) |
|---|
| | | 11. 案例分析审核技能（包括案例分析设计，案例分析全流程审计）;（属于common\ana-doc\案例审核规范.md 以及 项目本地 ana-doc\案例审核规范.md 两个共同作用的技能 ) |
|---|
| | | 12. 管理体系创建和管理控制技能（包括管理根目录初始化、项目创建、体系启用、角色创建、会话创建、MB-X 更新和 skill 同步）;（属于common\manage-doc\管理体系规范.md、common\manage-doc\管理环境创建指南.md 与 MB-X 管理类 skill 共同作用的技能 ) |
|---|
| | | 13. 管理观察审核技能（包括管理事项计划审核、执行审核、变更审核、框架更新审核和复审）;（属于common\manage-doc\管理体系规范.md、common\manage-doc\管理审计报告模版.md 与管理观察员工作说明共同作用的技能 ) |
|---|
| | | |
|---|
| | | ##体系特殊说明 |
|---|
| | | ## 体系特殊说明 |
|---|
| | | 实验体系目前固定成如下： |
|---|
| | | 1. 实验员和实验-开发员目前固定成一个ai |
|---|
| | | 2. 实验员的审核员和 实验-开发员的审核员 也都固定成一个ai, 这个ai对实验的审核 以及 实验开发员 的审核都统一记录在 exp-doc/实验审计报告.md 里 |
|---|
