soloforge 1.1.46 → 1.1.47

package/templates/shared//345/274/200/345/217/221/350/200/205/345/256/252/346/263/225.md

@@ -1,67 +1,72 @@
 ---
-id: ka-pattern-developer_constitution
-kind: knowledge
+id: ka-guidance-开发者宪法
+kind: guidance
 title: 开发者宪法
-sync_policy: internal
+sync_policy: copy_to_project
 status: active
+triggers:
+  - 架构
+  - 决策
+  - 审查
+  - 审计
+  - 签署
+  - 确认
+  - 变更
+  - 发布
+  - 上线
+  - 危险操作
+  - 删除
+  - 重构
+  - 迁移
+  - 灰度
 extra:
-  name: developer_constitution
+  name: developer-constitution
   scope:
     - '*'
   products:
     - '*'
+  type: constraint
   lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   verification_layer: L2
   stage: _global
-  owner_mechanism: mc-engine-runtime
+  owner_mechanism: mc-decision-sovereignty
 ---
 
-## 决策规则
+# 开发者宪法
 
-- 我是唯一的架构主权者，AI 的建议不代表最终正确
-- 严禁静默交付: 所有 GRAY_BOX 和 BLACK_BOX 级代码审查变更禁止跳过人工确认
-- 人工签署格式: [Human-Audit: APPROVED] 或 [Human-Audit: REJECTED]
-- 未获得签署的 GRAY/BLACK 变更不得标记为"验证通过"
-- 系统随机抽检人类审计真实性: 基于任务摘要生成是/否问题
-- 抽检频率: 每 5 次交付至少抽检 1 次
-- 抽检问题格式: "任务 {task_id} 的变更中，{摘要细节} 是否为 [是/否]？"
-- 人类答错时标记该交付为"待重新审计"
+> 用户是唯一的架构主权者。AI 的建议不代表最终正确。
+> 注意：本宪法原为 knowledge 类（不注入），现改为 guidance 类以保证每次都注入。
 
-## 逻辑奇点警告触发条件
+## 决策主权
 
-- LLM Gateway 返回 circuit_open = true
-- 单任务 Token 超过阈值，remaining_task_budget <= 0
-- 验证 3 次重试仍失败
-- 变异审计发现测试"自己证明自己"且覆盖率联动显示 0% 覆盖
-- 知识漂移 drift_ratio >= 0.5 且根因分析为 code_degradation
+- 用户是唯一的架构主权者，AI 的建议不代表最终正确
+- 重大技术决策须经用户确认，AI 不得自行拍板架构级选型
+- 跳过决策研讨须用户明确声明，AI 不得自行跳过
+- 每条架构决策须有对应记录，禁止口头决策不留痕
 
-## 验收项
+## 禁止静默交付
 
-- [AC-01] GRAY/BLACK 变更展示后等待人类签署
-- [AC-02] 未签署的变更无法推进状态记录
-- [AC-03] 抽检问题基于实际任务摘要生成
-- [AC-04] 逻辑奇点警告以 ⚠ 符号开头并包含具体触发原因
-- [AC-05] core/ 目录下的规则修改需人工签署双重确认
+- 所有 GRAY_BOX 和 BLACK_BOX 级代码审查变更禁止跳过人工确认
+- 人工签署格式：`[Human-Audit: APPROVED]` 或 `[Human-Audit: REJECTED]`
+- 未获签署的 GRAY/BLACK 变更不得标记为「验证通过」
 
-## 何时使用
+## 抽检机制
 
-advisory: 开发者主权的审查建议不 hard block 交付
+- 系统随机抽检人类审计真实性：基于任务摘要生成是/否问题
+- 抽检频率：每 5 次交付至少抽检 1 次
+- 抽检问题格式：`任务 {task_id} 的变更中，{摘要细节} 是否为 [是/否]？`
+- 人类答错时标记该交付为「待重新审计」
 
-## 是否 hard block
+## 敏感操作必须停下确认
 
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
+涉及以下时必须停下等用户确认，不得自作主张：
+- 金额算法 / 状态流转 / 审批规则 / 跨系统同步
+- 破坏性操作（删数据、改 schema、清表、删文件）
+- 外部副作用（发请求、部署、付款、发通知）
+- 权限变更、密钥操作
 
-## 证据要求
+## 与其他规则的关系
 
