docs(详细设计): 新增风险预警设计
This commit is contained in:
64
docs/详细设计/skill/风险规则加载Skill.md
Normal file
64
docs/详细设计/skill/风险规则加载Skill.md
Normal file
@@ -0,0 +1,64 @@
|
||||
# 风险规则加载Skill 设计
|
||||
|
||||
## 1. Skill 定位
|
||||
|
||||
`风险规则加载Skill` 负责加载风险分级、准入规则、责任角色映射和整改建议模板。
|
||||
|
||||
英文实现标识建议使用 `RiskRuleLoadSkill`。
|
||||
|
||||
## 2. 输入
|
||||
|
||||
```python
|
||||
@dataclass
|
||||
class RiskRuleLoadInput:
|
||||
risk_rule_id: str
|
||||
```
|
||||
|
||||
## 3. 输出
|
||||
|
||||
```python
|
||||
@dataclass
|
||||
class RiskRuleLoadOutput:
|
||||
risk_rule_id: str
|
||||
version: str
|
||||
risk_type_rules: dict
|
||||
admission_rules: dict
|
||||
owner_role_mapping: dict
|
||||
suggestion_templates: dict
|
||||
```
|
||||
|
||||
## 4. 核心方法
|
||||
|
||||
### 4.1 `run(input) -> RiskRuleLoadOutput`
|
||||
|
||||
主入口方法。
|
||||
|
||||
### 4.2 `load_rule_file(risk_rule_id) -> dict`
|
||||
|
||||
读取 YAML。
|
||||
|
||||
### 4.3 `validate_rules(raw_rules) -> RiskRuleValidationResult`
|
||||
|
||||
校验规则完整性。
|
||||
|
||||
## 5. 技术实现
|
||||
|
||||
使用技术:
|
||||
|
||||
1. YAML
|
||||
2. Pydantic
|
||||
3. Django cache
|
||||
|
||||
## 6. 异常处理
|
||||
|
||||
1. 规则不存在:任务失败。
|
||||
2. 准入规则缺失:校验失败。
|
||||
3. 责任角色缺失:使用默认角色并警告。
|
||||
|
||||
## 7. 测试要点
|
||||
|
||||
1. 规则加载成功。
|
||||
2. 准入规则可读取。
|
||||
3. 责任角色映射可读取。
|
||||
4. 缺失规则时报错。
|
||||
|
||||
Reference in New Issue
Block a user