1
2026-06-26 d2d03e02c7b8d982e29de0846726d9b7ee9c82d9
全局规范.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. 实验事项。
@@ -548,7 +555,23 @@
半成品、空壳文件、失败包不得被下游当成正式完成产物。
## 17. 汇报规范
## 17. Codex 会话上下文保护规范
角色窗口处理任务时,必须遵守“主体内容落文档,窗口只展示摘要和证据入口”的原则。
禁止将大文件、大目录、大量搜索结果、批量日志或批量图片内容直接回显到 Codex 会话窗口。
具体要求:
1. 不得直接使用 `Get-Content -Raw` 将大文件完整输出到窗口。
2. `rg`、`Select-String`、日志检索、代码检索等操作必须限制输出行数;如需全量结果,应写入 `tmp/`、readout 文件、证据包、审计附件或正式结果文档。
3. 不得对大目录执行无上限递归列表并直接回显;目录扫描结果应输出到文件,只在窗口展示摘要、数量、关键路径和异常项。
4. 图片证据优先记录图片路径、manifest、缩略图或抽样结果;避免批量 `view_image` 把大图片载荷写入会话历史。
5. 大结果应写入 `tmp/`、evidence package、readout 文件、审计附件或正式结果文档。
6. 角色窗口和 MB-X 消息只展示摘要、关键行、文件路径、证据入口、结论和期望动作,不复制大段正文。
7. 处理 `context window full` 或上下文耗尽时,不得未经确认直接创建新 thread;应优先执行备份、摘要、裁剪、审计记录和原 thread 恢复。
## 18. 汇报规范
对用户汇报时,默认先说结论。
@@ -565,7 +588,7 @@
不得把“代码能跑”“测试通过”“summary 好看”直接说成“事项通过”。
## 18. 禁止事项
## 19. 禁止事项
禁止:
@@ -580,7 +603,7 @@
9. 不记录来源聊天就开始执行复杂事项。
10. 问题未复验就关闭。
## 19. 变更规则
## 20. 变更规则
修改本文件时必须遵守:
@@ -590,13 +613,13 @@
4. 不得因为某个项目的临时问题,把全局规范改得过重。
5. 如果只是执行者个人失误,不应上升成全局硬规则。
## 20. 当前核心口径摘要
## 21. 当前核心口径摘要
1. 体系是插件,用不用由项目管理员决定。
2. 项目体系和开发体系默认随项目创建;其他体系由项目管理员按需启用。
3. 启用体系后,项目必须遵守 common 规范和本地规范;开发体系在未创建具体目标开发工作区前,先遵守 common/dev-doc 全局开发规范。
4. 正式文档必须有职责、引用、记录方式和目录入口;非文档产物必须能通过 manifest、索引或日志追溯。
5. 权限跟角色走,审核员不直接改被审计产物。
5. 权限跟角色走,审核员可维护对应本地审核 / 审计规范,但不直接改被审计产物或被审体系执行规范。
6. 开发体系绑定目标体系,代码放 `dev/<target>-dev/`,目标代码文档和方案附件放 `dev-doc/<target>-doc/`;正式开发账本统一放 `dev-doc/` 根目录。
7. 所有正式事项必须有目标、过程、结果和审计证据链。
8. 审核抓真问题,不吹毛求疵,不层层加码。
@@ -605,3 +628,4 @@
11. 具体项目内容不得污染全局或 common。
12. 项目本地规范可以补充规则和设计本地流程;已审核通过的本地流程优先执行,但不能削弱全局规范和 common 体系硬约束。
13. 全局公共数据入口是 `全局存储体系.md` 和 `全局数据格式.md`;读数据先找数据源,写字段先核 schema。
14. Codex 角色窗口只展示摘要和证据入口,大输出必须落入文件、证据包或正式文档;上下文耗尽时先备份、摘要、裁剪和审计,不得未经确认直接创建新 thread。