agentic-flow-kit 1.8.7 → 2.0.0

package/templates/engine/.agents/commands/stages.md

@@ -0,0 +1,256 @@
+---
+description: L2/L3 阶段流(四并一):Plan 立 intent → Design 起 spec → Build 起 plan + 实现代码 → Test 静态门 + UI 实测 + 复核 + 关单;L1 走 new-task.md 快速道
+stage:
+  - Plan
+  - Design
+  - Build
+  - Test
+triggers:
+  - "起个 intent"
+  - "立 intent"
+  - "起个 spec"
+  - "接着起 spec"
+  - "intent 看过了"
+  - "spec 走一下"
+  - "起个 plan"
+  - "spec 没问题"
+  - "开始写吧"
+  - "动手吧"
+  - "计划可以了"
+  - "跑下 verify"
+  - "改完了"
+  - "跑下 verify 看看"
+  - "验证一下"
+delegation:
+  - role: independent-reviewer
+    instructions: .agents/roles/independent-reviewer.md
+    when: L2 / L3 spec 草稿完成且用户确认前(Design §3);L2 或 L3 改动完成且 diff 已固定(Test §4)
+    required: true
+    attach:
+      - 同名 spec 的验收判据
+      - 固定 git range：git rev-parse <基准> 可解析，且 git diff <基准>...<HEAD> 非空
+      - 级别为 L2 或 L3
+      - 新会话，不与实现同上下文
+      - 结论首行 reviewed by <模型名>
+      - 落盘行按 .agents/roles/independent-reviewer.md 由主智能体写入文档「确认与复核」
+      - 不改任何仓库文件
+  - role: ui-verifier
+    instructions: .agents/roles/ui-verifier.md
+    when: 涉及 UI 改动且静态门已通过
+    required: true
+    fallback: main
+  - role: implementer
+    instructions: .agents/roles/implementer.md
+    when: plan 与改动文件清单均已确认,且工作包边界满足角色契约
+    required: false
+    fallback: main
+approval_required: true
+next: 章序 Plan → Design → Build → Test;Test 后 L2/L3 合入（PR 审查合并）→ .agents/commands/deploy.md;L1 → .agents/commands/new-task.md §L1 快速道
+---
+
+<!-- 2026-11-08 档 2-F 四并一（原 plan/design/build/test.md），历史查 git -->
+
+L1 的立档、实现、验证与关单都在 `.agents/commands/new-task.md` §L1 快速道；本文件 Plan → Design → Build → Test 四章只服务 L2/L3 阶段流。L1 只在 Plan §1 发现已有同名在途档时打开对齐进度，然后回快速道。
+
+# Plan · L2/L3 立 intent
+
+级别已由 `new-task.md` 定；本章按级别分叉执行，禁重新定级。
+
+## 1. 准入与捷径
+**Input**: 用户需求原文 + 已定级别
+**Process**:
+1. **捷径检查（兼会话重入，session-context）**: L1 看 `workflow/plans/` 是否已有同名 plan；L2/L3 看 `workflow/intents/` 是否已有 approved intent。已有且**终态** → 按 `next` 跳；已有且**在途**（draft/approved，勾选≠完成）→ 这是重入不是新建：读 plan 勾选态和 `git status` 对齐后续作，禁另立新档。L1 回到快速道，不进 Build 章。
+2. **同类检索**: `node .agents/scripts/kb-search.mjs "<关键词>" --scope workflow --type intents,plans,specs` $\rightarrow$ 命中同类先读结论与验收
+**Output**: 确认无同类入口 / 已有 approved 入口
+
+## 3. L2/L3：起草 intent
+**Process**:
+1. **生成草稿**: `node .agents/scripts/fill-intent.mjs --module <模块> --level <L2|L3> --topic <主题> --output workflow/intents/<date>-<主题>.md --notes "<备注>"`
+2. **填实**: 背景与问题 / 历史教训防复发 / 目标 / 非目标 / 约束 / 影响面 / 触达红线 / 验收标准
+3. **红线核对**: 对照根 `AGENTS.md` 及目录级 `AGENTS.md`。没碰到不勾。
+**Output**: `workflow/intents/{name}.md` (Status: Draft)
+**Next**: Design 章
+
+## 4. 确认与落态
+**Process**:
+1. **HALT**: 输出草稿全文 $\rightarrow$ 等待用户确认
+2. **状态迁移**: $\text{draft} \rightarrow \text{approved}$（口径见 `new-task.md` 快速道第 4 步）
+3. **留痕提交**: L2/L3 立即 `docs(workflow)` 单独提交；**L1 单笔提交**——验证绿后连跳 done，plan(done)+代码+确认分片+凭证同笔入树，无独立关单提交（口径单源 `new-task.md` 快速道第 4/6 步）。
+**Next**: L1 $\rightarrow$ `.agents/commands/new-task.md` §L1 快速道 / L2,L3 $\rightarrow$ Design 章
+
+## 🚫 禁止项
+| 操作 | 机器行为 | 例外 |
+|---|---|---|
+| 硬填红线 | check-loop 判「红线判低」 | 必须实测触达才勾 |
+| 硬填判据 | 验收标准不可测试 | 想不清楚必须 HALT 澄清 |
+| 直改状态 | 状态迁移失效 | 必须通过 `confirm-doc` |
+
+## 🛠️ 辅助工具
+- **需求拷问**: `grilling` (答完回填 6 节)
+
+# Design · 起 spec
+
+## 1. 准入与级别判断
+**Input**: `workflow/intents/{name}.md` (Approved) 或已确认的 incident 草稿。级别为 L2 或 L3。
+**Process**:
+1. **L1 禁入本阶段**: 遇到 L1 $\rightarrow$ **HALT** $\rightarrow$ 回 `.agents/commands/new-task.md` §L1 快速道。本阶段只起草 L2/L3 spec
+2. **前置校验**: 若入口文档未过确认门 $\rightarrow$ **HALT** $\rightarrow$ 回 Plan 章 / `maintain.md` (exit 2)
+3. **级别判定** (对照 `new-task.md` 两问):
+   - **L2** (规则/契约): 必须起草 spec $\rightarrow$ **强制独立复核**（独立子智能体或新会话）
+   - **L3** (结构/Schema): 必须起草 spec $\rightarrow$ **强制独立复核**（同上，跨模型优先）
+**Output**: 确定的设计级别 (L2/L3)
+
+## 2. 起草 spec
+**Input**: 选定的级别 + 入口文档
+**必读输入（起草前完成，缺一即 HALT 回本节补读；对照结果落「约束遵守映射」与「假设与推断」）**:
+1. `wiki/INDEX.md` 检索本主题相关任务文档（产品需求 / 开发方案 / 项目规范 / 数据字典 / 用户功能）——命中即通读，依据以路径引用写进 spec 相关节（功能行为 / 数据流的口径来源）；无命中写明检索词与结论
+2. `backend/AGENTS.md` 全文（§6 硬约束 / §7 机器门清单）——**无论本次改动面是否触及后端**
+3. `frontend/AGENTS.md` 全文（门禁 G-2~G-3 / 契约规则 / 列表页状态规则）
+**Process**:
+0. **先查后建**: 同功能已有 spec（含归档）/ `verify-ui/features` $\rightarrow$ 原件修订不新建（单源 `workflow/README.md`「同功能续作」）
+1. **生成草稿**: 运行 `node .agents/scripts/fill-spec.mjs --level <L2|L3> --topic <主题> --output workflow/specs/<date>-<主题>.md`
+2. **填实内容**: 复制 `_TEMPLATE.md` $\rightarrow$ 填写 [功能行为 / 数据流 / 系统改动 / 约束遵守映射 / 风险评估]
+3. **约束核对**: 对照根 `AGENTS.md` 及目录级 `AGENTS.md` 红线逐条说明满足方式
+4. **交互确认**: 明确标注入口形态 (表单/选择器/弹窗)，禁自行推定
+5. **入口验证**: [前端专有] 搜按钮事件 $\rightarrow$ 追 router/Drawer $\rightarrow$ 定位真实渲染文件 $\rightarrow$ 在「系统改动清单」标注 **入口证据 (文件+行号)**
+6. **方案取舍**: 多方案时 $\rightarrow$ 列出 [方案对照表(取舍+建议)] $\rightarrow$ **HALT** $\rightarrow$ 用户选定。分叉真实且推理定不了（契约形状 / 数据流 / 性能取舍）时，先开 **2 路并行方案**（子代理各一方案，只读仓库、产物落对话或 `tmp/`，禁改仓库文件），按「方案 | 关键取舍 | 风险 | 证据」比选；2 路封顶，推理能定夺的不跑，不占实现面委派并发额度
+7. **歧义扫描**: 写「歧义清单」，6 维各一行——状态与边界 / 数据口径 / 失败路径 / 契约对称 / 存量数据 / 验收可测性。列序 `维度 | 结论 | 依据 | 状态`。
+   - 可实验 → 先实验，依据写实验结果，**禁问用户**。
+   - 实验定不了 → 状态写 `待澄清`，当轮问清。
+   - 上界：每维 ≤2 行、合计 ≤12、单轮问询 ≤5。
+   - 推断类结论 → 另记「假设与推断」。
+   - 缺节 / 缺维 / 待澄清 ≠ 0 / 依据空 / 超界 → 确认门拒。
+8. **前提质询**: 写「前提质询」表——列出 spec 立论的解读性前提（如「展示诉求 vs 存储改写」），逐条反问对立解读并写选定依据；无解读风险的小件写一行「无关键前提」+ 理由。缺节 / 空表 / 占位 / 缺反问或缺依据 → 确认门拒（锚 premiseSince 起；10-23 identity-overwrite 三层同源失效的堵口）
+**Output**: `workflow/specs/{name}.md` (Status: Draft)
+
+## 3. 独立复核 (L2/L3 强制)
+L2/L3 强制：委派 `independent-reviewer`；触发、形态、必填输入与落盘口径以 `.agents/roles/independent-reviewer.md`「复核口径」为准（本文不复述）
+**Output**: 复核未过 $\rightarrow$ 回 §2 改 spec
+
+## 4. 确认与落态
+**Process**:
+1. **HALT**: 输出 spec 全文 $\rightarrow$ 等待用户确认。确认前自查歧义清单与前提质询：待澄清归零、6 维齐、每行有依据、前提有反问有选定依据（不满足则落态被拒）
+2. **状态迁移**: $\text{draft} \rightarrow \text{approved}$
+3. **落态入口**: 运行 `node .agents/scripts/confirm-doc.mjs <path>`（口径见 `new-task.md` 快速道第 4 步，本文不复述）
+4. **留痕提交**: 立即 `docs(workflow)` 单独提交
+**Next**: Build 章
+
+## 🚫 禁止项
+| 操作 | 后果 / 机器行为 | 例外 |
+|---|---|---|
+| 路由认定入口 | → 整轮返工 | 必须提供文件+行号的实测证据 |
+| 自行推定交互 | → UI 与需求不符 | 必须由用户确认形态 |
+| L3 自查冒充 | `.agents/skills/shipyard-workflow-closeout/SKILL.md` §0.3 HALT。check-loop 对缺复核上下文只 WARN | 必须由 `independent-reviewer` 执行 |
+| 带着「待澄清」走确认门 | `confirm-doc` 拒（歧义未清，exit 2，不落盘不记账）；缺维 / 依据为空同样拒 | 先问用户拿判定再落态 |
+| 前提不经质询进事实源 | `confirm-doc` 拒（前提质询缺节 / 空 / 占位 / 缺反问或缺依据，exit 2） | 无解读风险须写「无关键前提」行并给理由 |
+| 把可实验项问用户 | 多一轮确认税，且答案本就跑得出来 | 先查库 / 跑 eval / 原型，依据写实验结论 |
+| 「已定」不写依据 | `confirm-doc` 拒（等于没想过） | 依据须可指认（节号 / 代码路径 / 查库结果） |
+| 跳过必读输入 / 约束映射缺 backend/frontend AGENTS 条目 | → 独立复核驳回返工（映射缺源视同未做约束核对） | 两份目录规范是全仓契约基准，与本次改动面无关；wiki 无命中可豁免第 1 项（须写明检索词） |
+
+# Build · 起 plan + 写代码
+
+L1 不在本章起草 plan，回 `.agents/commands/new-task.md` §L1 快速道第 4 步；本章只为 L2/L3 实现，或委派 implementer（§3）、处理偏离 plan。
+
+## 1. 起草 plan
+**Input**: `workflow/intents/{name}.md` (Approved) + `workflow/specs/{name}.md` (Approved)
+**Process**:
+1. **创建文档**: 复制 `_TEMPLATE.md` $\rightarrow$ `workflow/plans/{name}.md`，填写改动方案 / 任务拆解（每步带「文件」与判据）/ 执行顺序 / 验证计划
+2. **HALT**: 输出刚起草的 plan 全文 $\rightarrow$ 等待用户逐件确认。
+**Output**: `workflow/plans/{name}.md` (Status: Approved)
+**Gates**:
+- **确认门 (confirm-doc)**: $\text{draft} \rightarrow \text{approved}$（口径见 `new-task.md` 快速道第 4 步）
+- **依据**: `workflow/papercuts.md`
+
+## 2. 进计划模式列改动
+**Input**: `workflow/plans/{name}.md` (Approved)
+**Process**:
+1. **坑点检索**: `node .agents/scripts/kb-search.mjs --scope workflow --module <token> "<关键词>"` $\rightarrow$ 提取 incident 根因入自查项
+2. **列清单**: 明确 [读后改/新建] 文件清单 + [动作 $\rightarrow$ 对象] 执行步骤
+3. **同步审计**: 改动命中 `.agents/commands/` 或 `.agents/roles/` 时，正文只改权威源，宿主壳保持指针（见 §🛠️ 辅助与同步）
+4. **红线核对**: 对照根 `AGENTS.md` 及目录级 `AGENTS.md` 标注触达红线
+5. **生成全景 + 拉起看板**: 先 `node .agents/scripts/gen-dev-tour.mjs workflow/plans/{name}.md --strict` 过每步文件门（实现步骤缺 `- 文件：` 拒产；纯验证步骤标「验证步骤」），再 `node .agents/scripts/auto-tour.mjs workflow/plans/{name}.md` 拉起看板（幂等，失败只告警）。需要快照另跑 gen-dev-tour；核对「文档外实际改动」，越界先回填/回滚；口径见 dev-tour/SKILL.md。层兜底（直认 0）= 标题失约，规范后重生成
+6. **HALT**: 输出改动清单 $\rightarrow$ 等待用户确认
+**Output**: 确认的改动清单 $\rightarrow$ **回填 plan「改动面/任务拆解」落盘**（session-context：对话留痕仅供当次，重入以 plan 为准——改动面 + 任务勾选态 + git status = 会话重入三锚）。**落盘后重跑 `node .agents/scripts/auto-tour.mjs workflow/plans/{name}.md`**——真实目的是确保看板进程在跑（幂等，已在跑即复用）；在跑则实时页自动重绘（SSE 推送 + 5s 兜底轮询），落盘后的改动面自会进图
+
+## 3. 实现与自验
+**Input**: `workflow/plans/{name}.md` (Approved，含落盘的改动面与任务清单)
+**Process**:
+1. **会话重入**（压缩 / 新会话 / 交接续作必走）: 读 plan 任务清单勾选态 + `git status` / `git diff` 现场比对 $\rightarrow$ 重建进度再继续。勾选态与工作树不符（勾了未提交 / 提交了未勾）$\rightarrow$ 先对齐再写新代码；改动清单只在对话里时，以 plan 改动面 + 工作树为准并回填 plan
+2. **推进实现**: 按依赖执行任务——**frontier = 任务拆解中「依赖」行无未决阻塞的任务**，可并行派发（多 worktree 各自分支 / 委派「新开+合并范围」），纯顺序链即自上而下；**每完成一项立刻回填任务清单勾选与留痕**（commit SHA / 测试名 / 实测输出），并解锁依赖它的下游任务（每完成一项顺手刷新 `/tour?file=workflow/plans/{name}.md`，确认没有「文档外实际改动」）。满足 `.agents/roles/implementer.md` 边界时可委派 `implementer`（模型取 `model-roles.json`，本地覆盖优先，皆空 = 宿主默认）
+3. **架构约束**: 严禁自创旁路数据访问，必须遵循根/目录级 `AGENTS.md` 红线
+4. **L3 专项**: Schema 变更必须走项目约定维护方式，禁擅自引入迁移机制
+5. **变更管控**: 若需偏离 plan (改公共接口 / 动未列文件 / 引新依赖) $\rightarrow$ **HALT** $\rightarrow$ 确认后继续
+6. **自验闭环**: 运行 [项目构建 / 类型检查 / 自动化测试] (详见 Test 章 §1)；范围对账 `node .agents/scripts/check-scope.mjs workflow/plans/{name}.md`——越界件即收口（回填 plan 或回滚）；**L2/L3 关单前必须 `--strict` 通过**，L1 保持 advisory（推送时刻另有 check-scope-range 按 old..new 范围硬门兜底）
+**Output**: 实现的代码变更 + 自验通过证据
+
+## 4. 确认后收尾
+**Process**:
+1. **状态迁移**: plan 保持 `approved`，不在此置 `done`。关单在 Test 章 §5，经 confirm-doc 置 `done`。
+2. **提交留痕**: intent/spec 在 design 确认后单独 `docs(workflow)`。plan 确认后同样单独 `docs(workflow)`，不与代码同一提交。Conventional Commits 中文。
+3. **脚本化改写**：改 workflow 文档或台账用 `node .agents/scripts/rewrite-file.mjs <文件> --find <字面串> --replace <字面串>`。禁止 `node -e` 配 `writeFileSync`（CRLF 检出上会静默没改到还打印成功）。
+**Next**: Test 章
+
+## 🚫 禁止项
+| 操作 | 机器行为 | 例外 |
+|---|---|---|
+| 直改 frontmatter | 状态迁移失效 | 必须通过 `confirm-doc` |
+| draft $\rightarrow$ done | check-loop 15 拦截 | 必须经 approved 中转 |
+| 摘要确认 | confirm-doc 拒绝 | 必须全文过目 |
+
+## 🛠️ 辅助与同步
+- **宿主是指针壳**：改 `.agents/commands/` 或 `.agents/roles/` 不要把正文抄进 opencode / trae / codebuddy。壳只保留宿主 frontmatter，并写明权威路径。机器检查仅 check-loop hard 五段，不覆盖宿主壳；人工核对壳是否断线/过厚。
+- **改动面纪律**: plan 改动面列权威源路径。宿主壳未改就不要把 `wf-*.md` 写进改动面。
+- **自检**: 改 check-loop 后跑 `node .agents/scripts/check-loop.mjs`
+
+# Test · 静态门 + UI 实测
+
+本章留给 L2/L3、切库冒烟、flaky 和独立复核。
+
+## 1. 静态门 (Static Gates)
+**Input**: 待验证代码变更
+**Process**:
+1. **执行门禁**: `node .agents/scripts/verify.mjs`（档位口径以 verify.mjs 头注为准，本文不复述）。项目构建、测试、类型检查的命令清单单源是 `.agents/hooks/commit-check.config.json`。
+2. **故障处置**: 任一失败 $\rightarrow$ **HALT**。L1 回 `.agents/commands/new-task.md` 快速道第 5 步改代码。L2/L3 回 Build 章修复。偶发/跨层问题用 `diagnosing-bugs` 诊断。全量首跑红、隔离重跑转绿不算绿：按 flaky 立项（papercut/incident）后修复，禁以重跑绿直接关单。
+3. **档位按任务小类**: 纯文档/业务面 → 默认档（产品门按 diff 面裁）；跨面或发版前 → `--full`。引擎面无测试门，`*.test.mjs` 不入库不自动跑（2026-10-29 清库）；手动工具——合并语义探针 `node .agents/scripts/check-loop-rev-semantics.mjs`（FULL 模式末尾自动跑）。
+**Output**: 静态门全绿证据
+**Note**: 运行环境细节见 `.agents/notes/runtime-env.md` §1, §2；长门禁命令（verify 全量/`dotnet test`）**分段等 + 每段回报进度**，不阻塞到 timeout 上限——口径 §6.4「后台长任务取结果」
+
+## 2. 切库冒烟 (DB Smoke Test)
+**Trigger**: 改了项目数据库连接配置或新增目标库
+**Process**:
+1. **Schema 比对**: 目标库实际 Schema $\leftrightarrow$ 代码期望（近期变更脚本 + 基础表）
+2. **接口探活**: 运行冒烟脚本 $\rightarrow$ 验证 6 个核心端点 $\text{HTTP 200}$
+**Output**: 探活通过证据
+**Fact**: 探活脚本路径见 `.agents/notes/runtime-env.md` §6.1
+**Fail**: 任一非 200 $\rightarrow$ **HARD-BLOCK** $\rightarrow$ 停在此步，禁部署。
+
+## 3. UI 实测 (UI Verification)
+**Trigger**: 涉及前端改动 $\text{AND}$ 静态门已通过
+**Process**:
+1. **调用技能**: 使用 `.agents/skills/verify-ui/SKILL.md` 执行实测。
+2. **环境配置**: 详情见 `.agents/notes/runtime-env.md` §4 与 §6.3
+**Output**: UI 验证报告 (截图/DOM 证据)
+
+## 4. 独立复核 (Independent Review - L2/L3 强制)
+1. **委派复核**: 交 `independent-reviewer`（必附文首该角色的 `attach`，缺一项不派；本节场景=关单前独立复核）。触发、形态、评审包、落盘、意见级台账与跨模型口径以 `.agents/roles/independent-reviewer.md`「复核口径」为准（本文不复述）
+2. **评审定性**: 根据复核意见 $\rightarrow$ 采纳 $\rightarrow$ 回 Build 章修改 $\rightarrow$ 重跑本阶段
+**Output**: 复核结论 (Approved / Reject) + 意见级台账行；署名与落盘口径见 role「复核口径」
+
+## 5. 确认后关单 (Closure)
+L1 关单即 `.agents/commands/new-task.md` 快速道第 6 步的单笔提交（默认不开关单技能，仅 plan 独立关单场景打开——口径单源 new-task.md 第 6 步）；本节从 L2/L3 新需求和修复类起。
+**Process**:
+1. **验证与关单**: 按 `.agents/skills/shipyard-workflow-closeout/SKILL.md`。
+2. **验收勾验**:
+   - **L2/L3 新需求**: 逐条勾验 intent「验收标准」 $\rightarrow$ 补证据 $\rightarrow$ intent $\text{approved} \rightarrow \text{done}$
+   - **修复类**: 验证防复发落地 $\rightarrow$ incident $\text{open} \rightarrow \text{fixed} \rightarrow \text{closed}$
+3. **同族清理**: L2/L3 与修复类的同名 plan 一并置 `done`。不留 `approved` 孤儿。
+4. **留痕记录**: 委派任务记入 `workflow/delegations.md` 委派结果表；L2/L3 自做记入自做任务结果表。自做 L1 不写。写了行才跑 `node .agents/scripts/agg-delegations.mjs --write`。
+5. **顺事回灌（advisory）**: 有摩擦记 `workflow/papercuts.md`，没有就在关单回复写「无候选」。
+**Next**: L2/L3 $\rightarrow$ `.agents/commands/deploy.md`
+
+## 🚫 禁止项
+| 操作 | 机器行为 | 例外 |
+|---|---|---|
+| 顺手改代码 | 违反 Test 阶段定义 | 必须回 Build 章修复 $\rightarrow$ 重跑 Test |
+| 部分通过 | `ui-verifier` 报告阻塞 | 禁将部分通过项标记为已通过 |
+| 缺证据勾选 | check-loop 拦截 | 必须提供具体证据 (截图/SHA/Log) |

