1
2026-06-03 612c64454865dcebaac47fad3e950ba73d60c2fd
Update routing smoke docs
17 files modified
32 files added
402 ■■■■■ changed files
common/ai-workplace/AI工作空间创建指南.md 14 ●●●●● patch | view | raw | blame | history
common/ana-doc/案例分析环境创建指南.md 2 ●●●●● patch | view | raw | blame | history
common/ana-doc/案例审核规范.md 2 ●●●●● patch | view | raw | blame | history
common/dev-doc/开发事项总纲模版.md 4 ●●●● patch | view | raw | blame | history
common/dev-doc/开发事项计划模版.md 6 ●●●● patch | view | raw | blame | history
common/dev-doc/开发审计规范.md 8 ●●●● patch | view | raw | blame | history
common/dev-doc/开发执行日志模版.md 6 ●●●● patch | view | raw | blame | history
common/dev-doc/开发环境创建指南.md 26 ●●●● patch | view | raw | blame | history
common/dev-doc/开发问题记录模版.md 6 ●●●● patch | view | raw | blame | history
common/dev-doc/目录导读.md 4 ●●●● patch | view | raw | blame | history
common/dev-doc/编码方案范本.md 4 ●●●● patch | view | raw | blame | history
common/dev-doc/编码规范.md 3 ●●●● patch | view | raw | blame | history
common/exp-doc/实验审核规范.md 2 ●●●●● patch | view | raw | blame | history
common/exp-doc/实验环境创建指南.md 2 ●●●●● patch | view | raw | blame | history
common/project-doc/项目环境创建指南.md 2 ●●● patch | view | raw | blame | history
common/project-doc/项目配置清单模版.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/ai-ana/工作说明.md 11 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/ai-exp/工作说明.md 11 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/ai-pro/工作说明.md 11 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/ana-doc/案例分析规范.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/ana-doc/案例审计报告.md 10 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/ana-doc/开发工作区说明.md 10 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/ana-doc/目录导读.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/exp-doc/开发工作区说明.md 10 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/exp-doc/目录导读.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/pro-doc/开发工作区说明.md 10 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/pro-doc/目录导读.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/开发事项总纲.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/开发事项计划.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/开发审计报告.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/开发审计规范.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/开发执行日志.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/开发问题记录.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/目录导读.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/dev-doc/编码规范.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/exp-doc/实验审计报告.md 10 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/exp-doc/实验规范.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/pro-doc/需求审核规范.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/pro-doc/需求规范.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目事项审计报告.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目事项总纲.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目事项计划.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目变更记录.md 10 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目总览.md 10 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目执行日志.md 10 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目规范.md 8 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目配置清单.md 16 ●●●●● patch | view | raw | blame | history
project-routing-smoke-20260603/项目问题记录.md 8 ●●●●● patch | view | raw | blame | history
管理系统说明.md 14 ●●●● patch | view | raw | blame | history
common/ai-workplace/AI工作空间创建指南.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 项目级日志和变更校验
common/ana-doc/案例分析环境创建指南.md
@@ -12,6 +12,8 @@
本指南只负责创建案例分析环境,不替代具体案例分析工作。
默认口径:案例分析员和案例分析开发员可由同一个 AI 承担;案例审核员和案例分析开发审核员也可由同一个 AI 承担。案例分析开发的审核结论统一写入 `ana-doc/案例审计报告.md`,不另写到 `dev-doc/开发审计报告.md`。
## 2. 输入
创建前应明确:
common/ana-doc/案例审核规范.md
@@ -98,6 +98,8 @@
审核员发现的问题,主记录写入 `案例审计报告.md`。
如果案例分析事项包含案例分析开发,案例分析开发的方案审核、实现审核、测试验收和复审结论也统一写入 `ana-doc/案例审计报告.md`,不另写到 `dev-doc/开发审计报告.md`。
只有问题需要跨轮跟踪、跨案例汇总或由案例分析员长期处理时,才在 `案例问题记录.md` 中建立索引或关联,不重复全文。
审核报告至少包含:
common/dev-doc/开发事项总纲模版.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;如无写“无”>
common/dev-doc/开发事项计划模版.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>
common/dev-doc/开发审计规范.md
@@ -124,7 +124,13 @@
## 7. 审计报告口径
开发审核员发现的问题主记录写入 `开发审计报告.md`。
开发审核员发现的问题主记录写入对应审计报告入口。
默认入口:
1. 需求开发、项目工具开发、独立开发事项:`dev-doc/开发审计报告.md`。
2. 实验开发:`exp-doc/实验审计报告.md`。
3. 案例分析开发:`ana-doc/案例审计报告.md`。
非审计人员发现的问题写入 `开发问题记录.md`。
common/dev-doc/开发执行日志模版.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>
common/dev-doc/开发环境创建指南.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. 如果问题会影响后续开发执行,必须先修复并复审,再允许正式开发事项开始。
common/dev-doc/开发问题记录模版.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>
common/dev-doc/目录导读.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`。
common/dev-doc/编码方案范本.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. 开发执行日志和对应审计报告入口已记录结论。
common/dev-doc/编码规范.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`。
常见映射:
common/exp-doc/实验审核规范.md
@@ -73,6 +73,8 @@
只有会影响目标、结论、数据、流程、可复核性或下游使用的问题,才作为审计问题。
审核员发现的审计问题主记录写入实验审计报告;如需跨轮跟踪,再在实验问题记录中建立索引。
如果实验事项包含实验开发,实验开发的方案审核、实现审核、测试验收和复审结论也统一写入 `exp-doc/实验审计报告.md`,不另写到 `dev-doc/开发审计报告.md`。
以下内容默认不作为阻断问题:
1. 文案不漂亮。
common/exp-doc/实验环境创建指南.md
@@ -15,6 +15,8 @@
目标不是把所有实验都做重,而是保证最关键的入口、证据链、存储位置和审核闭环可用。
默认口径:实验员和实验开发员可由同一个 AI 承担;实验审核员和实验开发审核员也可由同一个 AI 承担。实验开发的审核结论统一写入 `exp-doc/实验审计报告.md`,不另写到 `dev-doc/开发审计报告.md`。
## 2. 创建前需要确认的信息
创建实验环境前,至少确认:
common/project-doc/项目环境创建指南.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 启用体系
common/project-doc/项目配置清单模版.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. 目录映射
| 目录 | 用途 | 负责人 / 角色 | 状态 | 备注 |
project-routing-smoke-20260603/ai-ana/工作说明.md
New file
@@ -0,0 +1,11 @@
# ai-ana 工作说明
创建人员:Codex
文件职责:案例/案例开发/审核角色入口。
管理规范/模板:../common/ai-workplace/AI工作空间创建指南.md。
引用文件:../项目配置清单.md;../ana-doc/案例分析规范.md;../dev-doc/编码规范.md。
记录方式:当前说明。
角色:案例分析员;开发 AI(案例分析开发);审核员(案例分析审核);审核员(案例分析开发审核)
审计入口:ana-doc/案例审计报告.md
project-routing-smoke-20260603/ai-exp/工作说明.md
New file
@@ -0,0 +1,11 @@
# ai-exp 工作说明
创建人员:Codex
文件职责:实验/实验开发/审核角色入口。
管理规范/模板:../common/ai-workplace/AI工作空间创建指南.md。
引用文件:../项目配置清单.md;../exp-doc/实验规范.md;../dev-doc/编码规范.md。
记录方式:当前说明。
角色:实验员;开发 AI(实验开发);审核员(实验审核);审核员(实验开发审核)
审计入口:exp-doc/实验审计报告.md
project-routing-smoke-20260603/ai-pro/工作说明.md
New file
@@ -0,0 +1,11 @@
# ai-pro 工作说明
创建人员:Codex
文件职责:需求/需求开发/审核角色入口。
管理规范/模板:../common/ai-workplace/AI工作空间创建指南.md。
引用文件:../项目配置清单.md;../pro-doc/需求规范.md;../dev-doc/编码规范.md。
记录方式:当前说明。
角色:需求 AI;开发 AI(需求开发);审核员(需求审核);审核员(需求开发审核)
审计入口:dev-doc/开发审计报告.md
project-routing-smoke-20260603/ana-doc/案例分析规范.md
New file
@@ -0,0 +1,8 @@
# 案例分析规范
创建人员:Codex
文件职责:本地案例分析规范。
管理规范/模板:../common/ana-doc/案例分析规范.md。
引用文件:案例审计报告.md。
记录方式:本地规范。
project-routing-smoke-20260603/ana-doc/案例审计报告.md
New file
@@ -0,0 +1,10 @@
# 案例审计报告
创建人员:Codex
文件职责:案例和案例分析开发审计报告。
管理规范/模板:../common/ana-doc/案例审计报告模版.md。
引用文件:案例分析规范.md;../dev-doc/ana-doc/开发工作区说明.md。
记录方式:append-only。
- AUDIT-SMOKE-ANA:案例分析开发审计入口正确。
project-routing-smoke-20260603/dev-doc/ana-doc/开发工作区说明.md
New file
@@ -0,0 +1,10 @@
# 开发工作区说明
创建人员:Codex
文件职责:案例分析开发工作区说明。
管理规范/模板:../common/dev-doc/开发环境创建指南.md。
引用文件:../开发事项总纲.md;../../ana-doc/案例审计报告.md。
记录方式:说明文档。
审计报告入口:ana-doc/案例审计报告.md
project-routing-smoke-20260603/dev-doc/ana-doc/目录导读.md
New file
@@ -0,0 +1,8 @@
# 目录导读
创建人员:Codex
文件职责:案例开发目标文档入口。
管理规范/模板:../开发环境创建指南.md。
引用文件:开发工作区说明.md。
记录方式:入口导读。
project-routing-smoke-20260603/dev-doc/exp-doc/开发工作区说明.md
New file
@@ -0,0 +1,10 @@
# 开发工作区说明
创建人员:Codex
文件职责:实验开发工作区说明。
管理规范/模板:../common/dev-doc/开发环境创建指南.md。
引用文件:../开发事项总纲.md;../../exp-doc/实验审计报告.md。
记录方式:说明文档。
审计报告入口:exp-doc/实验审计报告.md
project-routing-smoke-20260603/dev-doc/exp-doc/目录导读.md
New file
@@ -0,0 +1,8 @@
# 目录导读
创建人员:Codex
文件职责:实验开发目标文档入口。
管理规范/模板:../开发环境创建指南.md。
引用文件:开发工作区说明.md。
记录方式:入口导读。
project-routing-smoke-20260603/dev-doc/pro-doc/开发工作区说明.md
New file
@@ -0,0 +1,10 @@
# 开发工作区说明
创建人员:Codex
文件职责:需求开发工作区说明。
管理规范/模板:../common/dev-doc/开发环境创建指南.md。
引用文件:../开发事项总纲.md;../开发审计报告.md。
记录方式:说明文档。
审计报告入口:dev-doc/开发审计报告.md
project-routing-smoke-20260603/dev-doc/pro-doc/目录导读.md
New file
@@ -0,0 +1,8 @@
# 目录导读
创建人员:Codex
文件职责:需求开发目标文档入口。
管理规范/模板:../开发环境创建指南.md。
引用文件:开发工作区说明.md。
记录方式:入口导读。
project-routing-smoke-20260603/dev-doc/开发事项总纲.md
New file
@@ -0,0 +1,8 @@
# 开发事项总纲
创建人员:Codex
文件职责:开发事项总纲。
管理规范/模板:../common/dev-doc/开发事项总纲模版.md。
引用文件:开发事项计划.md;对应审计报告入口。
记录方式:append-only。
project-routing-smoke-20260603/dev-doc/开发事项计划.md
New file
@@ -0,0 +1,8 @@
# 开发事项计划
创建人员:Codex
文件职责:开发事项计划。
管理规范/模板:../common/dev-doc/开发事项计划模版.md。
引用文件:开发事项总纲.md;对应审计报告入口。
记录方式:append-only。
project-routing-smoke-20260603/dev-doc/开发审计报告.md
New file
@@ -0,0 +1,8 @@
# 开发审计报告
创建人员:Codex
文件职责:需求开发/项目工具开发审计报告。
管理规范/模板:../common/dev-doc/开发审计报告模版.md。
引用文件:开发事项总纲.md。
记录方式:append-only。
project-routing-smoke-20260603/dev-doc/开发审计规范.md
New file
@@ -0,0 +1,8 @@
# 开发审计规范
创建人员:Codex
文件职责:本地开发审计规范。
管理规范/模板:../common/dev-doc/开发审计规范.md。
引用文件:编码规范.md。
记录方式:本地规范。
project-routing-smoke-20260603/dev-doc/开发执行日志.md
New file
@@ -0,0 +1,8 @@
# 开发执行日志
创建人员:Codex
文件职责:开发执行日志。
管理规范/模板:../common/dev-doc/开发执行日志模版.md。
引用文件:开发事项总纲.md;对应审计报告入口。
记录方式:append-only。
project-routing-smoke-20260603/dev-doc/开发问题记录.md
New file
@@ -0,0 +1,8 @@
# 开发问题记录
创建人员:Codex
文件职责:开发问题记录。
管理规范/模板:../common/dev-doc/开发问题记录模版.md。
引用文件:对应审计报告入口。
记录方式:append-only。
project-routing-smoke-20260603/dev-doc/目录导读.md
New file
@@ -0,0 +1,8 @@
# 目录导读
创建人员:Codex
文件职责:测试开发入口。
管理规范/模板:../common/dev-doc/目录导读.md。
引用文件:编码规范.md。
记录方式:入口导读。
project-routing-smoke-20260603/dev-doc/编码规范.md
New file
@@ -0,0 +1,8 @@
# 编码规范
创建人员:Codex
文件职责:本地编码规范。
管理规范/模板:../common/dev-doc/编码规范.md。
引用文件:开发审计规范.md。
记录方式:本地规范。
project-routing-smoke-20260603/exp-doc/实验审计报告.md
New file
@@ -0,0 +1,10 @@
# 实验审计报告
创建人员:Codex
文件职责:实验和实验开发审计报告。
管理规范/模板:../common/exp-doc/实验审计报告模版.md。
引用文件:实验规范.md;../dev-doc/exp-doc/开发工作区说明.md。
记录方式:append-only。
- AUDIT-SMOKE-EXP:实验开发审计入口正确。
project-routing-smoke-20260603/exp-doc/实验规范.md
New file
@@ -0,0 +1,8 @@
# 实验规范
创建人员:Codex
文件职责:本地实验规范。
管理规范/模板:../common/exp-doc/实验规范.md。
引用文件:实验审计报告.md。
记录方式:本地规范。
project-routing-smoke-20260603/pro-doc/需求审核规范.md
New file
@@ -0,0 +1,8 @@
# 需求审核规范
创建人员:Codex
文件职责:本地需求审核规范。
管理规范/模板:../common/pro-doc/需求审核规范.md。
引用文件:需求规范.md。
记录方式:本地规范。
project-routing-smoke-20260603/pro-doc/需求规范.md
New file
@@ -0,0 +1,8 @@
# 需求规范
创建人员:Codex
文件职责:本地需求规范。
管理规范/模板:../common/pro-doc/需求规范.md。
引用文件:需求审核规范.md。
记录方式:本地规范。
project-routing-smoke-20260603/项目事项审计报告.md
New file
@@ -0,0 +1,8 @@
# 项目事项审计报告
创建人员:Codex
文件职责:测试项目事项审计。
管理规范/模板:../common/project-doc/项目事项审计报告模版.md。
引用文件:项目事项总纲.md。
记录方式:append-only。
project-routing-smoke-20260603/项目事项总纲.md
New file
@@ -0,0 +1,8 @@
# 项目事项总纲
创建人员:Codex
文件职责:测试项目事项总纲。
管理规范/模板:../common/project-doc/项目事项总纲模版.md。
引用文件:项目事项计划.md。
记录方式:append-only。
project-routing-smoke-20260603/项目事项计划.md
New file
@@ -0,0 +1,8 @@
# 项目事项计划
创建人员:Codex
文件职责:测试项目事项计划。
管理规范/模板:../common/project-doc/项目事项计划模版.md。
引用文件:项目事项总纲.md。
记录方式:append-only。
project-routing-smoke-20260603/项目变更记录.md
New file
@@ -0,0 +1,10 @@
# 项目变更记录
创建人员:Codex
文件职责:记录测试项目配置变更。
管理规范/模板:../common/project-doc/项目变更记录模版.md。
引用文件:项目配置清单.md。
记录方式:append-only。
- 2026-06-03 初始化 smoke 项目。
project-routing-smoke-20260603/项目总览.md
New file
@@ -0,0 +1,10 @@
# 项目总览
创建人员:Codex
文件职责:测试项目基本信息。
管理规范/模板:../common/project-doc/项目总览范本.md。
引用文件:项目配置清单.md。
记录方式:测试项目总览。
项目名称:project-routing-smoke-20260603
project-routing-smoke-20260603/项目执行日志.md
New file
@@ -0,0 +1,10 @@
# 项目执行日志
创建人员:Codex
文件职责:记录测试项目创建动作。
管理规范/模板:../common/project-doc/项目执行日志模版.md。
引用文件:项目配置清单.md。
记录方式:append-only。
- 2026-06-03 创建测试项目并启用开发/实验/案例/需求体系。
project-routing-smoke-20260603/项目规范.md
New file
@@ -0,0 +1,8 @@
# 项目规范
创建人员:Codex
文件职责:测试项目本地项目规范。
管理规范/模板:../common/project-doc/项目规范模版.md。
引用文件:项目配置清单.md。
记录方式:本地规范。
project-routing-smoke-20260603/项目配置清单.md
New file
@@ -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 | 需求开发审计走开发审计报告 |
project-routing-smoke-20260603/项目问题记录.md
New file
@@ -0,0 +1,8 @@
# 项目问题记录
创建人员:Codex
文件职责:测试项目问题记录。
管理规范/模板:../common/project-doc/项目问题记录模版.md。
引用文件:项目事项审计报告.md。
记录方式:append-only。
管理系统说明.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 文档里