-- preDeliveryReview 测试通过
-- veto 逻辑测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 治理运行时 + 人工确认
+证据冲突时的处理见 [[证据驱动与反幻觉]]。门禁失败的人工介入见 [[反馈修复闭环]]。

package/templates/shared//346/234/272/345/210/266/350/257/264/346/230/216.md

@@ -0,0 +1,67 @@
+---
+id: ka-knowledge-机制说明
+kind: knowledge
+title: 机制说明
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 机制
+  - 门禁
+  - gate
+  - artifact
+  - guidance
+  - 注入
+  - sf_work
+  - sf_knowledge
+  - 工具
+  - 阶段
+extra:
+  name: mechanism-reference
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: knowledge
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-engine-runtime
+---
+
+# SoloForge 机制说明
+
+> 供查阅：SoloForge 怎么把知识/门禁/反馈给到 AI。
+> 运行时核心用法已散在各 guidance（[[工程执行总纲]]/[[反馈修复闭环]] 等）。
+> 注意：knowledge 类**不注入运行时 prompt**，只供 sf_knowledge 搜索查阅。
+
+## 四类资产怎么被消费
+
+| kind | 怎么被消费 | 触发条件 |
+|------|-----------|---------|
+| artifact | AI 按模板骨架产出对应文档 | 用户选 target（产物 kind）时必注入 |
+| guidance | 按 triggers 关键词匹配，全文注入 prompt | intent 含 triggers 或 target_artifact 匹配 |
+| enforced | 按 check.gate 聚合成门禁，确定性 executor 执行 | 该域 verify 时执行 |
+| knowledge | sf_knowledge 索引搜索 | **不注入运行时 prompt**，仅搜索查阅 |
+
+## 四阶段流转
+
+`design`（需求+设计）→ `build`（实现）→ `verify`（测试）→ `operate`（运维）
+
+- 跳转受白名单约束（正向 design→build→verify→operate，合法回退 build→design 等）
+- 跨两级非法（如 operate→design 被拒）
+- 同对域来回打转 >3 次 → escalate
+
+## 门禁与反馈闭环
+
+- 每域一个 `*-gate`，由该域 enforced.md 的 checks 聚合
+- verify 失败 → 生成 findings + recovery_summary → 注入回 AI → 修后重验 → 重试 5 次 escalate
+- 修复流程详见 [[反馈修复闭环]]
+
+## 当前限制（线 B 待办）
+
+用户自定义资产目前：
+- sf_knowledge add 的知识 → 可被索引搜索 ✓
+- 用户放的 enforced/guidance → **暂不进门禁/注入** ✗（下一步线 B 打通扫描范围）
+- domain contract 的产物清单 → **不可由用户扩展** ✗（TS 硬编码）

package/templates/shared//350/257/201/346/215/256/351/251/261/345/212/250/344/270/216/345/217/215/345/271/273/350/247/211.md

@@ -1,10 +1,23 @@
 ---
-id: ka-hard-rule-证据驱动与反幻觉规则
+id: ka-guidance-证据驱动与反幻觉
 kind: guidance
 title: 证据驱动与反幻觉
-owner_mechanism: mc-evidence-grounding
 sync_policy: copy_to_project
 status: active
+triggers:
+  - 架构选型
+  - 技术决策
+  - 代码重构
+  - 方案评估
+  - 风险评估
+  - 事实核查
+  - 证据验证
+  - 验证
+  - 测试
+  - 发布
+  - 完成
+  - 通过
+  - 确认
 extra:
   name: evidence-driven-anti-hallucination
   scope:
@@ -13,21 +26,14 @@ extra:
     - '*'
   type: constraint
   lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   verification_layer: L2
   stage: _global
-triggers:
-  - 架构选型
-  - 技术决策
-  - 代码重构
-  - 方案评估
-  - 风险评估
-  - 事实核查
-  - 证据验证
+  owner_mechanism: mc-evidence-grounding
 ---
 
-# 证据驱动与反幻觉规则
+# 证据驱动与反幻觉
 
 ## 硬规则
 
@@ -44,10 +50,10 @@ triggers:
 
 ## 风险分级
 
