---
name: semantic_evidence
when: '代码交付, 需求覆盖, 验证证据, 语义分析'
scope:
  - shared
products:
  - '*'
id: ka-pattern-semantic_evidence
asset_kind: pattern
lifecycle_status: active
authority: supporting
routes:
  - '*'
primary_triggers:
  - 代码交付
  - 需求覆盖
  - 验证证据
  - 语义分析
priority: P2
specificity: 3
version: 1.0.0
last_reviewed: '2026-05-22'
consumes: []
emits: []
secondary_triggers: []
negative_triggers: []
type: pattern
status: active
---

## 决策规则

- 需求点（requirement_points）必须与代码变更关联，形成可追踪的证据链
- computeSemanticEvidence 计算每个需求点的覆盖状态：covered / partial / uncovered
- buildDeliveryEvidenceChain 构建交付证据链，包含需求覆盖 + 变更摘要 + 验证结果
- 证据链使用 SHA256 hash chain 保证不可篡改
- 未覆盖需求点生成 advisory 警告，不阻断交付

## 验收项

- [AC-01] 所有需求点都有覆盖状态
- [AC-02] 证据链 hash 校验通过
- [AC-03] uncovered 需求点产生 advisory
- [AC-04] 证据链可验证完整性

## 何时使用

advisory: 需求覆盖是质量建议，uncovered 不阻断交付

## 是否 hard block

否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。

## 证据要求

- 语义证据计算测试通过
- 证据链完整性测试通过
-

## 人工确认/降级边界

- 此能力可被开发者决策覆盖
- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
- 降级/禁用需经 sf_capability_update + 人工确认
