soloforge 1.1.42 → 1.1.44

package/templates/shared//346/263/250/345/206/214/350/241/250/345/237/272/347/241/200/350/256/276/346/226/275.md

@@ -0,0 +1,49 @@
+---
+id: ka-hard-rule-注册表基础设施规则
+kind: guidance
+title: 注册表基础设施
+sync_policy: internal
+status: active
+triggers:
+  - 注册表基础设施规则
+extra:
+  name: registry-infrastructure
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: constraint
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-registry-infrastructure
+---
+
+# 注册表基础设施规则
+
+## 核心原则
+
+注册表是 SoloForge 契约体系的基础设施层。所有机制必须通过注册表发现、验证和追踪其契约和资产。
+
+## 规则
+
+1. **注册完整性**: 每个机制必须在 MechanismContractRegistry 注册，包含 id、status、priority
+2. **资产可发现**: 所有可消费模版资产必须在 ConsumableAssetRegistry 注册，包含 path、consumption_mode、owner_mechanism_id
+3. **生命周期测试**: 每个注册表条目必须有对应的生命周期测试，验证注册/查询/状态变更
+4. **跨注册表一致性**: owner_mechanism_id 必须在 DualLayerMechanismRegistry 中存在对应条目
+5. **注册表健康检查**: validate-mechanisms 和 audit-template-mechanisms 必须能检测注册表不一致
+
+## 失败模式
+
+- 注册表条目无对应测试 → 应补充 lifecycle test
+- owner_mechanism_id 指向不存在的机制 → 应修复引用
+- 模版文件存在但未注册 → 应在 ConsumableAssetRegistry 登记
+
+## 验收标准
+
+- [ ] 所有机制契约在 registry 中可查询
+- [ ] 所有模版资产有 owner_mechanism_id
+- [ ] 注册表查询函数返回非空结果
+- [ ] validate-mechanisms 不报告注册表缺失

package/templates/shared//346/265/201/345/274/217/345/277/203/350/267/263.md

@@ -0,0 +1,64 @@
+---
+id: ka-pattern-streaming_protocol
+kind: knowledge
+title: 流式心跳
+sync_policy: internal
+status: active
+extra:
+  name: streaming_protocol
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: knowledge
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-engine-runtime
+---
+
+## 决策规则
+
+- 重型 AI 操作（tier=heavy）执行期间必须启动流式心跳
+- 心跳间隔 Heartbeat_Interval = 5000 毫秒
+- 心跳通过 stdio 输出，格式: [SoloForge Heartbeat] {操作描述} 执行中... 已耗时 {N}s，当前任务已用 {M}/{T} Token
+- 心跳包含字段: elapsed_ms, tokens_used, operation, message
+- 轻量/中型操作（light/medium）不触发心跳
+- 操作完成后调用 completeOperation() 停止心跳
+- 重型操作定义: estimated_tokens > 3000（code_generation/solution_brainstorm/verification_reasoning/review_deep_analysis）
+
+## 验收项
+
+- [AC-01] 重型操作启动后 5 秒内首次心跳输出
+- [AC-02] 心跳消息包含操作名称、耗时、Token 用量
+- [AC-03] completeOperation() 调用后心跳立即停止
+- [AC-04] 中型操作（test_generation/debug_analysis）不产生心跳
+- [AC-05] 心跳回调通过 setHeartbeatCallback() 注册
+
+## 格式规范
+
+```text
+[SoloForge Heartbeat] 代码生成 执行中... 已耗时 10s，当前任务已用 5000/30000 Token
+```
+
+## 何时使用
+
+advisory: 预算耗尽是 warning 不是 hard fail，不应阻断任务
+
+## 是否 hard block
+
+否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
+
+## 证据要求
+
+- H1/H4 handler 测试通过
+- heartbeat 测试通过
+-
+
+## 人工确认/降级边界
+
+- 此能力可被开发者决策覆盖
+- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
+- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//346/274/224/350/277/233/345/233/236/345/275/222/351/227/250/346/216/247.md

