68 lines
1.2 KiB
Markdown
68 lines
1.2 KiB
Markdown
# 飞书任务入口解析Skill 设计
|
|
|
|
## 1. Skill 定位
|
|
|
|
`飞书任务入口解析Skill` 负责解析飞书事件和用户指令，将群聊消息映射到系统审核任务。
|
|
|
|
英文实现标识建议使用 `FeishuTaskEntryParseSkill`。
|
|
|
|
## 2. 输入
|
|
|
|
```python
|
|
@dataclass
|
|
class FeishuTaskEntryParseInput:
|
|
event_payload: dict
|
|
```
|
|
|
|
## 3. 输出
|
|
|
|
```python
|
|
@dataclass
|
|
class FeishuTaskEntryParseOutput:
|
|
command: str
|
|
scenario_id: str | None
|
|
batch_id: int | None
|
|
chat_id: str
|
|
message_id: str
|
|
warnings: list[dict]
|
|
```
|
|
|
|
## 4. 核心方法
|
|
|
|
### 4.1 `run(input) -> FeishuTaskEntryParseOutput`
|
|
|
|
主入口方法。
|
|
|
|
### 4.2 `verify_event_signature(payload) -> bool`
|
|
|
|
校验事件来源。
|
|
|
|
### 4.3 `extract_command(payload) -> str`
|
|
|
|
提取用户指令。
|
|
|
|
### 4.4 `resolve_scenario(command) -> str | None`
|
|
|
|
映射任务场景。
|
|
|
|
## 5. 技术实现
|
|
|
|
使用技术：
|
|
|
|
1. 飞书事件订阅
|
|
2. Django webhook
|
|
3. 场景配置 YAML
|
|
|
|
## 6. 异常处理
|
|
|
|
1. 验签失败：拒绝请求。
|
|
2. 指令无法识别：返回帮助提示。
|
|
3. 批次无法解析：提示用户补充批次。
|
|
|
|
## 7. 测试要点
|
|
|
|
1. 能解析群聊消息。
|
|
2. 能识别风险报告指令。
|
|
3. 验签失败被拒绝。
|
|
|