| | |
|---|
| | | | `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. 创建步骤 |
|---|
| | | |
|---|
| | |
|---|
| | | 创建人员：<填写> |
|---|
| | | 文件职责：记录本目标开发工作区的代码入口、测试入口、所属事项、方案附件和根级开发账本回写位置。 |
|---|
| | | 管理规范/模板：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. 目录映射 |
|---|
| | | |
|---|
| | |
|---|
| | | 3. 测试目录。 |
|---|
| | | 4. 开发文档入口。 |
|---|
| | | 5. 当前开发事项列表。 |
|---|
| | | 6. 审计报告入口。 |
|---|
| | | 6. 审计报告入口，必须按目标体系写清是 `dev-doc/开发审计报告.md`、`exp-doc/实验审计报告.md` 还是 `ana-doc/案例审计报告.md`。 |
|---|
| | | 7. 问题记录入口。 |
|---|
| | | |
|---|
| | | ### 5.6 登记到项目配置清单 |
|---|
| | |
|---|
| | | 3. 开发审核员。 |
|---|
| | | 4. 写权限范围。 |
|---|
| | | 5. 核心文档入口。 |
|---|
| | | 6. 审计报告入口。 |
|---|
| | | |
|---|
| | | 开发 AI 的写权限应绑定到对应 `dev/<target>-dev/`、`dev/<target>-dev/test/`、`dev-doc/<target>-doc/`，不默认拥有全部开发子目录。 |
|---|
| | | |
|---|
| | |
|---|
| | | 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 校验 |
|---|
| | | |
|---|
| | |
|---|
| | | 开发事项总纲：记录 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. 如果问题会影响后续开发执行，必须先修复并复审，再允许正式开发事项开始。 |
|---|
| | | |
|---|
