agentic-flow-kit 1.7.16 → 1.8.1

package/templates/workflow/README.md

@@ -12,15 +12,18 @@
 | `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-* 一律读它，改枚举改那边；附注写 `备注:` 键）、`级别`（L0-L3，同单源）、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` 字段断言），正文不再写「状态：/级别：」行；叙述性字段（独立复核/复盘三件套/验收勾验）仍留正文按节锚定。
+**文档协议（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 阶段总入口）
@@ -30,11 +33,13 @@
 - **评审**：`.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 历史即评审记录
-- **级别**：L0 例行 ｜ L1 实现级（页面 / 交互 / 样式等，未命中 L2/L3）｜ L2 规则 / 契约（编码权威 / 共享契约 / 既有接口语义 / 全局横切口径，触达面闭集见 `.agents/commands/new-task.md` §级别判断）｜ L3 数据与运行时结构（schema / 迁移 SQL / DI 链 / 认证与中间件管线）；混合改动就高不就低
-- **风险泳道（混合治理）**：级别即风险级（L0 最低 → L3 最高），按级选道——**L0 / L1 协作道（敏捷优先）**：L0 豁免 intent 直接 commit；L1 已确认 intent + 极简 plan 即动工，独立复核不设同步前置，审计异步补（check-loop、事后 review 兜底）；**L2 / L3 防御道（严谨优先）**：同步确认门——spec 确认通过方可起草 plan、plan 确认后方可动手（闭环规则 1-2），L3 加新会话独立复核，未确认不放行。intent frontmatter 以 `risk_level`（=级别）落机器可读标记；批量代录与 AI 自治（confirm-doc `--batch` / `--auto`，trust-mode Standard｜Trusted）均限协作道 L0/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 闭环扫描报告不阻断）；L0/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 单份调用对 L0/L1 文档**免旗标**（无需 `--delegated` 原话 / `--auto`）自动按 AI 自治放行（台账 source=ai-auto-trust-L2）；L2/L3 与 incidents 仍须人工，Standard / Strict 不隐式（fail-closed）
+- **级别**：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）
 
 ## 执行模型
 
@@ -59,12 +64,14 @@
    | 形态 | 机制 | 用法 |
    |---|---|---|
    | 多人/多分支合并冲突 | `.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 | `confirm-doc --shard` 写 `.agents/confirmations.d/<doc>.jsonl`，各写各的互不覆盖；里程碑跑 `compact-ledgers.mjs [--execute]` 并回主台账 | `--shard` **依赖 doc 链口径**（`kit.json` 须 `policyVersion: 8`+），缺锚时参数期直接拒 |
+   | 单机多 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`。driver 是本机态配置、不跨机共享（漏配退化为文本冲突，不静默丢数据但要人工解）。
+   > **存量装户迁移动作**：`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/templates/workflow/incidents/_TEMPLATE.md

@@ -2,12 +2,15 @@
 状态: 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（严格枚举，附注写备注键）；级别∈L0/L1/L2/L3；闭环引擎启用前的回填件加一行 `流程: legacy`（豁免级别/配对检查）；正文不再写状态/级别/发现行 -->
+<!-- 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） -->
 
 ## 时间线
 - <发现 → 定位 → 止血 → 恢复，带时刻>

package/templates/workflow/intents/_TEMPLATE.md

@@ -1,6 +1,7 @@
 ---
 状态: 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 自动抽草稿并回写本字段>
@@ -8,8 +9,9 @@
 ---
 # INTENT — <主题>
 <!-- 复制本模板为 YYYY-MM-DD-<主题>.md 后填写；plans/ 下同名文件与本文件配对 -->
-<!-- frontmatter 受限子集（2026-09-13）：每行 `键: 值`；状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L0/L1/L2/L3；check-loop 只扫 frontmatter 取机器字段，正文不再写状态/级别行 -->
-<!-- 探索泳道（可选，2026-09-30 hybrid-governance-explore-hardening）：experiment/ 前缀分支上的 PoC 任务在 frontmatter 加「阶段: exploring」——提交/推送门降级 advisory，spec/plan 可先于本入口确认起草（限 L0/L1）；转正合入 main 前须收口（本档 approved/done + 同名 plan/spec 在场，check-loop --hardening 加固门），或显式放弃（superseded/cancelled） -->
+<!-- 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 灰度口径 -->
 
 ## 背景与问题
 <为什么做；写明需求来源（工单 / 沟通记录 / 待办事项）>

package/templates/workflow/papercuts.md