@@ -0,0 +1,50 @@
+---
+id: ka-hard-rule-演进回归门控规则
+kind: guidance
+title: 演进回归门控
+owner_mechanism: mc-evolution-regression
+sync_policy: internal
+status: active
+extra:
+  name: evolution-regression-gate
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  verification_layer: L2
+  stage: _global
+---
+
+# 演进回归门控规则
+
+## hard_rules
+
+- 新增问题 / 新增 Batch / 新机制 / 新模版 / 新测试必须经过回归门控，不得打穿既有体系。
+- 必须包含以下检查项：
+  1. 跨 Batch 总回归门：新变更不得破坏已验收的 Batch 门禁。
+  2. 模版补齐检查：新机制必须有 required 模版资产。
+  3. 机制归属检查：新模版必须归属到正确机制。
+  4. 发布门禁更新：新问题/Batch 必须更新发布门禁配置。
+  5. 旧问题反向影响检查：新变更不得使已关闭问题重新失效。
+- 重复问题必须被 DuplicateIssueCheck 检测并阻断。
+- pending 状态的问题/机制不得通过门禁。
+
+## not_done_if_missing
+
+- 新问题未经 DuplicateIssueCheck → hard fail。
+- 新增功能批次未继承既有历史回归基线 → hard fail。
+- 模版层需更新但未更新 → hard fail。
+- 新增机制无 required 模版资产 → hard fail。
+- 发布门禁配置未更新 → hard fail。
+
+## verification_evidence
+
+- `EvolutionGateResult` 包含 passed/failed 状态和检查项列表。
+- `DuplicateCheckResult` 包含重复检测结果。
+- `performEvolutionGate()` 执行全部五项检查。
+- `checkDuplicateIssue()` 检测重复问题。
+- `diagnostic_codes`: duplicate-issue, pending-gate, missing-template, batch-regression-failed。

package/templates/shared//347/224/250/346/210/267/345/217/215/351/246/210/345/245/221/347/272/246.md

@@ -0,0 +1,86 @@
+---
+id: ka-hard-rule-用户反馈契约规则
+kind: guidance
+title: 用户反馈契约
+sync_policy: internal
+status: active
+triggers:
+  - 用户反馈契约规则
+extra:
+  name: user-feedback-contract
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: constraint
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-user-feedback
+---
+
+# 用户反馈契约规则
+
+## 核心约束
+
+1. 每个工具只能输出其 `getAllowedFeedbackKinds` 允许的反馈类型。
+2. 反馈消息必须包含：kind、severity、title、summary。禁止空洞反馈。
+3. 技术内容（路径、命令、错误码）禁止翻译，必须保留原文。
+4. `blocked` 类型反馈必须包含阻塞原因和建议下一步。
+5. `failure` 类型反馈必须包含失败证据和 retry_hint。
+6. 任何用户反馈、缺陷、设计疑问或实际使用偏差，不得只按表面文件、单个目录或单个场景收窄处理。
+7. 进入修复讨论前，必须先完成全局抽象审查：
+   - 该问题属于哪个机制族？
+   - 是否只是某个现象暴露出来的系统性问题？
+   - 是否同时影响 SoloForge 自身与用户项目使用路径？
+   - 是否涉及模版层、知识层、机制层、adapter、CLI、MCP、发布门禁、迁移和防回归？
+   - 是否需要抽象成通用能力，而不是只修当前案例？
+8. 如果全局抽象审查未完成，只能输出待分析项、影响矩阵和建议讨论顺序，不得直接给单点修复结论。
+9. 如果当前案例只是系统性问题的一个样本，修复方案必须覆盖同类入口、同类资产、同类任务和新增资产防回归。
+
+## 适用场景
+
+- 所有 SoloForge 工具的输出反馈
+- sf_gate 结果反馈
+- sf_work action=verify 学习反馈
+- sf_work action=act 降级/澄清反馈
+- 用户反馈实际使用问题
+- 讨论新增机制、模版、规则、流程、验收或发布风险
+- 将问题落入 Batch、备忘录、发布门槛或施工合同前
+
+## 违规处理
+
+- 禁止的反馈类型 → hard_fail，阻断输出
+- 空洞反馈 → advisory，标记质量降级
+- 翻译技术内容 → advisory，标记违规
+- 未做全局抽象审查就收窄为单点修复 → hard_fail，退回机制族归因
+- 只修当前文件/目录/样例但未覆盖同类路径和防回归 → hard_fail，要求补齐通用能力
+- 未分析 SoloForge 自身与用户项目双路径影响 → hard_fail，要求补齐影响矩阵
+- 未说明模版层、知识层、机制层、adapter、CLI、MCP、发布门禁、迁移和防回归影响 → hard_fail，要求补齐跨层影响
+
+## 全局抽象审查输出
+
+每次用户反馈进入讨论或施工合同前，必须形成以下结构化结论：
+
+```text
+1. 表面现象:
+2. 机制族归因:
+3. 是否系统性问题:
+4. SoloForge 自身影响:
+5. 用户项目影响:
+6. 涉及层级:
+   - 模版层:
+   - 知识层:
+   - 机制层:
+   - adapter:
+   - CLI:
+   - MCP:
+   - 发布门禁:
+   - 迁移:
+   - 防回归:
+7. 是否应抽象成通用能力:
+8. 不应只修的局部案例:
+9. 施工和验收必须覆盖的同类路径:
+```

