DKChan
0616af94fb
用户裁：需求卡片属过程件，不留在 design/；统一落 reports/（不新设目录，卡片靠「需求卡片-」文件名前缀与报告区分）。 搬移： - 10 张在役卡片 design/research/ → reports/（git mv，历史保留） - 卡内相对链接全部重基准：../gdd→../design/gdd、../art→../design/art、../../→../、 同目录 research 引用→../design/research/（营地澄清、playnote、资源配比提案）； 链接解析校验 BROKEN=0 路径依赖（全库 48 处）： - 06 待办清单 10 条卡片路径、roadmap 迭代 31 行 2 条、reports/iter31 报告与反哺点各 1 条 - 代码术语审计报告 2 处、会话提示 1 处、资源配比提案 1 处 规则说明： - AGENTS.md Project Layout：design/research 行注明「需求卡片不在此」；reports 行扩为「过程件容器」 - doc-conventions §11 暂存地表拆为两处；§12.1 状态机示例改 reports/ - reports/README.md：定位由「迭代批产出物」扩为「过程件容器」并新增需求卡片行 流水线闸： - pipeline_gate.py CARD_DIR / RESEARCH_RE / 报错文案三处改 reports/（闸 PASS，卡片口径 10 张全过） 工作流技能（.zcode/skills，不入 git）： - req-card :8 落位 / :27 三份已退役范本改指现行卡片 / :92 06 回写口径 - iter :19、iter-plan :28/:66、batch-closure :3/:63/:65 - 用户级副本 C:/Users/DK/.workbuddy/skills/req-card/SKILL.md 同步三处（技能列表启动时加载，需重开会话生效） 未动：design/art、design/qa、提案、playnote、道具退役素材库、会话交接件（归其它会话）。 闸：run_all_gates.sh --docs 验收通过。
27 lines
2.0 KiB
Markdown
27 lines
2.0 KiB
Markdown
# reports/ — 过程件容器
|
||
|
||
`design/` 只放持久化设计文档与规范，过程件一律不放。过程件落本目录，**按「吸收即死」到期即死**。
|
||
|
||
## 放什么
|
||
|
||
| 文件 | 内容 | 谁写 |
|
||
|---|---|---|
|
||
| `需求卡片-<批名>-<日期>.md` | 一个需求单位的实施文档（roadmap 迭代行里的「卡①②③」是需求单位，需求卡片是它的展开）：目标与完成定义／设计事实源／现状事实／契约／范围边界／任务卡／验收闸／代拍板白名单／待裁点 | 写卡段（`req-card` 技能） |
|
||
| `iter<N>-实现报告-<日期>.md` | 各任务卡状态、实机目检总清单、遗留读数义务 | 迭代批 |
|
||
| `iter<N>-代拍板-<日期>.md` | 批内 agent 替你拍的决定清单，等你追认或推翻 | 迭代批 |
|
||
| `iter<N>-反哺点-<日期>.md` | 需要写进 `design/` 权威文档的点，逐条列清"哪个文件哪一节、改成什么、依据是什么" | 迭代批 |
|
||
| `iter<N>-<交付物名>-<日期>.md` | 需求卡片点名的其它交付物（例：`iter27-探针迁移对照-2026-10-14.md`＝11 个探针的成员依赖面清单） | 迭代批 |
|
||
|
||
## 不放什么
|
||
|
||
- **不放设计结论。** 本目录的文件是"待处理的申请单"，不是事实源。反哺点由你在会话中讨论定稿后，
|
||
另开文档批写进 `design/`，写完即可删除本目录对应条目。
|
||
- **不放图。** 图像白名单不含本目录，放了会被熵增闸判红。
|
||
- **不放进度状态。** 现在做什么看根 `roadmap.md` 顶部「当前位」节，待办与待裁看 `design/gdd/06-待办清单.md`（2026-10-18 用户裁：根目录会话状态文件已废除，本目录也不许兼做状态记录）。
|
||
|
||
## 生命周期
|
||
|
||
一个迭代号一组文件，落档即死：反哺点被 `design/` 吸收后，对应文件删除，历史进 git commit log
|
||
（与"历史决策记录只进 git log、不设决策文档"这条红线同口径）。退役执行=batch-closure 技能
|
||
（批后收尾与中间文档退役），删前先过 doc-conventions §11 判据。
|