79 lines
1.7 KiB
Markdown
79 lines
1.7 KiB
Markdown
# 飞书通知编排Skill 设计
|
||
|
||
## 1. Skill 定位
|
||
|
||
`飞书通知编排Skill` 是第七步工作流的总入口 Skill，负责组织飞书触发上下文解析、通知上下文加载、责任人映射、消息摘要生成、消息发送和回执记录。
|
||
|
||
英文实现标识建议使用 `FeishuNotificationOrchestrateSkill`。
|
||
|
||
## 2. 输入
|
||
|
||
```python
|
||
@dataclass
|
||
class FeishuNotificationOrchestrateInput:
|
||
batch_id: int
|
||
scenario_id: str
|
||
trigger_source: str
|
||
feishu_chat_id: str
|
||
feishu_message_id: str | None = None
|
||
notify_owner: bool = True
|
||
include_web_link: bool = True
|
||
```
|
||
|
||
## 3. 输出
|
||
|
||
```python
|
||
@dataclass
|
||
class FeishuNotificationOrchestrateOutput:
|
||
report_type: str
|
||
batch_id: int
|
||
send_status: str
|
||
mentioned_users: list[dict]
|
||
receipt: dict
|
||
audit_id: int | None = None
|
||
```
|
||
|
||
## 4. 依赖 Skill
|
||
|
||
1. `飞书任务入口解析Skill`
|
||
2. `飞书责任人映射Skill`
|
||
3. `飞书消息摘要生成Skill`
|
||
4. `飞书消息发送Skill`
|
||
5. `飞书回执记录Skill`
|
||
|
||
## 5. 核心方法
|
||
|
||
### 5.1 `run(input) -> FeishuNotificationOrchestrateOutput`
|
||
|
||
主入口方法。
|
||
|
||
### 5.2 `load_notification_context(input) -> NotificationContext`
|
||
|
||
加载风险报告、导出报告和 Web 链接。
|
||
|
||
### 5.3 `build_notification_payload(context) -> dict`
|
||
|
||
构建消息载荷。
|
||
|
||
## 6. 技术实现
|
||
|
||
使用技术：
|
||
|
||
1. Tool Registry
|
||
2. 飞书 OpenAPI / MCP
|
||
3. Django ORM
|
||
4. Audit 服务
|
||
|
||
## 7. 异常处理
|
||
|
||
1. 风险报告缺失：发送提示消息。
|
||
2. 飞书 chat_id 缺失：任务失败。
|
||
3. 发送失败：记录失败回执。
|
||
|
||
## 8. 测试要点
|
||
|
||
1. 能生成飞书通知报告。
|
||
2. 能串联责任人映射和消息发送。
|
||
3. 发送失败可记录审计。
|
||
|