---
name: wave-close-checklist
description: "当波次收口、里程碑状态变化或裁定类提交(拍板/闸门判定/口径变更)时使用:按序执行总账→作战清单→回填→.agent→蒸馏→索引→编排入库→治理门的八步收口清单,收口铁律唯一可执行入口。"
---

# 波次收口检查单（wave-close checklist）

> **收口动作的唯一可执行清单**。总账铁律、作战清单回填铁律、`.agents/README.md` 维护规则、协议 §6 均指向本单——收口流程变更只改这里，不再四处散写。
> 触发时机：①波次收口 ②里程碑状态变化 ③裁定类提交（拍板/闸门判定/口径变更）。
> 由来：2026-06-11 harness 体检发现收口规则散落 4 处、靠记忆执行，总账表头/作战清单轮次/`.agent` 横幅/AGENTS.md §3 四处同时漂移——本单由此而来。

## 八步清单（按序执行，全过才算收口）

- [ ] **1. 总账**：更新 `docs/mvp/MVP进度总账.md` 受影响段（§0 现状 / §1 里程碑 / §2 模块矩阵 / §3 链路 / §5 backlog / §6 执行记录），**并同步表头「最近更新」日期 + 对账 commit**（表头漂移=本单诞生的直接诱因，勿再漏）。
- [ ] **2. 作战清单**：`docs/mvp/MVP作战清单.md` 勾掉完成项并**移入完成史归档**（清单保持 ≤ 一屏，只留完成线 + 队列）；**一轮完成线达成时，向创始人提请滚动重锁下一轮 §0**。
- [ ] **3. 回填检查（裁定类必做）**：拍板/闸门判定/口径变更须同步修订受影响的 SoT（架构 6 域树对应档、tech-decisions、对外档等,以 [注册表](../../docs/architecture/README.md) 为准），或在提交说明显式声明「不回填 + 理由」。（原作战清单回填铁律，2026-06-10 HJ-AUDIT-001）
- [ ] **4. `.agent` 文件（仅结构变化时）**：新建模块、目录职责/边界变化时更新对应 `.agent`；**纯进度推进不改 `.agent`**（进度一律以总账为准——避免再造「Day-0 横幅」式陈旧）。
- [ ] **5. 蒸馏**：可复用产出回写 `.agents/`（事实→knowledge / 红线→rules / 配方→skills / 流程→workflows），先查重后新增；**操作配方必须落 `.agents/skills/`，不得只存会话私有记忆**（私有记忆换会话/换 agent/换人即不可见）。
  - **蒸馏门（2026-06-17 文档体系重构，[`../rules/engineering-conventions.md`](../rules/engineering-conventions.md) §10.6）**：本波若产生留痕（新 brainstorm/plan/report/dated spec），**必须产出「蒸馏 diff」（洞见提升进策展层 canonical/`.agents`）或显式声明「无可蒸馏＋理由」**——杜绝留痕只堆不蒸馏致策展层陈旧（治「更新不及时」）。
- [ ] **6. 索引同步**：`.agents/` 有结构性变更（增/删/改名）时，同步 `.agents/README.md` 清单 + `AGENTS.md` §5 导航表（两处都要，§5 曾漏更两个 skill）。
- [ ] **7. 编排资产入库**：本波用过的 Workflow 脚本 / 探针 / 一次性工具入库（对应 spec 目录或编排器目录），收口报告落 `docs/agent-specs/`；确不入库的，在收口报告声明「不入库 + 理由」。
- [ ] **8. 目录退役 + 分层 + 治理门（2026-06-16 立,2026-07-02 接门）**：本波 `execution`/设计档收口后顶部状态横幅翻 `SHIPPED`（被推翻的翻 `SUPERSEDED→替代档`）；spike 代码/批跑证据/模型原始输出不入文档树（结论留 `*.md`,原始件 untracked 或移仓级 `spikes/`）；**更新 [`docs/agent-specs/_index.md`](../../docs/agent-specs/_index.md) 在飞板**（收口项移除,新在飞登记）；**一题一活档（§10.4）**:同一任务设计档收敛成最小自洽集,被取代者同提交删（git 即历史）;留痕 frontmatter（§10.6）:`date/topic/status/superseded-by`,设计档另须 `sot-impact`（G6）。**最后跑门:`bash .agents/tools/docs-gate.sh` 必须全绿**（七检:品牌/canonical 对账/死链/入口卫生/留痕隔离/设计档申报/计划谱系 G7,§10.7）。**波内有 merge commit 时(pre-commit 不触发)另手跑对应条件门**:碰门件(play.cdp/tools.mjs/gate_judge/cheap_gates/gate-fixtures)= `node contracts/gate-fixtures/run.mjs`;碰 `contracts/play-loop/` = 其 `validate.py --suite`;碰品类 rubric/五品类 skill = `.agents/tools/rubric-sync-gate.py`;碰 `contracts/prompts/` = 其 `check_registry.py`（挂载清单=B8,`.githooks/pre-commit` 为准）。

## 提交前 30 秒自检

```bash
# 治理门(七检,<5s,不绿不收口)
bash .agents/tools/docs-gate.sh
# 总账表头日期应 = 收口日
head -8 docs/mvp/MVP进度总账.md | grep 最近更新
# 作战清单不应残留已完成项（完成项应已移入 git 历史）
grep -c "✅" docs/mvp/MVP作战清单.md   # 期望 ≈ 0
```