docs(详细设计): 新增风险预警设计

docs/详细设计/skill/风险项生成Skill.md

@@ -0,0 +1,66 @@
+# 风险项生成Skill 设计
+
+## 1. Skill 定位
+
+`风险项生成Skill` 负责从前序报告中提取风险事实，并按照风险规则生成标准化风险项。
+
+英文实现标识建议使用 `RiskItemBuildSkill`。
+
+## 2. 输入
+
+```python
+@dataclass
+class RiskItemBuildInput:
+    reports: dict[str, dict]
+    risk_rules: dict
+```
+
+## 3. 输出
+
+```python
+@dataclass
+class RiskItemBuildOutput:
+    risk_items: list[RiskItem]
+    manual_review_items: list[dict]
+    warnings: list[dict]
+```
+
+## 4. 核心方法
+
+### 4.1 `run(input) -> RiskItemBuildOutput`
+
+主入口方法。
+
+### 4.2 `build_from_completeness(report) -> list[RiskItem]`
+
+从缺失、错放、待复核生成风险。
+
+### 4.3 `build_from_field_extraction(report) -> list[RiskItem]`
+
+从字段缺失、低可信、抽取失败生成风险。
+
+### 4.4 `build_from_consistency(report) -> list[RiskItem]`
+
+从字段冲突、混档风险生成风险。
+
+## 5. 技术实现
+
+使用技术：
+
+1. 前序报告 schema
+2. 风险规则映射
+3. dataclass/Pydantic
+
+## 6. 异常处理
+
+1. 报告缺失：生成报告缺失警告。
+2. 风险类型未配置：使用中风险并警告。
+3. 证据缺失：风险仍生成，但标记证据不足。
+
+## 7. 测试要点
+
+1. 缺失项生成风险。
+2. 字段冲突生成风险。
+3. 混档生成高风险。
+4. 手工复核项被保留。
+