-- **critical**: 发布门禁、生产环境、安全相关 → 任何证据缺失必须阻断
-- **high**: 架构、编码、迁移、验证 → 事实声明必须有权威证据
-- **medium**: 普通功能开发 → 关键声明需要证据
-- **low**: 通用问答、低风险操作 → 可标注为通用建议
+- **critical**：发布门禁、生产环境、安全相关 → 任何证据缺失必须阻断
+- **high**：架构、编码、迁移、验证 → 事实声明必须有权威证据
+- **medium**：普通功能开发 → 关键声明需要证据
+- **low**：通用问答、低风险操作 → 可标注为通用建议
 
 ## 检查项
 
@@ -58,3 +64,7 @@ triggers:
 - [ ] 高风险声明未用 stale/deprecated 证据
 - [ ] 验证结论基于真实执行结果
 - [ ] 生成的推理未单独支撑事实
+
+## 与其他规则的关系
+
+验证失败的修复流程见 [[反馈修复闭环]]。技术决策的确认要求见 [[开发者宪法]]。

package/templates/shared//350/264/241/347/214/256/350/247/204/350/214/203.md

@@ -0,0 +1,78 @@
+---
+id: ka-knowledge-贡献规范
+kind: knowledge
+title: 模板贡献规范
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 贡献
+  - 新增模板
+  - frontmatter
+  - 新增规则
+  - 新增知识
+  - 软下限
+  - 硬下限
+extra:
+  name: contribution-guide
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: knowledge
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-registry-infrastructure
+---
+
+# 模板贡献规范
+
+> 给未来维护者（含 AI 维护者）：怎么新增/修改 md 资产。
+> SoloForge 由 AI 维护，必须简单、数据驱动、配置扩展。参见 [[机制说明]]。
+
+## frontmatter 必填四件套
+
+每个 md 必须有：
+- `id`（全局唯一）
+- `kind`（artifact / guidance / enforced / knowledge）
+- `sync_policy`（copy_to_project / engine_only / internal）
+- `status`（active / retired）
+
+## 选 kind 的判断
+
+| 想达到的效果 | 用什么 kind | 关键要求 |
+|-------------|------------|---------|
+| AI 产出某个文档的骨架 | artifact | 放对应域目录 |
+| 注入 AI prompt 的方法论/纪律 | guidance | **必须有非空 triggers，否则永不注入=僵尸** |
+| 确定性门禁检查 | enforced | **必须有 gate + 非空 checks** |
+| 只供搜索查阅的参考 | knowledge | 注意：**不注入运行时 prompt** |
+
+## 软下限 vs 硬下限
+
+- **软下限 = guidance**：注入指导，不阻断。靠 triggers 匹配 intent 注入。
+- **硬下限 = enforced**：门禁检查，阻断。靠 check.gate 聚合到 *-gate 执行。
+
+新增硬下限注意：
+- check 的 `executor` 必须是已注册的（`regex_pattern_scan` / `document_structure` / `semantic`）
+- 未注册 executor → fail-closed 判失败
+- `regex_pattern_scan` 按行扫、不区分注释，容易误报，先想好是否该 warning 级
+
+## 避坑清单
+
+- guidance 没 triggers = 僵尸文件
+- enforced 没 gate/checks = 僵尸文件
+- knowledge 写成核心纪律 = 白写（不注入），核心纪律用 guidance
+- 不要造同义字段，新增字段先查 frontmatter 字段字典
+- artifact 改名要同步 domain contract 的 produces 和 CROSS_VALIDATION_ARTIFACT_PATHS 映射
+
+## 用户自定义资产（线B 已落地）
+
+用户在 `.soloforge/knowledge/`（项目级）或 `~/.soloforge/patterns/`（全局级）放 md（frontmatter 同内置格式），SoloForge 自动按 kind 分流：
+- `kind: guidance` → loadGuidance 注入 prompt（软下限，按 triggers 匹配 intent）
+- `kind: enforced` → gate 聚合执行（硬下限，按 `check.gate` 归属到对应 *-gate）
+- `kind: knowledge` → sf_knowledge 索引搜索
+- `kind: artifact` → 用户 artifact md 用 `artifact_contract` 块声明 `domain`/`artifact_kind`/`path_pattern`/`gate`/`required`，自动并入对应域 contract produces（AI 可选 target 产出，observer 列 pending）；模板按文件名在 .soloforge/knowledge/ 加载
+
+**内置优先**：同 id 用户资产不覆盖内置。规则文件 `rule_source` 用绝对路径定位（executor resolve 兼容用户目录）。

