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