package/templates/shared//347/237/245/350/257/206/344/270/273/346/235/203.md

@@ -0,0 +1,66 @@
+---
+id: ka-pattern-authority
+kind: knowledge
+title: 知识主权
+sync_policy: internal
+status: active
+extra:
+  name: authority
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: knowledge
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-engine-runtime
+---
+
+## 决策规则
+
+- knowledge/patterns/core/ 为人工维护只读区，AI 严禁修改
+- AI 进化产物只能写入 knowledge/patterns/temp/
+- 自进化机制（evolve）生成的知识条目经 KnowledgeWriter 写入 temp/
+- KnowledgeWriter.promoteToActive() 路由所有 pattern 类型到 patterns/temp/
+- updateKnowledge() 检测 core/ 路径时直接拒绝，返回知识隔离错误
+- drift_ratio >= 0.3 时触发漂移检测，根因分析判定:
+  - code_degradation: 安全规则违反，禁止更新知识库
+  - business_evolution: 多文件普遍违反，允许更新知识库（仅 temp/）
+  - unknown: 人工审核后决定
+- drift_ratio >= 0.5 且 code_degradation 时触发逻辑奇点警告
+
+## 验收项
+
+- [AC-01] core/ 目录下任何文件无法通过 AI 工具修改
+- [AC-02] evolve() 写入的条目路径包含 temp/
+- [AC-03] updateKnowledge() 对 core/ 条目返回"知识隔离"错误
+- [AC-04] KnowledgeWriter.isCorePath() 正确识别 core/ 路径
+- [AC-05] 自进化知识条目 status 从 staged → active 的路径仅经过 temp/
+
+## 逆向退化防护
+
+- 连续 3 次 drift 检测均为 code_degradation 时，暂停自动自愈
+- 暂停后需人工审查代码库状态，确认不是 AI 连续敷衍导致的退化
+
+## 何时使用
+
+advisory: 知识治理是建议性的，尚未接入强制门禁
+
+## 是否 hard block
+
+否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
+
+## 证据要求
+
+- 知识模版格式验证测试通过
+- 中文语义化路径测试通过
+-
+
+## 人工确认/降级边界
+
+- 此能力可被开发者决策覆盖
+- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
+- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//347/237/245/350/257/206/346/262/273/347/220/206.md

@@ -0,0 +1,31 @@
+---
+id: ka-hard-rule-知识治理规则
+kind: guidance
+title: 知识治理
+owner_mechanism: mc-knowledge-governance
+sync_policy: internal
+status: active
+extra:
+  name: knowledge-governance
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  verification_layer: L2
+  stage: _global
+---
+
+# 知识治理规则
+
+知识资产从草稿、演进、同步到注入必须有统一治理入口。
+
+## 硬规则
+
+- 知识晋级必须有证据，不能由 AI 推理直接变成核心事实。
+- 中文优先项目的用户可见语义不得被英文默认模版污染。
+- 设计文档只能承载已验证事实，不能承载施工日志或未验证假设。
+- 多语言策略必须显式声明，不能用日志或 stderr 替代用户反馈。

package/templates/shared//347/237/245/350/257/206/346/263/250/345/205/245/350/276/271/347/225/214.md

