From e524adfb0d804f5fe5d1023b2f583b7e7261d2d8 Mon Sep 17 00:00:00 2001 From: lili Date: Fri, 3 Jul 2026 21:02:00 -0700 Subject: [PATCH] =?UTF-8?q?docs(.agents):=20wave-close=20=E7=AC=AC8?= =?UTF-8?q?=E6=AD=A5=E2=80=94=E2=80=94docs-gate=20=E5=85=AD=E6=A3=80?= =?UTF-8?q?=E6=94=B9=E4=B8=83=E6=A3=80(G7)+merge=20commit=20=E6=89=8B?= =?UTF-8?q?=E8=B7=91=20B8=20=E6=9D=A1=E4=BB=B6=E9=97=A8=E6=B8=85=E5=8D=95(?= =?UTF-8?q?pre-commit=20=E4=B8=8D=E8=A7=A6=E5=8F=91=E7=BC=BA=E5=8F=A3)=20(?= =?UTF-8?q?=E5=B0=BE=E6=B3=A2=E6=8C=82=E7=82=B9)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- .agents/skills/wave-close-checklist.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.agents/skills/wave-close-checklist.md b/.agents/skills/wave-close-checklist.md index 7a666d70..151fa72a 100644 --- a/.agents/skills/wave-close-checklist.md +++ b/.agents/skills/wave-close-checklist.md @@ -14,12 +14,12 @@ - **蒸馏门(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 对账/死链/入口卫生/留痕隔离/设计档申报,§10.7)。 +- [ ] **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,不绿不收口) +# 治理门(七检,<5s,不绿不收口) bash .agents/tools/docs-gate.sh # 总账表头日期应 = 收口日 head -8 docs/mvp/MVP进度总账.md | grep 最近更新