agentic-flow-kit 1.8.2 → 2.0.0

package/templates/_github/workflows/kit-ci.yml

@@ -1,49 +0,0 @@
-# kit-ci —— agentic-flow-kit 装户远端门（GitHub Actions 薄模板，2026-10-07 adopter-ci-github）
-# 语义：本地 git hooks 可被 --no-verify / 未配 hooksPath 的克隆绕过——本工作流在 GitHub runner 上复跑
-# 统一入口 node .agents/scripts/verify.mjs（七门 GATES 编排：语法自检 / 测试【有根 package.json 才跑】/
-# 编排脚本检查 / 常驻面预算 / 生效规则视图漂移 / check-loop 闭环硬门 / 台账不变量历史全扫——门清单见
-# verify.mjs --list），任一门红即红；不在 YAML 里复制门禁逻辑（本地/远端单源，防口径漂移）。
-# 本文件归装户自持（owned）：触发分支 / node 版本 / 测试命令可自改，flow-kit sync 永不覆盖。
-# 装户仓工程在子目录（根无 package.json）时 verify 会跳过测试——改用
-#   node .agents/scripts/verify.mjs --test-cmd "<项目测试命令>"
-# 非 GitHub 托管（TFS / Azure DevOps / Jenkins…）可删除本文件：等价远端门 = 同入口命令 + 服务端分支策略。
-# ⚠️ 真正的「门」在服务端：Settings → Branches → branch protection 勾「要求 PR + 状态检查绿才可合并」
-# ——该配置带不进仓库文件，一次性人工动作，机器不校验。
-name: kit-ci
-on:
-  push:
-    branches: [main]
-  pull_request:
-jobs:
-  gate:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22   # 按项目 engines 调整（kit 引擎要求 >=18）
-      - name: 安装依赖（有根 package.json 才跑；私有源在此加 registry 配置）
-        if: hashFiles('package.json') != ''
-        run: npm ci || npm install || npm install --registry=https://registry.npmjs.org # 末级官方源兜底（2026-10-09 engine-quality-round3 W3：镜像故障不阻塞 CI）
-      - name: 远端门（verify 七门编排）
-        run: node .agents/scripts/verify.mjs
-      - name: CI 红回溯点名（2026-10-09 engine-quality-round2 B3：红时列出最近关单，复核优先）
-        if: failure()
-        run: |
-          node -e "
-            try {
-              const fs = require('fs');
-              const p = '.agents/confirmations.jsonl';
-              if (!fs.existsSync(p)) process.exit(0);
-              const cut = Date.now() - 7 * 864e5;
-              const rows = fs.readFileSync(p, 'utf8').split(/\r?\n/).filter(Boolean)
-                .map((l) => { try { return JSON.parse(l); } catch { return null; } })
-                .filter((e) => e && e.ts && ['done', 'closed'].includes(e.stage) && Date.parse(e.ts) >= cut)
-                .map((e) => e.doc);
-              const uniq = [...new Set(rows)];
-              if (uniq.length) {
-                console.log('⚠️ CI 红——最近 7 天关单文档（优先复核是否本批引入）：');
-                for (const d of uniq) console.log('  - ' + d);
-              } else console.log('最近 7 天无关单记录');
-            } catch { /* 回溯是辅助面，读不到不添乱 */ }
-          "

package/templates/wiki/INDEX.md

@@ -1,73 +0,0 @@
-# Wiki 索引
-
-> 本目录为整理后的项目知识沉淀，按主题归位。原文档归档到 `drafts-archive/`（按 `日期-主题` 命名）。
-> 人工只维护两样：**磁盘文件本身 + 下方速览表「用途」列**；速览计数 / 合计行 / 映射表 / 看板 DATA 均为生成区，勿手改——重生成 `node .agents/scripts/gen-wiki-board.mjs`（一致性验证 `node .agents/scripts/verify-wiki-consistency.mjs`）。
->
-> 看板：`知识沉淀总览.html`（同级目录）。
-
-## 主题目录速览
-
-| 主题 | 文件数 | 用途 |
-|---|---|---|
-| 产品需求 | 1 | 需求文档与变更记录（PRD、需求说明、评审结论） |
-| 用户功能 | 1 | 功能清单与操作说明（功能视角；与产品需求的分工：那里记"为什么做"，这里记"怎么用"） |
-| 开发方案 | 1 | 技术方案与设计文档（架构、接口、关键取舍） |
-| 项目规范 | 1 | 编码 / 流程 / 协作规范（只放现行有效版本） |
-| 项目计划 | 1 | 计划、里程碑与会议纪要（按日期命名） |
-| 测试报告 | 1 | 测试报告与验收记录（按 日期-主题 命名） |
-| 数据维护 | 1 | schema 变更与数据修复台账（子目录按批次组织，批内 README 记账，不参与文件级登记） |
-| drafts-archive | — | 原文档备份（按 日期-主题 分目录） |
-
-合计：**7 份**知识文档，**7 个主题**
-
-## 文件 → 主题 → 归属目录 映射表
-
-### 产品需求（1）
-
-| 文件名 | 主题 | 归属目录 |
-|---|---|---|
-| README.md | 产品需求 | wiki/产品需求/ |
-
-### 用户功能（1）
-
-| 文件名 | 主题 | 归属目录 |
-|---|---|---|
-| README.md | 用户功能 | wiki/用户功能/ |
-
-### 开发方案（1）
-
-| 文件名 | 主题 | 归属目录 |
-|---|---|---|
-| README.md | 开发方案 | wiki/开发方案/ |
-
-### 项目规范（1）
-
-| 文件名 | 主题 | 归属目录 |
-|---|---|---|
-| README.md | 项目规范 | wiki/项目规范/ |
-
-### 项目计划（1）
-
-| 文件名 | 主题 | 归属目录 |
-|---|---|---|
-| README.md | 项目计划 | wiki/项目计划/ |
-
-### 测试报告（1）
-
-| 文件名 | 主题 | 归属目录 |
-|---|---|---|
-| README.md | 测试报告 | wiki/测试报告/ |
-
-### 数据维护（1）
-
-| 文件名 | 主题 | 归属目录 |
-|---|---|---|
-| README.md | 数据维护 | wiki/数据维护/ |
-
----
-
-## 命名规则
-
-- 主题目录用中文名（如 `产品需求/`、`开发方案/`、`测试报告/`、`项目规范/`）；文件名不限中英文。
-- 成套产物（md+html 对）整目录计入索引与看板。
-- 原始/一次性文档归档 `drafts-archive/<日期-主题>/`，只读不增量。