@@ -0,0 +1,47 @@
+---
+id: ka-hard-rule-知识注入边界规则
+kind: guidance
+title: 知识注入边界
+sync_policy: copy_to_project
+status: retired
+triggers:
+  - 知识注入边界规则
+extra:
+  name: knowledge-injection-boundary
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: constraint
+  verification_layer: L2
+  stage: _global
+---
+
+# 知识注入边界规则
+
+## 核心原则
+
+知识注入必须经过三道门过滤: 状态门、路由门、预算门。未经审核的知识不可进入 prompt。
+
+## 三道门
+
+1. **状态门**: draft/quarantine/deprecated 知识被过滤，不进入 prompt
+2. **路由门**: 知识类型必须匹配当前路由，防止错误注入
+3. **预算门**: budget 不足时优先保留 required，supporting 可被裁剪
+
+## 规则
+
+1. consumption_mode=required 资产缺失时必须报错，不可静默降级
+2. pending_review 知识只能进入 advisory_only，不可进入 injected
+3. 所有注入结果必须生成 KnowledgeInjectionReport
+4. route 不匹配时跳过模版注入，不可强行注入
+
+## 验收标准
+
+- [ ] draft/quarantine 知识不出现在 injected 列表中
+- [ ] required 资产缺失时产生 missing_required_knowledge finding
+- [ ] KnowledgeInjectionReport 包含完整字段
+- [ ] budget 不足时 required 优先于 supporting

package/templates/shared//347/273/206/350/212/202/347/272/252/345/276/213.md

@@ -0,0 +1,54 @@
+---
+id: ka-hard-rule-细节纪律规则
+kind: guidance
+title: 细节纪律
+owner_mechanism: mc-detail-discipline
+sync_policy: copy_to_project
+status: active
+extra:
+  name: detail-discipline
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  verification_layer: L2
+  stage: _global
+triggers:
+  - 方案细节
+  - 实施细节
+  - 验收细节
+  - 边界约束
+  - 失败路径
+  - 降级路径
+  - 备份回滚
+---
+
+# 细节纪律规则
+
+## hard_rules
+
+- 方案细节、实施细节、验收细节、边界例外、反回归检查五个维度必须逐一检查，不得遗漏。
+- 细节必须包含可验证字段或清单（verification checklist），不得只有口号式描述。
+- 阻塞性检查（blocking check）必须接入交付 gate，不得游离在交付流程之外。
+- 设计有方向无边界 → hard fail，必须补齐边界约束。
+- 实施只有快乐路径 → hard fail，必须覆盖失败路径和降级路径。
+- 覆盖/迁移操作无备份回滚 → hard fail。
+
+## not_done_if_missing
+
+- 设计有方向无边界 → hard fail。
+- 实施只有快乐路径 → hard fail。
+- 覆盖/迁移无备份回滚 → hard fail。
+- blocking 检查未接入交付 gate → hard fail。
+- 细节维度缺失（5 个维度任缺 1 个）→ hard fail。
+
+## verification_evidence
+
+- `DetailDisciplineCheck` 包含 dimensions 覆盖报告（方案细节/实施细节/验收细节/边界例外/反回归）。
+- `performDetailCheck()` 返回各维度 pass/fail 状态。
+- `checkDetailGateIntegration()` 验证 blocking 检查已接入交付 gate。
+- `diagnostic_codes`: missing-dimension, gate-not-integrated, no-verification-field。

package/templates/shared//350/204/221/346/232/264/344/270/216/346/226/271/346/241/210/346/216/242/347/264/242.md

@@ -0,0 +1,51 @@
+---
+id: ka-hard-rule-脑暴与方案探索规则
+kind: guidance
+title: 脑暴与方案探索
+owner_mechanism: mc-brainstorm-contract
+sync_policy: copy_to_project
+status: active
+extra:
+  name: brainstorm-exploration
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  verification_layer: L2
+  stage: _global
+triggers:
+  - 脑暴
+  - 方案探索
+  - 候选方案
+  - 方案对比
+  - 不确定
+  - 多方案
+---
+
+# 脑暴与方案探索规则
+
+## hard_rules
+
+- 不确定项不能只报告，必须给出至少 2 个候选方案并附推荐理由后进入用户确认闭环。
+- 脑暴阶段必须区分四种状态：brainstorm（探索中）→ proposal（有候选）→ decision（选定方案）→ confirmed_decision（用户确认）。
+- 高影响变更不得只有单一无解释路径，必须经过多选项探索。
+- 脑暴推荐不得绕过决策主权机制（mc-decision-sovereignty），推荐结果必须进入 decision 状态确认。
+- 脑暴阶段不得自动执行任何方案，必须等 confirmed_decision 状态。
+
+## not_done_if_missing
+
+- 高影响变更只有单一无解释路径 → hard fail。
+- 脑暴无候选方案直接跳过 → hard fail。
+- 脑暴推荐绕过人工门禁 → hard fail。
+- 不确定项只报告不收敛 → hard fail。
+
+## verification_evidence
+
+- `BrainstormSession` 包含 options 数组（至少 2 项）、recommendation、reasoning 字段。
+- `validateBrainstormSession()` 检查候选数量和收敛状态。
+- `canBrainstormAutoExecute()` 始终返回 false（脑暴不可自动执行）。
+- `diagnostic_codes`: empty-session, auto-execute-blocked, single-option-no-explanation。

