① 红因与改法——run 169 远端唯一红项=流水线闸判据「能力行格式」13 条,全部出自需求卡片-棋盘瓦片与立体表现重做批 §12 对照表 365/366/367/368/373 五行:判据锚直接抄了 art-bible 条目名「棋盘地形体系|材质与装饰」这类含裸竖线的写法,Markdown 表格单元格内的裸 | 使行被多切一列,「能力行」格读到隔壁判据文字。闸的分列件 row_cells 按 | 直切、不认转义(tools/pipeline_gate.py:342),且该判据在 d97145ee 当时闸版本与现行版本逐字相同(CAP_ROW_RE 与 cap_hit 段两版一致)——属卡片表格格式缺陷,非闸版本变更引起。改法=锚关键词改取竖线后的条目专名(材质与装饰/受光与崖面/绘制序与遮挡/浮空数字/旧资产处理);CONTENT_ANCHOR_RE 关键词字符类本就在 | 处止住,故机器核验目标不变、表格恢复合法。五锚经 anchor_util.verify 逐一复算=None(节名「3.2 环境几何」命中标题行+关键词命中该节块)。
② 待办条目收口——「测试面真输入化分期与存量断言逐条精锚」(2026-11-05 登记)剩余面已由 iter54-卡1(提交 96123978)承接:本区复跑该批 R9 双模式 grep=定义面 `func press_*`/`func *_for_probe` 零命中、调用面 `.press_(` 零命中;注记面已由 test-conventions §8.3「测试函数的判据出处注记」把粒度定在验证函数(换代形态,非逐条断言)。按 doc-conventions §12.1「做完整条删除」删条。引用面改写:QA-harness 三批报告 B2 登记处改指提交 96123978、B3 登记处改写为函数级规格换代+提交 a69310b7(不留指向已删条目的悬空指路句)。
凭据:tools/pipeline_gate.py exit 0(31 条目·59 总表行·9 链·10 卡全过);tools/run_all_gates.sh --docs exit 0【验收通过】闸况与基线一致无新增红(该次跑批 game/ 面尚未提交,代码面读数见第二笔)。
reports/ — 过程件容器
design/ 只放持久化设计文档与规范,过程件一律不放。过程件落本目录,按「吸收即死」到期即死。
放什么
| 文件 | 内容 | 谁写 |
|---|---|---|
需求卡片-<批名>-<日期>.md |
一个需求单位的实施文档(roadmap 迭代行里的「卡①②③」是需求单位,需求卡片是它的展开):目标与完成定义/设计事实源/现状事实/契约/范围边界/任务卡/验收闸/代拍板白名单/待裁点 | 写卡段(req-card 技能) |
提案-*/需求澄清-*/审计-*/评估-* |
设计讨论段的过程稿:提案备选案与淘汰依据、需求澄清结论、调研与审计读数。被需求卡片或 GDD 当裁决源引用时在册;结论落进权威文档后即可删,删它不需要再裁(§11 吸收即死) | 设计讨论段 |
iter<N>-实现报告-<日期>.md |
各任务卡状态、实机目检总清单、遗留读数义务、实现决定记录(超白名单/超卡片明列范围事项的备案节,细则见 process-conventions §3 第 11 条) | 迭代批 |
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 判据。验收审计报告随实现报告同批退役(结论已并入实现报告)。