# 飞书回执记录Skill 设计

## 1. Skill 定位

`飞书回执记录Skill` 负责记录飞书消息发送结果、通知对象、消息 ID、失败原因和审计载荷。

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

## 2. 输入

```python
@dataclass
class FeishuReceiptRecordInput:
    batch_id: int
    send_result: dict
    mention_targets: list[dict]
    notification_payload: dict
    trigger_context: dict
```

## 3. 输出

```python
@dataclass
class FeishuReceiptRecordOutput:
    notification_record_id: int
    audit_payload: dict
    status: str
```

## 4. 核心方法

### 4.1 `run(input) -> FeishuReceiptRecordOutput`

主入口方法。

### 4.2 `create_notification_record(input) -> FeishuNotificationRecord`

创建通知记录。

### 4.3 `build_audit_payload(record) -> dict`

生成审计载荷。

### 4.4 `record_audit(payload) -> AuditLog`

写入审计。

## 5. 技术实现

使用技术：

1. Django ORM
2. JSONField
3. Audit 服务

## 6. 异常处理

1. 记录写入失败：返回系统错误。
2. 审计写入失败：保留通知记录并标记警告。
3. 发送失败：仍记录失败回执。

## 7. 测试要点

1. 成功发送可记录 message_id。
2. 失败发送可记录错误。
3. 审计载荷包含触发来源。
4. 提及用户列表可保存。