package/templates/engine/.agents/config/commit-msg-rules.json

@@ -0,0 +1,7 @@
+{
+  "_comment": "commit-msg 校验规则单源：.githooks/commit-msg（CJS）与 .agents/scripts/ci-commit-hygiene.mjs（ESM）共同 fs.readFileSync 消费——JSON 兼容两种模块体系，取最简（2026-11-05 自钩子内联正则抽出，复盘 P0 机器执法配套）。types = AGENTS.md「git提交」Conventional Commits 中文枚举；typeSuffix = 类型后须紧跟 ( 或 : 或 （；exemptPrefix = 真实 merge/revert 豁免（git 默认消息 Merge /Revert 与自定义小写 merge:/revert: 前缀；2026-11-06 补 git 自带 squash 模板首行 `Squashed commit of the following:`——`git merge --squash` 后直接提交时该行由 git 生成，非作者笔误）；收紧后不匹配任意 merge/revert 开头。改本文件 = 同时改两处执法面。planSlugRe（2026-11-09 增）= 任务短名在提交消息中的边界匹配模板（<slug> 占位符替换为 plan 文件名去 .md），消费方 .agents/hooks/check-commit-plan-ref.mjs。",
+  "types": ["feat", "fix", "docs", "style", "refactor", "perf", "chore"],
+  "typeSuffix": "(\\(|:|（)",
+  "exemptPrefix": "^(Merge |merge:|Revert |revert:|Squashed commit of the following:)",
+  "planSlugRe": "(^|[^A-Za-z0-9-])<slug>($|[^A-Za-z0-9-])"
+}

