agentic-flow-kit 1.8.0 → 1.8.1

package/modules/hosts/claude/commands/wf-review.md

@@ -44,6 +44,6 @@ description: 代码评审标准（按风险分级：机器兜底 + AI 自查出
 ## 4. 审查分工（用户决策 + AI 协作）
 
 - **机器兜底**（pre-commit / pre-push / test 自动拦，无需人守）：门禁清单与判据以 `.githooks/`、`.agents/hooks/`、`check-loop.sh` 头部注释为准；`项目测试命令` 跑自动化用例。
-- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法参考 `code-review` 技能（Standards×Spec 双轴）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
+- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法走 `.agents/skills/review-method/SKILL.md`（Standards×Spec 双轴 + 坏味道走查 + 合入标尺；有全局 `code-review` 技能时可叠加）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
 - **独立性**：L2 / L3 必须用独立子智能体，宿主不支持时另开新会话，不得由原作者自查冒充；L1 且宿主不支持子智能体时可由主智能体按同一复核契约执行。
 - **用户决策**：问题定性（误报驳回 / P0 成立必修 / P1、P2 处置裁量）+ 合入时机；git 历史即评审记录，追溯靠 commit 与 tag。

package/modules/hosts/codex/commands/wf-review.md

@@ -44,6 +44,6 @@ description: 代码评审标准（按风险分级：机器兜底 + AI 自查出
 ## 4. 审查分工（用户决策 + AI 协作）
 
 - **机器兜底**（pre-commit / pre-push / test 自动拦，无需人守）：门禁清单与判据以 `.githooks/`、`.agents/hooks/`、`check-loop.sh` 头部注释为准；`项目测试命令` 跑自动化用例。
-- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法参考 `code-review` 技能（Standards×Spec 双轴）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
+- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法走 `.agents/skills/review-method/SKILL.md`（Standards×Spec 双轴 + 坏味道走查 + 合入标尺；有全局 `code-review` 技能时可叠加）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
 - **独立性**：L2 / L3 必须用独立子智能体，宿主不支持时另开新会话，不得由原作者自查冒充；L1 且宿主不支持子智能体时可由主智能体按同一复核契约执行。
 - **用户决策**：问题定性（误报驳回 / P0 成立必修 / P1、P2 处置裁量）+ 合入时机；git 历史即评审记录，追溯靠 commit 与 tag。

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

@@ -44,6 +44,6 @@ description: 代码评审标准（按风险分级：机器兜底 + AI 自查出
 ## 4. 审查分工（用户决策 + AI 协作）
 
 - **机器兜底**（pre-commit / pre-push / test 自动拦，无需人守）：门禁清单与判据以 `.githooks/`、`.agents/hooks/`、`check-loop.sh` 头部注释为准；`项目测试命令` 跑自动化用例。
-- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法参考 `code-review` 技能（Standards×Spec 双轴）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
+- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法走 `.agents/skills/review-method/SKILL.md`（Standards×Spec 双轴 + 坏味道走查 + 合入标尺；有全局 `code-review` 技能时可叠加）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
 - **独立性**：L2 / L3 必须用独立子智能体，宿主不支持时另开新会话，不得由原作者自查冒充；L1 且宿主不支持子智能体时可由主智能体按同一复核契约执行。
 - **用户决策**：问题定性（误报驳回 / P0 成立必修 / P1、P2 处置裁量）+ 合入时机；git 历史即评审记录，追溯靠 commit 与 tag。

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

@@ -44,6 +44,6 @@ description: Review · 代码评审（横切，合入前使用；P0/P1/P2 分级
 ## 4. 审查分工（用户决策 + AI 协作）
 
 - **机器兜底**（pre-commit / pre-push / test 自动拦，无需人守）：门禁清单与判据以 `.githooks/`、`.agents/hooks/`、`check-loop.sh` 头部注释为准；`项目测试命令` 跑自动化用例。
-- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法参考 `code-review` 技能（Standards×Spec 双轴）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
+- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法走 `.agents/skills/review-method/SKILL.md`（Standards×Spec 双轴 + 坏味道走查 + 合入标尺；有全局 `code-review` 技能时可叠加）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
 - **独立性**：L2 / L3 必须用独立子智能体，宿主不支持时另开新会话，不得由原作者自查冒充；L1 且宿主不支持子智能体时可由主智能体按同一复核契约执行。
 - **用户决策**：问题定性（误报驳回 / P0 成立必修 / P1、P2 处置裁量）+ 合入时机；git 历史即评审记录，追溯靠 commit 与 tag。

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

