| | |
|---|
| | | 创建人员：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. 文档定位 |
|---|
| | |
|---|
| | | 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 默认拥有项目内所有文件的读权限。 |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | 工作空间目录必须统一使用 `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`。 |
|---|
| | | |
|---|
| | | 工作空间用于： |
|---|
| | | |
|---|
| | |
|---|
| | | 2. 草稿。 |
|---|
| | | 3. 私有中间产物。 |
|---|
| | | 4. 未进入正式体系的探索材料。 |
|---|
| | | 5. 重大协作问题和反复返修问题的私有反馈入口。 |
|---|
| | | |
|---|
| | | `项目问题反馈.md` 不替代正式审计报告、项目问题记录或执行日志；具体边界按 `common/project-doc/项目规范.md` 和 `common/ai-workplace/AI工作空间创建指南.md` 执行。 |
|---|
| | | |
|---|
| | | AI 对自己的工作空间有读写权限。 |
|---|
| | | |
|---|
| | |
|---|
| | | 3. 写审计报告。 |
|---|
| | | 4. 在需要跨轮跟踪时写问题记录索引或关联。 |
|---|
| | | 5. 要求执行者补证据、修复或重跑。 |
|---|
| | | 6. 维护自己审核职责对应的本地审核 / 审计规范文档，例如 `实验审计规范.md`、`案例审核规范.md`、`开发审计规范.md`、`需求审核规范.md`。该权限只用于审核流程、审计口径和阻断标准维护，不得削弱全局规范、全局项目规范或 common 体系硬约束。 |
|---|
| | | |
|---|
| | | 审核员默认不得： |
|---|
| | | |
|---|
| | |
|---|
| | | 2. 直接替执行者修改业务主表。 |
|---|
| | | 3. 用自己的补丁掩盖执行问题。 |
|---|
| | | 4. 把边角料问题升级成阻断问题。 |
|---|
| | | 5. 以审核员身份直接修改被审体系执行规范、事项设计 / 计划、执行日志、结果包或正式主产物；例如实验审核员不默认修改 `实验规范.md`，案例审核员不默认修改 `案例分析规范.md`。 |
|---|
| | | |
|---|
| | | 如果审核员必须临时修复工具脚本，应明确标记为“审计辅助脚本”，不能冒充执行方正式产物。 |
|---|
| | | |
|---|
| | | 如果确实需要修改被审体系执行规范，应创建独立的规范维护事项，或在 `项目配置清单.md` 中额外授予体系维护员 / 规范维护员角色；修改必须记录原因、影响范围、证据路径和复审入口，重大改动应由项目管理员或另一个审核员确认。 |
|---|
| | | |
|---|
| | | ## 7. 项目根目录 `项目规范.md` 规范 |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | 半成品、空壳文件、失败包不得被下游当成正式完成产物。 |
|---|
| | | |
|---|
| | | ## 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. 汇报规范 |
|---|
| | | |
|---|
| | | 对用户汇报时，默认先说结论。 |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | 不得把“代码能跑”“测试通过”“summary 好看”直接说成“事项通过”。 |
|---|
| | | |
|---|
| | | ## 18. 禁止事项 |
|---|
| | | ## 19. 禁止事项 |
|---|
| | | |
|---|
| | | 禁止： |
|---|
| | | |
|---|
| | |
|---|
| | | 9. 不记录来源聊天就开始执行复杂事项。 |
|---|
| | | 10. 问题未复验就关闭。 |
|---|
| | | |
|---|
| | | ## 19. 变更规则 |
|---|
| | | ## 20. 变更规则 |
|---|
| | | |
|---|
| | | 修改本文件时必须遵守： |
|---|
| | | |
|---|
| | |
|---|
| | | 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. 审核抓真问题，不吹毛求疵，不层层加码。 |
|---|
| | |
|---|
| | | 11. 具体项目内容不得污染全局或 common。 |
|---|
| | | 12. 项目本地规范可以补充规则和设计本地流程；已审核通过的本地流程优先执行，但不能削弱全局规范和 common 体系硬约束。 |
|---|
| | | 13. 全局公共数据入口是 `全局存储体系.md` 和 `全局数据格式.md`；读数据先找数据源，写字段先核 schema。 |
|---|
| | | 14. Codex 角色窗口只展示摘要和证据入口，大输出必须落入文件、证据包或正式文档；上下文耗尽时先备份、摘要、裁剪和审计，不得未经确认直接创建新 thread。 |
|---|
