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 --- common/dev-doc/开发环境创建指南.md | 26 ++++++++++++++------------ 1 files changed, 14 insertions(+), 12 deletions(-) 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. 如果问题会影响后续开发执行，必须先修复并复审，再允许正式开发事项开始。 -- Gitblit v1.9.3