docs(卡片): 需求卡片落位迁至 reports/——路径依赖、规则说明、流水线闸、工作流技能全量同步

用户裁:需求卡片属过程件,不留在 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 验收通过。
This commit is contained in:
DKChan committed 2026-10-20 05:28:42 +08:00
1 parent a2d446d9e0
commit 0616af94fb
21 files changed
+81 -81

No files matched your search

+3 -3
View File
@@ -1,12 +1,12 @@
# reports/ — 迭代批的产出物存放处
# reports/ — 过程件容器
迭代(代码实现)批**禁写 `design/` 整个目录**——那里是设计权威文档与规范,对实现批只读。
实现批自己要往外交代的东西,一律落在本目录。
`design/` 只放持久化设计文档与规范,过程件一律不放。过程件落本目录,**按「吸收即死」到期即死**。
## 放什么
| 文件 | 内容 | 谁写 |
|---|---|---|
| `需求卡片-<批名>-<日期>.md` | 一个需求单位的实施文档(roadmap 迭代行里的「卡①②③」是需求单位,需求卡片是它的展开):目标与完成定义/设计事实源/现状事实/契约/范围边界/任务卡/验收闸/代拍板白名单/待裁点 | 写卡段(`req-card` 技能) |
| `iter<N>-实现报告-<日期>.md` | 各任务卡状态、实机目检总清单、遗留读数义务 | 迭代批 |
| `iter<N>-代拍板-<日期>.md` | 批内 agent 替你拍的决定清单,等你追认或推翻 | 迭代批 |
| `iter<N>-反哺点-<日期>.md` | 需要写进 `design/` 权威文档的点,逐条列清"哪个文件哪一节、改成什么、依据是什么" | 迭代批 |