package/templates/shared//350/256/241/345/210/222/345/211/215/347/275/256/351/227/250.md

@@ -0,0 +1,47 @@
+---
+id: ka-hard-rule-plan-proposal-gate
+kind: guidance
+title: 计划前置门
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 代码修改
+  - 文件编辑
+  - 架构设计
+  - 迁移
+  - 删除
+  - 高风险操作
+  - code_change
+  - file_edit
+  - migration
+  - delete
+extra:
+  name: plan-proposal-first-gate
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: constraint
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-plan-proposal-gate
+---
+
+## 计划前置门规则
+
+### 核心原则
+先说明计划，再执行动作。任务越复杂、风险越高，计划越完整。
+
+### 执行前必须
+1. 给出与任务风险匹配的计划或方案
+2. 高风险动作必须用户确认
+3. 计划必须记录验证方式和风险
+
+### 禁止
+- 无计划直接写文件、改代码、构建、Docker、迁移、发布
+- none_with_reason 用于写入或高风险任务
+- 执行动作超出已确认计划 scope
+- review 上下文擅自修复

package/templates/shared//350/256/276/350/256/241/344/272/247/347/211/251/345/214/205.md

@@ -0,0 +1,58 @@
+---
+id: ka-rule-design-artifact-pack
+kind: guidance
+title: 设计产物包
+owner_mechanism: mc-design-artifact-pack
+sync_policy: copy_to_project
+status: active
+extra:
+  name: design-artifact-pack
+  lifecycle_status: active
+  scope:
+    - '*'
+  products:
+    - '*'
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: constraint
+  verification_layer: L2
+  stage: _global
+---
+
+# 设计产物包规则
+
+## 权威资产
+
+- 决策和确认以 `00-架构决策记录.md` 为准。
+- 总体架构以 `01-架构设计文档.md` 为准。
+- 详细设计的必需承载是 `design/01-数据库设计文档.md` 和 `design/02-API接口规格文档.md`；`design/03-详细设计文档.md` 仅在模块逻辑复杂度高、需要补充流程图或状态机描述时使用，不得被门禁强制要求。
+- 数据库物理结构以真实 SQL/migration 为准，`design/01-数据库设计文档.md` 解释和追踪。
+- API 路径和字段 schema 以 `docs/api/openapi.yaml` 为准，`design/02-API接口规格文档.md` 补充业务语义。
+- 开发切片以 `architecture/02-开发切片计划.md` 为准，作为全项目切片索引承载 `PHASE-*`、`SLICE-*`、状态、依赖和验收顺序；旧 `architecture/04-第一阶段开发切片计划.md` 只能作为迁移提示，不得作为新项目标准输出，也不得单独作为设计产物包通过依据。
+- 需求、原型、架构、详细设计、切片、实现和验收之间的身份关系以各产物正文中的 ID 互相引用为准（REQ-*、PROTO-*、ARCH-*、DD-*、SLICE-*、AC-* 在对应产物中声明并交叉引用）。
+- `audits/01-设计一致性验收报告.md` 只记录真实验证结果。
+
+## 生命周期输入输出
+
+| 节点 | 必需输入 | 必需输出 | 进入下一节点的硬门禁 |
+| --- | --- | --- | --- |
+| 需求输入 | 用户需求材料 | `REQ-*` 与需求文档 | 需求已分配 REQ-* 编号 |
+| 原型提取 | 原型材料 | `PROTO-*` 与原型说明 | 原型已分配 PROTO-* 编号 |
+| 架构设计 | `REQ-*`、`PROTO-*` | `00-架构决策记录.md`、`01-架构设计文档.md`、`ARCH-*` | 架构引用需求或原型，决策已确认 |
+| 详细设计 | `ARCH-*` | `design/01-数据库设计文档.md`、`design/02-API接口规格文档.md`、`DD-T*`、`DD-A*`、OpenAPI、SQL/migration | DB/API 设计引用架构，OpenAPI 和 SQL 权威资产存在 |
+| 切片规划 | `DD-*` 或 `ARCH-*` | `architecture/02-开发切片计划.md`、`PHASE-*`、`SLICE-*`、`AC-*` | 切片绑定阶段、设计来源和验收 ID |
+| 实现 | 切片计划 | 真实 `changed_files` | 任务绑定 `SLICE-*`、`DD-*`、`AC-*` |
+| 测试 | 真实 `changed_files` 与验收 ID | 真实命令执行结果 | 不能把验证计划当验证结果，验证必须覆盖变更 |
+| 验收/交付 | 测试结果和设计产物包 | `audits/01-设计一致性验收报告.md` 与交付摘要 | hard_fail 清零并保留消费 trace |
+
+## 硬底线
+
+- 每个 endpoint 必须具备请求和响应字段级说明，JSON 示例不能替代字段表。
+- SQL、OpenAPI、架构、数据库和 API 文档出现关键漂移时必须阻断。
+- 旧文档在新标准下必须先审计；未经确认和复验不得继续作为编码依据。
+- 升级必须默认 dry-run，确认写入时归档原文件和 hash。
+- DAP-01: 条件产物（数据库变更方案/接口对接方案）须明确标注"有"/"无"
+- DAP-02: 每个产物独立验证通过后才能进入下一个，禁止全量生成后统一验证
+- DAP-03: 子产物引用必须在主产物中有对应章节
+- DAP-04: 每个产物 frontmatter 须有 version 字段，主产物更新时子产物检查是否需要同步
+- DAP-05: "无"的条件产物须在主产物中记录判断依据

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