@@ -45,6 +45,6 @@ description: Review · 代码评审（横切，合入前使用；P0/P1/P2 分级
 ## 4. 审查分工（用户决策 + AI 协作）
 
 - **机器兜底**（pre-commit / pre-push / test 自动拦，无需人守）：门禁清单与判据以 `.githooks/`、`.agents/hooks/`、`check-loop.sh` 头部注释为准；`项目测试命令` 跑自动化用例。
-- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法参考 `code-review` 技能（Standards×Spec 双轴）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
+- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法走 `.agents/skills/review-method/SKILL.md`（Standards×Spec 双轴 + 坏味道走查 + 合入标尺；有全局 `code-review` 技能时可叠加）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
 - **独立性**：L2 / L3 必须用独立子智能体，宿主不支持时另开新会话，不得由原作者自查冒充；L1 且宿主不支持子智能体时可由主智能体按同一复核契约执行。
 - **用户决策**：问题定性（误报驳回 / P0 成立必修 / P1、P2 处置裁量）+ 合入时机；git 历史即评审记录，追溯靠 commit 与 tag。

package/package.json

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

package/templates/_agents/commands/review.md

@@ -57,6 +57,6 @@ next: .agents/commands/build.md（仅 P0 / P1 未清时；清零后经用户确
 ## 4. 审查分工（用户决策 + AI 协作）
 
 - **机器兜底**（pre-commit / pre-push / test 自动拦，无需人守）：门禁清单与判据以 `.githooks/`、`.agents/hooks/`、`check-loop.sh` 头部注释为准；`项目测试命令` 跑自动化用例。
-- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法参考 `code-review` 技能（Standards×Spec 双轴）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
+- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法走 `.agents/skills/review-method/SKILL.md`（Standards×Spec 双轴 + 坏味道走查 + 合入标尺；有全局 `code-review` 技能时可叠加）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
 - **独立性**：L2 / L3 必须用独立子智能体，宿主不支持时另开新会话，不得由原作者自查冒充；L1 且宿主不支持子智能体时可由主智能体按同一复核契约执行。
 - **用户决策**：问题定性（误报驳回 / P0 成立必修 / P1、P2 处置裁量）+ 合入时机；git 历史即评审记录，追溯靠 commit 与 tag。

package/templates/_agents/engine-lock.json

