116 lines
2.5 KiB
Markdown
116 lines
2.5 KiB
Markdown
# 完整性报告生成Skill 设计
|
|
|
|
## 1. Skill 定位
|
|
|
|
`完整性报告生成Skill` 负责把完整性检查链路中的规则判定结果、风险映射结果和法规证据组装成稳定的 `registration_completeness_report`。
|
|
|
|
英文实现标识建议使用 `CompletenessReportBuildSkill`。
|
|
|
|
本 Skill 不重新判定缺失，不重新检索证据，只负责报告结构、展示摘要和审计载荷生成。
|
|
|
|
## 2. 输入
|
|
|
|
```python
|
|
@dataclass
|
|
class CompletenessReportBuildInput:
|
|
execution_context: CompletenessExecutionContext
|
|
item_results: list[CompletenessItemResult]
|
|
evidence_refs: list[EvidenceRef]
|
|
pass_status: str
|
|
highest_risk_level: str
|
|
```
|
|
|
|
## 3. 输出
|
|
|
|
```python
|
|
@dataclass
|
|
class CompletenessReportBuildOutput:
|
|
report: dict
|
|
display_sections: list[dict]
|
|
audit_payload: dict
|
|
feishu_summary_payload: dict
|
|
```
|
|
|
|
## 4. 报告结构
|
|
|
|
报告必须包含：
|
|
|
|
1. `report_type`
|
|
2. `batch_id`
|
|
3. `workflow_type`
|
|
4. `rule_package_id`
|
|
5. `rule_version`
|
|
6. `chapter_scope`
|
|
7. `summary`
|
|
8. `matched_items`
|
|
9. `missing_items`
|
|
10. `misplaced_items`
|
|
11. `manual_review_items`
|
|
12. `evidence_refs`
|
|
13. `suggestions`
|
|
|
|
## 5. 核心方法
|
|
|
|
### 5.1 `run(input) -> CompletenessReportBuildOutput`
|
|
|
|
主入口方法。
|
|
|
|
### 5.2 `build_summary(item_results) -> dict`
|
|
|
|
汇总：
|
|
|
|
1. 要求项数量。
|
|
2. 已提供数量。
|
|
3. 缺失数量。
|
|
4. 疑似提供数量。
|
|
5. 错放数量。
|
|
6. 待复核数量。
|
|
7. 最高风险等级。
|
|
8. 是否通过。
|
|
|
|
### 5.3 `split_item_results(item_results) -> dict`
|
|
|
|
按状态拆分明细。
|
|
|
|
### 5.4 `attach_evidence(item_results, evidence_refs) -> list[dict]`
|
|
|
|
把法规证据挂到对应要求项。
|
|
|
|
### 5.5 `build_display_sections(report) -> list[dict]`
|
|
|
|
生成页面展示区块。
|
|
|
|
### 5.6 `build_audit_payload(report, context) -> dict`
|
|
|
|
生成审计载荷。
|
|
|
|
### 5.7 `build_feishu_summary_payload(report) -> dict`
|
|
|
|
生成飞书摘要载荷，供后续飞书通知步骤复用。
|
|
|
|
## 6. 技术实现
|
|
|
|
使用技术：
|
|
|
|
1. Pydantic/dataclass
|
|
2. JSONField
|
|
3. Django Audit 服务层
|
|
4. 结构化消息模板
|
|
|
|
## 7. 异常处理
|
|
|
|
1. 报告字段缺失：构建失败并写入失败审计。
|
|
2. 证据为空：正常输出，标记证据缺失。
|
|
3. 明细为空：输出空检查结果。
|
|
4. 风险等级缺失：按 `low` 处理，并记录规则警告。
|
|
|
|
## 8. 测试要点
|
|
|
|
1. 输出 schema 字段稳定。
|
|
2. 缺失项进入 `missing_items`。
|
|
3. 错放项进入 `misplaced_items`。
|
|
4. 待复核项进入 `manual_review_items`。
|
|
5. 审计载荷包含规则版本和输入范围。
|
|
6. 飞书摘要载荷不包含敏感信息。
|
|
|