病根=测试规范 §5.2 只要求「每条清单条目至少一个自动断言」,没要求断言从改动的真实入口进入: 裸 EffectEngine 断言可替 BattleOrchestrator 接线,报告写「V1 绿」而 V1 断言并不存在。 - test-conventions §9(9.1–9.8):验收单位=行为改动;四层与真实入口;改动—验收对照表六列 双端对上(需求点正向、diff 反向、断言挂载测试侧);撤销证明(改既有行为回退变红、新增行为 变异变红);禁削弱测试;明确不要求 TDD;合回前独立验收审计;旧卡不回头改、开工前补齐 - process-conventions §3:第 7 条挂对照表、第 9 条补撤销证明、第 10 条合回前审计、新增第 16 条 - AGENTS.md 硬性红线新增「验收闭合」,与变异验证并列 - pipeline_gate 新增 C3:卡片须有对照表节、五个必需列、至少一行、必填格非空、全文声明验收审计; 只查结构不判语义(生效 2026-10-21,按卡片文件名日期追新) - reports/README 与 batch-closure 同步验收审计报告的落点与退役判据 - 待办清单登记「验收闭合规则——下一次迭代实测评估」,按规则评估红线等真实迭代检验
2.3 KiB
2.3 KiB
reports/ — 过程件容器
design/ 只放持久化设计文档与规范,过程件一律不放。过程件落本目录,按「吸收即死」到期即死。
放什么
| 文件 | 内容 | 谁写 |
|---|---|---|
需求卡片-<批名>-<日期>.md |
一个需求单位的实施文档(roadmap 迭代行里的「卡①②③」是需求单位,需求卡片是它的展开):目标与完成定义/设计事实源/现状事实/契约/范围边界/任务卡/验收闸/代拍板白名单/待裁点 | 写卡段(req-card 技能) |
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/,写完即可删除本目录对应条目。 - 不放图。 图像白名单不含本目录,放了会被熵增闸判红。
- 不放进度状态。 现在做什么看根
roadmap.md顶部「当前位」节,待办与待裁看design/gdd/06-待办清单.md(2026-10-18 用户裁:根目录会话状态文件已废除,本目录也不许兼做状态记录)。
生命周期
一个迭代号一组文件,落档即死:反哺点被 design/ 吸收后,对应文件删除,历史进 git commit log
(与"历史决策记录只进 git log、不设决策文档"这条红线同口径)。退役执行=batch-closure 技能
(批后收尾与中间文档退役),删前先过 doc-conventions §11 判据。验收审计报告随实现报告同批退役(结论已并入实现报告)。