zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
games-development-ai/.agents/skills/wave-close-checklist.md
zizi 15efff4dee docs(harness): 文档体系重构(止血最小集)——两层模型+机器可检蒸馏门 
全局 ~/.claude/CLAUDE.md(仓外)退役「每任务 dated review+execution 双档」→两层喂料(WHAT/HOW)+收口蒸馏,增量 deprecate(旧档兼容)。本仓:engineering-conventions §10.6(两层心法/判层/蒸馏门/留痕 frontmatter);wave-close 第5/8步机器可检蒸馏门;AGENTS §2 目标锚去双 roadmap 二义 + §3.3 两层前门索引(模块进度 SoT=总账§2 / 自动记忆界外 / memorys 判死)。

评审 CE 5 人格(coherence/feasibility/scope/product/design)压缩至止血最小集,砍两层新目录/新收口门/评审舰队正式替换。WHAT=docs/brainstorms/2026-06-17-文档体系重构-requirements.md;决策记忆 docs-system-hybrid-two-layer(仓外)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 16:33:21 +00:00

4.3 KiB
Raw Blame History

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

收口动作的唯一可执行清单。总账铁律、作战清单回填铁律、.agents/README 维护规则、协议 §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. 回填检查（裁定类必做）：拍板/闸门判定/口径变更须同步修订受影响的蓝图档/蒸馏档/对外档（Doc A/B/C、tech-decisions、glossary、BP 等），或在提交说明显式声明「不回填 + 理由」。（原作战清单回填铁律，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 §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 目录治理新增，配套 ../rules/engineering-conventions.md §10）：本波 execution/edit-plan 收口后顶部状态横幅翻 SHIPPED（被推翻的翻 SUPERSEDED→替代档）；spike 代码 / 批跑证据 / 模型原始输出不入文档树——结论留 *.md 或收口报告，原始件 untracked 或移仓级 spikes/（__pycache__/node_modules 已 gitignore，勿 git add 批量 json/png）；更新 docs/agent-specs/_index.md 活地图（活档清单 + supersede 链 + 归档指针）。目的：杜绝「打过时标不归档」式堆积（治理审计根因）。+ 一题一活档（§10.4）：同一任务设计档收敛成最小自洽集（典型 1 review + 1 execution），被取代者同提交删/归档（演进就地修订、禁「一 pivot 一文件」、禁单独连推过期档）。+ 留痕 frontmatter（§10.6）：新留痕文件（brainstorms/plans/report）头带 date/topic/status/superseded-by；留痕原地累积，前门（AGENTS.md §3.3）只给检索入口、不逐条挂。

提交前 30 秒自检

# 总账表头日期应 = 收口日
head -8 docs/mvp/MVP进度总账.md | grep 最近更新
# 作战清单不应残留已完成项（完成项应已移入归档）
grep -c "✅" docs/mvp/MVP作战清单.md   # 期望 ≈ 0
# 本波若新增留痕(brainstorms/plans/report),应有对应蒸馏 diff 或「无可蒸馏」声明(§10.6 蒸馏门)
git status --short docs/brainstorms docs/plans 2>/dev/null