DEMO-AGENT/docs/详细设计/skill/飞书消息摘要生成Skill.md

飞书消息摘要生成Skill 设计

1. Skill 定位

飞书消息摘要生成Skill 负责将风险报告、导出报告和责任人信息组装为飞书文本消息或互动卡片。

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

2. 输入

@dataclass
class FeishuMessageSummaryBuildInput:
    risk_report: dict
    word_export_report: dict | None
    mention_targets: list[dict]
    web_detail_url: str | None

3. 输出

@dataclass
class FeishuMessageSummaryBuildOutput:
    message_type: str
    payload: dict
    summary_text: str

4. 核心方法

4.1 run(input) -> FeishuMessageSummaryBuildOutput

主入口方法。

4.2 build_summary_text(report) -> str

生成文本摘要。

4.3 build_interactive_card(report, mentions, url) -> dict

生成互动卡片。

4.4 build_mentions(mention_targets) -> list[dict]

生成 @ 用户片段。

5. 技术实现

使用技术：

1. 飞书卡片 JSON
2. 文本模板
3. 可选 LLM 摘要

6. 异常处理

1. 风险报告为空：生成提示消息。
2. Web 链接为空：卡片不展示按钮。
3. 责任人为空：不生成 @。

7. 测试要点

1. 能生成风险摘要。
2. 能生成卡片 payload。
3. 能包含 @ 用户。
4. 无链接时消息仍可发送。