package/templates/wiki/drafts-archive/README.md

@@ -1,3 +0,0 @@
-# drafts-archive — 原文档归档区
-
-按 `<日期-主题>/` 分目录存放整理前的原始文档快照，**只读不增量**：wiki 主题目录是活知识层，本区只留历史证据。归档文件不参与 INDEX 三方比对的文件级登记，仅计入归档总数（见 `../知识沉淀总览.html` 的 summary.archive）。

package/templates/wiki//344/272/247/345/223/201/351/234/200/346/261/202/README.md

@@ -1,3 +0,0 @@
-# 产品需求 — 需求文档与变更记录
-
-PRD、需求说明、评审结论归此；按 `<主题>-<日期>` 或成套子目录命名。原始聊天/草稿先归 `../drafts-archive/`，整理后入位。

package/templates/wiki//345/274/200/345/217/221/346/226/271/346/241/210/README.md

@@ -1,3 +0,0 @@
-# 开发方案 — 技术方案与设计文档
-
-架构设计、接口方案、关键取舍与评审记录归此。落码前的方案定稿入位，过程讨论归 `../drafts-archive/`。

package/templates/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md

@@ -1,3 +0,0 @@
-# 数据维护 — schema 变更与数据修复台账
-
-顶层放汇总文档；变更/修复按子目录 `<批次>/` 组织，批内 README.md 记账（引擎特例：本主题子目录不参与 INDEX 文件级登记，见 gen-wiki-board.mjs）。

package/templates/wiki//346/265/213/350/257/225/346/212/245/345/221/212/README.md

@@ -1,3 +0,0 @@
-# 测试报告 — 测试报告与验收记录
-
-按 `<日期>-<主题>` 命名（如 `2026-09-24-采购入库回归.md`）；关门单的验收证据链接 workflow/ 闭环文档，不重复粘贴。

package/templates/wiki//347/224/250/346/210/267/345/212/237/350/203/275/README.md

@@ -1,3 +0,0 @@
-# 用户功能 — 功能清单与操作说明
-
-按功能视角组织：功能清单、页面/角色操作说明、成套截图文档。与「产品需求」的分工：那里记"为什么做"，这里记"怎么用、有哪些"。

package/templates/wiki//347/237/245/350/257/206/346/262/211/346/267/200/346/200/273/350/247/210.html