@@ -1,6 +1,6 @@
 {
   "schema": 1,
-  "generatedAt": "2026-10-14T02:35:42.200Z",
+  "generatedAt": "2026-10-15T16:47:55.700Z",
   "files": {
     ".github/workflows/ci.yml": {
       "sha256": "e9cffb90dec8f0a49bfe231a13fb8df375a2494cc75c38d991b5eb7c7be104b5",
@@ -87,7 +87,7 @@
       "hard": 0
     },
     "templates/_agents/scripts/check-prejudgment.mjs": {
-      "sha256": "8f83a97ed907441cdf7819e64282bd04f65588991c63b491404d62e5d2644bec",
+      "sha256": "050227917cc5e5e73a189b23ea7f5ff7b5633b5e265b33e153147409772f7936",
       "hard": 0
     },
     "templates/_agents/scripts/check-registry.mjs": {

package/templates/_agents/scripts/check-loop.test.mjs

@@ -3765,21 +3765,33 @@ w(T, 'workflow/intents/2026-09-12-deep.md', INTENT('deep', '状态: draft\n级
   check('检查25 预判 L2 落位 L1 → WARN「预判级别不符」含判低信号',
     r.status === 0 && outOf(r).includes('预判级别不符') && outOf(r).includes('判低信号'), `exit=${r.status}\n${outOf(r)}`);
   rmfix(T3);
-  // ④ 词表非法 kind / 整字段不可解析 → WARN「预判字段不可解析」
+  // ④ 词表非法 kind / 整字段不可解析 → WARN「预判字段不可解析」（夹具取 approved 活文档——终态 done
+  //   自 2026-10-15 起形态类告警跳过，见 ⑥）
   const T4 = mkfix();
-  w(T4, 'workflow/intents/2026-09-12-pj5.md', INTENT('pj5', '状态: done\n级别: L1\n日期: 2026-09-12\n预判: kind=bug level=L1', '\n## 验收标准（可测试）\n- [x] 用例通过（证据:fixture）\n'));
-  w(T4, 'workflow/plans/2026-09-12-pj5.md', PLAN('pj5', '状态: done\n级别: L1'));
+  w(T4, 'workflow/intents/2026-09-12-pj5.md', INTENT('pj5', '状态: approved\n级别: L1\n日期: 2026-09-12\n预判: kind=bug level=L1', '\n## 验收标准（可测试）\n- [x] 用例通过（证据:fixture）\n'));
+  w(T4, 'workflow/plans/2026-09-12-pj5.md', PLAN('pj5', '状态: draft\n级别: L1'));
   r = run(T4);
   check('检查25 kind=bug 不在词表 → WARN「预判字段不可解析」',
     r.status === 0 && outOf(r).includes('预判字段不可解析'), `exit=${r.status}\n${outOf(r)}`);
   rmfix(T4);
   const T5 = mkfix();
-  w(T5, 'workflow/intents/2026-09-12-pj6.md', INTENT('pj6', '状态: done\n级别: L1\n日期: 2026-09-12\n预判: 这是个修复', '\n## 验收标准（可测试）\n- [x] 用例通过（证据:fixture）\n'));
-  w(T5, 'workflow/plans/2026-09-12-pj6.md', PLAN('pj6', '状态: done\n级别: L1'));
+  w(T5, 'workflow/intents/2026-09-12-pj6.md', INTENT('pj6', '状态: approved\n级别: L1\n日期: 2026-09-12\n预判: 这是个修复', '\n## 验收标准（可测试）\n- [x] 用例通过（证据:fixture）\n'));
+  w(T5, 'workflow/plans/2026-09-12-pj6.md', PLAN('pj6', '状态: draft\n级别: L1'));
   r = run(T5);
   check('检查25 预判字段无 kv 形态 → WARN「预判字段不可解析」',
     r.status === 0 && outOf(r).includes('预判字段不可解析'), `exit=${r.status}\n${outOf(r)}`);
   rmfix(T5);
+  // ⑥ 终态跳过（2026-10-15）：done 文档词表/形态类告警不产——终态受检查 15 内容绑定不可修订，
+  //   WARN 永不可消（「不可消除噪声」红线）；类型/级别比对照常（level 一致；类型告警不在本断言面）
+  {
+    const T6 = mkfix();
+    w(T6, 'workflow/intents/2026-09-12-pj7.md', INTENT('pj7', '状态: done\n级别: L1\n日期: 2026-09-12\n预判: kind=bug level=L1', '\n## 验收标准（可测试）\n- [x] 用例通过（证据:fixture）\n'));
+    w(T6, 'workflow/plans/2026-09-12-pj7.md', PLAN('pj7', '状态: done\n级别: L1'));
+    r = run(T6);
+    check('检查25 终态 done 词表外 kind → 形态类告警不产（2026-10-15 终态跳过）',
+      r.status === 0 && !outOf(r).includes('预判字段不可解析'), `exit=${r.status}\n${outOf(r)}`);
+    rmfix(T6);
+  }
 }
 
 // ---- 检查 26：闭环漏斗「协议前」占比动作阈值（相邻两月均 >30% → WARN；消费 gen-workflow-metrics 产物）----

package/templates/_agents/scripts/check-prejudgment.mjs

@@ -29,16 +29,21 @@ export function run(ctx) {
       const pj = fmGet(abs, '预判');
       if (!pj) continue;
       const rel = `${WF}/${sub}/${f}`;
+      // 终态文档（2026-10-15）：形态/词表类告警跳过——终态受检查 15 内容绑定不可修订，此类 WARN 永不可
+      // 消（「不可消除噪声」红线）；类型/级别比对保留——那是路由审计的本体信号，灰度对账照常采集。
+      // （终态并集 = doc 终态 done/superseded/cancelled + incident 终态 fixed/closed——两侧枚举无单一键
+      // 覆盖该并集，故与源仓 s25 同款内联声明。）
+      const terminalDoc = ['done', 'superseded', 'cancelled', 'fixed', 'closed'].includes(fmGet(abs, '状态'));
       const kv = {};
       for (const m of pj.matchAll(/(kind|level)=([^\s]+)/g)) kv[m[1]] = m[2];
       if (!Object.keys(kv).length) {
-        warnings.push(`- [WARN 预判字段不可解析] 须形如「预判: kind=<kind> level=<L1|L2|L3>」:${rel}`);
+        if (!terminalDoc) warnings.push(`- [WARN 预判字段不可解析] 须形如「预判: kind=<kind> level=<L1|L2|L3>」:${rel}`);
         continue;
       }
-      if (kv.kind && !KINDS.includes(kv.kind)) {
+      if (kv.kind && !KINDS.includes(kv.kind) && !terminalDoc) {
         warnings.push(`- [WARN 预判字段不可解析] kind=${kv.kind} 不在词表（${KINDS.join('/')}）:${rel}`);
       }
-      if (kv.level && !inSet(kv.level, ENUMS['level.all'])) {
+      if (kv.level && !inSet(kv.level, ENUMS['level.all']) && !terminalDoc) {
         warnings.push(`- [WARN 预判字段不可解析] level=${kv.level} 不在枚举 level.all:${rel}`);
       }
       // 类型比对：intents ≡ require、incidents ≡ fix（plans/specs 两道共用，不判类型）

package/templates/_agents/skills/review-method/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: review-method
+description: 代码复核走查方法（Standards×Spec 双轴 + 坏味道清单 + 合入标尺）。供 independent-reviewer 或主智能体复核 diff 时使用；是 .agents/commands/review.md 执行流程的方法层单源，不依赖宿主全局技能。
+---
+
+# review-method — 复核走查方法
+
+## 定位与分工
+复核三层各自单源，本文件只管「怎么走查」：
+
+| 层 | 单源 |
+|---|---|
+| 拦什么（不变量） | `.agents/commands/review.md` P0/P1 表 |
+| 以什么身份查（证据纪律） | `.agents/roles/independent-reviewer.md` Constraints |
+| 怎么走查（本文件） | 双轴框架 + 坏味道清单 + 合入标尺 |
+
+宿主有全局 `code-review` / `review-verification-protocol` 技能时可叠加；无则本文件兜底。
+
+## 双轴框架（分轴报告，禁合并排序）
+| 轴 | 问的问题 | 依据 |
+|---|---|---|
+| **Standards** | 是否符合本仓成文标准 | 根/目录级 `AGENTS.md` + review.md P0/P1 表 |
+| **Spec** | 是否忠实实现入口文档承诺 | intent/plan「验收标准」+ spec §测试用例 |
+
+两轴独立成立：合规范但做错事（Standards 过、Spec 挂）与做对事但破规范（Spec 过、Standards 挂）都存在——分开报告防一轴掩盖另一轴。Spec 轴报三类发现：承诺缺失/部分落地、超范围（scope creep）、实现走样。
+
+## 坏味道走查清单（Standards 轴补充）
+P0/P1 表之外的判断项。约束：仓库成文标准优先（成文认可即压制本清单）；始终是判断项非硬违规；门禁/tooling 已拦的跳过。每条 = 是什么 $\rightarrow$ 怎么修：
+
+| 坏味道 | 是什么 $\rightarrow$ 怎么修 |
+|---|---|
+| Mysterious Name 神秘命名 | 名字不揭示用途 $\rightarrow$ 重命名；起不出诚实名字 = 设计混浊 |
+| Duplicated Code 重复代码 | 同形逻辑在多处出现 $\rightarrow$ 提取共享实现，两处调用 |
+| Feature Envy 依恋情结 | 方法够别家数据多过自己 $\rightarrow$ 把方法移到所依恋的数据上 |
+| Data Clumps 数据泥团 | 几个字段/参数总是结伴出行 $\rightarrow$ 捆成一个类型传递 |
+| Primitive Obsession 基本类型偏执 | 原始值顶替领域概念 $\rightarrow$ 为概念建专属小类型 |
+| Repeated Switches 重复开关 | 对同一类型的 switch/级联 if 反复出现 $\rightarrow$ 多态或共享映射 |
+| Shotgun Surgery 霰弹式修改 | 一个逻辑变更迫使多文件分散编辑 $\rightarrow$ 聚拢到同一模块 |
+| Divergent Change 发散式变化 | 一个模块因多个不相关原因被改 $\rightarrow$ 按单一变化理由拆分 |
+| Speculative Generality 投机泛化 | 为 spec 没有的需求加抽象/参数/钩子 $\rightarrow$ 删掉内联，等真实需求出现 |
+| Message Chains 消息链 | 长 `a.b().c().d()` 导航 $\rightarrow$ 在首对象上藏一个方法 |
+| Middle Man 中间人 | 类/函数几乎只做转发 $\rightarrow$ 删掉，直调真目标 |
+| Refused Bequest 拒绝继承 | 子类忽略/覆盖大部分继承物 $\rightarrow$ 弃继承改组合 |
+
+性能三项（P1 分页条款之外）：N+1 查询、无界取数/循环、热路径大对象。
+
+## 结构化修复动作
+报结构问题时给命名动作，禁只说「这里复杂」让作者猜：消条件链建类型/分发器、折叠重复分支、编排与业务分离、特性逻辑移回所属层、复用权威 helper 禁近亲复制、显式类型边界消下游分支、删无澄清价值的透传包装、抽 helper 或拆大文件。
+
+## 合入标尺（防 P2 纠缠）
+确定改善整体代码健康即建议合入，不因「不是我会这么写」而拦——完美不存在，持续改进是目标。样式偏好与假设性风险禁报（证据纪律见角色契约 Constraints）。
+
+## 出处
+- 双轴框架与坏味道清单：提炼自宿主全局 `code-review` 技能（Fowler《Refactoring》ch.3 基线）。
+- 结构化修复动作与合入标尺：借自 [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)（MIT）。