agentic-flow-kit 1.7.0 → 1.7.15

package/modules/hosts/cursor/commands/wf-build.md

@@ -12,7 +12,7 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 
 起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
 验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
-确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录；摘要可复用——分辨力由 scope+指纹承担，2026-10-09 起）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
 
 ## 1. 执行
 
@@ -23,7 +23,7 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
    - 复制 `workflow/plans/_TEMPLATE.md` → `workflow/plans/YYYY-MM-DD-<主题>.md`(与入口文档同名)
    - L2/L3 按 4 节填写:改动方案 / 任务拆解(每个任务有判据) / 执行顺序 / 验证计划（与 fill-plan.mjs 单源一致）
    - L1 使用 Quick-Plan 极简三节:改动方案 / 约束与风险(原 Spec 核心) / 验证计划；多文件多步骤时可补任务拆解/执行顺序
-3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件配逐件原话**:`--delegated` 每次传当次实际放行的措辞,不复用同句——复用同句使台账 quote 失去分辨力(事后对质看不出放行的是哪一件);原因与根治见 workflow/papercuts.md 2026-09-28。
+3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件代录**:`--delegated "<授权摘要>"` 每件单独一次——摘要为人类可读留痕,复用同句不削弱判据(分辨力由落账自动记录的改动面 `scope{files,sha256}` 与文档指纹承担,2026-10-09 起)。
    **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 一次一份多份并录被拒 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 4. 确认后 → plan 状态 draft → approved,并在 plan 内补「确认与复核」节(确认结果 + 日期)。确认环节须在文档留痕:`approved` 是确认的机器可见态,`done` 只在关单出现,禁从 `draft` 直跳 `done`;确认后立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)。
 
@@ -33,7 +33,7 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
    - **先拉同模块历史坑**：按入口文档 `模块:` 跑 `node .agents/scripts/kb-search.mjs --scope workflow --module <token> "<关键词>"`——命中 incident 的根因 / 防复发条目列入改动自查
    - 列改动文件清单(读后改 vs 新建)
    - 列步骤(改 X 文件做 Y → 改 Z 文件做 W)
-   - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（见 incidents/2026-09-25-wf-runtime 复盘）
+   - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（仅包源/dogfood 双形态仓适用；纯装户仓 owned 即项目自有文件，无此步）
    - 标注触达红线(对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）)
 6. 停下,等用户确认改动清单。
 
@@ -56,32 +56,13 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 
 - 红线(架构 / 数据 / 安全等)正文与豁免见根与目录级 `AGENTS.md`(如有)——已由 pre-commit 机器门强制的部分以钩子为准，写代码前先过一遍目录级 AGENTS
 
-## 4. 改权威源后必跑（薄适配同步防漏）
-
-- 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
-- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
-
-## 5. 改 doctor / check-loop 后必跑（三处口径对账）
-
-- 改 `src/doctor.mjs` 加新 § 检查项 → 跑 `node .agents/scripts/gate-checklist.mjs --diff` 看 doctor ↔ check-loop 对照表
-- 改 `.agents/scripts/check-loop.sh` 加新 § 检查项 → 同上
-- 任一处有而另一边无 → 工具报"缺点"，由用户拍板是否补齐（不自动同步，B-b 决策）；详见 `.agents/commands/gate-checklist.md`
-
-## 6. 改包源后必跑（装户面同步一致性）
-
-- 改 `templates/_agents/*` 包源后 → 跑 `node .agents/scripts/source-sync-check.mjs --diff` 看装副本 `.agents/` 是否同步（缺失 / 孤儿 / 漂移三类差异）
-- 漂移说明包源改了装副本未跟；缺失说明新增文件 init 未执行；孤儿说明装副本独有（可能是装户配置，不删）
-- **新增 managed 类文件须经 init/sync 登记，禁手动双写绕过台账**——手工同时写 `templates/_agents/` 与 `.agents/` 会绕过台账登记，使该文件永远不被 sync 升级（`doctor` 台账覆盖率检查会拦；见 incidents/2026-09-26-managed-ledger-adopt 复盘）
-- 门禁边界（pre-commit 双源一致性）：比较工作树非暂存区——两侧改好、分两笔提交不拦（最终一致即可）；包源删除文件退化为「孤儿」只报告不拦，删包源须手动清理装副本残件（复核 P2-2 声明，2026-09-27 gate-hardening-p2-batch）
-- B-b 决策「只报告不修复」；详见 `.agents/commands/source-sync-check.md`
-
-## 7. 子代理调用约定
+## 4. 子代理调用约定
 
 - plan 起草、风险判断、改动清单与两道确认门由主智能体负责;仅两道确认后范围明确的工作包可委派 `implementer`,公共接口 / Schema / 依赖 / 安全 / 权限 / 破坏性操作不得委派。
 - 多工作包并行 / 链式推进:编排机制(声明随 plan 草稿一并确认;确认后读 `.agents/workflows/` 按机制文档执行,`steps/` 为项目自定义步骤扩展点);详见 `.agents/workflows/_TEMPLATE.md`。
 - 子智能体返回后,主智能体须检查 diff 与授权文件范围、确认未覆盖既有修改并重跑相关验证;不支持子智能体时 `fallback: main`,验收标准不变。
 
-## 8. 确认后
+## 5. 确认后
 
 - plan 状态 → done（实现完成；intent / spec 关单在 test）
 - commit：L1+ 入口文档 / spec / plan 随代码同一提交（Conventional Commits 中文 feat/fix/refactor/perf）；docs 豁免与 bootstrap 可单独 `docs(*)`

package/modules/hosts/cursor/commands/wf-deploy.md