@@ -1,77 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh">
-<head>
-<meta charset="utf-8">
-<title>知识沉淀总览</title>
-<style>
-  body{font-family:system-ui,'Segoe UI','Microsoft YaHei',sans-serif;max-width:1100px;margin:2rem auto;padding:0 1rem;color:#222}
-  h1{border-bottom:2px solid #ddd;padding-bottom:.4rem}
-  table{border-collapse:collapse;width:100%;margin:1rem 0}
-  td,th{border:1px solid #ddd;padding:.4rem .6rem;text-align:left;vertical-align:top}
-  th{background:#f6f6f6}
-  a{color:#0366d6;text-decoration:none}
-  a:hover{text-decoration:underline}
-  .muted{color:#888;font-size:.9em}
-</style>
-</head>
-<body>
-<h1>知识沉淀总览</h1>
-<p class="muted">生成物：<code>node .agents/scripts/gen-wiki-board.mjs</code> 重生成（人工只维护 wiki/INDEX.md 速览表「用途」列与磁盘文件本身）。</p>
-<div id="app"></div>
-<script>
-const DATA = {
-  "summary": { "total": 7, "topics": 7, "files": 7, "archive": 1 },
-  "topics": [
-    { "name": "产品需求", "files": [
-      { "file": "README.md", "topic": "产品需求", "dir": "./产品需求/" }
-    ]},
-    { "name": "用户功能", "files": [
-      { "file": "README.md", "topic": "用户功能", "dir": "./用户功能/" }
-    ]},
-    { "name": "开发方案", "files": [
-      { "file": "README.md", "topic": "开发方案", "dir": "./开发方案/" }
-    ]},
-    { "name": "项目规范", "files": [
-      { "file": "README.md", "topic": "项目规范", "dir": "./项目规范/" }
-    ]},
-    { "name": "项目计划", "files": [
-      { "file": "README.md", "topic": "项目计划", "dir": "./项目计划/" }
-    ]},
-    { "name": "测试报告", "files": [
-      { "file": "README.md", "topic": "测试报告", "dir": "./测试报告/" }
-    ]},
-    { "name": "数据维护", "files": [
-      { "file": "README.md", "topic": "数据维护", "dir": "./数据维护/" }
-    ]}
-  ]
-};
-(function () {
-  var el = document.getElementById('app');
-  var p = document.createElement('p');
-  p.textContent = '合计 ' + DATA.summary.files + ' 份知识文档 / ' + DATA.summary.topics + ' 个主题 / 归档 ' + DATA.summary.archive + ' 份';
-  el.appendChild(p);
-  var table = document.createElement('table');
-  var head = document.createElement('tr');
-  ['主题', '文件'].forEach(function (h) {
-    var th = document.createElement('th'); th.textContent = h; head.appendChild(th);
-  });
-  table.appendChild(head);
-  DATA.topics.forEach(function (t) {
-    var tr = document.createElement('tr');
-    var td1 = document.createElement('td'); td1.textContent = t.name; tr.appendChild(td1);
-    var td2 = document.createElement('td');
-    t.files.forEach(function (f, i) {
-      if (i) td2.appendChild(document.createElement('br'));
-      var a = document.createElement('a');
-      a.setAttribute('href', f.dir + f.file);
-      a.textContent = f.file;
-      td2.appendChild(a);
-    });
-    tr.appendChild(td2);
-    table.appendChild(tr);
-  });
-  el.appendChild(table);
-})();
-</script>
-</body>
-</html>

package/templates/wiki//351/241/271/347/233/256/350/247/204/350/214/203/README.md

@@ -1,3 +0,0 @@
-# 项目规范 — 编码 / 流程 / 协作规范
-
-编码规范、分支与提交约定、目录级 AGENTS 补充等团队契约归此；只放现行有效版本，历史版本走 `../drafts-archive/`。

package/templates/wiki//351/241/271/347/233/256/350/256/241/345/210/222/README.md

@@ -1,3 +0,0 @@
-# 项目计划 — 计划、里程碑与会议纪要
-
-排期计划、里程碑、复盘纪要归此；按日期命名（如 `2026-Q4-排期.md`）。

package/templates/workflow/README.md

@@ -1,90 +0,0 @@
-# workflow — AI 驱动闭环流程（唯一真相源）
-
-本目录是个人 AI 工作流引擎的唯一载体：**intents（为什么做）→ specs（怎么设计）→ plans（怎么做）→ incidents（学到了什么）**。单人 + AI 协作：唯一决策人与授权人是用户本人，多人评审暂缓，确认都在对话内一句话完成，追溯靠 git（commit + release tag）。
-
-> 闭环新增记录一律写在本目录。
-
-## 目录结构
-
-| 目录 | 放什么 | 命名 |
-|------|--------|------|
-| `intents/` | 意图文档：背景、目标/非目标、验收标准、级别、触达红线 | `YYYY-MM-DD-<主题>.md` |
-| `specs/` | 设计规格：功能行为、数据流、系统改动、约束遵守映射 | 与入口文档（intent / incident）同名 |
-| `plans/` | 计划文档：与入口文档同名配对，任务拆解 + 判据 + 风险 | 与入口文档（intent / incident）同名 |
-| `incidents/` | 事故复盘：时间线、根因、为什么没拦住、复盘三件套 | `YYYY-MM-DD-<主题>.md` |
-| `archive/` | 终态件归档（`<YYYY-MM>/<类型>/`）：同名家族滚动归档的落点，整族退出活跃面——INDEX、check-loop 配对门与 kb 活跃语料只扫四目录直下，台账行原路径未命中时 check-ledger-invariant 会探到此处 | `YYYY-MM/` |
-
-**命名一律英文 kebab-case**（如 `2026-09-07-<主题>.md`），**禁中文文件名**——check-loop 对非 ASCII 文件名给 warning。文档内容（标题/正文）不受此限。
-
-**文档协议（frontmatter 受限子集）**：四类文档头部一律为 YAML frontmatter（每行 `键: 值`，机器字段唯一来源）——`状态`（intent/spec/plan：draft/approved/done/superseded/cancelled；incident：open/fixed/closed，**严格枚举，单源 `.agents/workflow-enums.txt`**——check-loop / 看板 / 检索 / fill-* 一律读它，改枚举改那边；附注写 `备注:` 键）、`级别`（L1-L3，同单源；L0 已退役，存量件改 L1 或标 `流程: legacy`）、intent 的 `risk_level`（=级别，混合治理风险泳道选道字段，fill-intent 落）、`日期`/`发现`（YYYY-MM-DD）、`模块`（**新建文档必填**，取值见 `.agents/workflow-modules.txt` 词表，单值取主导模块；存量不回填，AI 触碰时顺手补）、L3 spec 的 `确认结果`/`确认时间`、回填件 `流程: legacy`。**`状态` 迁移须经 `approved`**（确认环节的机器可见态，`done` 只在关单出现）：新建的 spec/plan 若已 done 而 git 历史中从未出现行首 `状态: approved`，check-loop 报「确认态缺失」warning。check-loop 只扫 frontmatter 取机器字段（`fm_get` 字段断言），正文不再写「状态：/级别：」行；叙述性字段（独立复核/复盘三件套/验收勾验）仍留正文按节锚定。
-
-各子目录内 `_TEMPLATE.md` 为起步模板，复制后填写，不直接改动模板本身。
-
-根目录 `regression-checklist.md` 为**活文档回归清单**：deploy 回归必过条目与 incident 防复发验证的统一落点，随模块上线补充、随 incident 追加。
-
-**三份 append-only 台账已分片**（2026-10-13 ledger-shard-ledgers）：`regression-checklist` / `delegations` / `papercuts` 的数据行按月存 `workflow/<台账>.d/<YYYY-MM>.md`，主台账只留说明、表头与 GENERATED 区——消除「每次追加全量重写整文件」的体积与合并冲突面。读写单源 = `.agents/scripts/ledger-shards.mjs`（读侧自动合并主台账 ∪ 全部分片，既有消费者无需改动）；追加一行用 `node .agents/scripts/ledger-shards.mjs --append <台账> --row "<行>"`。
-
-## 使用方式
-
-- **发起新任务**：执行 `.agents/commands/new-task.md` 定义的流程（6 阶段总入口）
-- **看板（可选，默认不拉起）**：需要时手动跑 node .agents/scripts/ensure-board.mjs（跨平台单入口；幂等：探活 / 旧代码自动重启 / 全新启动弹浏览器），端口从基端口 {{BOARD_PORT}} 起自动上探首个可用，链接以脚本输出为准；**预警层，非门禁；告警口径对齐 check-loop 硬断档**。端口被占时探活 `/api/board` 并比对 `root`——本项目看板才复用 / 旧代码重启；他人进程（含其他项目看板）不动手不 kill，自动跳过试下一端口
-- **检索**：活跃流程读 `INDEX.md`（生成物，`node .agents/scripts/gen-workflow-index.mjs` 重生成、`--check` 校验漂移）；跨语料检索 `node .agents/scripts/kb-search.mjs "<词>"`（workflow 按节级定位 + wiki 全文，`--type/--module/--status/-n` 过滤；`--status all` 显式全量）
-- **验证**：`.agents/commands/test.md`（静态门 + 实测；项目自有验证脚本/门禁如有，见 `.agents/hooks/local-pre-commit` 与根 `AGENTS.md`「项目适配区」）
-- **评审**：`.agents/commands/review.md`（按 P0 / P1 / P2 分级：机器兜底 + AI 自查出清单，用户决策定性与合入）
-- **上线**：`.agents/commands/deploy.md`（上线前必跑清单）
-- **量化**：委派/自做结果记 `delegations.md`，聚合跑 `node .agents/scripts/agg-delegations.cjs`（**并发扩容门槛见该文件——数字达标前不扩并发**）；语料与常驻面体积的**月度快照**跑 `node .agents/scripts/gen-workflow-metrics.mjs`（每月一行落 `metrics.md`，同月重跑即更新；明细看 stdout）
-- **归档**：终态件滚动归档跑 `node .agents/scripts/archive-sweep.mjs`（缺省 dry-run 预览；`--window 21 --execute` 执行 git mv）——归档单位 = **同名家族**（intent/spec/plan/incident 同进同退：任一成员非终态 / 未满窗 / 被活跃引用 / 无日期，整族留守）；终态时间三级锚 = 确认台账终态行 ts → 内容 last-touch（frontmatter-only 提交不刷新）→ 文件名日期；落点 `workflow/archive/<家族最晚终态月>/<类型>/`
-- **papercut 回路（存量债清偿，手动触发）**：命令/技能卡壳记 `workflow/papercuts.md` 攒成的未升级条目 = 存量债；要清时跑 `node .agents/scripts/papercut-debt-sensor.mjs`（测 debt）→ `node .agents/scripts/papercut-debt-controller.mjs`（确定性选本轮唯一目标；源码/数据库面条目被 scope gate 拦下等授权）→ 按 `.agents/skills/papercut-fix/SKILL.md` 执行（改完 debt 应恰好 -1）。判定与排序口径单源 `.agents/loop/papercut-debt/DESIGN.md`，改口径先改设计文件
-- **追溯**：git 即审计——文档随代码同 commit、上线打 `release/<日期>` tag，`git log` 全链路可查；多人评审暂缓，git 历史即评审记录
-- **级别**：L1 实现级（未命中 L2/L3；新需求的入口是 plan）｜ L2 规则 / 契约（编码权威 / 共享契约 / 既有接口语义 / 全局横切口径，触达面闭集见 `.agents/commands/new-task.md` §级别判断）｜ L3 数据与运行时结构（schema / 迁移 SQL / DI 链 / 认证与中间件管线）；混合改动就高不就低
-- **风险泳道（混合治理）**：级别即风险级（L1 最低 → L3 最高），按级选道——**L1 协作道（敏捷优先）**：一份 plan 即入口，不另立 intent，独立复核不设同步前置，审计异步补（check-loop、事后 review 兜底）；**L2 / L3 防御道（严谨优先）**：同步确认门——spec 确认通过方可起草 plan、plan 确认后方可动手（闭环规则 1-2），L3 加新会话独立复核，未确认不放行。intent frontmatter 以 `risk_level`（=级别）落机器可读标记；批量代录与 AI 自治（confirm-doc `--batch` / `--auto`，trust-mode Standard｜Trusted）均限协作道 L1，协作道勾触达红线会被 check-loop 判「红线判低」hard 拦截
-- **探索泳道（experiment/ 前缀分支，Explore-to-Harden，2026-09-30 hybrid-governance-explore-hardening）**：experiment/ 前缀分支上的 PoC 任务在 intent frontmatter 加 `阶段: exploring` 标记——提交/推送门降级 advisory（pre-commit 闭环配对、pre-push 闭环扫描报告不阻断）；L1 的 draft intent 允许 spec/plan 起草与确认先于入口确认（stage-gates 起草门泳道豁免，「先起草后确认」）。**转正（合入 main）必须过加固门**：pre-push 对目标 refs/heads/main 以 `check-loop --hardening` 运行——exploring 任务的 intent 须为 approved/done、同名 plan 在场且收口（L2/L3 另须同名 spec），未收口 hard 阻断；探索作废走显式放弃态 superseded/cancelled（出列不加固）。诚实边界：分支名不进 commit——experiment/* 分支上暂存 intent 缺「阶段: exploring」由 pre-commit「泳道完整性」门禁拦截（2026-10-01 drift-hardening），残余暴露面仅剩绕过本地钩子的提交（`--no-verify` 禁令纪律覆盖）
-- **Trusted 自动泳道（2026-09-30 hybrid-governance-explore-hardening）**：trust-mode.json = Trusted（level 2）时，confirm-doc 的非 TTY 单份调用对 L1 文档**免旗标**（无需 `--delegated` 原话 / `--auto`）自动按 AI 自治放行（台账 source=ai-auto-trust-L2）；L2/L3 与 incidents 仍须人工，Standard / Strict 不隐式（fail-closed）
-
-## 执行模型
-
-- 默认宿主主智能体负责阶段路由、用户确认、关键判断和最终验收，不注册为额外角色。
-- 阶段命令仅在边界明确时委派 `.agents/roles/implementer.md`、`.agents/roles/independent-reviewer.md`、`.agents/roles/ui-verifier.md`。
-- 各 agent 宿主通过其适配目录下的薄 Adapter 注册角色（`.claude/`、`.cursor/`、`.codex/`、`.opencode/`、`.trae/`、`.zcode/`、`.omp/`）。角色行为只维护在 `.agents/roles/`。Codex 自动读取的是仓库根 `AGENTS.md` 与 `.codex/skills/`；`.codex/commands` 与 `.codex/agents` 是同形薄转发，供显式引用。Cursor 自动加载 `.cursor/commands/`。Claude Code 自动加载 `.claude/commands/` 与 `.claude/agents/`。
-- 宿主不支持子智能体时按命令 frontmatter 的 `fallback` 执行；L2 / L3 独立复核不得回退为原主智能体自查。
-- 子智能体不得跨越用户确认门，也不得自行提交、合入或上线；所有结果由主智能体复核后交用户决策。
-
-## 硬规则
-
-`kit.json` 的 `audit: false`（`init` 新装的默认值）时，check-loop 只阻断下面与文档闭环直接相关的项。`audit` 字段缺省时保持全量检查，已装仓库升级不会突然丢掉卫生警告。本字段设为 `true` 时卫生检查照常打印。豁免日期的唯一表是 `.agents/scripts/policy.mjs` 的 `policyVersion`（`kit.json` 同名字段；未知版本回退到 1）。
-
-1. **同名配对**：L1 有 plan；L2/L3 有 spec 与 plan。incident 的回路断档同样阻断。
-2. **验收勾验**：新建 intent 关到 done 时，验收标准未勾则阻断。
-3. **确认留痕**：approved / done / fixed / closed 须经 `confirm-doc.mjs`，指纹与台账一致。`--delegated` 原话仅限用户对话内明确确认的当次措辞——官方脚本/门禁不得自动代录或编造 quote（2026-10-01 v09-review-defects：solidify-task 曾自动伪造原话，已修复并纳入回归）。
-4. **敏感信息**：pre-commit 的 commit-check 扫描密钥。
-5. **双源与台账**：doctor 核对 managed / owned 的 sha；引擎改动改包源 `templates/` 再 `sync`。
-6. **台账不可变**（2026-10-02 ledger-ci-invariant）：`confirmations.jsonl` 历史行禁删改（append-only 前缀不变量，机器门 = CI 历史全扫 + pre-commit `--staged` 前置）；误写/修正只能**追加补偿行**，篡改历史属审计事件（`git revert` 整个提交后重新追加）。
-7. **台账并发三形态与修剪通道**（2026-10-12，台账是尾部追加形态，撞三种正常协作）：
-
-   | 形态 | 机制 | 用法 |
-   |---|---|---|
-   | 多人/多分支合并冲突 | `.gitattributes` 的 `.agents/*.jsonl merge=jsonl-union` → `git-merge-jsonl.mjs` 并集去重（两侧行全保留，无冲突可解） | 需目标仓 `.gitattributes` 有该行 + 本机 `git config merge.jsonl-union.driver "node .agents/scripts/git-merge-jsonl.mjs %O %A %B"`（`init` 自动配） |
-   | 单机多 worktree 并行 append | 确认行**默认**写分片 `.agents/confirmations.d/<doc>.jsonl`（2026-10-13 ledger-shard-default），各写各的互不覆盖；`--no-shard` / `CONFIRM_SHARDED=0` 回退主台账；里程碑可选跑 `compact-ledgers.mjs [--execute]` 并回主台账 | 分片默认**依赖 doc 链口径**（`kit.json` 须 `policyVersion: 8`+）：缺锚时自动回退主台账并出 ℹ️（存量装户行为零变化）；显式 `--shard` 缺锚仍参数期直接拒 |
-   | 所有者明令删某批文档 | **特许修剪**：同笔提交 `.agents/ledger-prune-manifest.json`（`{ts, authority, reason, removes:[被删行 sha256], docs:[家族名]}`），门禁逐行对账放行 | 无 manifest 的删/改/重排**仍全拦** |
-
-   哈希链的域是「同一 doc 的逻辑序」而非文件物理序——并发 append / 并集合并 / 分片归并都不会打断它；就地改行、删行、插行三类篡改照拦。诚实边界：manifest 是可写文件，**刻意伪造即可让任意删行合法化**（与「台账本地可写」同级），本通道只把「顺手手改」抬到「提交一份可被 git 历史对质的凭据」。
-
-   > **存量装户迁移动作**：`merge=jsonl-union` 属 `.gitattributes`，而该文件是**项目自持（owned）**、`sync` 永不覆盖——升级后**不会自动获得**，需手动在目标仓 `.gitattributes` 补两行：`.agents/*.jsonl merge=jsonl-union` 与 `.agents/confirmations.d/*.jsonl merge=jsonl-union`（2026-10-13 ledger-shard-default 起分片为默认写入口径，分片行漏配则并行分支合并分片仍走文本冲突）。driver 是本机态配置、不跨机共享（漏配退化为文本冲突，不静默丢数据但要人工解）。
-
-   > **冲突自愈兜底**：gitattributes 行或 driver 漏配退化为文本冲突时，跑 `node .agents/scripts/resolve-merge-conflicts.mjs` 一键消解派生面——`workflow/INDEX.md` 冲突取当前侧后全量重生成 + `git add`；`.agents/` 下 `*.jsonl`（主台账与 `confirmations.d/` 分片同判定面）UU/AA 双方并集去重 + `git add`；删除/改删型（DD/UD/AU/DU）不写入只提示人工裁决，业务代码冲突原样保留交人收尾。
-
-其余检查（占位符、引用、模块字段、常驻面预算、量化签名、阶段索引、适配器断线、引擎脚本测试覆盖（检查 20，包源环境——新增引擎脚本默认必须带 `.test.mjs`，库件/工具须登记 `.agents/scripts-test-exempt.txt`，2026-10-01 gate-script-test-coverage））只在 `audit` 不是 `false` 时出警告。
-
-**发版草稿**：最近一次改动 `package.json` 的 `version` 的那次提交里，当时已经是 draft 或 approved 的 intent、spec、plan，若被扫描的树上仍是 draft 或 approved，则阻断。当时已是 draft 的不看版本锚。当时已是 approved 的，只在发版版本大于 `policy.mjs` 的 `check17UnclosedAfter` 时阻断；版本 1 没有该键。不带 `--rev` 时现在的状态读工作区，带 `--rev` 时读被推送的那棵树。那次提交之后新建的文件不在范围内。状态为 open 的 incident 不在此列。
-
-**委派台账**：L2 或 L3 的 intent、spec、plan 状态为 done，或同级别 incident 状态为 fixed 或 closed 时，若 `workflow/delegations.md` 的「委派结果」表与「自做任务结果」表中均没有日期不早于该文档日期、且含该文件名（带 / 不带 `.md` 均匹配）的一行，check-loop 打出警告。incident 的日期取 frontmatter「发现」。`audit: false` 时这条警告与其他卫生警告一起被吞掉。退出码仍由阻断项决定。
-
-## 闭环规则
-
-1. L1 以上新需求始于已确认的 intent；L1 以上修复始于已确认的 incident 草稿（作为 intent 等价入口）
-2. L2 / L3 变更必须先有与入口文档同名的 spec 确认通过（L3 加新会话独立复核），方可起草 plan；L1 用 Quick-Plan 极简三节——改动方案 / 约束与风险 / 验证计划起步（fill-plan.mjs 单源），多文件多步骤再加任务拆解/执行顺序。**逐阶段前置已机器强制**（2026-09-30 stage-gate-machine）：fill-spec / fill-plan / confirm-doc 校验入口与 spec 前置未过即拒；顺序审计 = check-loop 检查 19
-3. 实现产物必须通过静态门（构建 + 测试 + 项目门禁）
-4. 线上 / 实测缺陷回落到 `incidents/`，复盘三件套（新 intent、防复发验证、规范条目）缺一不可；**根因属「门禁缺位 / 规范未落地 / 系统性问题」时，即使结构性修复已完成也必须立新 intent** 追踪系统性改进，禁止以「修复已完成」为由绕过 intent 回路
-5. 关单在 test：逐条勾验入口文档「验收标准」并补证据后 intent → done（不依赖是否上 prod）。done 仍有未勾项会被 check-loop 拦（新建 intent hard-block）。上 prod 另走 deploy（tag / 回滚 / 观察）
-6. 放弃留档：方案曾确认后不做 → `superseded`；未完成即取消 → `cancelled`。二者均为已确认终态，check-loop 不按「状态未确认」拦截；L3 放弃件豁免「确认结果必须为 approved」
-7. 后续回归清单与周检清单也归档本目录

package/templates/workflow/delegations.md

@@ -1,29 +0,0 @@
-# 量化证据台账（委派 + 自做任务）
-
-> 目的：把「一次完成率 / 平均返工次数 / 主兜底占比 / 月度故障数」从感觉变成数字——**数字达标之前不扩并发**（门槛见 §并发扩容门槛）。
-> 记法（主智能体顺手写一行，不增加用户负担）：
-> - **委派结果表**：每次向子智能体/执行模型委派后追加一行。
-> - **自做任务结果表**：主智能体自己完成的 **L1+ 新需求任务**，闭环时（intent→done）追加一行；**修复类不重复记**——incident 本身即故障信号，聚合脚本按月扫 `workflow/incidents/` 计数。
-> - 结果列取值：`一次通过`（静态门首跑全过且复核无 P0/P1 返工）/ `返工×N`（回炉 N 次）/ `主兜底`（executor 失败、主智能体接手——委派口径专用，计返工信号）/ `返工待修`（未闭环，不计入率，单列提示）。
-> - **合入结论列**（末列，2026-10-12 merge-accept-rate）：`合入` / `返工后合入` / `未合入` / 留空。为什么单列而不并进结果列：结果列度量**执行过程质量**（跑了几遍），合入结论度量**产出被不被人接受**——METR 2026-03 实测落差（agent 生成的 SWE-bench 通过 PR，维护者合并判定比自动评分低约 24 个百分点、约一半不会被合入）说明「自动门全绿」与「人愿意合」是两个维度，混在一列必然被前者盖过后者。记法：关单时顺手一写；留空 = 未记录（**不计入接受率分母**，存量行零回填）。边界：结论由人工/独立复核写入，机器无法判真伪（同 `--delegated` 信任边界）；它是**观测项不是门槛项**——不进 §并发扩容门槛（样本 <5 不出率）。对标：<https://metr.org/notes/2026-03-10-many-swe-bench-passing-prs-would-not-be-merged-into-main/>
-> 聚合：`node .agents/scripts/agg-delegations.cjs` → 输出各月指标 + 扩容门判定 + 可粘贴快照行，粘贴进 §月度聚合快照（每月一行）。聚合时顺路按「三类清理清单」巡检 AGENTS.md：代码/配置已可推导的删；只针对一次需求的细节移 wiki 或删；已被脚本/hook/测试自动保证的只留入口。
-> 口径说明：合并冲突率不适用（单人串行 + 每阶段确认）；人工复核负担以「复核类委派的返工行」近似（见结果列 + 备注）。
-> 调整某角色的模型指派前，先从 `workflow/incidents/` 取 3 个已定性 bug 丢给候选模型做回归对比，再拍板。
-
-## 委派结果
-
-| 日期 | 被委派方(模型) | 任务一句话 | 结果 | 备注 | 合入结论 |
-|------|----------------|------------|------|------|----------|
-
-## 自做任务结果
-
-| 日期 | 任务一句话 | 结果 | 备注 | 合入结论 |
-|------|------------|------|------|----------|
-
-## 月度聚合快照
-
-（`node .agents/scripts/agg-delegations.cjs` 输出的可粘贴快照行落这里，每月一行）
-
-## 并发扩容门槛
-
-连续两个月一次完成率 ≥ 90%、月度返工次数为 0 且无主兜底信号，才考虑扩大并发委派；任一不达标维持单并发。门槛判定由聚合脚本输出，两处同步修改。

package/templates/workflow/incidents/_TEMPLATE.md

@@ -1,51 +0,0 @@
----
-状态: open
-级别: L1
-发现: YYYY-MM-DD
-来源: <self | user | test | monitor——谁发现，见 .agents/workflow-enums.txt incident.source.all>
-影响环境: <dev | staging | prod | none——缺陷触达的环境，none=未触达运行环境>
-模块: <词表之一，见 .agents/workflow-modules.txt>
-沉淀: <可选：复盘沉淀到 wiki 的相对仓根路径，如 wiki/项目规范/权限收敛方案.md；不沉淀写「无」，留空待 check-loop 提醒；关单时可跑 node .agents/scripts/draft-sediment.mjs 自动抽草稿并回写本字段>
----
-# INCIDENT — <日期 主题>
-<!-- 复制为 YYYY-MM-DD-<主题>.md；线上或实测发现的功能缺陷都记录，历史 BUG 可回填 -->
-<!-- frontmatter 受限子集（2026-09-13）：状态∈open/fixed/closed（严格枚举，附注写备注键）；级别∈L1/L2/L3；闭环引擎启用前的回填件加一行 `流程: legacy`（豁免级别/配对检查；存量 L0 件同样改 L1 或标 `流程: legacy`）；正文不再写状态/级别/发现行 -->
-<!-- 归因两键（2026-10-13 自 Shipyard 回灌 incident-attribution；归因检查 B6b 落地后编号以 check-loop.mjs 头部清单为准）：新建件必填、锚前存量不回填；「来源」是缺陷发现方（供来源×环境交叉表机器复算，替代逐件人工判读），「影响环境」写实际触达环境（未触达写 none） -->
-
-## 时间线
-- <发现 → 定位 → 止血 → 恢复，带时刻>
-- 用户确认：草稿过目通过（<日期>）
-<!-- 上行是**L2/L3 起草 spec 的机器前置**（fill-spec / confirm-doc 校验）：须为「时间线」小节内的行首条目；
-     接受形态 `- 用户确认：…` / `- **用户确认**：…` / `- <日期> 用户确认：…`（词前词后加粗、日期前缀均可）；
-     正文叙述句（如「用户确认了方案」）不算留痕。形态清单写在本注释内，避免样例行自含描述文字 -->
-
-## 影响面
-- <页面 / 接口 / 数据范围>
-
-## 根因
-<一句话；深层原因另起一行>
-<!-- 复杂度收敛证据收集（P4 判据触发器，2026-10-11）：根因若与重复/未收拢代码有关（改 A 处漏了同源 B 处、克隆分叉），在此写明涉及的两处位置——这是「收敛须有消费方与事故证据才启动」判据的直接采集点（证据出现再立项收拢，基线对照 scripts/jscpd-baseline.json；无关联则无视本行） -->
-
-## 为什么之前没拦住
-<门禁 / 测试 / 规范各查一遍：哪一层本可以拦住>
-
-## 复盘三件套（缺一不可）
-
-> 目的：让事故真正回到 Plan，不让「防复发」承诺停留在文档里。模块已逐步上线，事故可能来自 dev / staging / prod 任一环境。
-
-1. 结构性修复
-   - 修复 commit：<SHA + 改动文件清单>
-   - 影响环境：dev / staging / prod（已上线模块若波及 prod，需附影响用户数 / 持续时长 / 是否回滚）
-   - 是否需要新 intent：
-     - 是 → ../intents/YYYY-MM-DD-<主题>.md（根因属「门禁缺位 / 规范未落地 / 系统性问题」时强制立，即使结构性修复已完成）
-     - 否 → 理由：<根因属实现 bug、单点修复已完成，且已有规范条目覆盖>
-
-2. 防复发验证（必须落到自动化用例或回归清单条目，禁止只写「已人工验证」）
-   - 自动化用例：项目测试套件 <文件>（<用例名 / 数量>）
-   - 或 test 步骤：.agents/commands/test.md + <具体操作>
-   - 或回归清单条目：workflow/regression-checklist.md（防复发验证节追加一行）
-
-3. 规范条目（必须有可追溯的落点）
-   - 落点（多选）：AGENTS.md <章节> / .agents/hooks/<脚本> / .agents/skills/<skill> / .agents/commands/<cmd> / 回归清单 §<章节>
-   - 引用：commit <SHA> / 文件:<路径>#L<行>
-   - 若无新增条目，理由：<已有条目覆盖，说明条目位置>

package/templates/workflow/intents/_TEMPLATE.md

@@ -1,46 +0,0 @@
----
-状态: draft
-级别: L1
-预判: <可选：kind=<require|fix|verify|review|deploy> level=<L1|L2|L3>>
-日期: YYYY-MM-DD
-模块: <词表之一，见 .agents/workflow-modules.txt>
-沉淀: <可选：沉淀到 wiki 的相对仓根路径，如 wiki/项目规范/权限收敛方案.md；不沉淀写「无」，留空待 check-loop 提醒；关单时可跑 node .agents/scripts/draft-sediment.mjs 自动抽草稿并回写本字段>
-备注: <可选：附注自由文本，check-loop 不解析>
----
-# INTENT — <主题>
-<!-- 复制本模板为 YYYY-MM-DD-<主题>.md 后填写；plans/ 下同名文件与本文件配对 -->
-<!-- frontmatter 受限子集（2026-09-13）：每行 `键: 值`；状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L1/L2/L3；check-loop 只扫 frontmatter 取机器字段，正文不再写状态/级别行 -->
-<!-- 探索泳道（可选，2026-09-30 hybrid-governance-explore-hardening）：experiment/ 前缀分支上的 PoC 任务在 frontmatter 加「阶段: exploring」——提交/推送门降级 advisory，spec/plan 可先于本入口确认起草（限 L1）；转正合入 main 前须收口（本档 approved/done + 同名 plan/spec 在场，check-loop --hardening 加固门），或显式放弃（superseded/cancelled） -->
-<!-- 预判（可选，2026-10-13 自 Shipyard 回灌 prejudgment-ledger）：定级时先做结构化预判，结果如实写「预判: kind=<require|fix|verify|review|deploy> level=<L1|L2|L3>」——intents≡require、incidents≡fix；与实际落位不符时 check-loop 路由预判一致性检查（B6b 落地后编号以 check-loop.mjs 头部清单为准）出 WARN 留账。缺字段零告警（存量宽容不回填，不做强制前置）——advisory 灰度口径 -->
-
-## 背景与问题
-<为什么做；写明需求来源（工单 / 沟通记录 / 待办事项）>
-
-## 目标
-- <可验证的目标>
-
-## 非目标（L1 微改动无实质内容可删本节，不硬填）
-- <明确不做的，防止范围蔓延>
-
-## 约束（L1 微改动无实质内容可删本节，不硬填）
-- <复用什么、不许动什么>
-
-## 影响面
-- 模块：<词表之一，见 .agents/workflow-modules.txt>
-- 数据库：无 / <表名>（涉及 schema 变更 → L3；无 schema 的运行时 / 管线结构面亦为 L3，判据见 `.agents/commands/new-task.md` §级别判断）
-- 前端页面：<路由或组件，无则删本行>
-
-## 触达红线（对照 AGENTS.md，勾选仅标记触及范围；具体如何满足在同名 spec 中说明）
-- [ ] <按本项目 AGENTS.md 红线逐行补；无则删本行>
-- [ ] 规则 / 契约变更（编码权威 / 共享契约 / 接口签名 / 既有参数语义 / 全局口径）→ 级别至少 L2
-- [ ] schema / 迁移 SQL / DI 链 / 认证与中间件管线 → 级别 L3
-
-> 触及任一红线即为 L2 / L3，必须立 ../specs/YYYY-MM-DD-<主题>.md 写明如何满足，方可起草 plan。
-
-## 验收标准（可测试）
-- [ ] <逐条可测试；写不出可测试判据 = 还没想清楚>
-
-> **闭环对账**：关单在 test 阶段（不依赖 deploy）。intent 置 done 前逐条勾验，每条勾选项后补证据——`- [x] <判据>（证据：<commit SHA / 测试用例名 / 冒烟脚本输出>）`。
-> done 状态仍有未勾项会被 check-loop 拦截（2026-09-12 起新建 intent 为 hard-block，存量 intent 仅 warning 提示）；勾选但缺「证据：」为 warning。
-> **场景覆盖**（2026-10-10 scenario-coverage 灰度）：同名 spec 写了「验收场景」节时，本节须**逐场景 ID 引用**——
-> `- [x] 场景：S1 <判据>（证据：…）`。缺引用只出 warning（灰度第一档，不阻断）；spec 无该节则本条不适用。

package/templates/workflow/papercuts.md

@@ -1,9 +0,0 @@
-# 命令/技能 Papercut 留痕
-
-> `.agents/commands/`、`.agents/roles/` 或已装技能在真实任务中卡住、误导、缺步骤时记一行，**不当场顺手改**。
-> 同一文件命中第 2 次或用户点名时，升级为 docs 修复 commit。
-> **分片（2026-10-13 ledger-shard-ledgers）**：数据行按月存 `workflow/papercuts.d/<YYYY-MM>.md`（本文件只留说明与表头）。追加一行用 `node .agents/scripts/ledger-shards.mjs --append papercuts --row "<行>"`（缺省按行内日期定月，`--month` 可覆盖）；读侧（`papercut-debt-sensor.mjs` 等）自动合并主台账 ∪ 全部分片，无需改动。手工编辑分片亦可，但须自带表头。
-> **存量债回路**：未升级条目累积 = 存量债，清理跑 papercut 回路（传感器测 debt → 控制器选目标 → `papercut-fix` 技能执行），口径单源 `.agents/loop/papercut-debt/DESIGN.md`。
-
-| 日期 | 位置 | 症状 | 拟修 |
-|------|------|------|------|

package/templates/workflow/plans/_TEMPLATE.md

@@ -1,47 +0,0 @@
----
-状态: draft
-级别: L1
-模块: <词表之一，见 .agents/workflow-modules.txt>
----
-# PLAN — <与入口文档同名主题>
-<!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2/L3 必须先有 ../specs/ 同名 spec 确认通过；AI 起草、用户对话内确认后开工 -->
-<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L1/L2/L3；正文不再写状态/级别行 -->
-<!-- L1 极简形态（Quick-Plan，与 fill-plan.mjs 单源一致）：单/少文件微改动只填「改动方案」+「约束与风险」+「验证计划」三节（L1 主节标题模板正文用「改动面」，fill-plan 生成「改动方案」——check-loop 证据校验对 改动面/任务拆解/改动方案 三种节名均识别为声明文件来源）——改动方案逐条列改哪个文件做什么（判据细节直接写进条目），验证计划一行静态门 + 按需 UI 实测；任务拆解/执行顺序仅 L1 多文件多步骤时保留 -->
-<!-- L1 直达（2026-10-13 自 Shipyard 回灌）：新单用 fill-plan.mjs --level L1，本文件即入口，不另立 intent（无同名 intent/incident 时起草门放行；文件已在则级别以文件为准，禁用 --level L1 放行存量 L2 plan）。修复类另保留 ../incidents/ 同名件 -->
-<!-- 待澄清标记（2026-10-12 needs-clarification）：判据不明 / 依赖不确定 / 用户没说的细节，照实写一行
-     `- 待澄清：<你卡在哪>`，不要猜（语义说明同 specs 模板：占位符=忘了填，本标记=我不知道）。
-     起草不拦，draft→approved 确认时仍挂着会被 confirm-doc 拒绝；解决后改行首为 `- 已澄清：` 或删行。 -->
-
-对应入口：L1 = 本 plan。修复类另保留 ../incidents/YYYY-MM-DD-<主题>.md。L2/L3 = ../intents/YYYY-MM-DD-<主题>.md
-对应 spec：../specs/YYYY-MM-DD-<主题>.md（仅 L2/L3）
-
-## 改动面（L1 极简形态主节；L2/L3 可作任务拆解的汇总或删本节）
-- <文件/组件>：<做什么；判据细节直接写进条目，如「L771 message.success 改『更新成功』」>
-<!-- build.md 确认的改动清单确认后回填本节落盘（对话留痕仅供当次）——改动面 + 任务勾选态 + git status = 会话重入三锚（2026-10-11 session-context，自 Shipyard 回灌） -->
-
-## 任务拆解（L2/L3 必填；L1 仅多文件多步骤时用，单任务微改动删本节）
-<!-- 任务即勾选态（2026-10-11 session-context，自 Shipyard 回灌）：完成一项立刻勾选并回填留痕；压缩 / 新会话续作先读本表勾选态 + git status 重建进度，禁凭记忆补勾 -->
-- [ ] 1. <任务>
-   - 判据：<怎样算完成；尽量对应一个测试或可复现操作>
-   - 风险：低 / 中 / 高（<原因>）
-   - 留痕：（勾选时回填 commit SHA / 测试名 / 实测输出）
-- [ ] 2. <任务>
-   - 判据：…
-   - 风险：…
-   - 留痕：…
-
-## 执行顺序（L2/L3 必填；L1 单文件微改动删本节）
-<1 → 2 → 3；标注依赖关系>
-
-## 验证方式
-- 验证层标注:每条验收标准标注验证层(单元 / 集成 / E2E / 人工实测)——关单证据按层对质,「已人工验证」不替代可自动化层
-- 静态门：`项目构建命令`（+ `项目测试命令`，测试项目就绪后）
-- 前端：cd frontend && npm run build（vue-tsc）
-- UI：.agents/commands/test.md（涉及页面改动必走，headless Chrome 实测）
-- L2 追加：<契约 / 规则面比对：编码结果抽样 / 接口契约断言 / 口径对账>
-- L3 追加：<含 schema 变更：备份 + 回滚 SQL 就绪后执行；仅运行时 / 管线：回退上一 release tag + 配置开关预案>
-
-## 确认与复核
-> 确认 = 用户在对话内一句话通过；确认后本 plan 状态 `draft → approved` 并回填本节（确认环节的机器可见态），`done` 只在关单出现——禁从 `draft` 直跳 `done`（2026-09-22 papercut）。
-- 确认结果：approved（YYYY-MM-DD 用户对话内确认）；done（YYYY-MM-DD 关单，随入口文档置终态）
-- 确认门记录：plan 草稿全文过目 + 改动清单确认（`build.md` 两道门，逐次，不合并）

package/templates/workflow/regression-checklist.md

@@ -1,23 +0,0 @@
-# 回归清单（活文档）
-
-> 用途：deploy 清单「回归必过」与 incidents 复盘「防复发验证」的统一落点。
-> 本清单是**活文档**：随模块上线补充、随 incident 追加、随功能演进修订；代码演进后以本清单与实际行为为准。
-
-## 维护规则
-
-1. **deploy 前**：过本清单中「涉及模块」的全部条目 + 跑自动化测试（项目防复发用例）
-2. **incident 后**：防复发条目追加到「防复发验证」节，不留在 incident 文档里；能自动化的落测试用例
-3. **模块上线/走查后**：为该模块补关键路径条目
-4. 条目过时（功能下线/行为变更）时删除或改写，不保留失效条目
-5. **新增防复发条目落点优先级**：自动化用例 > 脚本化断言 > 人工步骤（仅剩视觉/交互断言无法脚本化时）
-6. **分片（2026-10-13 ledger-shard-ledgers）**：「防复发验证」节的数据行按月存 `workflow/regression-checklist.d/<YYYY-MM>.md`（该节是唯一 append-only 追加区；上方模块节为稳定参考内容，留守本文件）。追加一行用 `node .agents/scripts/ledger-shards.mjs --append regression-checklist --row "<行>"`；读侧自动合并主台账 ∪ 全部分片。
-
-## 回归必过
-
-| 模块 | 条目 | 依据 |
-|------|------|------|
-
-## 防复发验证
-
-| incident | 条目 | 落点 |
-|----------|------|------|