@@ -2,6 +2,8 @@
 
 > `.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

@@ -5,25 +5,30 @@
 ---
 # PLAN — <与入口文档同名主题>
 <!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2/L3 必须先有 ../specs/ 同名 spec 确认通过；AI 起草、用户对话内确认后开工 -->
-<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L0/L1/L2/L3；正文不再写状态/级别行 -->
+<!-- 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 拒绝；解决后改行首为 `- 已澄清：` 或删行。 -->
 
-对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）
-对应 spec：../specs/YYYY-MM-DD-<主题>.md（L1 可省略）
+对应入口：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 仅多文件多步骤时用，单任务微改动删本节）
-1. <任务>
+<!-- 任务即勾选态（2026-10-11 session-context，自 Shipyard 回灌）：完成一项立刻勾选并回填留痕；压缩 / 新会话续作先读本表勾选态 + git status 重建进度，禁凭记忆补勾 -->
+- [ ] 1. <任务>
    - 判据：<怎样算完成；尽量对应一个测试或可复现操作>
    - 风险：低 / 中 / 高（<原因>）
-2. <任务>
+   - 留痕：（勾选时回填 commit SHA / 测试名 / 实测输出）
+- [ ] 2. <任务>
    - 判据：…
    - 风险：…
+   - 留痕：…
 
 ## 执行顺序（L2/L3 必填；L1 单文件微改动删本节）
 <1 → 2 → 3；标注依赖关系>

package/templates/workflow/regression-checklist.md

@@ -10,6 +10,7 @@
 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 "<行>"`；读侧自动合并主台账 ∪ 全部分片。
 
 ## 回归必过
 

package/templates/workflow/specs/_TEMPLATE.md

@@ -50,6 +50,22 @@ THEN 行是机器对账断言：声明了场景却缺「- THEN <可观测结果>
 | <示例：schema / 迁移路径约束> | <涉及路径与处理方式> |
 | <示例：前端或客户端约定（如有）> | <本 spec 涉及哪些约定> |
 
+## 验收判据
+<!-- 判据级收敛对账的机器输入（check-loop 验收判据对账段，2026-10-13 自 Shipyard 回灌；B6b 落地后编号以 check-loop.mjs 头部清单为准）：
+     每行一条判据，「证据」须机器可解析。路径：文件必须存在。机器不读正文，不判断它和判据是否相关（那一步留给新会话复核）。
+     命令：只认全量门跑过的 `npm test` / `node .agents/scripts/verify.mjs`（kit 全量门 = verify.mjs 七门编排；
+     装户项目测试命令各异，verify.mjs `--test-cmd` 注入的算 npm test 面）。
+     还须 workflow/verify-evidence.md 有一行时间不早于本 spec「日期」的全绿凭证；没有这行 = 未覆盖。
+     日期口径：frontmatter「日期」与全绿行时间同为 UTC（fill-spec 默认即此）；手写勿用本地时区日期——
+     UTC+8 凌晨 0–8 点落的全绿行日期为前一日，会对不上（硬拦，08:00 后重跑门即解）。
+     不在全量门里的检查（UI 实测 / 回归冒烟等）改记证据文件路径。
+     「状态」写「覆盖」而证据无效仍判未覆盖。人工走查状态写「人工」，证据列留空（仅「人工+空证据」豁免机器对账；
+     截图等图片不在路径白名单，需留痕改存 .md 报告后引路径）。
+     无本节或表为空 → WARN；证据无效的 WARN / HARD-BLOCK 分档与生效锚随 B6b 对账段落地。 -->
+| 判据（可观察行为） | 证据（测试文件 / 命令 / 证据文件） | 状态 |
+|---|---|---|
+| <行为 1> | <路径或命令> | <覆盖 / 未覆盖 / 人工> |
+
 ## 风险评估
 - <风险点 1> ｜ 应对：<测试 / hook / 评审>
 - <风险点 2> ｜ 应对：…
@@ -58,7 +74,7 @@ THEN 行是机器对账断言：声明了场景却缺「- THEN <可观测结果>
 > 个人工作流：确认 = 用户在对话内一句话通过；无第二审批人，追溯靠 git（commit 记录确认时点）。
 > 确认结果 / 确认时间写在文件头 frontmatter（L3 由 check-loop 强制校验）；本节只留叙述性复核记录。
 
-- 独立复核：<L3 强制：另开新会话由 AI 复核本 spec，记录复核会话与结论；L1 / L2 无则删除本行>
+- 独立复核：<L3 强制：另开新会话由 AI 复核本 spec，记录复核会话与结论；L1 / L2 无则删除本行。复核行须落「复核上下文：<会话/子代理 id>」——隔离前提的机器事实，advisory>
 - 复核结论：<无则删除本行>
 - 返修意见：<无则删除本行>
 - 确认通过后，方可起草 ../plans/YYYY-MM-DD-<主题>.md

