- .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>
4.7 KiB
4.7 KiB
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)或显式声明「无可蒸馏+理由」——杜绝留痕只堆不蒸馏致策展层陈旧(治「更新不及时」)。
- 蒸馏门(2026-06-17 文档体系重构,
- 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-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 秒自检
# 治理门(七检,<5s,不绿不收口)
bash .agents/tools/docs-gate.sh
# 总账表头日期应 = 收口日
head -8 docs/mvp/MVP进度总账.md | grep 最近更新
# 作战清单不应残留已完成项(完成项应已移入 git 历史)
grep -c "✅" docs/mvp/MVP作战清单.md # 期望 ≈ 0