@@ -41,6 +41,7 @@ description: Deploy 阶段:prod 上线清单(静态门 + 配对检查 + 回归 +
 ## 6. 上线后观察(用户观察,Maintain 阶段接手)
 
 - 观察期:上线后 24h;由用户观察错误率 / 延迟 / 关键业务流(无监控时人工看)
+- 异常判据(观察期退出规则):项目口径填 `workflow/regression-checklist.md`——无监控时的最低判据:错误日志 / 异常告警 / 关键业务流失败**任一出现即触发 §5 回滚预案,不等 24h**;无异常满 24h 方可闭环
 - 闭环宣告:用户确认无异常后才算闭环;AI 不得自行宣告
 - 异常回落:超阈值 → 生成 `workflow/incidents/YYYY-MM-DD-<主题>.md`,进 `maintain.md`(止血方案用户拍板,见 maintain.md §0)
 - 事故响应:单用途账号 + 最小权限;不得跨智能体协作推送修复(参考 Anthropic 教训)

package/modules/hosts/cursor/commands/wf-design.md

@@ -10,7 +10,7 @@ description: Design 阶段:起 spec(L2/L3 强制,L1 可省略)
 
 起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
 验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
-确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录；摘要可复用——分辨力由 scope+指纹承担，2026-10-09 起）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
 
 ## 1. 执行
 
@@ -43,6 +43,6 @@ description: Design 阶段:起 spec(L2/L3 强制,L1 可省略)
 ## 4. 确认后
 
 - spec 状态 draft → approved
-- **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件调用+逐件原话 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+- **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 - 立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)
 - 进 `next: .agents/commands/build.md`

package/modules/hosts/cursor/commands/wf-gate-checklist.md

@@ -74,6 +74,4 @@ npm test                                       # 含 gate-checklist 套件
 
 ## 6. 相关留痕
 
-- intent（登记表重写）：`workflow/intents/2026-09-25-gate-checklist-registry.md`
-- intent（工具首建）：`workflow/intents/2026-09-25-gate-checklist.md`
-- 父 incident：`workflow/incidents/2026-09-25-wf-runtime.md`（owned 漂移未对账，催生本工具）
+- 立法出处：2026-09-25（登记表重写 + 工具首建；父事件 = owned 漂移未对账，催生本工具）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/cursor/commands/wf-plan.md

