DEMO-AGENT/docs/详细设计/skill/飞书消息发送Skill.md

飞书消息发送Skill 设计

1. Skill 定位

飞书消息发送Skill 负责调用飞书 OpenAPI 或 MCP 工具发送消息，并返回发送结果。

英文实现标识建议使用 FeishuMessageSendSkill。

2. 输入

@dataclass
class FeishuMessageSendInput:
    chat_id: str
    message_type: str
    payload: dict

3. 输出

@dataclass
class FeishuMessageSendOutput:
    send_status: str
    message_id: str | None
    raw_response: dict
    error_message: str = ""

4. 核心方法

4.1 run(input) -> FeishuMessageSendOutput

主入口方法。

4.2 send_text(chat_id, payload) -> dict

发送文本消息。

4.3 send_card(chat_id, payload) -> dict

发送互动卡片。

4.4 retry_on_transient_error(request) -> dict

临时错误重试。

5. 技术实现

使用技术：

1. 飞书 OpenAPI
2. 飞书 MCP 工具
3. HTTP client
4. 重试策略

6. 异常处理

1. token 失效：发送失败并记录。
2. chat_id 无效：发送失败。
3. 网络超时：重试后失败。
4. payload 非法：发送失败。

7. 测试要点

1. 文本消息 payload 正确。
2. 卡片消息 payload 正确。
3. API 失败可记录错误。
4. 临时错误可重试。