# 飞书消息摘要生成Skill 设计

## 1. Skill 定位

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

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

## 2. 输入

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

## 3. 输出

```python
@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. 无链接时消息仍可发送。

