DKChan
f958a03f51
八件受版文件 git mv 进 reports/（一律先迁不删，删除归后续批或用户点名）：提案三件（冒险前资源配比预设／效果引擎无状态化／武器锻造系统）、审计两件（代码术语审计／单测与验收门禁标准测试审计）、美术审计两件（cursor 会话存档 md ＋ canvas 转 HTML 渲染件）、需求澄清-营地交互重做；未入库的 UI预览demo 三路对照件只搬盘不入库。 GDD 落文：锻造工坊.md「满级特效扩展位」节收下七条候选池（长剑破甲／长剑暴击面扩大／长枪先手连击／法杖开局魔法矢／轻甲灵巧／重甲反震／魔法护甲护盾），按现役 EFFECT_KINDS 与 settlement.tres:51/52 逐条复核实现代价分档，效果类型闭集口径取正文现行 31 种、不抄过程稿旧记 24 种；候选池定性为备用清单非承诺清单。 引用面换代 08（playnote 之外两处 ../research/ 改 ../../reports/）、待办清单四处、reports 八张卡片（跨目录前缀改同目录）、art-assets-checklist 与 sim-data/README 两处既存死指改「沿革查 git 提交史」、content-archive 出处句标注该目录已退役。迁入件内部相对链接随迁移重基准（../gdd/ → ../design/gdd/，playnote 与待办清单改回仓库根），并订正上一批遗留错误：两张迭代 30 卡片的 playnote 链接原写 ../../playnote.md（从 reports/ 出发指到仓库外），现改 ../playnote.md。 规则与机检：doc-conventions §11「暂存地非档案库」行改为单暂存地＋禁在 design/ 下设过程件目录＋图像载体与报告渲染件口径分列（禁图留 artwork/ 沿用 2026-09-27 用户裁；.html/.json 允许作为报告的一种＝2026-10-21 用户裁，原「只放 .md」句系 10-17 建目录时顺带照搬、无单独点头记录）；AGENTS Project Layout 两行同步；reports/README 补「设计讨论段过程稿」命名行。repo_structure_audit：DESIGN_SUBDIRS 去 research、RETIRED 加 design/research；doc_ref_audit 排除面清空（design 全树入扫描面）；doc_term/doc_link 扫描域注释换代；三件样张脚本 OUT_REPORT 改落 reports/ 并补 os.makedirs（改前只对 OUT_PNG 建目录，目录缺失即 FileNotFoundError）。 变异验证：重建 design/research 并放文件 → 结构闸退出码 1、同时报「退役路径再现」与「子目录越界」两条；design/ 内放两条指向不存在文件的引用 → 引用可核机检报「路径不存在」红项 2（该闸暂未注册进闸壳，无基线记录必判变化）；清场后结构闸 PASS。
29 lines
3.0 KiB
Markdown
29 lines
3.0 KiB
Markdown
# reports/ — 过程件容器
|
||
|
||
`design/` 只放持久化设计文档与规范，过程件一律不放。过程件落本目录，**按「吸收即死」到期即死**。
|
||
|
||
## 放什么
|
||
|
||
| 文件 | 内容 | 谁写 |
|
||
|---|---|---|
|
||
| `需求卡片-<批名>-<日期>.md` | 一个需求单位的实施文档（roadmap 迭代行里的「卡①②③」是需求单位，需求卡片是它的展开）：目标与完成定义／设计事实源／现状事实／契约／范围边界／任务卡／验收闸／代拍板白名单／待裁点 | 写卡段（`req-card` 技能） |
|
||
| `提案-*`／`需求澄清-*`／`审计-*`／`评估-*` | 设计讨论段的过程稿：提案备选案与淘汰依据、需求澄清结论、调研与审计读数。被需求卡片或 GDD 当裁决源引用时在册；结论落进权威文档后即可删，删它不需要再裁（§11 吸收即死） | 设计讨论段 |
|
||
| `iter<N>-实现报告-<日期>.md` | 各任务卡状态、实机目检总清单、遗留读数义务 | 迭代批 |
|
||
| `iter<N>-代拍板-<日期>.md` | 批内 agent 替你拍的决定清单，等你追认或推翻 | 迭代批 |
|
||
| `iter<N>-反哺点-<日期>.md` | 需要写进 `design/` 权威文档的点，逐条列清"哪个文件哪一节、改成什么、依据是什么" | 迭代批 |
|
||
| `iter<N>-验收审计-<日期>.md` | 独立验收审计结果：逐行对照表核对、撤销证明抽查、未过项与例外及依据 | 独立审计方（未参与实现） |
|
||
| `iter<N>-<交付物名>-<日期>.md` | 需求卡片点名的其它交付物（例：`iter27-探针迁移对照-2026-10-14.md`＝11 个探针的成员依赖面清单，已随迭代 27 收尾退役） | 迭代批 |
|
||
|
||
## 不放什么
|
||
|
||
- **不放设计结论。** 本目录的文件是"待处理的申请单"，不是事实源。反哺点由你在会话中讨论定稿后，
|
||
另开文档批写进 `design/`，写完即可删除本目录对应条目。
|
||
- **不放图像载体。** png/jpg/svg 等图一律留 `artwork/`（2026-09-27 用户裁「审图只看一处」；熵增闸图像白名单不含本目录，放了判红）。`.html`／`.json` 这类报告渲染件允许作为报告的一种（2026-10-21 用户裁）。
|
||
- **不放进度状态。** 现在做什么看根 `roadmap.md` 顶部「当前位」节，待办与待裁看仓库根 `待办清单.md`（2026-10-18 用户裁：根目录会话状态文件已废除，本目录也不许兼做状态记录）。
|
||
|
||
## 生命周期
|
||
|
||
一个迭代号一组文件，**所属迭代实现批合回 master 即死**（判据权威=doc-conventions §11：需求卡片与迭代产出物的死期都是合回那一刻，roadmap 对应行改填「已退役（git 历史可考）」保留字）：反哺点须先由 `design/` 吸收落文，再连同卡片与本目录其余产出物一并删除，历史进 git commit log
|
||
（与"历史决策记录只进 git log、不设决策文档"这条红线同口径）。退役执行=batch-closure 技能
|
||
（批后收尾与中间文档退役），删前先过 doc-conventions §11 判据。验收审计报告随实现报告同批退役（结论已并入实现报告）。
|