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 | 29 ++++++++++++++++++----------- 1 files changed, 18 insertions(+), 11 deletions(-) diff --git "a/\345\205\250\345\261\200\350\247\204\350\214\203.md" "b/\345\205\250\345\261\200\350\247\204\350\214\203.md" index ade01ae..7895779 100644 --- "a/\345\205\250\345\261\200\350\247\204\350\214\203.md" +++ "b/\345\205\250\345\261\200\350\247\204\350\214\203.md" @@ -3,7 +3,7 @@ 创建人员：Codex 文件职责：记录管理体系下所有项目、所有 AI、所有事项默认遵守的全局规则。 管理规范/模板：参考 `管理系统说明.md` 和 `体系说明.md`；本文件是全局执行规则，不是体系说明书。 -引用文件：`管理系统说明.md`；`体系说明.md`；`体系创建流程.md`；`全局存储体系.md`；`全局数据格式.md`；`common/ai-workplace/AI工作空间创建指南.md`；`common/pro-doc/产品规范.md`；`common/pro-doc/需求规范.md`；`common/dev-doc/编码规范.md`；`common/exp-doc/实验规范.md`；`common/exp-doc/实验审核规范.md`。 +引用文件：`管理系统说明.md`；`体系说明.md`；`体系创建流程.md`；`全局存储体系.md`；`全局数据格式.md`；`common/ai-workplace/AI工作空间创建指南.md`；`common/pro-doc/需求规范.md`；`common/dev-doc/编码规范.md`；`common/exp-doc/实验规范.md`；`common/exp-doc/实验审核规范.md`。 记录方式：本文件为全局规则文档；新增规则默认追加到对应章节，重大口径变化必须保留变更说明，不得静默覆盖历史原因。 ## 1. 文档定位 @@ -26,8 +26,8 @@ 本文件适用于： 1. `manage_system` 下所有项目。 -2. 所有项目管理员、开发 AI、产品 AI、实验员、案例分析员、审核员和临时协作 AI。 -3. 所有产品、需求、编码、实验、案例分析、数据处理、审计和归档事项。 +2. 所有项目管理员、开发 AI、需求 AI、实验员、案例分析员、审核员和临时协作 AI。 +3. 所有需求、编码、实验、案例分析、数据处理、审计和归档事项。 规范优先级： @@ -59,7 +59,7 @@ ## 3. 体系插件原则 -`common/` 下的产品体系、开发体系、实验体系、数据体系、案例分析体系，都是体系插件。项目体系和开发体系是项目创建时默认自带的基础体系；其他体系由项目管理员按需启用。 +`common/` 下的需求体系、开发体系、实验体系、数据体系、案例分析体系，都是体系插件。项目体系和开发体系是项目创建时默认自带的基础体系；其他体系由项目管理员按需启用。 默认口径： @@ -184,7 +184,7 @@ ```text common/ project-doc/ 项目规范、项目创建、项目审计规范 - pro-doc/ 产品、需求、策略规范 + pro-doc/ 需求、策略规范 dev-doc/ 开发体系、编码、测试、代码审核规范 exp-doc/ 实验规范、实验模板、实验审核规范 data-doc/ 数据存储、数据样本、数据字典规范 @@ -212,7 +212,7 @@ ```text dev/ 开发代码根目录；具体代码放 dev/<target>-dev/ dev-doc/ 开发文档根目录；根级开发账本和规范放 dev-doc/；目标代码文档和方案附件放 dev-doc/<target>-doc/ -pro-doc/ 产品文档、需求文档 +pro-doc/ 需求文档、策略说明、业务规则说明 exp-doc/ 实验文档 exp-data/ 实验数据和结果包 ana-doc/ 案例分析文档 @@ -252,11 +252,11 @@ 默认角色： 1. 项目管理员：项目根目录管理权限。 -2. 产品 AI：`pro-doc/` 写权限，负责产品、需求、策略和业务规则文档。 +2. 需求 AI：`pro-doc/` 写权限，负责需求、策略和业务规则文档。 3. 开发 AI：按目标体系绑定 `dev/<target>-dev/`、`dev/<target>-dev/test/`、`dev-doc/<target>-doc/` 写权限；不默认拥有所有开发子目录写权限。 4. 实验员：`exp-doc/`、`exp-data/` 写权限。 5. 案例分析员：`ana-doc/`、`ana-data/` 写权限。 -6. 审核员：主写对应审计报告；如审计问题需要跨轮跟踪，只在问题记录中写索引或关联，不直接改被审计产物。 +6. 审核员：主写对应审计报告；如审计问题需要跨轮跟踪，只在问题记录中写索引或关联；可维护自己审核职责对应的本地审核 / 审计规范，但不默认改被审计产物或被审体系执行规范。 所有 AI 默认拥有项目内所有文件的读权限。 @@ -266,7 +266,7 @@ 工作空间目录必须统一使用 `ai-<name>/` 命名，`<name>` 使用稳定英文名或拼音小写。例如 Andrew 使用 `ai-andrew/`，Codex 使用 `ai-codex/`。禁止直接使用裸 AI 名目录，例如 `Andrew/`、`Codex/`。 -创建 AI 工作空间、分配角色、生成 `工作说明.md` 时，按 `common/ai-workplace/AI工作空间创建指南.md` 执行，并同步更新项目根目录 `项目配置清单.md`、`项目执行日志.md` 和 `项目变更记录.md`。 +创建 AI 工作空间、分配角色、生成 `工作说明.md` 和 `项目问题反馈.md` 时，按 `common/ai-workplace/AI工作空间创建指南.md` 执行，并同步更新项目根目录 `项目配置清单.md`、`项目执行日志.md` 和 `项目变更记录.md`。 工作空间用于： @@ -274,6 +274,9 @@ 2. 草稿。 3. 私有中间产物。 4. 未进入正式体系的探索材料。 +5. 重大协作问题和反复返修问题的私有反馈入口。 + +`项目问题反馈.md` 不替代正式审计报告、项目问题记录或执行日志；具体边界按 `common/project-doc/项目规范.md` 和 `common/ai-workplace/AI工作空间创建指南.md` 执行。 AI 对自己的工作空间有读写权限。 @@ -290,6 +293,7 @@ 3. 写审计报告。 4. 在需要跨轮跟踪时写问题记录索引或关联。 5. 要求执行者补证据、修复或重跑。 +6. 维护自己审核职责对应的本地审核 / 审计规范文档，例如 `实验审计规范.md`、`案例审核规范.md`、`开发审计规范.md`、`需求审核规范.md`。该权限只用于审核流程、审计口径和阻断标准维护，不得削弱全局规范、全局项目规范或 common 体系硬约束。 审核员默认不得： @@ -297,8 +301,11 @@ 2. 直接替执行者修改业务主表。 3. 用自己的补丁掩盖执行问题。 4. 把边角料问题升级成阻断问题。 +5. 以审核员身份直接修改被审体系执行规范、事项设计 / 计划、执行日志、结果包或正式主产物；例如实验审核员不默认修改 `实验规范.md`，案例审核员不默认修改 `案例分析规范.md`。 如果审核员必须临时修复工具脚本，应明确标记为“审计辅助脚本”，不能冒充执行方正式产物。 + +如果确实需要修改被审体系执行规范，应创建独立的规范维护事项，或在 `项目配置清单.md` 中额外授予体系维护员 / 规范维护员角色；修改必须记录原因、影响范围、证据路径和复审入口，重大改动应由项目管理员或另一个审核员确认。 ## 7. 项目根目录 `项目规范.md` 规范 @@ -334,7 +341,7 @@ 事项类型可以包括： -1. 产品事项。 +1. 需求事项。 2. 需求事项。 3. 编码事项。 4. 实验事项。 @@ -596,7 +603,7 @@ 2. 项目体系和开发体系默认随项目创建；其他体系由项目管理员按需启用。 3. 启用体系后，项目必须遵守 common 规范和本地规范；开发体系在未创建具体目标开发工作区前，先遵守 common/dev-doc 全局开发规范。 4. 正式文档必须有职责、引用、记录方式和目录入口；非文档产物必须能通过 manifest、索引或日志追溯。 -5. 权限跟角色走，审核员不直接改被审计产物。 +5. 权限跟角色走，审核员可维护对应本地审核 / 审计规范，但不直接改被审计产物或被审体系执行规范。 6. 开发体系绑定目标体系，代码放 `dev/<target>-dev/`，目标代码文档和方案附件放 `dev-doc/<target>-doc/`；正式开发账本统一放 `dev-doc/` 根目录。 7. 所有正式事项必须有目标、过程、结果和审计证据链。 8. 审核抓真问题，不吹毛求疵，不层层加码。 -- Gitblit v1.9.3