package/templates/engine/.agents/config/engine.json

@@ -0,0 +1,11 @@
+{
+  "policyVersion": 16,
+  "createdAt": "{{installedAt}}",
+  "options": {
+    "hosts": {{hostsJson}},
+    "stack": "{{stack}}",
+    "boardPort": "{{boardPort}}",
+    "language": "{{language}}"
+  },
+  "modelBaseline": "GLM-4.x"
+}

package/templates/engine/.agents/config/gate-budgets.json

@@ -0,0 +1,5 @@
+{
+  "fullMs": 240000,
+  "scopeMs": 120000,
+  "note": "墙钟预算（ms），advisory：超限只告警不阻断；连续两月超限由 owner 裁决降档/退役一门（一进一出）。fullMs 依据 workflow/metrics.md 2026-10 均值 217s + 余量；scopeMs 为增量关单目标。（flaky 隔离重跑已退役 2026-11-08 减重档 3-U1：近 30 天零触发；flaky 仍按人工立项处置，见 commands/stages.md。）"
+}

package/templates/engine/.agents/config/mechanism-registry.md

@@ -0,0 +1,62 @@
+# 机制使用量台账 (Mechanism Usage Registry)
+
+> 门禁棘轮的出口：每个门禁机制的「触发统计口径 + 退役阈值 + 状态」单源登记于此（格式人工对账，机器校验段 §22 已于 2026-10-28 随 hygiene 退役）。
+> **台账的目的不是记录而是强制处置**：新增机制须登记一行；
+> 机制退役当日删码 + 测试 + **删本表行**（同一提交，不留死代码不留已退役行，历史查 git）。
+> 列序固定：机制 | 门禁位置 | 触发统计口径 | 退役阈值 | 最近触发 | 状态 | 处置期限。
+> 段编号永不重编号（承重引用）。
+> 车道：仅 hard = §1 §3x §8 §15 §23（hygiene 16 段已于 2026-10-28 引擎减重第一刀全部退役）。
+> 分片（gate-metrics-shard）：判定流水月度分片 `workflow/gate-metrics.d/<YYYY-MM>.jsonl`（每月一行、多机并集），读侧本地 ∪ 分片取 max；pre-push 月检自动生成、随提交入库。
+> **现状**：本表全现役。zcode Bash 槽 owner 手动启用后 CLAIMS 全 true（见「接线宣称一致性」行）；engine-tests 全量不自动跑仅手动（手动探针 = 入库的 `check-loop-rev-semantics.mjs`）；pipeline-run 保留待用、不按零使用退役（登记在 `.agents/commands/pipeline-run.md` 头注）。当日增删流水见当日 git 提交。
+> **per-rule 计数口径**：judgments.jsonl 的 rule 名为剥 WARN/NOTE 前缀的归一名，级别以落账来源数组为准——判读与判定分离，标签只命名规则不改判定。
+> **机制类型标记**：状态列值后追加 —— `[检出型]` 0 命中即失效，适用零命中退役；`[健康静默]` 0 命中 = 当前无问题，不适用零命中退役（退役须由覆盖面失效或被取代触发）；`[不退役主干]` 机器判据/安全/状态机主干，永不退役；`[数据面]` 非门禁遥测，按「有数据月」对账。标记在第 6 列原样书写；解析内联于 `gen-engine-map.mjs`（2026-11-08 档 3 起，retire-watch 退役后仍单一解析点）。
+
+| 机制 | 门禁位置 | 触发统计口径 | 退役阈值 | 最近触发 | 状态 | 处置期限 |
+|---|---|---|---|---|---|---|
+| 三件套同名配对 | check-loop §1（**advisory**，2026-10-21 降档：自查已接线 closeout §0；红线判低与 L3 状态仍 hard） | 配对断裂 WARN 计数（月）；链内状态倒挂 WARN 计数（月） | 连续 6 月 = 0 → 评估退役 | 2026-10-11 建倒挂检测；2026-10-19 降 advisory；2026-10-21 撤出 pre-commit、hard→WARN、下沉 closeout §0 | 现役 [检出型] | 复评 2027-01-21 |
+| 证据真相核验 | check-loop §8 | hard「证据伪造/无关」计数 | 不退役（防伪主干） | 2026-10-09 豁免分类实证 | 现役 [不退役主干] | — |
+| 确认指纹配对 | check-loop §15（终态整篇绑定 + approved 档承诺面绑定，判据单源 stage-gates.commitmentFingerprint） | hard「指纹不配对」+ hard「承诺面漂移」计数 | 不退役（防伪造确认主干） | 2026-10 在用；10-27 补 approved 档承诺面绑定；归一规则与诚实边界见 stage-gates.mjs 头注 + closeout §0 第 4 项 | 现役 [不退役主干] | — |
+| 独立复核上下文标识 | check-loop §1（WARN「复核上下文缺失」计数（月）——复核行须含「复核上下文：<会话/子代理 id>」）+ closeout skill §0 第 3 项**流程内强制**（2026-10-21 起：L2/L3 关单缺复核上下文 → HALT 回 stages.md Test §4 不写 done） | WARN 命中计数（月） | 连续 6 月 = 0 → 评估退役 | 2026-10-11 建门（增量理由：独立性声明可证伪化，与确认指纹链同构的声明绑定缺口，无既有机制可并入）；2026-10-21 closeout 强制接线 | 现役 [检出型] | — |
+| 判据级收敛对账 | check-loop §23 | hard「收敛未覆盖」+ WARN「收敛无判据」计数（月） | 不退役（证据门主干；无判据表仍是 advisory） | 2026-10-11 建门；2026-10-11 证据无效升 hard（convergenceHardSince 2026-10-12） | 现役 [不退役主干] | — |
+| 触达面判低门 | check-lane-surface（verify.mjs lane-surface-ci 关单/CI 硬拦；2026-10-21 撤出 pre-commit） | hard「触达面判低/产品契约面」计数（--ci diff 面执法，done 亦算） | 不退役（级别闭环主干） | 2026-10-10 产品面分段；2026-10-19 gate-diet：pre-commit 实例降 advisory；2026-10-21 提交钩子不再起该进程，硬拦仍在 lane-surface-ci | 现役 [不退役主干] | — |
+| 密钥扫描门（gitleaks） | verify.mjs 安全段 `secrets-scan`（detect+基线；本地默认档**范围增量**：SECRETS_SCAN_BASE=绿行锚点、锚解析失败 loud 回退全量；`--full` 本地/CI main 重档保全量；缺装机 loud-skip 落绿行 envSkips 不作增量锚（防覆盖链空洞）；不自动安装） | 基线外拦截计数（月）+ 缺装机 loud-skip（月）+ 增量锚回退全量（月） | 不退役（安全主干） | 2026-10-14 建（基线 1227 处 owner 拍板）；2026-10-29 增量化 + 本地腿退役 + CI 收敛 main；appsettings 开发库凭据/JWT Secret 经 owner 判非风险不入扫描面 | 现役 [不退役主干] | 复评 2027-01-21 |
+| 门禁耗时埋点 | verify.mjs 逐门计时 → verifications.jsonl `durations` + `totalMs`（各门之和）+ `wallMs`（墙钟，2026-10-16 并行编排起落；metrics 门禁成本表取 wallMs 优先、旧行回退 totalMs） | 门禁成本/迭代 月均（metrics.md 门禁成本表消费） | G10 影响面裁剪判定出结果且连续两月无判读需求 → 评估退役（数据源性质，非门禁不拦提交） | 2026-10-14 建门（G8）；2026-10-16 加墙钟键（并行编排下 totalMs≠等待成本） | 现役 [健康静默] | — |
+| 常驻面体积预算 | rule-budget（verify 引擎段 --all 硬门；2026-10-28 退出 pre-commit；CI --all） | hard「常驻面超限」计数 | 不退役（膨胀防线——保障 token 在预算内，用户裁定属硬拦主干） | 2026-10-19 gate-diet 降 advisory 后同日恢复硬拦（用户裁定：体积预算保障 token 预算） | 现役 [不退役主干] | — |
+| incident 防复发证据门 | check-loop §3x | hard「回归证据缺失」计数（月） | 不退役（防复发主干） | 2026-10-09 建门 | 现役 [不退役主干] | — |
+| 回归清单执法者配对 | check-loop §29（锚 regrEnforcerSince 2026-11-12；存量不追溯，[prompt-only] 为合法显式声明） | hard「回归执法者缺失」计数（月） | 不退役（配对纪律主干） | 2026-11-11 建门（owner 拍板决策二；2026-11-10 审计 P1「168 条空执法者」补位——同日人工清零 + 170 条显式 prompt-only 后接线） | 现役 [不退役主干] | — |
+| 后端测试分档执法 | verify.mjs 默认档 backend-test `--unit-only`（owner 拍板「关单只跑单测」）+ .githooks/pre-push（2026-11-08 档 3 起默认单测档按影响面选测 `--unit-range`，映射缺失/后端生产面/空集回落全量 fail-open；集成档须 `PREPUSH_RUN_INTEGRATION=1` 显式触发，按 `test-impact-map.json` 选测）+ CI 重档全量兜底（先机检映射） | pre-push 集成档触发计数（月）+ 集成档拦截次数（月）+ 影响面选测命中/回落计数（月） | 被 CI 重档全面取代（本地推送消失）→ 评估退役 | 2026-10-29 建档（三档门禁配套，补齐「关单单测化后集成的执法点」）；11-08 档 3 影响面接线 | 现役 [不退役主干] | — |
+| 代码四门 CI 兜底 | verify.mjs product 段 code-architecture / code-audit-fields / code-delete-guard / code-notify-guard（--mid/--full 执法；本地增量档单边化跳过；audit-fields CI 形态用 CI_PUSH_BEFORE..HEAD 范围扫，存量不拦语义保持） | hard 拦截计数（月） | 不退役（架构红线主干） | 2026-11-11 接入（owner 拍板决策一；2026-11-10 审计 P2「--no-verify 远端零兜底」补位；pre-commit 保留为最早拦截点） | 现役 [不退役主干] | — |
+| 状态严格枚举 | check-loop §1/§3 | hard/WARN 计数（月） | 不退役（状态机主干） | 2026-10 在用 | 现役 [不退役主干] | — |
+| 产品契约面归因 | check-lane-surface product 段（verify.mjs lane-surface-ci 关单/CI 硬拦；2026-10-21 撤出 pre-commit） | hard「产品契约面无活跃入口」计数（--ci diff 面执法，done 亦算） | 不退役（产品面主干） | 2026-10-10 分段；2026-10-15 CI 协伴含归档件；2026-10-19 pre-commit 降 advisory；2026-10-21 提交钩子不再起该进程，硬拦仍在 lane-surface-ci | 现役 [不退役主干] | — |
+| 复核效果台账 | workflow/reviews.d/ 意见级处置（采纳/拒绝/误报）→ gen-workflow-metrics.mjs 月度聚合 | metrics.md「复核效果」表（采纳率/误报率；区分「门禁制造返工 vs 拦下问题」的信号源） | 连续 6 个有数据月零记录且 delegations 复核采纳行恒 0 → 评估退役（数据面非门禁） | 2026-10-16 建账（deep-research 建议1：野外评审 56.3% 拒绝率证明评审条数零信息量，本仓缺意见级处置信号） | 现役 [数据面] | — |
+| 评审黄金集校准 | `.agents/skills/review-method/golden-set.md`（25 条带答案盲评样本：正 15 / 负 10，含本仓上下文要点 + 月度留痕表） | 月度盲评比对独立复核结论与事后结果；双臂（A 载技能 / B 干净会话）+ 方差复跑（翻转计题面歧义）；命中差连续两月 >20% → papercuts 登记校准债 | 连续 6 个有数据月零盲评记录 → 评估退役（数据面非门禁） | 2026-10-16 建集；2026-10-21 首跑 A 臂 25 条（命中 24/误报 0/漏报 1，命中差 4%）；2026-11-08 B 臂 8 条（稳定 7 命中/0 误报，#13 判评分方差不计、题面已补保留字线索；Δ(A−B)=+4pp——校准力主要来自样本内联上下文） | 现役 [数据面] | — |
+| verify 增量关单（scope） | verify.mjs **默认档**（不带参数 = diff 面增量，`--full` 显式全量；恒跑面与产品重门裁剪口径单源 verify-scope.mjs；2026-11-08 档 1 减重：增量档恒裁产品 5 门单边化 CI（--full/--mid/--product 不变），新增 `--face` 显式面覆盖）；**24h 兜底**：最近全量绿行超 24h 或面解析失败 → 退回全量并打 ⏭️ | scope 绿行计数（月，末列 scope=diff）；skipped 非零即真实触发 | 连续 6 月 scope 绿行 = 0 → 评估退役 | 2026-10-21 建（fail-loud）；10-22 默认档化 + 24h 兜底 | 现役 [检出型] | — |
+| 委托引文接地 | confirm-doc 动作时刻（`--delegated` 落账前；非 check-loop 段） | 台账行 `quoteGrounding=ungrounded` 计数（月）；`--strict-quote` 下同为拒绝计数 | 连续 6 月 = 0 → 评估退役（或按信号升级为硬拦） | 2026-10-22 建（回放 873 行 17.9% 不接地，故 advisory 不硬拦） | 现役 [检出型] | 复评 2027-01-22 |
+| 告警聚合（输出降噪） | check-loop 输出层（`warn-format.mjs`；折叠开关 `CHECK_LOOP_VERBOSE=1` 可关；2026-11-08 档 2-G 起三类高频纯 WARN 默认静默、仅 VERBOSE=1 打印，judgments 落账与明细日志保留） | 折叠后 stderr 分组行数 vs 明细行数（`tmp/check-loop-warn.log`）；组数小于条数即折叠生效 | 不按零命中判退役（输出层非规则型）；退役判据 = 折叠致信息不可读或误并条目，owner 拍板 | 2026-10-22 建（实测 17 WARN+19 NOTE 淹没项；原单测随引擎测试面退役） | 现役 [健康静默] | — |
+| 门禁判定月度分片 | 手动 `agg-judgments --emit-month`（pre-push 月检已于 2026-10-28 退役；数据面，非门禁） | 分片月数 / 规则数（月）；`workflow/gate-metrics.d/<YYYY-MM>.jsonl`（每月一行，多机并集） | 连续 6 个有数据月零新增分片 → 评估退役（数据面非门禁） | 2026-10-22 建账（judgments.jsonl 本地台账换机/换树即归零，退役判据无燃料；读侧本地 ∪ 分片取 max） | 现役 [数据面] | — |
+| 本地门禁挂载自检（WARN 档） | verify.mjs 引擎段 `local-gate-config`（check-local-gate-config.mjs；判据与 check-local-gates ①-④ 对齐；CI/非 git loud-skip；--strict 升格开关） | WARN 缺配计数（月）+ --strict 阻断计数 | 连续 6 月 = 0 → 评估退役；升格 --strict 后由上岗自检入口吸收 | 2026-10-25 建门。增量理由：core.hooksPath 不随 clone 传播、漏配即门禁静默失效（事故实证）——本门补 verify 自动对质 | 现役 [检出型] | — |
+| 宿主写前门（写入拦截） | 宿主 PreToolUse(Edit\|Write\|MultiEdit)——`.agents/hooks/pre-write-check.cjs` 三层：①执法面自保护（清单单源 `WIRING_RE` + `--unlock` TTL）②台账 append-only ③红线快照-恢复（判据单源不复制）。**codebuddy 2026-11-11 接入；trae 无壳；PostToolUse 反馈腿已退役**；本机壳（qwen/qoder/zcode/commandcode）接线见 runtime-env.local | deny/提示计数（月，人工对账） | 被宿主原生「写前审批」能力取代 → 评估退役 | 2026-10-29 建（三层 deny 实证记 runtime-env §6.4）；2026-11-07 zcode 撤出跟踪（3f3082a4f）→ 本行改口径、CLAIMS 删两行。边界：Bash 重定向/sed 不经本门；pre-commit 四门同批条件化；11-08 post-edit 腿退役、CLAIMS 同步 | 现役 [检出型] | — |
+| 订单域文案与创建审计静态门（红线 6 + 审计 hook 扩展） | pre-commit 四门 + 写前门快照——`check-architecture.mjs` 红线 6（订单域 7 控制器：并发 catch 必用 `ApiMessages.DataStateInvalid`、禁旧字面量；库存/主数据口径豁免）+ `check-audit-fields.mjs`（新增 `CreatedBy/CreatedByJobNo/CreatedTime`，豁免 `CreationAuditExtensions` 单源写入器与 ICreationAudit 桥接） | 违例条数（命中即 fail，月人工对账） | 订单域文案/创建审计口径被架构收口取代 → 评估退役 | 2026-11-02 建（根因 incident 2026-11-02-mto-pml-review-defects-batch2，批 B 补静态执法） | 现役 [检出型] | — |
+| spec 前提质询门 | confirm-doc（stage-gates premiseGate，spec draft→approved 前置；锚 policy premiseSince 2026-10-30） | hard「前提未质询」计数（月） | 不退役（spec 事实源前提防线主干——歧义门拦「没想清」，本门拦「自信的想错」；无既有机制可并入，增量理由：10-23 三层同源失效的缺口不在任何既有门射程内） | 2026-10-29 建门（根因 incident 2026-10-23-pml-quota-substitute-identity-overwrite：展示诉求写成身份改写，测试按错前提固化期望） | 现役 [不退役主干] | — |
+| 接线宣称一致性（check-hook-wiring） | .githooks/pre-push（推送范围触宿主壳/.agents/hooks/registry 条件执行，实测 <1s）+ 手动——check-hook-wiring.mjs 的 CLAIMS 表 ↔ 宿主配置实态对账 | 漂移拦截计数（月，人工对账） | registry 各行接线信息改为机读结构（宣称随行携带）→ 评估退役 | 2026-10-29 建：引擎测试面退役后接线漂移无自动防线的补位（首跑产出即上行「轮询门修正」案例） | 现役 [检出型] | — |
+| 先确认后改代码 | .githooks/commit-msg 接线 `.agents/hooks/check-confirm-order.mjs`（暂存产品路径才跑；合并族跳过；2026-11-08 档 2-D 自 pre-commit 位移——pre-commit 看不到消息）。豁免 A：消息体非空 `L0:` 行且产品 ≤5 放行（judgments 落账 L0 计数）；豁免 B：覆盖 plan 与产品同批 staged（done 亦可，L1 单笔提交）放行 | hard「路径不在 approved plan 正文」拒绝计数 + L0 放行计数（月，人工对账） | 不退役（顺序红线主干。增量理由：确认指纹只核状态与承诺面，不核发生顺序；历史 done plan 仍不算覆盖，仅同批 staged 算） | 2026-11-03 建（incident 2026-11-03-po-pml-outbound-guards：实现提交先于三件套，check-loop 期间无阻塞） | 现役 [不退役主干] | — |
+| 提交信息卫生检出（ci-commit-hygiene） | azure-pipelines.yml ci-push-before 后无条件步（中/重两档）；区间三层——PR 构建取合并提交第一父（目标分支尖端）只判本 PR 新增提交、推送构建用 CI_PUSH_BEFORE、缺省退 HEAD~1（2026-11-05 build 29054 假红修正：changes API 基准会拉入目标侧存量提交）——枚举/正则单源 commit-msg-rules.json 与 .githooks/commit-msg 同判 | CI 红计数（违规笔数，检出型） | 连续 6 月 = 0 → 评估退役 | 2026-11-05 建（复盘 P0：钩子未挂/--no-verify 且消息违规 → CI 可见；不覆盖消息恰好合法的绕过） | 现役 [检出型] | 复评 2027-02-05 |
+| Dreaming 持续运行链路（dream-run 接线） | .githooks/post-commit（advisory 第三段，≥7 天提醒）+ `.agents/skills/dream/SKILL.md`（session-resume 装载、会话内执行）+ dream-run.mjs E2 阶段 | 冷数据候选数（agg-kb-usage --stale-days 90，月；kb-search 命中遥测 `.agents/cache/kb-usage.jsonl` 为数据源） | 不退役（Anthropic Dreaming 对照的记忆维护主干）；数据面按「有数据月」对账 | 2026-11-11 建（对照文章补接线：post-commit 7 天提醒 + 会话内执行链路 + kb-search 命中遥测 + E2 冷数据候选） | 现役 [数据面] | — |
+| PI 宿主门禁接线（本机私有） | .pi/extensions/shipyard-gates.ts（session_start 接线自检 + tool_call → pre-shell-check.cjs / pre-write-check.cjs，判据单源在 .agents/hooks/）；check-local-gates.mjs advisory 对账 4 必需文件 + project trust | 接线缺失 / trust 未检出的 WARN 计数（月，advisory 输出）；pi 会话 tool_call 门 deny 计数（gates.json 判据） | 不适用零命中退役（[健康静默]：0 命中 = 接线健康）；本仓不再使用 pi 宿主或宿主原生提供等价门禁 → 评估退役 | 2026-11-11 建门（P0 补 ctx_execute / ctx_batch 绕过口、createRequire 修 /reload CJS 缓存）；增量理由：.pi/ 不随 clone 传播，接线缺失时 session_start 自检随之消失，无外部防线 | 现役 [健康静默] | — |
+| Cline 宿主适配（本机私有） | .cline/workflows/wf-*.md（7 指针壳 → `.agents/commands/`）+ .cline/agents/*.yml（7 角色 → `.agents/roles/`）+ `.cline/hooks/PreToolUse.cjs`（命令门/写前门协议适配层 → pre-shell-check.cjs / pre-write-check.cjs）；权威源零改动 | check-local-gates.mjs advisory 对账（workflows+agents 壳 + hook 在位） | 不适用零命中退役（[健康静默]：未用 ≠ 失效）；弃用 → 评估退役 | 2026-11-11 建（Cline 原生读 `AGENTS.md` 与 `.agents/skills/`；hook 协议与仓库 CJS 不兼容，故建适配层，参照 `.pi/extensions/lib/gates-core.cjs` 同型映射） | 现役 [健康静默] | — |
+| Claude Code 宿主适配（本机私有） | `.claude/settings.json` PreToolUse 两门（`Bash` → pre-shell-check.cjs；`Write\|Edit\|MultiEdit` → pre-write-check.cjs）+ `.claude/commands/wf-*.md`（7 指针壳 → `.agents/commands/`）+ `.claude/agents/*.md`（7 角色 → `.agents/roles/`）；根 `CLAUDE.md` 为 AGENTS.md 镜像；权威源零改动 | check-local-gates.mjs ⑩ advisory 对账（settings 两门接线 + 7+7 壳） | 不适用零命中退役（[健康静默]：未用 ≠ 失效）；弃用 → 评估退役 | 2026-11-11 建（hook 协议与 Trae/CodeBuddy 同形；`.claude/` 与 CLAUDE.md gitignore 不随 clone）。增量理由：Claude 会话此前无宿主侧两门，仅 git 钩子兜底 | 现役 [健康静默] | — |
+
+## 维护纪律
+
+- **一进一出**：新增门禁机制必须同时在本表登记，并点名它替代/合并的既有机制（无替代则说明增量理由）。
+- **月度对账**：每月初按「触发统计口径」列刷新计数（半自动：`node .agents/scripts/agg-delegations.mjs` + `agg-judgments.mjs` 查判定流水 `.agents/judgments.jsonl`——check-loop 每次真实运行自动落账，2026-10-11 judgment-ledger 起替代人工 grep 输出；git log 统计口径不变）；
+  达到阈值的行改「待退役」并填处置期限。
+- **数据面机制的「现役」≠「有数据」**：复核效果台账与评审黄金集校准属数据面机制——黄金集已首跑（见该行），复核效果台账已有跑数（reviews.d 2026-10 起）。月度对账时须区分两件事：① 资产是否存在；② 本月是否产生数据并写进留痕面（未产生 → 该月记「无跑数」，连续 6 个有数据月零记录才走退役阈值，**年轻遥测不得制造假候选**，口径同 `agg-judgments --retire-candidates`）。黄金集盲评动作与双臂/方差复跑口径见 `.agents/skills/review-method/golden-set.md` 使用方法节。
+- **退役动作**：当日删除机制代码 + 其测试 + 本表该行，同一提交完成（不留死代码、不留已退役行，历史查 git）。
+- **体量三闸（2026-10-31 起）**：① 总量受 `rule-budgets.txt` 预算行约束（超限 verify 硬拦）；② 单行上限 `<N>#line` 机器执法（rule-budget，超标 pre-commit 硬拦——2026-10-31 上线，替代已退役的检查 22 人工纪律）；③ 行文纪律——「最近触发」只留「建门 → 关键降档 → 当前态」，细节留 git 史。**月度对账附瘦身步**：行超 `#line` 上限 80% 即时压；runtime-env 侧同纪律（已根治条目与退役机制行随确认提交删除、本机事实入 local.md、过程细节留提交信息，见该文件 §6 头注）。
+- **健康静默型不适用零命中退役**：状态列标 `[健康静默]` 的机制（如告警聚合、门禁耗时埋点等），其「0 命中」语义为「当前无问题」而非「机制失效」，**不适用**「连续 6 月 = 0 → 评估退役」判据；月度对账时仅记「无跑数」，不产生退役候选。此类机制的退役须由「覆盖面失效」或「被替代机制取代」触发，由 owner 裁决后走「退役动作」同一提交删码 + 表更新。
+- **模型代际触发（2026-10-16 立）**：每个机制都是对当前模型能力边界的假设，既有退役阈值只有使用维度、缺代际维度——主力模型**代际变更**（主版本号或模型家族更换，如 GLM-4.x → 5.x；小版本/推理档变更不算）后的**下一次月度对账**按下面分组逐件重评去留，结论写各机制「最近触发」列；重评本身不改状态列（退役仍走既有阈值）。分组按届时现役行归组（立法时点所列机制部分已退役）：
+  - **A · 纪律假设**（无机器检查时会跳步/声称未做之事）：观察新代际 WARN/hard 是否加速归零（是 → 走既有阈值）；**不因代际主动拆门**——判据已机器化、边际成本 ≈ 0。
+  - **B · 能力边界假设**（强度绑在当前模型短板上，**须主动重评**）：体积预算（长上下文增强 → 只重定上限不拆门）、复核上下文标识、触达面判低（观察判低命中率，连续零命中走既有阈值）。证据真相核验 + 密钥扫描属信任边界/安全主干：**代际不撤门**，只重评执行成本。
+  - **C · 机器判据**（纯确定性检查，代际免评）。**D · 宿主生态**（跟宿主版本走，宿主升级随 Adapter 检查顺带过）。**E · 测量自举**（数据面，代际只影响结论解释；测量结论标注代际见 delegations.md 口径注）。
+- **owner-fiat 复评惯例（2026-10-21 门禁极小化第 3 批 W5 立）**：凡 owner 裁决型退役/降档（非数据阈值驱动），状态保持现役并在「处置期限」列写「复评 YYYY-MM-DD」（建议 +3 月）——复评日期到期由月度对账人工催办（retire-watch 自动催办已随 2026-11-08 档 3 退役）；维持则顺延下一复评日，恢复则 revert 对应提交并回滚本表行。首个挂号称：2026-10-21 批（密钥本地不扫 / §1 配对降档 / §3 三件套降档 / §14 留痕降档），复评 2027-01-21。已退役（删码）行不挂——恢复走重新建门。

package/templates/engine/.agents/config/model-roles.json

@@ -0,0 +1,26 @@
+{
+  "version": 1,
+  "fallback": "host-default",
+  "localOverride": ".agents/config/model-roles.local.json",
+  "preSwapRegression": {
+    "cases": 3,
+    "basis": "workflow/delegations.md"
+  },
+  "roles": {
+    "code": {
+      "model": null,
+      "purpose": "实现 / 重构 / 机械改：优先低成本高吞吐",
+      "heterogeneous": false
+    },
+    "judgment": {
+      "model": null,
+      "purpose": "定级 / 根因 / 设计：优先强推理",
+      "heterogeneous": false
+    },
+    "review": {
+      "model": null,
+      "purpose": "独立复核：须与实现模型不同",
+      "heterogeneous": true
+    }
+  }
+}

package/templates/engine/.agents/config/model-roles.local.example.json

@@ -0,0 +1,7 @@
+{
+  "roles": {
+    "code": { "model": "<你的快模型 ID>" },
+    "judgment": { "model": "<你的强推理模型 ID>" },
+    "review": { "model": "<与实现不同的模型 ID>" }
+  }
+}

package/templates/engine/.agents/config/pr-review.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "pr-review/config@1",
+  "version": 1,
+  "mode": "enforce",
+  "promptVersion": "pr-review/v1",
+  "tmpDir": ".agents/tmp/pr-review",
+  "artifactDir": "workflow/reviews.d/artifacts",
+  "ledgerDir": "workflow/reviews.d",
+  "verifiersPerFinding": 1,
+  "modelRoles": {
+    "finder": "code",
+    "verifier": "review",
+    "adjudicator": "judgment"
+  },
+  "consensus": {
+    "importantConfirm": 2,
+    "nitConfirm": 1,
+    "escalateOnSingleImportantRepro": true
+  },
+  "limits": {
+    "maxFinders": 3,
+    "maxCandidates": 40,
+    "maxFilesPerLens": 40,
+    "maxDiffBytes": 2000000
+  },
+  "brief": {
+    "maxSliceBytes": 80000,
+    "maxBaseBytes": 50000,
+    "contextLines": 12,
+    "maxSliceFiles": 16,
+    "maxBaseFiles": 10
+  },
+  "lenses": {
+    "base": [
+      "correctness",
+      "spec"
+    ],
+    "extra": [
+      {
+        "id": "data-integrity",
+        "focus": "数据丢失、事务边界、幂等、并发写、迁移可逆、审计字段、删除引用检查",
+        "filePattern": "(^backend/|^tests/|\\.sql$|repository|service|migration|entity|dto)",
+        "note": "本仓业务面重点：后端/数据维护 SQL"
+      }
+    ]
+  },
+  "styleDrop": {
+    "categories": [
+      "style"
+    ],
+    "patterns": [
+      "^\\s*(格式|排版|空白|重命名|改个名字|注释措辞|import 顺序|style|format|whitespace)",
+      "^\\s*(建议|最好|可以)(把|将).*(改名|格式化|调整顺序)"
+    ],
+    "keepIfBehaviorImpact": true
+  },
+  "verifierEscalation": 0,
+  "fast": {
+    "lenses": ["correctness"],
+    "finderToolBudget": 8,
+    "finderWallBudgetSec": 150,
+    "verifierWallBudgetSec": 60,
+    "importantConfirm": 1,
+    "note": "fast 档契约见 .agents/scripts/pr-review.mjs 头注 fast 档节"
+  },
+  "_note": "2026-11-08 减重两档（owner 指示「评审耗时太长」）：U1 verifier 3 票 → 每候选默认 1 票。U2（档 3-U2）finder 面 6→3——保留 correctness/spec/data-integrity（条件），tests/performance 与 correctness 及 CI 门重叠、security 等其余 lens 一并裁撤；verifierEscalation 1→0，Important/P2 不再追加复核票——Nit 1 票 confirm 即确认，Important（P0/P1）1 票不足 importantConfirm=2 一律 escalated 进裁决复核，即复核仅由 P0 级发现物触发。恢复口径：lenses.base 调回全量、maxFinders 调回 6、verifierEscalation 调回 1。"
+}

package/templates/engine/.agents/config/principles.md

@@ -0,0 +1,32 @@
+# 纠偏短名索引
+
+> 用途：任务中途用短名纠偏，按指针去读权威原文。**本文件只放短名与指针，不复制规则正文**（正文单源在指针处）。
+> 用法：`用「删除优先」再看一遍` / `这步按「证明它能跑」走`。
+> 维护：只增删短名与指针；指针必须存在（原 principles.test.mjs 校验已随引擎测试面退役 2026-10-28，现为人工纪律），单元格不得塞正文。
+
+| 短名 | 何时报它 | 权威指针（单源） |
+|---|---|---|
+| 删除优先 | 想加抽象、开关或兼容层时 | `AGENTS.md` §3 最小改动；`.agents/skills/review-method/SKILL.md` 坏味道走查 |
+| 单源 | 同一事实要写第二处时 | `AGENTS.md` §3 单源纪律 |
+| 守卫上下文 | 准备把长输出贴回主线时 | `AGENTS.md` §3 上下文纪律 |
+| 证明它能跑 | 准备说「完成」时 | `.agents/commands/stages.md` Test §1 静态门、§3 UI 实测 |
+| 解释这个数 | 要引用测量值或性能结论时 | `.agents/skills/number-vetting/SKILL.md` |
+| 修根因 | 症状反复或准备加守卫时 | `.agents/commands/maintain.md` §2 结构性修复 |
+| 攻击前提 | 同一前提下两种修法都过不了同一道验证时 | `.agents/commands/maintain.md` §2 攻击前提 |
+| 先对齐再动手 | 接手、切 worktree、中断续作时 | `.agents/skills/session-resume/SKILL.md` |
+| 可验证单元 | 拆任务、拆提交时 | `.agents/commands/stages.md` Build §3 任务清单与自验 |
+| 规则要执法 | 新增规则或回归条目时 | `workflow/regression-checklist.md` 规则 7 规则-执法者配对 |
+| 先升层再写文 | 想靠「写一句规范」防复发时 | `.agents/skills/papercut-fix/SKILL.md` §0 落点阶梯 |
+| 不弱化旅程 | UI 实测前置条件缺失时 | `.agents/skills/verify-ui/SKILL.md`「禁为通过而弱化验证路径」 |
+| 边界收口 | 校验、异常、解析要散落到各处时 | `backend/AGENTS.md` §6 项目硬约束（数据完整性 / API 契约）；`frontend/AGENTS.md` §8 规则与门禁 BC 组 |
+| 可实验先跑 | 准备向用户提问前 | `.agents/commands/new-task.md` §1 提问分型 |
+| 模型按角色 | 委派实现或复核前 | `.agents/config/model-roles.json`；`.agents/commands/review.md` §执行流程 |
+| 爆炸半径 | 小改动但不确定还会碰坏什么时 | `.agents/skills/blast-radius/SKILL.md` |
+| 决策留痕 | 长跑/无人值守要留可复核轨迹时 | `.agents/skills/show-me-your-work/SKILL.md` |
+| 先问为什么 | 动手改一段不理解的代码前 | `.agents/skills/why/SKILL.md` |
+| 多镜拆解 | 复核要覆盖多个风险面时 | `.agents/skills/interrogate/SKILL.md` |
+| 盲评改动 | 技能/提示词改动要证据时 | `.agents/skills/eval/SKILL.md` |
+| 暂停留痕 | 长跑中断/离开前要可续时 | `.agents/skills/pause-safely/SKILL.md` |
+| 并行编排 | 设计选型或多切片覆盖时 | `.agents/skills/arena/SKILL.md` |
+| 门轻闭环 | 想新增门/机制、扩门耗时，或发现机制纸面零使用时（用户基线 2026-10-29：门禁不能重、要简化、流程要闭环） | `workflow/gate-cost.md`（当前态单源）；`.agents/config/mechanism-registry.md`（退役棘轮） |
+| 质量门兜底 | 后端改动要判断「有没有测试兜住 / 哪些方法该先补测试」时 | `.agents/skills/csharp-quality-gates/SKILL.md`（手动触发；CRAP／变异／重复三道门） |

package/templates/engine/.agents/config/workflow-enums.txt

@@ -0,0 +1,25 @@
+# workflow 文档枚举单源（2026-09-25 enum-single-source）
+# 本文件会被 core.autocrlf 检出为 CRLF——读取方显式去 \r（node parseEnums），禁止依赖行尾格式（rule-budgets.txt 同约定）。
+# 消费方：check-loop.mjs / workflow-board-server.mjs / kb-search.mjs / gen-workflow-index.mjs /
+#         fill-{intent,plan,spec}.mjs（均经 scripts/workflow-enums.mjs 读取器）——改枚举改这里，别改消费方。
+# 格式：key=value value value（空格分隔；# 注释行忽略；键重复 / 值重复 / 缺键 = 消费方 fail-loud）
+# 语义：doc = intent/spec/plan 三件；incident = 事故件。
+#   all       全生命周期状态
+#   confirmed 已确认（check-loop「状态未确认」放行口径 = 看板枚举告警口径）
+#   active    活跃（INDEX 活跃层 / kb-search 活跃 ×1.3 排序）
+#   terminal  终态（看板「入口已 done 而 plan 未终态」告警口径）
+#   abandoned 放弃留档（L3 确认三件豁免口径）
+doc.status.all=draft approved done superseded cancelled
+doc.status.confirmed=approved done superseded cancelled
+doc.status.active=draft approved
+doc.status.terminal=done superseded cancelled
+doc.status.abandoned=superseded cancelled
+incident.status.all=open fixed closed
+incident.status.active=open
+# 归因枚举（2026-10-11 incident-attribution）：incident frontmatter 的「来源:」/「影响环境:」（原由检查 24 校验，检查 24 已于 2026-10-28 退役，现为人工纪律）。
+#   source = 谁发现（self=AI 自查 / user=用户报出 / test=测试或实测暴露 / monitor=监控告警）
+#   env    = 缺陷触达的环境（none=未触达任何运行环境，如仅静态检查发现）
+# 锚前存量不回填（policy attributionSince）；新 open 件必填。
+incident.source.all=self user test monitor
+incident.env.all=dev staging prod none
+level.all=L0 L1 L2 L3