@@ -20,7 +20,7 @@ description: Plan 阶段:立 intent(需求来源 / 目标 / 约束 / 触达红
    - 红线勾选对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）;**没触及就全不勾**,不要硬填
 3. 写不出可测试判据 = 还没想清楚 → 反问澄清,不要硬填。
 4. 起草后停下,输出草稿全文给用户过目,一句"可以"即确认。
-   **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件调用+逐件原话 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+   **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 
 ## 2. 技能辅助(可选,宿主级 skills)
 

package/modules/hosts/cursor/commands/wf-source-sync-check.md

@@ -86,6 +86,4 @@ flow-kit doctor                                     # 10/0/0
 
 ## 6. 相关留痕
 
-- intent：`workflow/intents/2026-09-25-source-sync-check.md`
-- plan：`workflow/plans/2026-09-25-source-sync-check.md`
-- 父 incident：`workflow/incidents/2026-09-25-wf-runtime.md`（包源改了装副本未同步——本工具预防性体检）
+- 立法出处：2026-09-25 source-sync-check（intent/plan；父事件 = 包源改了装副本未同步，本工具预防性体检）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/cursor/commands/wf-sync-hosts.md

@@ -67,6 +67,4 @@ sh .agents/scripts/check-loop.sh                # Windows 无 sh 时 doctor 已
 
 ## 5. 相关留痕
 
-- intent：`workflow/intents/2026-09-25-cross-host-sync.md`
-- plan：`workflow/plans/2026-09-25-cross-host-sync.md`（含 B-b 方案拍板）
-- incident：`workflow/incidents/2026-09-25-wf-runtime.md`（双源纪律教训，规范 §7.x 包源环境跳过）
+- 立法出处：2026-09-25 cross-host-sync（intent/plan，含 B-b 方案拍板；父事件 = wf-runtime 双源纪律教训，规范 §7.x 包源环境跳过）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/cursor/commands/wf-test.md

@@ -16,7 +16,7 @@ description: Test 阶段:静态门(架构红线 + build + test)+ UI 实测(headl
 项目测试命令                                       # 自动化测试
 项目类型检查命令                                  # 前端类型检查/构建(涉及前端时跑)
 node .agents/scripts/verify-wiki-consistency.mjs   # 触及 wiki/ 时跑(exit 1 即先修台账再继续:跑 gen-wiki-board.mjs 补索引/看板;pre-commit 已按增量自动拦,此行用于改完即验)
-node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 owned 漂移 + §6.7 跨宿主薄适配正文漂移(装户环境；包源环境 §6.7 skipped)
+npx agentic-flow-kit doctor                        # §6.5 delegations + §6.6 owned 漂移 + §6.7 跨宿主薄适配正文漂移(装户环境；包源环境 §6.7 skipped)
 ```
 
 > **环境注记**：本地服务占用构建产物导致编译失败、多会话并行时「谁跑静态门 / 提交谁先停服务」等约定——如有,见项目注记 `.agents/notes/runtime-env.md` §2,跑静态门前先过一眼。
@@ -55,11 +55,12 @@ node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 o
 
 - 输出测试报告(通过项 / 失败项);失败项已修复并复测通过。
 - **关单**（日常闭环点，不依赖是否上 prod）:
-  - 关单前一键过门：`node .agents/scripts/verify.mjs --doc workflow/intents/<本单>.md`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**`--doc` 把测试绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 对账只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定（2026-10-07 papercut）
+  - 关单前一键过门：`node .agents/scripts/verify.mjs --doc workflow/intents/<本单>.md`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**`--doc` 把测试绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 对账只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定
   - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent → done；同名 spec/Quick-Plan（若有）仍 approved → done。**注意：勾选但缺证据会被 check-loop 拦截（hard-block）**
-  - **approved 留痕提交**（2026-09-30 起）：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
-  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件+逐件原话 / done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+  - **approved 留痕提交**：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
+  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
   - 修复：防复发验证已落地，incident → closed（经确认门 confirm-doc：open→fixed / fixed→closed 两跳、无单跳；2026-09-28 起 check-loop 15 对账——关单编辑先于 closed 确认，口径同 done 内容绑定）
+  - **沉淀草稿**：intent done / incident closed 后跑 `node .agents/scripts/draft-sediment.mjs workflow/<intents|incidents>/<本单>.md`——自动抽高价值节（intent：影响面/触达红线；incident：影响面/根因/为什么之前没拦住/复盘三件套）落 `wiki/drafts-archive/<日期-主题>/` 草稿、回写源文件 `沉淀` 字段、重跑 gen-wiki-board（归档计数随动，否则 verify-wiki-consistency 拦提交）。全占位单拒抽（正常，无沉淀价值）。`--dry-run` 先预览。草稿是**中间态**：人工读一遍归类到 `wiki/<主题>/`（补主题与用途、保留 `来源` 字段）后跑 gen-wiki-board + verify-wiki-consistency。沉淀是人工判断——机器只代抽与登记，值不值得入库由人定；不沉淀写 `沉淀: 无` 显式豁免（check-loop 的 `[WARN 未沉淀]` 随之消除）
   - **同族收尾**：入口置终态时，同名 plan 一并置 `done`（spec 见上条），不留 `approved` 孤儿（口径同看板「入口已 done，本 plan 未终态」告警）
   - 主智能体自做的 L1+ 新需求在 `workflow/delegations.md`「自做任务结果表」记一行（修复类不重复记）
   - **委派快照回写**：关单后若 `workflow/delegations.md` §月度聚合快照缺当月行或 doctor §6.5 报陈旧 → 跑 `node .agents/scripts/agg-delegations.cjs` 并回贴当月快照行

package/modules/hosts/opencode/commands/wf-build.md

@@ -12,7 +12,7 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
 
 起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
 验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
-确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录；摘要可复用——分辨力由 scope+指纹承担，2026-10-09 起）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
 
 ## 1. 执行
 
@@ -23,7 +23,7 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
    - 复制 `workflow/plans/_TEMPLATE.md` → `workflow/plans/YYYY-MM-DD-<主题>.md`(与入口文档同名)
    - L2/L3 按 4 节填写:改动方案 / 任务拆解(每个任务有判据) / 执行顺序 / 验证计划（与 fill-plan.mjs 单源一致）
    - L1 使用 Quick-Plan 极简三节:改动方案 / 约束与风险(原 Spec 核心) / 验证计划；多文件多步骤时可补任务拆解/执行顺序
-3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件配逐件原话**:`--delegated` 每次传当次实际放行的措辞,不复用同句——复用同句使台账 quote 失去分辨力(事后对质看不出放行的是哪一件);原因与根治见 workflow/papercuts.md 2026-09-28。
+3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件代录**:`--delegated "<授权摘要>"` 每件单独一次——摘要为人类可读留痕,复用同句不削弱判据(分辨力由落账自动记录的改动面 `scope{files,sha256}` 与文档指纹承担,2026-10-09 起)。
    **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 一次一份多份并录被拒 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 4. 确认后 → plan 状态 draft → approved,并在 plan 内补「确认与复核」节(确认结果 + 日期)。确认环节须在文档留痕:`approved` 是确认的机器可见态,`done` 只在关单出现,禁从 `draft` 直跳 `done`;确认后立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)。
 
@@ -33,7 +33,7 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
    - **先拉同模块历史坑**：按入口文档 `模块:` 跑 `node .agents/scripts/kb-search.mjs --scope workflow --module <token> "<关键词>"`——命中 incident 的根因 / 防复发条目列入改动自查
    - 列改动文件清单(读后改 vs 新建)
    - 列步骤(改 X 文件做 Y → 改 Z 文件做 W)
-   - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（见 incidents/2026-09-25-wf-runtime 复盘）
+   - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（仅包源/dogfood 双形态仓适用；纯装户仓 owned 即项目自有文件，无此步）
    - 标注触达红线(对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）)
 6. 停下,等用户确认改动清单。
 
@@ -56,32 +56,13 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
 
 - 红线(架构 / 数据 / 安全等)正文与豁免见根与目录级 `AGENTS.md`(如有)——已由 pre-commit 机器门强制的部分以钩子为准，写代码前先过一遍目录级 AGENTS
 
-## 4. 改权威源后必跑（薄适配同步防漏）
-
-- 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
-- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
-
-## 5. 改 doctor / check-loop 后必跑（三处口径对账）
-
-- 改 `src/doctor.mjs` 加新 § 检查项 → 跑 `node .agents/scripts/gate-checklist.mjs --diff` 看 doctor ↔ check-loop 对照表
-- 改 `.agents/scripts/check-loop.sh` 加新 § 检查项 → 同上
-- 任一处有而另一边无 → 工具报"缺点"，由用户拍板是否补齐（不自动同步，B-b 决策）；详见 `.agents/commands/gate-checklist.md`
-
-## 6. 改包源后必跑（装户面同步一致性）
-
-- 改 `templates/_agents/*` 包源后 → 跑 `node .agents/scripts/source-sync-check.mjs --diff` 看装副本 `.agents/` 是否同步（缺失 / 孤儿 / 漂移三类差异）
-- 漂移说明包源改了装副本未跟；缺失说明新增文件 init 未执行；孤儿说明装副本独有（可能是装户配置，不删）
-- **新增 managed 类文件须经 init/sync 登记，禁手动双写绕过台账**——手工同时写 `templates/_agents/` 与 `.agents/` 会绕过台账登记，使该文件永远不被 sync 升级（`doctor` 台账覆盖率检查会拦；见 incidents/2026-09-26-managed-ledger-adopt 复盘）
-- 门禁边界（pre-commit 双源一致性）：比较工作树非暂存区——两侧改好、分两笔提交不拦（最终一致即可）；包源删除文件退化为「孤儿」只报告不拦，删包源须手动清理装副本残件（复核 P2-2 声明，2026-09-27 gate-hardening-p2-batch）
-- B-b 决策「只报告不修复」；详见 `.agents/commands/source-sync-check.md`
-
-## 7. 子代理调用约定
+## 4. 子代理调用约定
 
 - plan 起草、风险判断、改动清单与两道确认门由主智能体负责;仅两道确认后范围明确的工作包可委派 `implementer`,公共接口 / Schema / 依赖 / 安全 / 权限 / 破坏性操作不得委派。
 - 多工作包并行 / 链式推进:编排机制(声明随 plan 草稿一并确认;确认后读 `.agents/workflows/` 按机制文档执行,`steps/` 为项目自定义步骤扩展点);详见 `.agents/workflows/_TEMPLATE.md`。
 - 子智能体返回后,主智能体须检查 diff 与授权文件范围、确认未覆盖既有修改并重跑相关验证;不支持子智能体时 `fallback: main`,验收标准不变。
 
-## 8. 确认后
+## 5. 确认后
 
 - plan 状态 → done（实现完成；intent / spec 关单在 test）
 - commit：L1+ 入口文档 / spec / plan 随代码同一提交（Conventional Commits 中文 feat/fix/refactor/perf）；docs 豁免与 bootstrap 可单独 `docs(*)`

package/modules/hosts/opencode/commands/wf-deploy.md

@@ -41,6 +41,7 @@ description: Deploy 阶段 · prod 上线清单（静态门 / 配对 / 回归 /
 ## 6. 上线后观察(用户观察,Maintain 阶段接手)
 
 - 观察期:上线后 24h;由用户观察错误率 / 延迟 / 关键业务流(无监控时人工看)
+- 异常判据(观察期退出规则):项目口径填 `workflow/regression-checklist.md`——无监控时的最低判据:错误日志 / 异常告警 / 关键业务流失败**任一出现即触发 §5 回滚预案,不等 24h**;无异常满 24h 方可闭环
 - 闭环宣告:用户确认无异常后才算闭环;AI 不得自行宣告
 - 异常回落:超阈值 → 生成 `workflow/incidents/YYYY-MM-DD-<主题>.md`,进 `maintain.md`(止血方案用户拍板,见 maintain.md §0)
 - 事故响应:单用途账号 + 最小权限;不得跨智能体协作推送修复(参考 Anthropic 教训)

package/modules/hosts/opencode/commands/wf-design.md

@@ -10,7 +10,7 @@ description: Design 阶段 · 起 spec（L2/L3 强制，L1 可省略直接进 bu
 
 起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
 验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
-确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录；摘要可复用——分辨力由 scope+指纹承担，2026-10-09 起）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
 
 ## 1. 执行
 
@@ -43,6 +43,6 @@ description: Design 阶段 · 起 spec（L2/L3 强制，L1 可省略直接进 bu
 ## 4. 确认后
 
 - spec 状态 draft → approved
-- **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件调用+逐件原话 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+- **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 - 立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)
 - 进 `next: .agents/commands/build.md`

package/modules/hosts/opencode/commands/wf-gate-checklist.md

@@ -74,6 +74,4 @@ npm test                                       # 含 gate-checklist 套件
 
 ## 6. 相关留痕
 
-- intent（登记表重写）：`workflow/intents/2026-09-25-gate-checklist-registry.md`
-- intent（工具首建）：`workflow/intents/2026-09-25-gate-checklist.md`
-- 父 incident：`workflow/incidents/2026-09-25-wf-runtime.md`（owned 漂移未对账，催生本工具）
+- 立法出处：2026-09-25（登记表重写 + 工具首建；父事件 = owned 漂移未对账，催生本工具）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/opencode/commands/wf-plan.md

@@ -20,7 +20,7 @@ description: Plan 阶段 · 立 intent（AI 起草、用户确认；本阶段不
    - 红线勾选对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）;**没触及就全不勾**,不要硬填
 3. 写不出可测试判据 = 还没想清楚 → 反问澄清,不要硬填。
 4. 起草后停下,输出草稿全文给用户过目,一句"可以"即确认。
-   **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件调用+逐件原话 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+   **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 
 ## 2. 技能辅助(可选,宿主级 skills)
 

package/modules/hosts/opencode/commands/wf-source-sync-check.md

@@ -86,6 +86,4 @@ flow-kit doctor                                     # 10/0/0
 
 ## 6. 相关留痕
 
-- intent：`workflow/intents/2026-09-25-source-sync-check.md`
-- plan：`workflow/plans/2026-09-25-source-sync-check.md`
-- 父 incident：`workflow/incidents/2026-09-25-wf-runtime.md`（包源改了装副本未同步——本工具预防性体检）
+- 立法出处：2026-09-25 source-sync-check（intent/plan；父事件 = 包源改了装副本未同步，本工具预防性体检）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/opencode/commands/wf-sync-hosts.md

@@ -67,6 +67,4 @@ sh .agents/scripts/check-loop.sh                # Windows 无 sh 时 doctor 已
 
 ## 5. 相关留痕
 
-- intent：`workflow/intents/2026-09-25-cross-host-sync.md`
-- plan：`workflow/plans/2026-09-25-cross-host-sync.md`（含 B-b 方案拍板）
-- incident：`workflow/incidents/2026-09-25-wf-runtime.md`（双源纪律教训，规范 §7.x 包源环境跳过）
+- 立法出处：2026-09-25 cross-host-sync（intent/plan，含 B-b 方案拍板；父事件 = wf-runtime 双源纪律教训，规范 §7.x 包源环境跳过）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/opencode/commands/wf-test.md

@@ -16,7 +16,7 @@ description: Test 阶段 · 静态门 + 切库冒烟 + UI 实测 + L2/L3 独立
 项目测试命令                                       # 自动化测试
 项目类型检查命令                                  # 前端类型检查/构建(涉及前端时跑)
 node .agents/scripts/verify-wiki-consistency.mjs   # 触及 wiki/ 时跑(exit 1 即先修台账再继续:跑 gen-wiki-board.mjs 补索引/看板;pre-commit 已按增量自动拦,此行用于改完即验)
-node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 owned 漂移 + §6.7 跨宿主薄适配正文漂移(装户环境；包源环境 §6.7 skipped)
+npx agentic-flow-kit doctor                        # §6.5 delegations + §6.6 owned 漂移 + §6.7 跨宿主薄适配正文漂移(装户环境；包源环境 §6.7 skipped)
 ```
 
 > **环境注记**：本地服务占用构建产物导致编译失败、多会话并行时「谁跑静态门 / 提交谁先停服务」等约定——如有,见项目注记 `.agents/notes/runtime-env.md` §2,跑静态门前先过一眼。
@@ -55,11 +55,12 @@ node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 o
 
 - 输出测试报告(通过项 / 失败项);失败项已修复并复测通过。
 - **关单**（日常闭环点，不依赖是否上 prod）:
-  - 关单前一键过门：`node .agents/scripts/verify.mjs --doc workflow/intents/<本单>.md`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**`--doc` 把测试绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 对账只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定（2026-10-07 papercut）
+  - 关单前一键过门：`node .agents/scripts/verify.mjs --doc workflow/intents/<本单>.md`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**`--doc` 把测试绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 对账只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定
   - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent → done；同名 spec/Quick-Plan（若有）仍 approved → done。**注意：勾选但缺证据会被 check-loop 拦截（hard-block）**
-  - **approved 留痕提交**（2026-09-30 起）：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
-  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件+逐件原话 / done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+  - **approved 留痕提交**：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
+  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
   - 修复：防复发验证已落地，incident → closed（经确认门 confirm-doc：open→fixed / fixed→closed 两跳、无单跳；2026-09-28 起 check-loop 15 对账——关单编辑先于 closed 确认，口径同 done 内容绑定）
+  - **沉淀草稿**：intent done / incident closed 后跑 `node .agents/scripts/draft-sediment.mjs workflow/<intents|incidents>/<本单>.md`——自动抽高价值节（intent：影响面/触达红线；incident：影响面/根因/为什么之前没拦住/复盘三件套）落 `wiki/drafts-archive/<日期-主题>/` 草稿、回写源文件 `沉淀` 字段、重跑 gen-wiki-board（归档计数随动，否则 verify-wiki-consistency 拦提交）。全占位单拒抽（正常，无沉淀价值）。`--dry-run` 先预览。草稿是**中间态**：人工读一遍归类到 `wiki/<主题>/`（补主题与用途、保留 `来源` 字段）后跑 gen-wiki-board + verify-wiki-consistency。沉淀是人工判断——机器只代抽与登记，值不值得入库由人定；不沉淀写 `沉淀: 无` 显式豁免（check-loop 的 `[WARN 未沉淀]` 随之消除）
   - **同族收尾**：入口置终态时，同名 plan 一并置 `done`（spec 见上条），不留 `approved` 孤儿（口径同看板「入口已 done，本 plan 未终态」告警）
   - 主智能体自做的 L1+ 新需求在 `workflow/delegations.md`「自做任务结果表」记一行（修复类不重复记）
   - **委派快照回写**：关单后若 `workflow/delegations.md` §月度聚合快照缺当月行或 doctor §6.5 报陈旧 → 跑 `node .agents/scripts/agg-delegations.cjs` 并回贴当月快照行

package/modules/hosts/trae/commands/wf-build.md

@@ -13,7 +13,7 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
 
 起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
 验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
-确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录；摘要可复用——分辨力由 scope+指纹承担，2026-10-09 起）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
 
 ## 1. 执行
 
@@ -24,7 +24,7 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
    - 复制 `workflow/plans/_TEMPLATE.md` → `workflow/plans/YYYY-MM-DD-<主题>.md`(与入口文档同名)
    - L2/L3 按 4 节填写:改动方案 / 任务拆解(每个任务有判据) / 执行顺序 / 验证计划（与 fill-plan.mjs 单源一致）
    - L1 使用 Quick-Plan 极简三节:改动方案 / 约束与风险(原 Spec 核心) / 验证计划；多文件多步骤时可补任务拆解/执行顺序
-3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件配逐件原话**:`--delegated` 每次传当次实际放行的措辞,不复用同句——复用同句使台账 quote 失去分辨力(事后对质看不出放行的是哪一件);原因与根治见 workflow/papercuts.md 2026-09-28。
+3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件代录**:`--delegated "<授权摘要>"` 每件单独一次——摘要为人类可读留痕,复用同句不削弱判据(分辨力由落账自动记录的改动面 `scope{files,sha256}` 与文档指纹承担,2026-10-09 起)。
    **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 一次一份多份并录被拒 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 4. 确认后 → plan 状态 draft → approved,并在 plan 内补「确认与复核」节(确认结果 + 日期)。确认环节须在文档留痕:`approved` 是确认的机器可见态,`done` 只在关单出现,禁从 `draft` 直跳 `done`;确认后立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)。
 
@@ -34,7 +34,7 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
    - **先拉同模块历史坑**：按入口文档 `模块:` 跑 `node .agents/scripts/kb-search.mjs --scope workflow --module <token> "<关键词>"`——命中 incident 的根因 / 防复发条目列入改动自查
    - 列改动文件清单(读后改 vs 新建)
    - 列步骤(改 X 文件做 Y → 改 Z 文件做 W)
-   - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（见 incidents/2026-09-25-wf-runtime 复盘）
+   - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（仅包源/dogfood 双形态仓适用；纯装户仓 owned 即项目自有文件，无此步）
    - 标注触达红线(对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）)
 6. 停下,等用户确认改动清单。
 
@@ -57,32 +57,13 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
 
 - 红线(架构 / 数据 / 安全等)正文与豁免见根与目录级 `AGENTS.md`(如有)——已由 pre-commit 机器门强制的部分以钩子为准，写代码前先过一遍目录级 AGENTS
 
-## 4. 改权威源后必跑（薄适配同步防漏）
-
-- 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
-- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
-
-## 5. 改 doctor / check-loop 后必跑（三处口径对账）
-
-- 改 `src/doctor.mjs` 加新 § 检查项 → 跑 `node .agents/scripts/gate-checklist.mjs --diff` 看 doctor ↔ check-loop 对照表
-- 改 `.agents/scripts/check-loop.sh` 加新 § 检查项 → 同上
-- 任一处有而另一边无 → 工具报"缺点"，由用户拍板是否补齐（不自动同步，B-b 决策）；详见 `.agents/commands/gate-checklist.md`
-
-## 6. 改包源后必跑（装户面同步一致性）
-
-- 改 `templates/_agents/*` 包源后 → 跑 `node .agents/scripts/source-sync-check.mjs --diff` 看装副本 `.agents/` 是否同步（缺失 / 孤儿 / 漂移三类差异）
-- 漂移说明包源改了装副本未跟；缺失说明新增文件 init 未执行；孤儿说明装副本独有（可能是装户配置，不删）
-- **新增 managed 类文件须经 init/sync 登记，禁手动双写绕过台账**——手工同时写 `templates/_agents/` 与 `.agents/` 会绕过台账登记，使该文件永远不被 sync 升级（`doctor` 台账覆盖率检查会拦；见 incidents/2026-09-26-managed-ledger-adopt 复盘）
-- 门禁边界（pre-commit 双源一致性）：比较工作树非暂存区——两侧改好、分两笔提交不拦（最终一致即可）；包源删除文件退化为「孤儿」只报告不拦，删包源须手动清理装副本残件（复核 P2-2 声明，2026-09-27 gate-hardening-p2-batch）
-- B-b 决策「只报告不修复」；详见 `.agents/commands/source-sync-check.md`
-
-## 7. 子代理调用约定
+## 4. 子代理调用约定
 
 - plan 起草、风险判断、改动清单与两道确认门由主智能体负责;仅两道确认后范围明确的工作包可委派 `implementer`,公共接口 / Schema / 依赖 / 安全 / 权限 / 破坏性操作不得委派。
 - 多工作包并行 / 链式推进:编排机制(声明随 plan 草稿一并确认;确认后读 `.agents/workflows/` 按机制文档执行,`steps/` 为项目自定义步骤扩展点);详见 `.agents/workflows/_TEMPLATE.md`。
 - 子智能体返回后,主智能体须检查 diff 与授权文件范围、确认未覆盖既有修改并重跑相关验证;不支持子智能体时 `fallback: main`,验收标准不变。
 
-## 8. 确认后
+## 5. 确认后
 
 - plan 状态 → done（实现完成；intent / spec 关单在 test）
 - commit：L1+ 入口文档 / spec / plan 随代码同一提交（Conventional Commits 中文 feat/fix/refactor/perf）；docs 豁免与 bootstrap 可单独 `docs(*)`

package/modules/hosts/trae/commands/wf-deploy.md

@@ -42,6 +42,7 @@ description: Deploy 阶段 · prod 上线清单（静态门 / 配对 / 回归 /
 ## 6. 上线后观察(用户观察,Maintain 阶段接手)
 
 - 观察期:上线后 24h;由用户观察错误率 / 延迟 / 关键业务流(无监控时人工看)
+- 异常判据(观察期退出规则):项目口径填 `workflow/regression-checklist.md`——无监控时的最低判据:错误日志 / 异常告警 / 关键业务流失败**任一出现即触发 §5 回滚预案,不等 24h**;无异常满 24h 方可闭环
 - 闭环宣告:用户确认无异常后才算闭环;AI 不得自行宣告
 - 异常回落:超阈值 → 生成 `workflow/incidents/YYYY-MM-DD-<主题>.md`,进 `maintain.md`(止血方案用户拍板,见 maintain.md §0)
 - 事故响应:单用途账号 + 最小权限;不得跨智能体协作推送修复(参考 Anthropic 教训)

package/modules/hosts/trae/commands/wf-design.md

@@ -11,7 +11,7 @@ description: Design 阶段 · 起 spec（L2/L3 强制，L1 可省略直接进 wf
 
 起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
 验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
-确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录；摘要可复用——分辨力由 scope+指纹承担，2026-10-09 起）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
 
 ## 1. 执行
 
@@ -44,6 +44,6 @@ description: Design 阶段 · 起 spec（L2/L3 强制，L1 可省略直接进 wf
 ## 4. 确认后
 
 - spec 状态 draft → approved
-- **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件调用+逐件原话 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+- **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 - 立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)
 - 进 `next: .agents/commands/build.md`

package/modules/hosts/trae/commands/wf-gate-checklist.md

@@ -75,6 +75,4 @@ npm test                                       # 含 gate-checklist 套件
 
 ## 6. 相关留痕
 
-- intent（登记表重写）：`workflow/intents/2026-09-25-gate-checklist-registry.md`
-- intent（工具首建）：`workflow/intents/2026-09-25-gate-checklist.md`
-- 父 incident：`workflow/incidents/2026-09-25-wf-runtime.md`（owned 漂移未对账，催生本工具）
+- 立法出处：2026-09-25（登记表重写 + 工具首建；父事件 = owned 漂移未对账，催生本工具）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/trae/commands/wf-plan.md

@@ -21,7 +21,7 @@ description: Plan 阶段 · 立 intent（AI 起草、用户确认；本阶段不
    - 红线勾选对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）;**没触及就全不勾**,不要硬填
 3. 写不出可测试判据 = 还没想清楚 → 反问澄清,不要硬填。
 4. 起草后停下,输出草稿全文给用户过目,一句"可以"即确认。
-   **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件调用+逐件原话 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+   **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 
 ## 2. 技能辅助(可选,宿主级 skills)
 

package/modules/hosts/trae/commands/wf-source-sync-check.md

@@ -87,6 +87,4 @@ flow-kit doctor                                     # 10/0/0
 
 ## 6. 相关留痕
 
-- intent：`workflow/intents/2026-09-25-source-sync-check.md`
-- plan：`workflow/plans/2026-09-25-source-sync-check.md`
-- 父 incident：`workflow/incidents/2026-09-25-wf-runtime.md`（包源改了装副本未同步——本工具预防性体检）
+- 立法出处：2026-09-25 source-sync-check（intent/plan；父事件 = 包源改了装副本未同步，本工具预防性体检）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/trae/commands/wf-sync-hosts.md

@@ -68,6 +68,4 @@ sh .agents/scripts/check-loop.sh                # Windows 无 sh 时 doctor 已
 
 ## 5. 相关留痕
 
-- intent：`workflow/intents/2026-09-25-cross-host-sync.md`
-- plan：`workflow/plans/2026-09-25-cross-host-sync.md`（含 B-b 方案拍板）
-- incident：`workflow/incidents/2026-09-25-wf-runtime.md`（双源纪律教训，规范 §7.x 包源环境跳过）
+- 立法出处：2026-09-25 cross-host-sync（intent/plan，含 B-b 方案拍板；父事件 = wf-runtime 双源纪律教训，规范 §7.x 包源环境跳过）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/modules/hosts/trae/commands/wf-test.md

@@ -17,7 +17,7 @@ description: Test 阶段 · 静态门 + 切库冒烟 + UI 实测 + L2/L3 独立
 项目测试命令                                       # 自动化测试
 项目类型检查命令                                  # 前端类型检查/构建(涉及前端时跑)
 node .agents/scripts/verify-wiki-consistency.mjs   # 触及 wiki/ 时跑(exit 1 即先修台账再继续:跑 gen-wiki-board.mjs 补索引/看板;pre-commit 已按增量自动拦,此行用于改完即验)
-node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 owned 漂移 + §6.7 跨宿主薄适配正文漂移(装户环境；包源环境 §6.7 skipped)
+npx agentic-flow-kit doctor                        # §6.5 delegations + §6.6 owned 漂移 + §6.7 跨宿主薄适配正文漂移(装户环境；包源环境 §6.7 skipped)
 ```
 
 > **环境注记**：本地服务占用构建产物导致编译失败、多会话并行时「谁跑静态门 / 提交谁先停服务」等约定——如有,见项目注记 `.agents/notes/runtime-env.md` §2,跑静态门前先过一眼。
@@ -56,11 +56,12 @@ node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 o
 
 - 输出测试报告(通过项 / 失败项);失败项已修复并复测通过。
 - **关单**（日常闭环点，不依赖是否上 prod）:
-  - 关单前一键过门：`node .agents/scripts/verify.mjs --doc workflow/intents/<本单>.md`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**`--doc` 把测试绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 对账只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定（2026-10-07 papercut）
+  - 关单前一键过门：`node .agents/scripts/verify.mjs --doc workflow/intents/<本单>.md`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**`--doc` 把测试绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 对账只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定
   - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent → done；同名 spec/Quick-Plan（若有）仍 approved → done。**注意：勾选但缺证据会被 check-loop 拦截（hard-block）**
-  - **approved 留痕提交**（2026-09-30 起）：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
-  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件+逐件原话 / done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+  - **approved 留痕提交**：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
+  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
   - 修复：防复发验证已落地，incident → closed（经确认门 confirm-doc：open→fixed / fixed→closed 两跳、无单跳；2026-09-28 起 check-loop 15 对账——关单编辑先于 closed 确认，口径同 done 内容绑定）
+  - **沉淀草稿**：intent done / incident closed 后跑 `node .agents/scripts/draft-sediment.mjs workflow/<intents|incidents>/<本单>.md`——自动抽高价值节（intent：影响面/触达红线；incident：影响面/根因/为什么之前没拦住/复盘三件套）落 `wiki/drafts-archive/<日期-主题>/` 草稿、回写源文件 `沉淀` 字段、重跑 gen-wiki-board（归档计数随动，否则 verify-wiki-consistency 拦提交）。全占位单拒抽（正常，无沉淀价值）。`--dry-run` 先预览。草稿是**中间态**：人工读一遍归类到 `wiki/<主题>/`（补主题与用途、保留 `来源` 字段）后跑 gen-wiki-board + verify-wiki-consistency。沉淀是人工判断——机器只代抽与登记，值不值得入库由人定；不沉淀写 `沉淀: 无` 显式豁免（check-loop 的 `[WARN 未沉淀]` 随之消除）
   - **同族收尾**：入口置终态时，同名 plan 一并置 `done`（spec 见上条），不留 `approved` 孤儿（口径同看板「入口已 done，本 plan 未终态」告警）
   - 主智能体自做的 L1+ 新需求在 `workflow/delegations.md`「自做任务结果表」记一行（修复类不重复记）
   - **委派快照回写**：关单后若 `workflow/delegations.md` §月度聚合快照缺当月行或 doctor §6.5 报陈旧 → 跑 `node .agents/scripts/agg-delegations.cjs` 并回贴当月快照行

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-flow-kit",
-  "version": "1.7.0",
-  "description": "AI-Native 闭环工作流 + wiki 知识层脚手架——flow-kit init 一条命令为新项目装好 .agents 工作流引擎（阶段命令/角色契约/门禁钩子/kb 检索/看板/规则面预算）+ workflow 文档闭环 + wiki 知识库，装完自包含、零运行时依赖",
+  "version": "1.7.15",
+  "description": "AI-Native 闭环工作流 + wiki 知识层脚手架——flow-kit init 一条命令为新项目装好 .agents 工作流引擎（阶段命令/角色契约/门禁钩子/kb 检索/看板/规则面预算）+ workflow 文档闭环 + wiki 知识库，装完本地可跑、零运行时依赖",
   "type": "module",
   "scripts": {
     "test": "node src/run-tests.mjs",

package/src/add-gate.mjs

@@ -2,6 +2,13 @@
 // 模块约定：modules/gates/<gate>/ 下源文件拷入 .agents/hooks/（平铺，README.md 与 local-pre-commit.line 为包内元数据不拷）；
 // local-pre-commit.line 内容 = 需追加进 .agents/hooks/local-pre-commit 的挂载行（存在同名行则不重复追加，幂等）。
 // 门禁装后归项目所有：入 owned 台账，sync 永不覆盖（改红线/删不适用条目自行编辑——见各模块 README）。
+// gate 防改锚（2026-10-11 P3-1）：逐字拷贝安装的 gate 脚本，owned 条目写 srcSha256＝安装时刻包源文件
+// （modules/gates/<gate>/<file>）的 LF 归一 sha。语义：sync 对 owned 的 sha256 按盘面自愈（记账不约束），
+// 但 srcSha256 只按包源刷新——gate 文件在装户 sync 中 srcTemplatePath 解析不到包源模板（templates/_agents/
+// hooks/ 无同名件）即提前 return，锚一经写入恒定。doctor 的 gate 安装锚校验据此让「装后手改」永久可见：
+// 装户可改（不阻断），但改了会被看见。--force 重装锚随新安装刷新（即重锚路径）；已存在被跳过的文件锚
+// 盘面现状（盘面非逐字拷贝，锚包源会装后即误报），盘面与包源不一致时 WARN 差异。local-pre-commit 是
+// 合并接线件（模板 + 各门挂载行），非逐字拷贝——不写锚（它的 srcSha256 由 init/sync 按模板语义记，含义不同）。
 import fs from 'node:fs';
 import path from 'node:path';
 import { sha256 } from './render.mjs';
@@ -77,9 +84,26 @@ export function addGate(args, pkgRoot) {
   // 记账一律 LF 归一（init-p1-batch P1-4 rider）：与 doctor §6.6 / sync ownedSha 同口径，跨 checkout 字节稳定
   const shaText = (p) => sha256(Buffer.from(fs.readFileSync(p, 'utf8').replace(/\r\n/g, '\n'), 'utf8'));
   const ownedLedger = new Map((kit.owned || []).map((f) => [f.rel, f]));
+  // 跳过件（盘上已存在、未 --force）：先出声再记账——盘面与包源不一致即本地已改，WARN 保证差异在安装输出可见。
+  // 无台账条目的首次见面按盘面现状建立基线与锚；已有条目则原样保留（锚停在安装时刻值，盘面手改
+  // 继续由 doctor gate 安装锚校验留痕——重锚会把手改吸收成「无差异」，违背防改锚初衷）。
+  for (const name of skipped) {
+    const rel = `.agents/hooks/${name}`;
+    const known = ownedLedger.has(rel);
+    if (shaText(path.join(hooksDir, name)) !== shaText(path.join(srcRoot, name))) {
+      console.log(known
+        ? `  ⚠️ ${name} 盘面与包源不一致（本地已改）——原锚保留，手改由 doctor 锚校验留痕；重装覆盖用 --force`
+        : `  ⚠️ ${name} 盘面与包源不一致（本地已改），锚记盘面现状——重装覆盖用 --force`);
+    }
+    if (!known) {
+      const diskSha = shaText(path.join(hooksDir, name));
+      ownedLedger.set(rel, { rel, sha256: diskSha, srcSha256: diskSha });
+    }
+  }
   for (const name of installed) {
     const rel = `.agents/hooks/${name}`;
-    ownedLedger.set(rel, { rel, sha256: shaText(path.join(hooksDir, name)) });
+    // srcSha256＝安装时刻包源文件 sha（gate 防改锚，见文件头注）：sha256 被 sync 按盘面自愈，锚恒定
+    ownedLedger.set(rel, { rel, sha256: shaText(path.join(hooksDir, name)), srcSha256: shaText(path.join(srcRoot, name)) });
   }
   if (wiredLp) {
     const lpRel = '.agents/hooks/local-pre-commit';