package/templates/_agents/hooks/check-pairing-incremental.sh

@@ -1,43 +0,0 @@
-#!/bin/sh
-# 闭环配对（增量版）：本次暂存的 intents/ incidents/ 入口文档必须已有同名 plan（L2/L3 另须同名 spec）
-# 目的：把 check-loop.sh「配对断裂」hard-block 的发现时机从 pre-push 提前到 commit
-# （papercut 2026-09-15：maintain.md 只写「incident≡intent 免另立 intent」，未把配 plan 写成显式步骤，
-#  按文档字面执行三次 commit 全绿、push 才爆红，只能后补；
-#  2026-09-27 audit-gate-hardening 补齐 spec 档——此前只查 plan，L2/L3 缺 spec 仍要拖到 push 才爆红）
-# 口径与 check-loop.sh 对齐：入口文档（intents/ incidents/ 直下 .md）↔ workflow/plans/ 同名，
-# L2/L3 级别另须 workflow/specs/ 同名（check-loop 检查 1 同款分档）；
-# 同 commit 携带 plan/spec 合法（检查的是工作区文件存在，staged 新建同样命中）。
-# 已知边界：legacy 豁免与级别读取均基于工作区文件而非暂存 blob——add 后又改工作区时可能误豁免/误拦（逐文件取 blob 的 fork 成本大于收益，接受）。
-
-cd "$(git rev-parse --show-toplevel)" || exit 1
-
-fail=0
-# -c core.quotepath=off：quotepath 默认 true 时非 ASCII 路径被引号转义（"workflow/\346..."），
-# ^workflow/ 前缀匹配失配 → 门禁静默跳过——教训与修法同 check-wiki-ledger.sh（2026-09-27 gate-coverage）
-for f in $(git -c core.quotepath=off diff --cached --name-only --diff-filter=ACMR | grep -E '^workflow/(intents|incidents)/[^/]+\.md$' | grep -v '_TEMPLATE\.md$'); do
-  # 闭环引擎启用前的回填件带「流程: legacy」豁免配对检查（与 check-loop 同口径）
-  if grep -q '^流程: legacy' "$f"; then
-    continue
-  fi
-  base=$(basename "$f" .md)
-  if [ ! -f "workflow/plans/$base.md" ]; then
-    echo "闭环配对（增量）— BLOCK:"
-    echo "  入口缺同名 plan: $f（应在 workflow/plans/$base.md）"
-    echo "  L1 极简 plan 只需「改动面 + 验证方式」两节（复制 workflow/plans/_TEMPLATE.md）"
-    fail=1
-  fi
-  lvl=$(sed -n 's/^级别:[[:space:]]*//p' "$f" | head -1)
-  if [ "$lvl" = "L2" ] || [ "$lvl" = "L3" ]; then
-    if [ ! -f "workflow/specs/$base.md" ]; then
-      echo "闭环配对（增量）— BLOCK:"
-      echo "  入口缺同名 spec: $f（级别 $lvl 须三件套，应在 workflow/specs/$base.md）"
-      echo "  与 pre-push check-loop 检查 1 同口径——先起草 spec 走 design.md，再提交"
-      fail=1
-    fi
-  fi
-done
-
-if [ $fail -ne 0 ]; then
-  echo "pre-commit: 入口文档配对不全（plan / L2-L3 spec），提交已阻止（与 pre-push check-loop 同口径，发现时机提前到 commit）" >&2
-fi
-exit $fail

package/templates/_agents/hooks/check-wiki-ledger.sh

@@ -1,18 +0,0 @@
-#!/bin/sh
-# wiki 台账一致性（增量版）：本次暂存触及 wiki/ 时跑 verify 三方校验（磁盘 ↔ INDEX ↔ 看板 DATA）
-# 目的：给「登记动作」装触发点——verify 此前无任何钩子调用，只能靠「触及 wiki 时手跑」的文字纪律
-# （incident 2026-09-16-wiki-drift-and-verifier-gaps 认定的根因）；本脚本把发现时机提前到 commit。
-# 口径与 .agents/scripts/verify-wiki-consistency.mjs 一致：活层新增/删除/移动未登记、数据维护批次目录未入台账即拦。
-# 注意 `-c core.quotepath=off`：core.quotepath 为 git 默认 true 时中文路径被转义加引号——实测输出
-# `"wiki/\346\265\213\350\257\225..."`，`^wiki/` 前缀匹配失配 → 门禁静默跳过（本机 .gitconfig 恰好设 false，本地不复现）。
-
-cd "$(git rev-parse --show-toplevel)" || exit 1
-
-git -c core.quotepath=off diff --cached --name-only | grep -q '^wiki/' || exit 0
-
-if ! node .agents/scripts/verify-wiki-consistency.mjs; then
-  echo "wiki 台账（增量）— BLOCK:"
-  echo "  先跑 node .agents/scripts/gen-wiki-board.mjs 补 INDEX/看板（或补 wiki/数据维护/README.md 登记行），再原路重试提交"
-  exit 1
-fi
-exit 0