@@ -0,0 +1,60 @@
+---
+id: ka-hard-rule-证据驱动与反幻觉规则
+kind: guidance
+title: 证据驱动与反幻觉
+owner_mechanism: mc-evidence-grounding
+sync_policy: copy_to_project
+status: active
+extra:
+  name: evidence-driven-anti-hallucination
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  verification_layer: L2
+  stage: _global
+triggers:
+  - 架构选型
+  - 技术决策
+  - 代码重构
+  - 方案评估
+  - 风险评估
+  - 事实核查
+  - 证据验证
+---
+
+# 证据驱动与反幻觉规则
+
+## 硬规则
+
+1. **没证据，不得当事实** — 任何项目事实、技术栈、测试、发布状态的声明必须有可追溯证据
+2. **没检索，不得做高风险判断** — 架构、编码、发布、迁移任务必须先检索项目证据
+3. **有冲突，不得直接拍板** — 证据冲突时必须列出冲突、给出推荐、请求用户确认
+4. **有不确定，必须说清** — 不确定项必须明确标注并给出推荐方案
+5. **验证计划不是验证结果** — `validation_plan` 不得冒充 `validation_result`
+6. **模型推理不是事实证据** — `generated_inference` 不得单独支撑项目事实结论
+7. **测试/gate/scenario 不是主链路落地** — 只被测试文件调用不是真实消费证据
+8. **禁止源永远不得注入** — `forbidden` 权限的证据不得出现在 prompt 或 citation 中
+9. **过期证据不得用于高风险** — `stale` / `deprecated` 证据不得作为高风险任务唯一依据
+10. **失败必须修复复验** — 证据不足时不得假完成，必须修复并复验
+
+## 风险分级
+
+- **critical**: 发布门禁、生产环境、安全相关 → 任何证据缺失必须阻断
+- **high**: 架构、编码、迁移、验证 → 事实声明必须有权威证据
+- **medium**: 普通功能开发 → 关键声明需要证据
+- **low**: 通用问答、低风险操作 → 可标注为通用建议
+
+## 检查项
+
+- [ ] 关键事实声明有 evidence_refs
+- [ ] 无证据的声明已标注不确定
+- [ ] 冲突证据已列出并裁决
+- [ ] forbidden 证据未被注入
+- [ ] 高风险声明未用 stale/deprecated 证据
+- [ ] 验证结论基于真实执行结果
+- [ ] 生成的推理未单独支撑事实