games-development-ai/.agents/skills/wave-close-checklist.md
lili a207cb8d65
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
docs-gate / docs-gate (push) Has been cancelled
docs(agents): skill 规范化双层收口 + 席位context skill 新增 + W-NSTAR/W-TPL/W-GENLOG 设计波落档
- .agents/skills 25 件全量 frontmatter 规范化与评审修入(含 prompt-governance 大修);.claude/skills 7 件薄壳按双层方案①落位
- 新增 skill:agentic-seat-context-design(agentic 席位与 context 工程设计基线,2026-07-05 探索蒸馏)
- 设计波三件落档:复杂游戏北极星件(W-NSTAR 终审稿待拍)/黄金模板规格件(W-TPL 定稿待批)/生成侧过程蒸馏回路(W-GENLOG 骨架)
- protocol/在飞板/作战清单/数据飞轮 SoT/契约 prompts 索引同步;breakout 九门证据刷新
- .gitignore 补 /localagents.md 真实忽略行(该文件自声明绝不提交,此前声明未被机器执行)
- 刻意不入库:nacos-data/ 与 _tier2-gen、c2v-*、amgen-* 生成产物(可重生成,忽略行格式待拍)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 05:32:56 -07:00

4.7 KiB
Raw Permalink Blame History

name, description
name description
wave-close-checklist 当波次收口、里程碑状态变化或裁定类提交(拍板/闸门判定/口径变更)时使用:按序执行总账→作战清单→回填→.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、对外档等,以 注册表 为准),或在提交说明显式声明「不回填 + 理由」。原作战清单回填铁律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 立,2026-07-02 接门):本波 execution/设计档收口后顶部状态横幅翻 SHIPPED(被推翻的翻 SUPERSEDED→替代档spike 代码/批跑证据/模型原始输出不入文档树(结论留 *.md,原始件 untracked 或移仓级 spikes/更新 docs/agent-specs/_index.md 在飞板(收口项移除,新在飞登记);一题一活档§10.4:同一任务设计档收敛成最小自洽集,被取代者同提交删git 即历史);留痕 frontmatter§10.6:date/topic/status/superseded-by,设计档另须 sot-impactG6最后跑门: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 秒自检

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