package/templates/_agents/scripts/rule-budget.sh

@@ -1,74 +0,0 @@
-#!/bin/sh
-# 常驻面体积预算检查（单源：本脚本 + .agents/rule-budgets.txt；两个触发点共用）
-# 用法：sh .agents/scripts/rule-budget.sh [--all|--staged]
-#   --all     查「提交后树」全量（check-loop.sh 检查 13 调用，warning 侧）
-#   --staged  仅查本次暂存触及的条目 + 触及目录的合计（.githooks/pre-commit 调用，超限即硬拦）
-# 退出码：0 通过；1 有超限（违例逐条打到 stdout，调用方决定警告还是阻断）
-# 「提交后树」= 索引（index）内容：staged 版优先于 HEAD；无 git（fixture 沙箱）时回退工作区文件。
-# 预算表按字节读，显式去 \r——本仓库 core.autocrlf=true，表文件检出即 CRLF，行尾残留会让数值比较失配。
-# 字节口径 = 索引 / HEAD 内容（git cat-file，LF 归一）。**禁用 wc -c 核对**——工作区文件是 CRLF，量出来系统性偏大
-# （2026-09-21 实测 .agents/commands/ 工作区 39963B vs 索引 39451B，差 ~500B，一度误判「已超限」）。
-cd "$(git rev-parse --show-toplevel 2>/dev/null)" || true   # 非 git 环境（fixture）留在原地
-MODE=${1:---all}
-BUDGETS=.agents/rule-budgets.txt
-[ -f "$BUDGETS" ] || exit 0
-
-# 取「提交后」字节数：索引 → HEAD → 工作区
-fsize() { # <path>
-  if git cat-file -e ":$1" 2>/dev/null; then git cat-file -s ":$1"
-  elif git cat-file -e "HEAD:$1" 2>/dev/null; then git cat-file -s "HEAD:$1"
-  else wc -c < "$1" 2>/dev/null | tr -d '[:space:]'
-  fi
-}
-
-staged_list=""
-if [ "$MODE" = "--staged" ]; then
-  staged_list=$(git -c core.quotepath=off diff --cached --name-only 2>/dev/null)
-fi
-
-viol=0
-while IFS= read -r line; do
-  line=$(printf '%s' "$line" | tr -d '\r')
-  pat=${line%% *}
-  lim=${line##* }
-  case "$pat" in ''|'#'*) continue ;; esac
-  case "$lim" in ''|*[!0-9]*) continue ;; esac
-  case "$pat" in
-    */) # 目录合计：--staged 下仅当暂存触及该目录内文件才查（case 字面前缀匹配——pat 含 . 时不能当正则用，2026-09-24）
-      if [ "$MODE" = "--staged" ]; then
-        found=0
-        while IFS= read -r sf; do
-          case "$sf" in "$pat"*) found=1 ;; esac
-        done <<EOF
-$staged_list
-EOF
-        [ "$found" = "1" ] || continue
-      fi
-      total=0
-      for f in "$pat"*; do
-        [ -f "$f" ] || continue
-        total=$((total + $(fsize "$f")))
-      done
-      if [ "$total" -gt "$lim" ]; then
-        echo "常驻面超限：${pat} 合计 ${total}B > 上限 ${lim}B"
-        viol=1
-      fi
-      ;;
-    *) # 逐文件（glob 刻意不加引号以展开；无命中时 [ -f ] 兜住）
-      for f in $pat; do
-        [ -f "$f" ] || continue
-        if [ "$MODE" = "--staged" ]; then
-          printf '%s\n' "$staged_list" | grep -qxF "$f" || continue
-        fi
-        b=$(fsize "$f")
-        if [ "$b" -gt "$lim" ]; then
-          echo "常驻面超限：$f = ${b}B > 上限 ${lim}B"
-          viol=1
-        fi
-      done
-      ;;
-  esac
-done < "$BUDGETS"
-
-[ "$viol" -eq 0 ] || exit 1
-exit 0