package/templates/verify/enforced.md

@@ -5,6 +5,8 @@ gate: verify-gate
 title: verify阶段强制检查清单
 sync_policy: engine_only
 status: active
+extra:
+  owner_mechanism: mc-stage-gate-engine
 checks:
   - id: SOLID-DIP
     executor: regex_pattern_scan
@@ -343,6 +345,7 @@ checks:
     rule: "主链路集成检查：所有模块为 integrated 状态，无孤岛模块；部署决策必须经人类审批"
     severity: error
     check_type: deterministic
+    required_artifact: 代码审查报告模版
     evidence_required: ["0 implemented_not_integrated + 无孤岛模块","人类审批记录（审批人/时间/决策）"]
     gate: verify-gate
     target: "self"

package/templates/verify//344/272/244/344/273/230/345/256/214/345/244/207/346/200/247/345/256/241/346/237/245.md

@@ -1,5 +1,5 @@
 ---
-id: ka-review-rule-交付完备性审查规则
+id: ka-guidance-交付完备性审查
 kind: guidance
 title: 交付完备性审查
 sync_policy: copy_to_project
@@ -9,109 +9,67 @@ triggers:
   - review
   - 交付检查
   - 上线前检查
-  - 提交检查
+  - 提测
+  - 交付完备
   - 终局宣言
+  - 完成检查
+  - 交付
+target_artifact:
+  - review_report
 extra:
   name: delivery-completeness
-  type: constraint
   scope:
-    - backend
-    - frontend
+    - '*'
   products:
     - '*'
+  type: constraint
   lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain: verify
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   verification_layer: L2
   stage: verify
+  domain: verify
   owner_mechanism: mc-generic-review
 ---
 
-## DEL-01: 交付物缺少终局宣言签名
-pattern: /SoloForge Audit: PASS/
-severity: error
-check_type: deterministic
-scope: [backend, frontend]
-description: 所有交付物末尾必须包含 [SoloForge Audit: PASS - 已通过三重深度推演，确认无潜在隐患]。缺少此签名的交付视为无效
-evidence_required:
-  - "交付物文件路径"
-  - "终局宣言签名存在确认"
+# 交付完备性审查：交付前必查清单
+
+> 这是"最小交付偏差 + 逼证据"的总裁决。交付前逐项核对，缺一不算交付完成。
+> 注入到代码审查报告（review_report）产出时。
+
+## 一、最小偏差（交付 = 需求）
+
+- [ ] 每条需求 REQ 有对应实现，且实现行为符合需求
+- [ ] 交付内容不超出需求范围（无多余功能，[[工程执行总纲]] 精准修改）
+- [ ] 根本目标（fundamental_need）已达成，非只完成表面功能
+
+## 二、证据充分（逼证据）
+
+- [ ] 验证基于真实执行（E1+ 运行时证据），非静态分析/AI 摘要（[[证据驱动与反幻觉]] 第 5 条）
+- [ ] 验收覆盖正常/异常/边界/权限四类（适用时含并发）
+- [ ] 测试全绿，增量覆盖率达标
+- [ ] 无"未验证项"被假装通过
 
-## DEL-02: 验收项缺少边界值覆盖
-pattern: //
-severity: warning
-check_type: deterministic
-scope: [backend, frontend]
-description: 验收项应覆盖空值(null/undefined)、极端值(MAX_VALUE/空字符串)、异常输入场景，而非仅 happy path
-evidence_required:
-  - "验收项列表"
-  - "边界值覆盖统计"
+## 三、无半成品（逼质量）
 
