From 612c64454865dcebaac47fad3e950ba73d60c2fd Mon Sep 17 00:00:00 2001 From: 1 <wentingyear@gmail.com> Date: Wed, 03 Jun 2026 21:26:49 +0800 Subject: [PATCH] Update routing smoke docs --- project-routing-smoke-20260603/项目事项总纲.md | 8 + common/dev-doc/编码规范.md | 3 common/exp-doc/实验环境创建指南.md | 2 project-routing-smoke-20260603/dev-doc/ana-doc/开发工作区说明.md | 10 + project-routing-smoke-20260603/dev-doc/开发执行日志.md | 8 + project-routing-smoke-20260603/dev-doc/编码规范.md | 8 + project-routing-smoke-20260603/dev-doc/开发审计规范.md | 8 + common/dev-doc/开发审计规范.md | 8 + common/dev-doc/目录导读.md | 4 project-routing-smoke-20260603/项目总览.md | 10 + project-routing-smoke-20260603/dev-doc/开发事项计划.md | 8 + project-routing-smoke-20260603/dev-doc/exp-doc/开发工作区说明.md | 10 + project-routing-smoke-20260603/dev-doc/目录导读.md | 8 + common/ana-doc/案例分析环境创建指南.md | 2 project-routing-smoke-20260603/ana-doc/案例分析规范.md | 8 + project-routing-smoke-20260603/项目事项审计报告.md | 8 + project-routing-smoke-20260603/exp-doc/实验规范.md | 8 + common/dev-doc/开发事项总纲模版.md | 4 common/project-doc/项目配置清单模版.md | 8 project-routing-smoke-20260603/pro-doc/需求审核规范.md | 8 + 管理系统说明.md | 14 + common/dev-doc/开发执行日志模版.md | 6 project-routing-smoke-20260603/dev-doc/pro-doc/开发工作区说明.md | 10 + common/project-doc/项目环境创建指南.md | 2 project-routing-smoke-20260603/dev-doc/exp-doc/目录导读.md | 8 + project-routing-smoke-20260603/项目变更记录.md | 10 + project-routing-smoke-20260603/exp-doc/实验审计报告.md | 10 + common/dev-doc/开发事项计划模版.md | 6 project-routing-smoke-20260603/ai-ana/工作说明.md | 11 + project-routing-smoke-20260603/项目配置清单.md | 16 ++ project-routing-smoke-20260603/dev-doc/ana-doc/目录导读.md | 8 + project-routing-smoke-20260603/项目事项计划.md | 8 + project-routing-smoke-20260603/dev-doc/开发问题记录.md | 8 + project-routing-smoke-20260603/dev-doc/开发审计报告.md | 8 + project-routing-smoke-20260603/项目问题记录.md | 8 + common/ai-workplace/AI工作空间创建指南.md | 14 + common/ana-doc/案例审核规范.md | 2 common/dev-doc/开发问题记录模版.md | 6 project-routing-smoke-20260603/ai-pro/工作说明.md | 11 + common/dev-doc/编码方案范本.md | 4 project-routing-smoke-20260603/ai-exp/工作说明.md | 11 + project-routing-smoke-20260603/ana-doc/案例审计报告.md | 10 + project-routing-smoke-20260603/dev-doc/开发事项总纲.md | 8 + common/dev-doc/开发环境创建指南.md | 26 ++- project-routing-smoke-20260603/dev-doc/pro-doc/目录导读.md | 8 + common/exp-doc/实验审核规范.md | 2 project-routing-smoke-20260603/pro-doc/需求规范.md | 8 + project-routing-smoke-20260603/项目执行日志.md | 10 + project-routing-smoke-20260603/项目规范.md | 8 + 49 files changed, 362 insertions(+), 40 deletions(-) diff --git "a/common/ai-workplace/AI\345\267\245\344\275\234\347\251\272\351\227\264\345\210\233\345\273\272\346\214\207\345\215\227.md" "b/common/ai-workplace/AI\345\267\245\344\275\234\347\251\272\351\227\264\345\210\233\345\273\272\346\214\207\345\215\227.md" index 4720637..5e78af5 100644 --- "a/common/ai-workplace/AI\345\267\245\344\275\234\347\251\272\351\227\264\345\210\233\345\273\272\346\214\207\345\215\227.md" +++ "b/common/ai-workplace/AI\345\267\245\344\275\234\347\251\272\351\227\264\345\210\233\345\273\272\346\214\207\345\215\227.md" @@ -57,7 +57,9 @@ | 开发 AI | 开发 AI(案例分析开发) | `dev/ana-dev/`;`dev-doc/ana-doc/` | | 审核员 | 审核员(项目事项审核) | `项目事项审计报告.md` | | 审核员 | 审核员(实验审核) | `exp-doc/实验审计报告.md` | -| 审核员 | 审核员(开发审核) | `dev-doc/开发审计报告.md` | +| 审核员 | 审核员(需求开发审核 / 项目工具开发审核) | `dev-doc/开发审计报告.md` | +| 审核员 | 审核员(实验开发审核) | `exp-doc/实验审计报告.md` | +| 审核员 | 审核员(案例分析开发审核) | `ana-doc/案例审计报告.md` | | 审核员 | 审核员(需求审核) | `pro-doc/需求审计报告.md` 或项目约定需求审核入口 | 审核员不是只读审计规范。任何审核员都必须同时读取: @@ -108,12 +110,12 @@ | 审核角色 | 必读文档 | |---|---| | 需求审核员 | 项目本地 `pro-doc/需求规范.md`、`pro-doc/需求审核规范.md`、被审需求事项账本和上游聊天 / 文档证据 | -| 开发审核员 | 项目本地 `dev-doc/编码规范.md`、`dev-doc/开发审计规范.md`、被审开发事项账本、需求文档和开发产物证据 | +| 开发审核员 | 项目本地 `dev-doc/编码规范.md`、`dev-doc/开发审计规范.md`、被审开发事项账本、目标体系规范和开发产物证据;审计报告入口按目标体系查看项目配置清单 | | 实验审核员 | 项目本地 `exp-doc/实验规范.md`、`exp-doc/实验审核规范.md`、被审实验总纲 / 实验设计 / 执行日志 / 结果包 | | 案例分析审核员 | 项目本地 `ana-doc/案例分析规范.md`、`ana-doc/案例分析审核规范.md`、被审案例账本 / 执行记录 / 图片或数据证据 | | 项目事项审核员 | 项目本地 `项目规范.md`、`项目配置清单.md`、项目事项总纲 / 项目事项计划 / 项目执行日志 / 项目变更记录 | -如果是组合审核角色,例如“需求-开发-审核员”,工作说明必须同时列出需求规范、编码规范、需求审核规范、开发审计规范,以及对应需求事项和开发事项的账本入口。不得只列审计报告或只列审核规范。 +如果是组合审核角色,例如“需求-开发-审核员”“实验-开发-审核员”“案例分析-开发-审核员”,工作说明必须同时列出目标体系规范、编码规范、目标体系审核规范、开发审计规范,以及对应目标事项和开发事项的账本入口。不得只列审计报告或只列审核规范。 组合角色必须避免“自己执行、自己无条件通过”的问题。若同一 AI 同时是执行者和审核员,`工作说明.md` 必须要求它在审计报告中明确标注“自审”,并列出可复核证据;重大事项应优先安排独立审核员。 @@ -341,8 +343,10 @@ 1. 需求-开发角色:`工作说明.md` 必须同时列出 `pro-doc/需求规范.md`、相关需求事项账本或需求文档入口、`dev-doc/编码规范.md`、`dev-doc/开发审计规范.md`、`dev/pro-dev/`、`dev-doc/pro-doc/`。 2. 实验-开发角色:`工作说明.md` 必须同时列出 `exp-doc/实验规范.md`、`exp-doc/实验审核规范.md`、相关实验总纲 / 实验设计入口、`dev-doc/编码规范.md`、`dev-doc/开发审计规范.md`、目标实验开发工作区。 3. 案例分析-开发角色:`工作说明.md` 必须同时列出案例分析规范、案例审核规范、相关案例账本入口、`dev-doc/编码规范.md`、`dev-doc/开发审计规范.md`、目标案例开发工作区。 -4. 需求-开发-审核员:`工作说明.md` 必须同时列出需求规范、需求审核规范、编码规范、开发审计规范、需求审计报告、开发审计报告、需求事项账本入口、开发事项账本入口;不得只列审计报告或只列审核规范。 -5. 任一组合审核员:必须列出它要审核的每个体系的“怎么做”文档和“怎么审”文档。如果漏任一体系规范,校验不通过。 +4. 需求-开发-审核员:`工作说明.md` 必须同时列出需求规范、需求审核规范、编码规范、开发审计规范、需求审计报告、`dev-doc/开发审计报告.md`、需求事项账本入口、开发事项账本入口;不得只列审计报告或只列审核规范。 +5. 实验-开发-审核员:`工作说明.md` 必须同时列出实验规范、实验审核规范、编码规范、开发审计规范、`exp-doc/实验审计报告.md`、实验事项账本入口、开发事项账本入口和实验开发工作区;不得把审计入口写成 `dev-doc/开发审计报告.md`。 +6. 案例分析-开发-审核员:`工作说明.md` 必须同时列出案例分析规范、案例审核规范、编码规范、开发审计规范、`ana-doc/案例审计报告.md`、案例事项账本入口、开发事项账本入口和案例分析开发工作区;不得把审计入口写成 `dev-doc/开发审计报告.md`。 +7. 任一组合审核员:必须列出它要审核的每个体系的“怎么做”文档和“怎么审”文档。如果漏任一体系规范,校验不通过。 ### 6.5 项目级日志和变更校验 diff --git "a/common/ana-doc/\346\241\210\344\276\213\345\210\206\346\236\220\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" "b/common/ana-doc/\346\241\210\344\276\213\345\210\206\346\236\220\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" index 3f4a823..1865e6e 100644 --- "a/common/ana-doc/\346\241\210\344\276\213\345\210\206\346\236\220\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" +++ "b/common/ana-doc/\346\241\210\344\276\213\345\210\206\346\236\220\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" @@ -12,6 +12,8 @@ 本指南只负责创建案例分析环境,不替代具体案例分析工作。 +默认口径:案例分析员和案例分析开发员可由同一个 AI 承担;案例审核员和案例分析开发审核员也可由同一个 AI 承担。案例分析开发的审核结论统一写入 `ana-doc/案例审计报告.md`,不另写到 `dev-doc/开发审计报告.md`。 + ## 2. 输入 创建前应明确: diff --git "a/common/ana-doc/\346\241\210\344\276\213\345\256\241\346\240\270\350\247\204\350\214\203.md" "b/common/ana-doc/\346\241\210\344\276\213\345\256\241\346\240\270\350\247\204\350\214\203.md" index 6692181..ea9ee59 100644 --- "a/common/ana-doc/\346\241\210\344\276\213\345\256\241\346\240\270\350\247\204\350\214\203.md" +++ "b/common/ana-doc/\346\241\210\344\276\213\345\256\241\346\240\270\350\247\204\350\214\203.md" @@ -98,6 +98,8 @@ 审核员发现的问题,主记录写入 `案例审计报告.md`。 +如果案例分析事项包含案例分析开发,案例分析开发的方案审核、实现审核、测试验收和复审结论也统一写入 `ana-doc/案例审计报告.md`,不另写到 `dev-doc/开发审计报告.md`。 + 只有问题需要跨轮跟踪、跨案例汇总或由案例分析员长期处理时,才在 `案例问题记录.md` 中建立索引或关联,不重复全文。 审核报告至少包含: diff --git "a/common/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\346\200\273\347\272\262\346\250\241\347\211\210.md" "b/common/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\346\200\273\347\272\262\346\250\241\347\211\210.md" index 28fd572..f5cffdb 100644 --- "a/common/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\346\200\273\347\272\262\346\250\241\347\211\210.md" +++ "b/common/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\346\200\273\347\272\262\346\250\241\347\211\210.md" @@ -3,7 +3,7 @@ 创建人员:<创建人员> 文件职责:作为目标开发工作区的滚动账本,记录开发事项背景、来源、目标、边界、状态和结论。 管理规范/模板:common/dev-doc/编码规范.md;common/dev-doc/开发事项总纲模版.md。 -引用文件:开发事项计划.md;开发执行日志.md;开发审计报告.md;开发问题记录.md;重型开发编码方案文件按事项创建。 +引用文件:开发事项计划.md;开发执行日志.md;对应审计报告入口;开发问题记录.md;重型开发编码方案文件按事项创建。 记录方式:append-only 开发事项总纲账本;新开发事项、新阶段、新结论追加到文件末尾。 ## 1. 当前开发总览 @@ -61,7 +61,7 @@ <开发执行日志.md 中 DEV-LOG-ID> 审计入口: -<开发审计报告.md 中 AUDIT-ID> +<对应审计报告入口中的 AUDIT-ID> 问题入口: <开发问题记录.md 中 ISSUE-ID;如无写“无”> diff --git "a/common/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\350\256\241\345\210\222\346\250\241\347\211\210.md" "b/common/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\350\256\241\345\210\222\346\250\241\347\211\210.md" index 6a8201d..93e2175 100644 --- "a/common/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\350\256\241\345\210\222\346\250\241\347\211\210.md" +++ "b/common/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\350\256\241\345\210\222\346\250\241\347\211\210.md" @@ -3,7 +3,7 @@ 创建人员:<创建人员> 文件职责:作为目标开发工作区的滚动账本,记录开发计划、步骤、输入输出、验收方式和审计入口。 管理规范/模板:common/dev-doc/编码规范.md;common/dev-doc/开发事项计划模版.md。 -引用文件:开发事项总纲.md;开发执行日志.md;开发审计报告.md;重型开发编码方案文件按事项创建。 +引用文件:开发事项总纲.md;开发执行日志.md;对应审计报告入口;重型开发编码方案文件按事项创建。 记录方式:append-only 开发事项计划账本;新计划、新修订追加到文件末尾。 ## 1. 当前计划总览 @@ -63,7 +63,7 @@ 未审计 / 审计通过 / 审计不通过 / 暂缓 计划审计入口: -<开发审计报告.md 中 AUDIT-ID> +<对应审计报告入口中的 AUDIT-ID> 状态: 未开始 / 进行中 / 待审核 / 完成 / 暂停 / 取消 @@ -75,4 +75,4 @@ <开发执行日志.md 中 DEV-LOG-ID> 执行审计入口: -<开发审计报告.md 中 AUDIT-ID> +<对应审计报告入口中的 AUDIT-ID> diff --git "a/common/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\350\247\204\350\214\203.md" "b/common/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\350\247\204\350\214\203.md" index 9cf1977..6726743 100644 --- "a/common/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\350\247\204\350\214\203.md" +++ "b/common/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\350\247\204\350\214\203.md" @@ -124,7 +124,13 @@ ## 7. 审计报告口径 -开发审核员发现的问题主记录写入 `开发审计报告.md`。 +开发审核员发现的问题主记录写入对应审计报告入口。 + +默认入口: + +1. 需求开发、项目工具开发、独立开发事项:`dev-doc/开发审计报告.md`。 +2. 实验开发:`exp-doc/实验审计报告.md`。 +3. 案例分析开发:`ana-doc/案例审计报告.md`。 非审计人员发现的问题写入 `开发问题记录.md`。 diff --git "a/common/dev-doc/\345\274\200\345\217\221\346\211\247\350\241\214\346\227\245\345\277\227\346\250\241\347\211\210.md" "b/common/dev-doc/\345\274\200\345\217\221\346\211\247\350\241\214\346\227\245\345\277\227\346\250\241\347\211\210.md" index 67889c0..7e2b035 100644 --- "a/common/dev-doc/\345\274\200\345\217\221\346\211\247\350\241\214\346\227\245\345\277\227\346\250\241\347\211\210.md" +++ "b/common/dev-doc/\345\274\200\345\217\221\346\211\247\350\241\214\346\227\245\345\277\227\346\250\241\347\211\210.md" @@ -3,7 +3,7 @@ 创建人员:<创建人员> 文件职责:作为目标开发工作区的滚动账本,记录开发执行过程、关键节点、测试、自检、偏离和结果。 管理规范/模板:common/dev-doc/编码规范.md;common/dev-doc/开发执行日志模版.md。 -引用文件:开发事项总纲.md;开发事项计划.md;开发审计报告.md;开发问题记录.md;重型开发编码方案文件按事项创建。 +引用文件:开发事项总纲.md;开发事项计划.md;对应审计报告入口;开发问题记录.md;重型开发编码方案文件按事项创建。 记录方式:append-only 开发执行日志;每次开发 run、测试、自检或修复追加到文件末尾。 ## 1. 当前日志说明 @@ -69,10 +69,10 @@ 完成 / 部分完成 / 失败 / 暂停 结论回写: -<已回写到开发事项总纲 / 计划 / 审计报告的位置,或写待回写原因> +<已回写到开发事项总纲 / 计划 / 对应审计报告入口的位置,或写待回写原因> 后续动作: <下一步> 审计入口: -<开发审计报告.md 中 AUDIT-ID> +<对应审计报告入口中的 AUDIT-ID> diff --git "a/common/dev-doc/\345\274\200\345\217\221\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" "b/common/dev-doc/\345\274\200\345\217\221\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" index 9dc9065..a0d8a1d 100644 --- "a/common/dev-doc/\345\274\200\345\217\221\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" +++ "b/common/dev-doc/\345\274\200\345\217\221\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" @@ -107,13 +107,13 @@ | `dev-doc/开发事项总纲.md` | `开发事项总纲模版.md` | 根级开发事项背景、目标、边界、状态和结论滚动账本 | | `dev-doc/开发事项计划.md` | `开发事项计划模版.md` | 根级开发计划、步骤、输入输出、验收方式和审计入口 | | `dev-doc/开发执行日志.md` | `开发执行日志模版.md` | 根级实际编码、测试、自检和偏离记录 | -| `dev-doc/开发审计报告.md` | `开发审计报告模版.md` | 根级方案审核、实现审核、测试验收和复审 | +| `dev-doc/开发审计报告.md` | `开发审计报告模版.md` | 需求开发、项目工具开发、独立开发事项的方案审核、实现审核、测试验收和复审 | | `dev-doc/开发问题记录.md` | `开发问题记录模版.md` | 根级非审计来源开发问题闭环 | | `dev-doc/<target>-doc/目录导读.md` | 可手写 | 说明目标开发工作区的入口和当前事项 | | `dev-doc/<target>-doc/开发工作区说明.md` | 可手写 | 说明目标开发目录、代码入口、测试入口、所属事项和根级账本回写位置 | | `dev-doc/<target>-doc/开发方案/` | 按需创建 | 存放重型开发事项的具体编码方案文件;轻量开发可不创建具体方案 | -一个项目只有一套开发体系账本。实验开发、案例分析开发、项目工具开发都统一登记到 `dev-doc/开发事项总纲.md`、`dev-doc/开发事项计划.md`、`dev-doc/开发执行日志.md`、`dev-doc/开发审计报告.md`、`dev-doc/开发问题记录.md`。`dev-doc/<target>-doc/` 只放目标相关代码文档和方案附件,不再复制一套完整开发体系。 +一个项目只有一套开发体系账本。开发事项总纲、计划、执行日志和问题记录默认登记到 `dev-doc/开发事项总纲.md`、`dev-doc/开发事项计划.md`、`dev-doc/开发执行日志.md`、`dev-doc/开发问题记录.md`。审计报告入口按目标体系分账:需求开发、项目工具开发、独立开发事项写 `dev-doc/开发审计报告.md`;实验开发写 `exp-doc/实验审计报告.md`;案例分析开发写 `ana-doc/案例审计报告.md`。`dev-doc/<target>-doc/` 只放目标相关代码文档和方案附件,不再复制一套完整开发体系。 ## 5. 创建步骤 @@ -168,14 +168,14 @@ 创建人员:<填写> 文件职责:记录本目标开发工作区的代码入口、测试入口、所属事项、方案附件和根级开发账本回写位置。 管理规范/模板:common/dev-doc/开发环境创建指南.md;dev-doc/编码规范.md;dev-doc/开发审计规范.md -引用文件:../开发事项总纲.md;../开发事项计划.md;../开发执行日志.md;../开发审计报告.md;../开发问题记录.md +引用文件:../开发事项总纲.md;../开发事项计划.md;../开发执行日志.md;../开发问题记录.md;审计报告入口按目标体系查看项目配置清单 记录方式:目标开发工作区说明;代码入口、测试入口或关联事项变化时更新。 ## 1. 基本口径 本目录不是独立开发体系,只是目标代码文档区。 -正式开发事项统一登记到 dev-doc/ 根级开发账本。 +正式开发事项的总纲、计划、执行日志和问题记录登记到 dev-doc/ 根级开发账本;审计报告入口按目标体系查看项目配置清单。 ## 2. 目录映射 @@ -207,7 +207,7 @@ 3. 测试目录。 4. 开发文档入口。 5. 当前开发事项列表。 -6. 审计报告入口。 +6. 审计报告入口,必须按目标体系写清是 `dev-doc/开发审计报告.md`、`exp-doc/实验审计报告.md` 还是 `ana-doc/案例审计报告.md`。 7. 问题记录入口。 ### 5.6 登记到项目配置清单 @@ -219,6 +219,7 @@ 3. 开发审核员。 4. 写权限范围。 5. 核心文档入口。 +6. 审计报告入口。 开发 AI 的写权限应绑定到对应 `dev/<target>-dev/`、`dev/<target>-dev/test/`、`dev-doc/<target>-doc/`,不默认拥有全部开发子目录。 @@ -290,8 +291,9 @@ 4. 不存在空的 `dev-doc/<target>-doc/编码方案.md`。 5. `dev-doc/<target>-doc/开发方案/` 只在已有重型开发事项并需要具体编码方案时创建;轻量开发或空工作区不创建。 6. 目标开发工作区已登记到项目配置清单,包括开发 AI、开发审核员、写权限范围和文档入口。 -7. 目标工作区没有把代码直接堆在 `dev/` 根目录。 -8. 目标工作区事项已回写到 `dev-doc/` 根级开发账本。 +7. 目标开发工作区已登记正确审计报告入口:实验开发为 `exp-doc/实验审计报告.md`,案例分析开发为 `ana-doc/案例审计报告.md`,需求开发或项目工具开发为 `dev-doc/开发审计报告.md`。 +8. 目标工作区没有把代码直接堆在 `dev/` 根目录。 +9. 目标工作区事项已回写到对应开发账本和审计报告入口。 ### 7.3 证据链 dry-run 校验 @@ -303,24 +305,24 @@ 开发事项总纲:记录 DEV-SMOKE-001 的来源、目标、边界 -> 开发事项计划:记录 DEV-PLAN-SMOKE-001 的步骤、输入输出和验收方式 -> 开发执行日志:记录 DEV-LOG-SMOKE-001 的关键步骤和产物位置;如无代码,明确 dry-run --> 开发审计报告:记录 DEV-AUDIT-SMOKE-001 的初始化 / dry-run 审计结论 +-> 对应审计报告入口:记录 DEV-AUDIT-SMOKE-001 的初始化 / dry-run 审计结论 -> 开发问题记录:仅在存在非审计来源问题或需要审计问题索引时使用 ``` 通过标准: 1. 各文档之间的 ID 能互相引用。 -2. 人或 AI 能从开发事项总纲一路追到计划、执行日志和审计报告。 +2. 人或 AI 能从开发事项总纲一路追到计划、执行日志和对应审计报告入口。 3. 如果没有真实代码,执行日志要明确写“dry-run,无真实代码产物”。 -4. 审计问题主记录写在开发审计报告;开发问题记录不被误用成审计问题主账。 +4. 审计问题主记录写在对应审计报告入口;开发问题记录不被误用成审计问题主账。 ### 7.4 校验结果记录 -校验结论写入 `开发审计报告.md` 的初始化审计记录。 +校验结论写入对应审计报告入口的初始化审计记录。 如果发现问题: -1. 审核员发现的问题,主记录写入 `开发审计报告.md`。 +1. 审核员发现的问题,主记录写入对应审计报告入口。 2. 非审计人员发现的问题,写入 `开发问题记录.md`。 3. 如果问题会影响后续开发执行,必须先修复并复审,再允许正式开发事项开始。 diff --git "a/common/dev-doc/\345\274\200\345\217\221\351\227\256\351\242\230\350\256\260\345\275\225\346\250\241\347\211\210.md" "b/common/dev-doc/\345\274\200\345\217\221\351\227\256\351\242\230\350\256\260\345\275\225\346\250\241\347\211\210.md" index ee42ca3..fe56ad8 100644 --- "a/common/dev-doc/\345\274\200\345\217\221\351\227\256\351\242\230\350\256\260\345\275\225\346\250\241\347\211\210.md" +++ "b/common/dev-doc/\345\274\200\345\217\221\351\227\256\351\242\230\350\256\260\345\275\225\346\250\241\347\211\210.md" @@ -3,10 +3,10 @@ 创建人员:<创建人员> 文件职责:记录非审计来源的开发问题、影响、修复建议、状态和复验结论。 管理规范/模板:common/dev-doc/编码规范.md;common/dev-doc/开发审计规范.md;common/dev-doc/开发问题记录模版.md。 -引用文件:开发事项总纲.md;开发事项计划.md;开发执行日志.md;开发审计报告.md;重型开发编码方案文件按事项创建。 +引用文件:开发事项总纲.md;开发事项计划.md;开发执行日志.md;对应审计报告入口;重型开发编码方案文件按事项创建。 记录方式:append-only 开发问题记录;新问题、新修复、新复验追加到文件末尾。 -固定口径:开发审核员发现的问题主记录写入 `开发审计报告.md`。本文主要记录非审计来源问题,或为跨轮跟踪建立索引。 +固定口径:开发审核员发现的问题主记录写入对应审计报告入口。本文主要记录非审计来源问题,或为跨轮跟踪建立索引。 ## 1. 当前问题总览 @@ -65,4 +65,4 @@ 通过 / 不通过 / 待复验 审计入口: -<如进入审计,写开发审计报告.md 中 AUDIT-ID> +<如进入审计,写对应审计报告入口中的 AUDIT-ID> diff --git "a/common/dev-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" "b/common/dev-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" index 261a370..894be73 100644 --- "a/common/dev-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" +++ "b/common/dev-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" @@ -41,7 +41,7 @@ 2. 按 `开发环境创建指南.md` 创建 `dev/<target>-dev/`、`dev/<target>-dev/test/`、`dev-doc/<target>-doc/`。 3. 创建开发事项总纲、计划、执行日志、审计报告和问题记录。 4. 重型开发先按事项创建具体编码方案文件,例如 `开发方案/<CODE-DESIGN-ID>.md`,经审核通过后再写代码。 -5. 开发完成后写执行日志、自测结果和开发审计报告。 +5. 开发完成后写执行日志、自测结果,并按目标体系写入对应审计报告入口。 ## 4. 开发体系边界 @@ -64,7 +64,7 @@ ## 5. 问题记录口径 -开发审核员发现的问题主记录写入 `开发审计报告.md`。 +开发审核员发现的问题主记录写入对应审计报告入口:需求开发、项目工具开发、独立开发事项写 `开发审计报告.md`;实验开发写 `exp-doc/实验审计报告.md`;案例分析开发写 `ana-doc/案例审计报告.md`。 非审计来源的问题,例如需求 AI、实验员、案例分析员、项目管理员或人工反馈,记录到 `开发问题记录.md`。 diff --git "a/common/dev-doc/\347\274\226\347\240\201\346\226\271\346\241\210\350\214\203\346\234\254.md" "b/common/dev-doc/\347\274\226\347\240\201\346\226\271\346\241\210\350\214\203\346\234\254.md" index 6c9ca17..ed53c01 100644 --- "a/common/dev-doc/\347\274\226\347\240\201\346\226\271\346\241\210\350\214\203\346\234\254.md" +++ "b/common/dev-doc/\347\274\226\347\240\201\346\226\271\346\241\210\350\214\203\346\234\254.md" @@ -3,7 +3,7 @@ 创建人员:Codex 文件职责:提供一份重型开发编码方案的参考范本,帮助 AI 理解方案应如何写;本文件不是必须复制的模板。 管理规范/模板:编码规范.md;开发审计规范.md。 -引用文件:开发事项总纲.md;开发事项计划.md;开发执行日志.md;开发审计报告.md;开发问题记录.md。 +引用文件:开发事项总纲.md;开发事项计划.md;开发执行日志.md;对应审计报告入口;开发问题记录.md。 记录方式:参考范本;编码方案写法出现重大调整时更新。 ## 1. 使用口径 @@ -181,4 +181,4 @@ 3. 每个模块至少覆盖一个 fail-fast 负例。 4. 最小链路 smoke 通过。 5. 输出字段、枚举、主键、ID、manifest、compare 与需求文档一致。 -6. 开发执行日志和开发审计报告已记录结论。 +6. 开发执行日志和对应审计报告入口已记录结论。 diff --git "a/common/dev-doc/\347\274\226\347\240\201\350\247\204\350\214\203.md" "b/common/dev-doc/\347\274\226\347\240\201\350\247\204\350\214\203.md" index 960f07b..46d026b 100644 --- "a/common/dev-doc/\347\274\226\347\240\201\350\247\204\350\214\203.md" +++ "b/common/dev-doc/\347\274\226\347\240\201\350\247\204\350\214\203.md" @@ -40,7 +40,8 @@ 1. 代码放在 `dev/<target>-dev/`。 2. 测试放在 `dev/<target>-dev/test/`。 3. 目标相关代码文档、测试说明和重型编码方案附件放在 `dev-doc/<target>-doc/`。 -4. 开发事项总纲、计划、执行日志、审计报告和问题记录统一放在 `dev-doc/` 根级账本,不在目标目录复制第二套。 +4. 开发事项总纲、计划、执行日志和问题记录默认放在 `dev-doc/` 根级账本,不在目标目录复制第二套。 +5. 审计报告入口按目标体系分账:需求开发、项目工具开发等独立开发事项写 `dev-doc/开发审计报告.md`;实验开发写 `exp-doc/实验审计报告.md`;案例分析开发写 `ana-doc/案例审计报告.md`。 常见映射: diff --git "a/common/exp-doc/\345\256\236\351\252\214\345\256\241\346\240\270\350\247\204\350\214\203.md" "b/common/exp-doc/\345\256\236\351\252\214\345\256\241\346\240\270\350\247\204\350\214\203.md" index 53b7511..7e21b90 100644 --- "a/common/exp-doc/\345\256\236\351\252\214\345\256\241\346\240\270\350\247\204\350\214\203.md" +++ "b/common/exp-doc/\345\256\236\351\252\214\345\256\241\346\240\270\350\247\204\350\214\203.md" @@ -73,6 +73,8 @@ 只有会影响目标、结论、数据、流程、可复核性或下游使用的问题,才作为审计问题。 审核员发现的审计问题主记录写入实验审计报告;如需跨轮跟踪,再在实验问题记录中建立索引。 +如果实验事项包含实验开发,实验开发的方案审核、实现审核、测试验收和复审结论也统一写入 `exp-doc/实验审计报告.md`,不另写到 `dev-doc/开发审计报告.md`。 + 以下内容默认不作为阻断问题: 1. 文案不漂亮。 diff --git "a/common/exp-doc/\345\256\236\351\252\214\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" "b/common/exp-doc/\345\256\236\351\252\214\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" index 8c0bc11..b740744 100644 --- "a/common/exp-doc/\345\256\236\351\252\214\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" +++ "b/common/exp-doc/\345\256\236\351\252\214\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" @@ -15,6 +15,8 @@ 目标不是把所有实验都做重,而是保证最关键的入口、证据链、存储位置和审核闭环可用。 +默认口径:实验员和实验开发员可由同一个 AI 承担;实验审核员和实验开发审核员也可由同一个 AI 承担。实验开发的审核结论统一写入 `exp-doc/实验审计报告.md`,不另写到 `dev-doc/开发审计报告.md`。 + ## 2. 创建前需要确认的信息 创建实验环境前,至少确认: diff --git "a/common/project-doc/\351\241\271\347\233\256\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" "b/common/project-doc/\351\241\271\347\233\256\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" index 1463164..2d6f366 100644 --- "a/common/project-doc/\351\241\271\347\233\256\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" +++ "b/common/project-doc/\351\241\271\347\233\256\347\216\257\345\242\203\345\210\233\345\273\272\346\214\207\345\215\227.md" @@ -93,7 +93,7 @@ 项目创建阶段不得提前创建未启用目标体系的 `dev/<target>-dev/`、`dev-doc/<target>-doc/` 完整工作区。具体目标开发工作区仍按 `common/dev-doc/开发环境创建指南.md` 的 `target_workspace` 模式创建。 -目标开发工作区只创建目标代码目录、测试目录、目标代码文档区入口和工作区说明。不得在 `dev-doc/<target>-doc/` 下复制第二套 `编码规范.md`、`开发审计规范.md`、开发事项总纲、开发事项计划、开发执行日志、开发审计报告或开发问题记录。正式开发账本只在 `dev-doc/` 根目录。 +目标开发工作区只创建目标代码目录、测试目录、目标代码文档区入口和工作区说明。不得在 `dev-doc/<target>-doc/` 下复制第二套 `编码规范.md`、`开发审计规范.md`、开发事项总纲、开发事项计划、开发执行日志、开发审计报告或开发问题记录。正式开发总纲、计划、执行日志和问题记录只在 `dev-doc/` 根目录;审计报告入口按目标体系填写,实验开发写 `exp-doc/实验审计报告.md`,案例分析开发写 `ana-doc/案例审计报告.md`。 ### 3.4 启用体系 diff --git "a/common/project-doc/\351\241\271\347\233\256\351\205\215\347\275\256\346\270\205\345\215\225\346\250\241\347\211\210.md" "b/common/project-doc/\351\241\271\347\233\256\351\205\215\347\275\256\346\270\205\345\215\225\346\250\241\347\211\210.md" index f8ca9c1..7d20f7d 100644 --- "a/common/project-doc/\351\241\271\347\233\256\351\205\215\347\275\256\346\270\205\345\215\225\346\250\241\347\211\210.md" +++ "b/common/project-doc/\351\241\271\347\233\256\351\205\215\347\275\256\346\270\205\345\215\225\346\250\241\347\211\210.md" @@ -32,9 +32,9 @@ 这里记录的是协作权限约束,不等同于操作系统或工具实际权限。所有 AI 默认拥有项目内文件读权限,写权限按角色和工作空间执行。 -| AI 名称 | 角色 | 是否审核员 | 工作空间 | 默认写权限范围 | 备注 | -|---|---|---|---|---|---| -| <AI_NAME> | 项目管理员 | 是 / 否 | ai-<AI_NAME>/ | 项目根目录;ai-<AI_NAME>/ | | +| AI 名称 | 角色 | 是否审核员 | 工作空间 | 默认写权限范围 | 审计报告入口 | 备注 | +|---|---|---|---|---|---|---| +| <AI_NAME> | 项目管理员 | 是 / 否 | ai-<AI_NAME>/ | 项目根目录;ai-<AI_NAME>/ | 项目事项审计报告.md / 无 | | ## 4. 默认角色权限 @@ -48,6 +48,8 @@ | 数据负责人 | data-doc/;<数据目录> | 数据字典、数据存储说明、正式数据入口 | | 审核员 | 对应审计报告;问题记录仅写跨轮索引 | 不直接改被审计主产物 | +开发审核的审计报告入口按目标体系填写:需求开发、项目工具开发、独立开发事项写 `dev-doc/开发审计报告.md`;实验开发写 `exp-doc/实验审计报告.md`;案例分析开发写 `ana-doc/案例审计报告.md`。 + ## 5. 目录映射 | 目录 | 用途 | 负责人 / 角色 | 状态 | 备注 | diff --git "a/project-routing-smoke-20260603/ai-ana/\345\267\245\344\275\234\350\257\264\346\230\216.md" "b/project-routing-smoke-20260603/ai-ana/\345\267\245\344\275\234\350\257\264\346\230\216.md" new file mode 100644 index 0000000..2ec95f7 --- /dev/null +++ "b/project-routing-smoke-20260603/ai-ana/\345\267\245\344\275\234\350\257\264\346\230\216.md" @@ -0,0 +1,11 @@ +# ai-ana 工作说明 + +创建人员:Codex +文件职责:案例/案例开发/审核角色入口。 +管理规范/模板:../common/ai-workplace/AI工作空间创建指南.md。 +引用文件:../项目配置清单.md;../ana-doc/案例分析规范.md;../dev-doc/编码规范.md。 +记录方式:当前说明。 + +角色:案例分析员;开发 AI(案例分析开发);审核员(案例分析审核);审核员(案例分析开发审核) +审计入口:ana-doc/案例审计报告.md + diff --git "a/project-routing-smoke-20260603/ai-exp/\345\267\245\344\275\234\350\257\264\346\230\216.md" "b/project-routing-smoke-20260603/ai-exp/\345\267\245\344\275\234\350\257\264\346\230\216.md" new file mode 100644 index 0000000..f636e25 --- /dev/null +++ "b/project-routing-smoke-20260603/ai-exp/\345\267\245\344\275\234\350\257\264\346\230\216.md" @@ -0,0 +1,11 @@ +# ai-exp 工作说明 + +创建人员:Codex +文件职责:实验/实验开发/审核角色入口。 +管理规范/模板:../common/ai-workplace/AI工作空间创建指南.md。 +引用文件:../项目配置清单.md;../exp-doc/实验规范.md;../dev-doc/编码规范.md。 +记录方式:当前说明。 + +角色:实验员;开发 AI(实验开发);审核员(实验审核);审核员(实验开发审核) +审计入口:exp-doc/实验审计报告.md + diff --git "a/project-routing-smoke-20260603/ai-pro/\345\267\245\344\275\234\350\257\264\346\230\216.md" "b/project-routing-smoke-20260603/ai-pro/\345\267\245\344\275\234\350\257\264\346\230\216.md" new file mode 100644 index 0000000..e86a6a0 --- /dev/null +++ "b/project-routing-smoke-20260603/ai-pro/\345\267\245\344\275\234\350\257\264\346\230\216.md" @@ -0,0 +1,11 @@ +# ai-pro 工作说明 + +创建人员:Codex +文件职责:需求/需求开发/审核角色入口。 +管理规范/模板:../common/ai-workplace/AI工作空间创建指南.md。 +引用文件:../项目配置清单.md;../pro-doc/需求规范.md;../dev-doc/编码规范.md。 +记录方式:当前说明。 + +角色:需求 AI;开发 AI(需求开发);审核员(需求审核);审核员(需求开发审核) +审计入口:dev-doc/开发审计报告.md + diff --git "a/project-routing-smoke-20260603/ana-doc/\346\241\210\344\276\213\345\210\206\346\236\220\350\247\204\350\214\203.md" "b/project-routing-smoke-20260603/ana-doc/\346\241\210\344\276\213\345\210\206\346\236\220\350\247\204\350\214\203.md" new file mode 100644 index 0000000..bf92beb --- /dev/null +++ "b/project-routing-smoke-20260603/ana-doc/\346\241\210\344\276\213\345\210\206\346\236\220\350\247\204\350\214\203.md" @@ -0,0 +1,8 @@ +# 案例分析规范 + +创建人员:Codex +文件职责:本地案例分析规范。 +管理规范/模板:../common/ana-doc/案例分析规范.md。 +引用文件:案例审计报告.md。 +记录方式:本地规范。 + diff --git "a/project-routing-smoke-20260603/ana-doc/\346\241\210\344\276\213\345\256\241\350\256\241\346\212\245\345\221\212.md" "b/project-routing-smoke-20260603/ana-doc/\346\241\210\344\276\213\345\256\241\350\256\241\346\212\245\345\221\212.md" new file mode 100644 index 0000000..93b15c4 --- /dev/null +++ "b/project-routing-smoke-20260603/ana-doc/\346\241\210\344\276\213\345\256\241\350\256\241\346\212\245\345\221\212.md" @@ -0,0 +1,10 @@ +# 案例审计报告 + +创建人员:Codex +文件职责:案例和案例分析开发审计报告。 +管理规范/模板:../common/ana-doc/案例审计报告模版.md。 +引用文件:案例分析规范.md;../dev-doc/ana-doc/开发工作区说明.md。 +记录方式:append-only。 + +- AUDIT-SMOKE-ANA:案例分析开发审计入口正确。 + diff --git "a/project-routing-smoke-20260603/dev-doc/ana-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" "b/project-routing-smoke-20260603/dev-doc/ana-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" new file mode 100644 index 0000000..955cef6 --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/ana-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" @@ -0,0 +1,10 @@ +# 开发工作区说明 + +创建人员:Codex +文件职责:案例分析开发工作区说明。 +管理规范/模板:../common/dev-doc/开发环境创建指南.md。 +引用文件:../开发事项总纲.md;../../ana-doc/案例审计报告.md。 +记录方式:说明文档。 + +审计报告入口:ana-doc/案例审计报告.md + diff --git "a/project-routing-smoke-20260603/dev-doc/ana-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" "b/project-routing-smoke-20260603/dev-doc/ana-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" new file mode 100644 index 0000000..a1b9b09 --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/ana-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" @@ -0,0 +1,8 @@ +# 目录导读 + +创建人员:Codex +文件职责:案例开发目标文档入口。 +管理规范/模板:../开发环境创建指南.md。 +引用文件:开发工作区说明.md。 +记录方式:入口导读。 + diff --git "a/project-routing-smoke-20260603/dev-doc/exp-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" "b/project-routing-smoke-20260603/dev-doc/exp-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" new file mode 100644 index 0000000..4a238bf --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/exp-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" @@ -0,0 +1,10 @@ +# 开发工作区说明 + +创建人员:Codex +文件职责:实验开发工作区说明。 +管理规范/模板:../common/dev-doc/开发环境创建指南.md。 +引用文件:../开发事项总纲.md;../../exp-doc/实验审计报告.md。 +记录方式:说明文档。 + +审计报告入口:exp-doc/实验审计报告.md + diff --git "a/project-routing-smoke-20260603/dev-doc/exp-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" "b/project-routing-smoke-20260603/dev-doc/exp-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" new file mode 100644 index 0000000..95d59ee --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/exp-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" @@ -0,0 +1,8 @@ +# 目录导读 + +创建人员:Codex +文件职责:实验开发目标文档入口。 +管理规范/模板:../开发环境创建指南.md。 +引用文件:开发工作区说明.md。 +记录方式:入口导读。 + diff --git "a/project-routing-smoke-20260603/dev-doc/pro-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" "b/project-routing-smoke-20260603/dev-doc/pro-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" new file mode 100644 index 0000000..656d3af --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/pro-doc/\345\274\200\345\217\221\345\267\245\344\275\234\345\214\272\350\257\264\346\230\216.md" @@ -0,0 +1,10 @@ +# 开发工作区说明 + +创建人员:Codex +文件职责:需求开发工作区说明。 +管理规范/模板:../common/dev-doc/开发环境创建指南.md。 +引用文件:../开发事项总纲.md;../开发审计报告.md。 +记录方式:说明文档。 + +审计报告入口:dev-doc/开发审计报告.md + diff --git "a/project-routing-smoke-20260603/dev-doc/pro-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" "b/project-routing-smoke-20260603/dev-doc/pro-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" new file mode 100644 index 0000000..9016b26 --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/pro-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" @@ -0,0 +1,8 @@ +# 目录导读 + +创建人员:Codex +文件职责:需求开发目标文档入口。 +管理规范/模板:../开发环境创建指南.md。 +引用文件:开发工作区说明.md。 +记录方式:入口导读。 + diff --git "a/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\346\200\273\347\272\262.md" "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\346\200\273\347\272\262.md" new file mode 100644 index 0000000..48ef2e0 --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\346\200\273\347\272\262.md" @@ -0,0 +1,8 @@ +# 开发事项总纲 + +创建人员:Codex +文件职责:开发事项总纲。 +管理规范/模板:../common/dev-doc/开发事项总纲模版.md。 +引用文件:开发事项计划.md;对应审计报告入口。 +记录方式:append-only。 + diff --git "a/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\350\256\241\345\210\222.md" "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\350\256\241\345\210\222.md" new file mode 100644 index 0000000..53ce116 --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\344\272\213\351\241\271\350\256\241\345\210\222.md" @@ -0,0 +1,8 @@ +# 开发事项计划 + +创建人员:Codex +文件职责:开发事项计划。 +管理规范/模板:../common/dev-doc/开发事项计划模版.md。 +引用文件:开发事项总纲.md;对应审计报告入口。 +记录方式:append-only。 + diff --git "a/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\346\212\245\345\221\212.md" "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\346\212\245\345\221\212.md" new file mode 100644 index 0000000..c312ac3 --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\346\212\245\345\221\212.md" @@ -0,0 +1,8 @@ +# 开发审计报告 + +创建人员:Codex +文件职责:需求开发/项目工具开发审计报告。 +管理规范/模板:../common/dev-doc/开发审计报告模版.md。 +引用文件:开发事项总纲.md。 +记录方式:append-only。 + diff --git "a/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\350\247\204\350\214\203.md" "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\350\247\204\350\214\203.md" new file mode 100644 index 0000000..694c0b6 --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\345\256\241\350\256\241\350\247\204\350\214\203.md" @@ -0,0 +1,8 @@ +# 开发审计规范 + +创建人员:Codex +文件职责:本地开发审计规范。 +管理规范/模板:../common/dev-doc/开发审计规范.md。 +引用文件:编码规范.md。 +记录方式:本地规范。 + diff --git "a/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\346\211\247\350\241\214\346\227\245\345\277\227.md" "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\346\211\247\350\241\214\346\227\245\345\277\227.md" new file mode 100644 index 0000000..0e86abe --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\346\211\247\350\241\214\346\227\245\345\277\227.md" @@ -0,0 +1,8 @@ +# 开发执行日志 + +创建人员:Codex +文件职责:开发执行日志。 +管理规范/模板:../common/dev-doc/开发执行日志模版.md。 +引用文件:开发事项总纲.md;对应审计报告入口。 +记录方式:append-only。 + diff --git "a/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\351\227\256\351\242\230\350\256\260\345\275\225.md" "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\351\227\256\351\242\230\350\256\260\345\275\225.md" new file mode 100644 index 0000000..34089a1 --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/\345\274\200\345\217\221\351\227\256\351\242\230\350\256\260\345\275\225.md" @@ -0,0 +1,8 @@ +# 开发问题记录 + +创建人员:Codex +文件职责:开发问题记录。 +管理规范/模板:../common/dev-doc/开发问题记录模版.md。 +引用文件:对应审计报告入口。 +记录方式:append-only。 + diff --git "a/project-routing-smoke-20260603/dev-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" "b/project-routing-smoke-20260603/dev-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" new file mode 100644 index 0000000..fa7096a --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" @@ -0,0 +1,8 @@ +# 目录导读 + +创建人员:Codex +文件职责:测试开发入口。 +管理规范/模板:../common/dev-doc/目录导读.md。 +引用文件:编码规范.md。 +记录方式:入口导读。 + diff --git "a/project-routing-smoke-20260603/dev-doc/\347\274\226\347\240\201\350\247\204\350\214\203.md" "b/project-routing-smoke-20260603/dev-doc/\347\274\226\347\240\201\350\247\204\350\214\203.md" new file mode 100644 index 0000000..456865c --- /dev/null +++ "b/project-routing-smoke-20260603/dev-doc/\347\274\226\347\240\201\350\247\204\350\214\203.md" @@ -0,0 +1,8 @@ +# 编码规范 + +创建人员:Codex +文件职责:本地编码规范。 +管理规范/模板:../common/dev-doc/编码规范.md。 +引用文件:开发审计规范.md。 +记录方式:本地规范。 + diff --git "a/project-routing-smoke-20260603/exp-doc/\345\256\236\351\252\214\345\256\241\350\256\241\346\212\245\345\221\212.md" "b/project-routing-smoke-20260603/exp-doc/\345\256\236\351\252\214\345\256\241\350\256\241\346\212\245\345\221\212.md" new file mode 100644 index 0000000..4d61763 --- /dev/null +++ "b/project-routing-smoke-20260603/exp-doc/\345\256\236\351\252\214\345\256\241\350\256\241\346\212\245\345\221\212.md" @@ -0,0 +1,10 @@ +# 实验审计报告 + +创建人员:Codex +文件职责:实验和实验开发审计报告。 +管理规范/模板:../common/exp-doc/实验审计报告模版.md。 +引用文件:实验规范.md;../dev-doc/exp-doc/开发工作区说明.md。 +记录方式:append-only。 + +- AUDIT-SMOKE-EXP:实验开发审计入口正确。 + diff --git "a/project-routing-smoke-20260603/exp-doc/\345\256\236\351\252\214\350\247\204\350\214\203.md" "b/project-routing-smoke-20260603/exp-doc/\345\256\236\351\252\214\350\247\204\350\214\203.md" new file mode 100644 index 0000000..bd7ba7c --- /dev/null +++ "b/project-routing-smoke-20260603/exp-doc/\345\256\236\351\252\214\350\247\204\350\214\203.md" @@ -0,0 +1,8 @@ +# 实验规范 + +创建人员:Codex +文件职责:本地实验规范。 +管理规范/模板:../common/exp-doc/实验规范.md。 +引用文件:实验审计报告.md。 +记录方式:本地规范。 + diff --git "a/project-routing-smoke-20260603/pro-doc/\351\234\200\346\261\202\345\256\241\346\240\270\350\247\204\350\214\203.md" "b/project-routing-smoke-20260603/pro-doc/\351\234\200\346\261\202\345\256\241\346\240\270\350\247\204\350\214\203.md" new file mode 100644 index 0000000..a76213f --- /dev/null +++ "b/project-routing-smoke-20260603/pro-doc/\351\234\200\346\261\202\345\256\241\346\240\270\350\247\204\350\214\203.md" @@ -0,0 +1,8 @@ +# 需求审核规范 + +创建人员:Codex +文件职责:本地需求审核规范。 +管理规范/模板:../common/pro-doc/需求审核规范.md。 +引用文件:需求规范.md。 +记录方式:本地规范。 + diff --git "a/project-routing-smoke-20260603/pro-doc/\351\234\200\346\261\202\350\247\204\350\214\203.md" "b/project-routing-smoke-20260603/pro-doc/\351\234\200\346\261\202\350\247\204\350\214\203.md" new file mode 100644 index 0000000..9a259da --- /dev/null +++ "b/project-routing-smoke-20260603/pro-doc/\351\234\200\346\261\202\350\247\204\350\214\203.md" @@ -0,0 +1,8 @@ +# 需求规范 + +创建人员:Codex +文件职责:本地需求规范。 +管理规范/模板:../common/pro-doc/需求规范.md。 +引用文件:需求审核规范.md。 +记录方式:本地规范。 + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\345\256\241\350\256\241\346\212\245\345\221\212.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\345\256\241\350\256\241\346\212\245\345\221\212.md" new file mode 100644 index 0000000..154e5a7 --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\345\256\241\350\256\241\346\212\245\345\221\212.md" @@ -0,0 +1,8 @@ +# 项目事项审计报告 + +创建人员:Codex +文件职责:测试项目事项审计。 +管理规范/模板:../common/project-doc/项目事项审计报告模版.md。 +引用文件:项目事项总纲.md。 +记录方式:append-only。 + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\346\200\273\347\272\262.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\346\200\273\347\272\262.md" new file mode 100644 index 0000000..8e0740d --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\346\200\273\347\272\262.md" @@ -0,0 +1,8 @@ +# 项目事项总纲 + +创建人员:Codex +文件职责:测试项目事项总纲。 +管理规范/模板:../common/project-doc/项目事项总纲模版.md。 +引用文件:项目事项计划.md。 +记录方式:append-only。 + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\350\256\241\345\210\222.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\350\256\241\345\210\222.md" new file mode 100644 index 0000000..61a3e50 --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\344\272\213\351\241\271\350\256\241\345\210\222.md" @@ -0,0 +1,8 @@ +# 项目事项计划 + +创建人员:Codex +文件职责:测试项目事项计划。 +管理规范/模板:../common/project-doc/项目事项计划模版.md。 +引用文件:项目事项总纲.md。 +记录方式:append-only。 + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\345\217\230\346\233\264\350\256\260\345\275\225.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\345\217\230\346\233\264\350\256\260\345\275\225.md" new file mode 100644 index 0000000..23ff2e2 --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\345\217\230\346\233\264\350\256\260\345\275\225.md" @@ -0,0 +1,10 @@ +# 项目变更记录 + +创建人员:Codex +文件职责:记录测试项目配置变更。 +管理规范/模板:../common/project-doc/项目变更记录模版.md。 +引用文件:项目配置清单.md。 +记录方式:append-only。 + +- 2026-06-03 初始化 smoke 项目。 + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\346\200\273\350\247\210.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\346\200\273\350\247\210.md" new file mode 100644 index 0000000..c2d5469 --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\346\200\273\350\247\210.md" @@ -0,0 +1,10 @@ +# 项目总览 + +创建人员:Codex +文件职责:测试项目基本信息。 +管理规范/模板:../common/project-doc/项目总览范本.md。 +引用文件:项目配置清单.md。 +记录方式:测试项目总览。 + +项目名称:project-routing-smoke-20260603 + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\346\211\247\350\241\214\346\227\245\345\277\227.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\346\211\247\350\241\214\346\227\245\345\277\227.md" new file mode 100644 index 0000000..705641b --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\346\211\247\350\241\214\346\227\245\345\277\227.md" @@ -0,0 +1,10 @@ +# 项目执行日志 + +创建人员:Codex +文件职责:记录测试项目创建动作。 +管理规范/模板:../common/project-doc/项目执行日志模版.md。 +引用文件:项目配置清单.md。 +记录方式:append-only。 + +- 2026-06-03 创建测试项目并启用开发/实验/案例/需求体系。 + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\350\247\204\350\214\203.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\350\247\204\350\214\203.md" new file mode 100644 index 0000000..d207c26 --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\350\247\204\350\214\203.md" @@ -0,0 +1,8 @@ +# 项目规范 + +创建人员:Codex +文件职责:测试项目本地项目规范。 +管理规范/模板:../common/project-doc/项目规范模版.md。 +引用文件:项目配置清单.md。 +记录方式:本地规范。 + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\351\205\215\347\275\256\346\270\205\345\215\225.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\351\205\215\347\275\256\346\270\205\345\215\225.md" new file mode 100644 index 0000000..744d18d --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\351\205\215\347\275\256\346\270\205\345\215\225.md" @@ -0,0 +1,16 @@ +# 项目配置清单 + +创建人员:Codex +文件职责:记录测试项目当前启用体系、AI角色、权限和审计入口。 +管理规范/模板:../common/project-doc/项目配置清单模版.md。 +引用文件:项目总览.md;项目规范.md。 +记录方式:测试配置清单。 + +## AI 角色与权限 + +| AI 名称 | 角色 | 是否审核员 | 工作空间 | 默认写权限范围 | 审计报告入口 | 备注 | +|---|---|---|---|---|---|---| +| ai-exp | 实验员;开发 AI(实验开发);审核员(实验审核);审核员(实验开发审核) | 是 | ai-exp/ | exp-doc/;exp-data/;dev/exp-dev/;dev-doc/exp-doc/ | exp-doc/实验审计报告.md | 实验和实验开发审计合并 | +| ai-ana | 案例分析员;开发 AI(案例分析开发);审核员(案例分析审核);审核员(案例分析开发审核) | 是 | ai-ana/ | ana-doc/;ana-data/;dev/ana-dev/;dev-doc/ana-doc/ | ana-doc/案例审计报告.md | 案例和案例开发审计合并 | +| ai-pro | 需求 AI;开发 AI(需求开发);审核员(需求审核);审核员(需求开发审核) | 是 | ai-pro/ | pro-doc/;dev/pro-dev/;dev-doc/pro-doc/ | dev-doc/开发审计报告.md | 需求开发审计走开发审计报告 | + diff --git "a/project-routing-smoke-20260603/\351\241\271\347\233\256\351\227\256\351\242\230\350\256\260\345\275\225.md" "b/project-routing-smoke-20260603/\351\241\271\347\233\256\351\227\256\351\242\230\350\256\260\345\275\225.md" new file mode 100644 index 0000000..1e6f429 --- /dev/null +++ "b/project-routing-smoke-20260603/\351\241\271\347\233\256\351\227\256\351\242\230\350\256\260\345\275\225.md" @@ -0,0 +1,8 @@ +# 项目问题记录 + +创建人员:Codex +文件职责:测试项目问题记录。 +管理规范/模板:../common/project-doc/项目问题记录模版.md。 +引用文件:项目事项审计报告.md。 +记录方式:append-only。 + diff --git "a/\347\256\241\347\220\206\347\263\273\347\273\237\350\257\264\346\230\216.md" "b/\347\256\241\347\220\206\347\263\273\347\273\237\350\257\264\346\230\216.md" index b4071c9..8df00da 100644 --- "a/\347\256\241\347\220\206\347\263\273\347\273\237\350\257\264\346\230\216.md" +++ "b/\347\256\241\347\220\206\347\263\273\347\273\237\350\257\264\346\230\216.md" @@ -270,5 +270,15 @@ 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\dev-doc\案例分析规范.md 以及 项目本地 dev-doc\案例分析规范.md 两个共同作用的技能 ) -11. 案例分析审核技能(包括案例分析设计,案例分析全流程审计);(属于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 两个共同作用的技能 ) + +##体系特殊说明 +实验体系目前固定成如下: +1. 实验员和实验-开发员目前固定成一个ai +2. 实验员的审核员和 实验-开发员的审核员 也都固定成一个ai, 这个ai对实验的审核 以及 实验开发员 的审核都统一记录在 exp-doc/实验审计报告.md 里 +案例分析体系目前固定成如下: +1. 案例分析员和案例分析员-开发员目前固定成一个ai +2. 案例分析员的审核员和 案例分析员-开发员的审核员 也都固定成一个ai, 这个ai对案例分析员的审核 以及 案例分析员开发员 的审核都统一记录在 ana-doc/案例审计报告.md 里 + +最后因为目前3个体系都需要开发员,但是两个体系的开发员的审核都记录到了别的地方,所以只有需求-开发员、项目工具开发员等独立开发事项的审计员的审计报告会记录到 dev-doc/开发审计报告.md 文档里 -- Gitblit v1.9.3