DKChan
27812167ef
判据（对 869 个 ZCode 会话与 16 个 Qoder 会话的读写统计）：active.md 被整文件读 448 次、 单次中位数 14 KB、累计 6.09 MB 进上下文，311/320 个碰它的会话把它当第一个工具调用读； 但 7311 个提及它的思考片段的语境分布是——写入与编号簿记 327 个会话、并行冲突与避让 234 个、 退役与失真核对 162 个，而明确写「从它所载内容得知某事实」的只有 20 个会话。 逐条核 41 个条目：独特且现行 2 条（另 3 个子句）、别处已有权威源 14 条、陈旧或自相矛盾 7 条、 已完结批次的历史叙述 18 条；按字节约 95% 属后三类。失实样本：architecture 版本记 v1.6 实为 v1.8、 规则文件数记 7 份实为 6 份、迭代 27/28 记「位预留追加卡」而 roadmap 记已完成、三个已删 worktree 仍记「在盘待删」、同一条既宣称「文档禁列闸清单」又自行列出 01–11 全套闸。 执法件已建一轮仍拦不住：08b 体量闸只测条目数/行数/编号/死链，测不出语义失真；钩子不随仓库传播， 只有 ZCode 在跑；10-15 清到 8.6 KB、10-17 回到 40 KB，用户为「只写不删」连续三次发火。 改动面： - 删 active.md 与 tools/audit_active_state.py；run_all_gates.sh 摘除 08b 闸件与头注、 baseline.json 删 08b 记录（现存 12 闸）、repo_structure_audit.py 根文件白名单去 active.md - doc-conventions §10 改写为「仓库根不设状态文件」并留裁决与判据（保持 §11/§12 编号不漂）； §11 表两行去状态文件口径；§4 适用范围去 active.md - process-conventions §1 第 2/3 条（合回前查尾号防撞号、豁免面）、§3 第 12 条（批次完成后的 登记义务）、§6 分级周期口径（闸件清单不再在文档重列）四处换代 - code-conventions「实现批收尾双登记」改为单登记；CLAUDE.md 目录节、规范导航行、worktree 豁免 行三处换代，红线新增「仓库根禁止设会话状态文件」一条 - roadmap.md 顶部新增「当前位」三行（阶段／迭代位／下一步）接替原快照职责，头注、执行纪律第 3 条、 loop 规范第 8 条、维护纪律四处改指 06 与本文；reports/README.md 与 sim-data/README.md 两处 现行指路改口；architecture.md 文档域闸表行去 active.md 体量闸与触发路径 - 06-待办清单迁入七条真残值（原仅载于该文件）：卡片入库纪律悬空待办、req-card 两副本取齐、 魔法道具与罕见残留（实数 23/17 处，旧记约 30/18）、通关口径统一（gdd 内 188 处，旧记 273）、 黑话第二波待发令、数据整改批九条存疑待抽查（该批未提交面所载）、发布前删除 main.gd:196 调试 入口写死行（工程直入·待写卡） harness 侧另批处理（.zcode/ 与用户级技能不入 git）：session-snapshot.sh 与 config.json 注册、 worktree-guard.sh 的 active.md 豁免白名单、active-closing 技能、doc-consistency-check 第 8/9 项、 iter 与 req-card 技能里的「唯一例外=active.md」与查尾号条款。
25 lines
1.5 KiB
Markdown
25 lines
1.5 KiB
Markdown
# reports/ — 迭代批的产出物存放处
|
||
|
||
迭代（代码实现）批**禁写 `design/` 整个目录**——那里是设计权威文档与规范，对实现批只读。
|
||
实现批自己要往外交代的东西，一律落在本目录。
|
||
|
||
## 放什么
|
||
|
||
| 文件 | 内容 | 谁写 |
|
||
|---|---|---|
|
||
| `iter<N>-实现报告-<日期>.md` | 各任务卡状态、实机目检总清单、遗留读数义务 | 迭代批 |
|
||
| `iter<N>-代拍板-<日期>.md` | 批内 agent 替你拍的决定清单，等你追认或推翻 | 迭代批 |
|
||
| `iter<N>-反哺点-<日期>.md` | 需要写进 `design/` 权威文档的点，逐条列清"哪个文件哪一节、改成什么、依据是什么" | 迭代批 |
|
||
|
||
## 不放什么
|
||
|
||
- **不放设计结论。** 本目录的文件是"待处理的申请单"，不是事实源。反哺点由你在会话中讨论定稿后，
|
||
另开文档批写进 `design/`，写完即可删除本目录对应条目。
|
||
- **不放图。** 图像白名单不含本目录，放了会被熵增闸判红。
|
||
- **不放进度状态。** 现在做什么看根 `roadmap.md` 顶部「当前位」节，待办与待裁看 `design/gdd/06-待办清单.md`（2026-10-18 用户裁：根目录会话状态文件已废除，本目录也不许兼做状态记录）。
|
||
|
||
## 生命周期
|
||
|
||
一个迭代号一组文件，落档即死：反哺点被 `design/` 吸收后，对应文件删除，历史进 git commit log
|
||
（与"历史决策记录只进 git log、不设决策文档"这条红线同口径）。
|