-## DEL-03: 涉及外部调用但无异常处理验收
-pattern: /(?:feign|http|restTemplate|webClient|fetch|axios)\s*\(/i
-severity: warning
-check_type: deterministic
-scope: [backend, frontend]
-description: 涉及外部 HTTP 调用的代码必须有超时、异常格式、降级场景的验收覆盖
-evidence_required:
-  - "外部调用点列表"
-  - "异常处理验收覆盖确认"
+- [ ] 无 TODO 占位、空函数体、空 catch（build-gate BLD-G02）
+- [ ] 无未接入主链路的孤岛代码（VRF-G06）
+- [ ] 错误路径都有处理，非只 happy path
 
-## DEL-04: 涉及状态变更但无事务/幂等验收
-pattern: /(?:@Transactional|save\(|insert\(|update\(|delete\()/i
-severity: warning
-check_type: deterministic
-scope: backend
-description: 涉及数据库状态变更的代码必须有事务一致性、幂等性验收覆盖
-evidence_required:
-  - "状态变更操作列表"
-  - "事务/幂等验收确认"
+## 四、人工审计（逼安全/质量）
 
-## DEL-05: 测试断言精度不足（疑似自己证明自己）
-pattern: /(?:toBeTruthy|toBeFalsy|toBeDefined|toBeUndefined|toBeDefined)\s*\(/
-severity: info
-check_type: deterministic
-scope: [backend, frontend]
-description: 大量使用模糊断言(toBeTruthy等)视为测试有效性风险，必须补充精确断言(toBe/toEqual/toThrow)
-evidence_required:
-  - "模糊断言使用统计"
+- [ ] 黑盒信任级发现项已人类签署 `[Human-Audit: APPROVED]`（[[开发者宪法]]）
+- [ ] 敏感操作（金额/状态/审批/跨系统）经用户确认
+- [ ] 无静默变更（GRAY/BLACK 级变更未跳过确认）
 
-## SEL-01: 技术选型无行业基准支撑
-pattern: //
-severity: error
-check_type: deterministic
-scope: [backend, frontend]
-description: 技术选型必须检索至少 3 个行业标准方案（结合通用知识 + sf_knowledge 项目沉淀）。禁止凭空推荐方案
-evidence_required:
-  - "技术选型记录路径"
-  - "行业基准检索结果路径"
-  - "对比方案数（须≥3）"
+## 五、可回滚（逼安全）
 
-## SEL-02: 推荐方案未说明致命缺点规避策略
-pattern: //
-severity: warning
-check_type: semantic
-scope: [backend, frontend]
-description: 最优解宣誓必须明确说明如何规避其他方案的致命缺点。无规避说明视为不完整选型
-evidence_required:
-  - "推荐方案致命缺点列表"
-  - "规避策略说明"
+- [ ] 有回滚方案（DDL/配置/代码变更可回滚）
+- [ ] 数据迁移有回滚脚本且验证过
 
-## TRA-01: 审查发现未按信任分级路由
-pattern: //
-severity: info
-check_type: semantic
-scope: [backend, frontend]
-description: sf_work action=verify 结果应按白盒(可跳过)/灰盒(建议审查)/黑盒(强制审查)三级分类展示，禁止平铺所有发现
-evidence_required:
-  - "信任分级统计（白盒/灰盒/黑盒项数）"
+## 禁止
 
-## TRA-02: 审查报告缺少认知透明度标注
-pattern: //
-severity: info
-check_type: semantic
-scope: [backend, frontend]
-description: 审查结果应标注熔断触发状态、变异检测结果、漂移检测结果，确保人类能看到系统内部决策
-evidence_required:
-  - "认知透明度标注内容"
+- 没验证就说"通过"（违规）
+- 隐藏未验证项（违规）
+- 黑盒项跳过人工签署（违规）
+- 无回滚方案就交付（违规）

package/templates/verify//344/273/243/347/240/201/345/256/241/346/237/245/346/212/245/345/221/212.md

@@ -13,8 +13,15 @@ extra:
   lifecycle_status: active
   stage: verify
   owner_mechanism: mc-generic-artifact
+  products:
+    - '*'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
 ---
 
+> **产物定位**：verify 阶段必出。代码审查的最终裁决——发现项按严重度分级，黑盒项须人类签署。
+> **核心纪律**：审查 Agent 与编码 Agent 须独立（[[证据驱动与反幻觉]]）；黑盒项未经 `[Human-Audit: APPROVED]` 不得判通过（[[开发者宪法]]）。
+
 # 代码审查报告
 
 ## 1. 审查信息

package/templates/verify//345/256/241/346/237/245/346/270/205/345/215/225.md

@@ -0,0 +1,79 @@
+---
+id: ka-guidance-审查清单
+kind: guidance
+title: 审查清单
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 审查
+  - review
+  - 代码审查
+  - 质量
+  - 审查清单
+  - 检查清单
+  - code review
+target_artifact:
+  - review_report
+extra:
+  name: review-checklist
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: verify
+  domain: verify
+  owner_mechanism: mc-generic-review
+---
+
+# 审查清单：代码审查查什么
+
+> 合并旧的十几个审查碎拆（SOLID/性能/并发/错误处理/数据隐私/可维护性等）。
+> verify-gate 的 SEC/PER/CON/API 是确定性正则门禁；本清单是审查者的维度指引。
+> 注入到代码审查报告（review_report）产出时。
+
+## 审查维度（每类都要过一遍）
+
+### 正确性
+- 逻辑是否实现需求（对照 REQ）
+- 边界条件：空/null/极值/并发/重复提交
+- 错误路径都有处理
+
+### 安全（对应 build-gate SEC-01~12）
+- 输入校验、SQL 注入、XSS、权限、敏感信息、SSRF、反序列化
+- 详见 [[安全加固]]
+
+### 性能（对应 PER-01~09）
+- N+1 查询、SELECT *、全量返回、循环内建对象、大事务、连接池
+- 前端：不必要重渲染、未记忆化、未优化资源
+
+### 并发（对应 CON-01~10）
+- 共享可变状态保护、JVM 锁误用、先查后改原子性、事务自调用、ThreadLocal 清理
+
+### 架构（对应 ARC-*）
+- 分层依赖、循环依赖、单一职责、Controller 不含业务逻辑
+
+### 接口契约（对应 API-01~10）
+- DTO 不暴露 Entity、写操作事务、权限注解、参数校验、RESTful、统一响应、分页、版本号、文档
+
+### 可维护性（AI 盲区，重点人工复核）
+- 命名清晰、单一职责、注释解释 why、无上帝对象
+- 可观测：关键路径有日志，便于排查
+
+### 数据隐私
+- 敏感数据加密/脱敏、日志不泄露、数据生命周期合规
+
+## 信任分级
+
+- **白盒**：AI 可确定性判定（正则/类型/编译）→ 自动通过
+- **灰盒**：AI 可判但需复核 → AI 判 + 标注
+- **黑盒**：需业务/设计判断（设计意图/可维护性深层）→ **必须人类签署**（[[开发者宪法]]）
+
+## 输出
+
+每个发现项：维度 + 严重度(error/warning/info) + 信任分级 + 文件:行号 + 描述 + 建议。
+黑盒项未签署不得判通过。

package/templates/verify//351/252/214/350/257/201/346/226/271/346/263/225.md

@@ -0,0 +1,72 @@
+---
+id: ka-guidance-验证方法
+kind: guidance
+title: 验证方法
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 验证
+  - verify
+  - 测试
+  - 端到端
+  - 集成测试
+  - 验收
+  - 执行验证
+  - 怎么验证
+target_artifact:
+  - review_report
+extra:
+  name: verification-method
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: verify
+  domain: verify
+  owner_mechanism: mc-verifier
+---
+
+# 验证方法：怎么真实验证（禁止假验证）
+
+> [[证据驱动与反幻觉]] 第 5/10 条：验证计划不是验证结果，失败必须修复复验。
+> build-gate VRF-G03 守护：端到端核心流程须全过、证据 ≥ E1。
+
+## 分层验证
+
+1. **单元测试**：单个函数/模块逻辑，mock 外部依赖
+2. **集成测试**：模块组合，真实依赖（DB/缓存）
+3. **端到端测试**：完整业务流程，浏览器/API 真实跑通
+
+每层都要跑，不能只跑单元测试就交。
+
+## 证据收集
+
+- 测试输出（pass/fail/total）
+- 截图（端到端，证明真实跑过）
+- API 响应日志
+- 数据库状态验证（改完数据真的变了）
+
+## Evidence 级别（承接测试计划）
+
+- **E0 不可接受**：无运行时证据（静态分析/AI 摘要/"我觉得对"）
+- **E1 最低**：运行时证据（测试输出/响应日志）
+- **E2 推荐**：端到端浏览器验证 + API + DB 状态
+
+P0 核心业务流程推荐 E2。
+
+## 禁止假验证
+
+- 只跑 happy path（违规，必须覆盖异常/边界）
+- mock 掉被测逻辑（违规，测试自己证明自己）
+- 用"验证计划"冒充"验证结果"（违规）
+- 未执行就说"全部通过"（违规）
+- 失败不修复就说"建议验证"后标记完成（违规）
+
+## 失败处理
+
+验证失败 → 进入 [[反馈修复闭环]]：读 findings → 定位根因 → 修复 → 重验 → 重试 5 次 escalate。