aily-doc-group-chat-summary

name	aily-doc-group-chat-summary
label	群聊内容摘要
description	基于飞书群聊的**智能摘要与洞察**生成能力。从指定群聊/时间范围的消息中提取关键信息，识别决策、行动项、风险，生成**飞书云文档结构化摘要**。

SKILL: aily-doc-group-chat-summary

基于飞书群聊的智能摘要与洞察生成能力。从指定群聊/时间范围的消息中提取关键信息，识别决策、行动项、风险，生成飞书云文档结构化摘要。

---

1) Overview

⚠️ 输出形式（强制）

• 本 skill 被触发即代表用户期望生成飞书云文档，主 Agent 无需询问用户是否需要写成文档，也不得以对话文本替代文档作为最终交付物。
• 数据收集完成后，必须通过 task（subagent_type: writer）委托 Writer Agent 创建飞书云文档。

飞书工具优先（必须遵守）

• 所有飞书相关信息获取与写作，先参考 feishu-use-skills-map 并按其指引调用对应技能
• 需要访问飞书文档/群消息/会议/任务时，必须先 get_skills 获取对应飞书技能说明
• 禁止绕过飞书工具直接构造 API 请求

工具/Skill 明确清单（执行前先 get_skills）

Agent	工具名	用途	使用阶段
主 Agent	aily-im（search-chats）	搜索/定位目标群聊	Module A
主 Agent	aily-im（list-messages / search-messages）	拉取群聊消息	Module A
主 Agent	aily-im（提取链接） → fetch / aily-doc	获取群内分享的云文档内容	Module A
主 Agent	aily-user	查询用户信息（姓名、部门）	Module A / B
主 Agent	knowledge_answer	补充历史决策、项目背景等上下文	Module A / B
主 Agent	todo_write	分解任务、追踪执行进度	全流程
主 Agent	file	写入 draft.md 素材	Module A / B
主 Agent	task（subagent_type: writer）	分发写作任务给 Writer Agent	Module C
Writer Agent	file_read	读取 draft.md	Module C
Writer Agent	outline_generator	生成文档大纲	Module C
Writer Agent	feishu_doc_create	创建飞书云文档	Module C

证据与时间约束（与主/写作 Agent 一致）

• 任何数据/结论必须来自可追溯来源；不确定则明确标注"需补充资料"
• 若用户指定时间范围，必须严格筛选在时间窗内的资料，过期内容不得使用
• 不可编造事实、链接或来源；引用必须有明确出处

可读性规则（强制）

• 并列项 >= 3：优先使用无序/有序列表或表格
• 单段 > 150 字必须拆分（列表/小节/Callout）
• 连续两段无列表且信息密度高：插入列表或 Callout

触发方式（Triggers）

• "帮我总结一下 {群名} 群的聊天记录"
• "把这个群最近一周的讨论整理成摘要"
• "总结今天群里的重要决策和待办事项"
• "帮我追踪 {群名} 群里关于 {话题} 的讨论"

输入（Inputs）

• 必选：群聊标识（群名 / 群 ID / 群链接）
• 可选：
  • 时间范围（默认：过去 24 小时）
  • 关注主题/关键词
  • 输出粒度（简洁版 / 标准版 / 详细版）

核心输出（Deliverables）

• 飞书云文档群聊摘要：结构化、可追溯、行动项可执行

质量标准

• 完整性：不遗漏关键决策与行动项
• 准确性：可回溯到原始消息
• 可操作：行动项有 Owner / 截止时间
• 时效性：严格遵守用户指定的时间窗口

---

2) 任务分解示例（todo_write）

主 Agent 收到群聊摘要请求后，使用 todo_write 分解任务：

{
  "todos": [
    {"content": "确定目标群聊和时间范围", "status": "in_progress"},
    {"content": "获取群聊消息（aily-im）", "status": "pending"},
    {"content": "预处理：去噪、分段、去重", "status": "pending"},
    {"content": "结构化提取：议题/决策/行动项/风险/链接", "status": "pending"},
    {"content": "整理素材，写入 draft.md", "status": "pending"},
    {"content": "调用 writer agent 生成摘要云文档", "status": "pending"}
  ]
}

---

3) Module A — 消息获取（主 Agent 执行）

核心原则：先拉取原始消息，再做时间过滤、去噪、分段。所有数据写入 draft.md 以供后续模块使用。

A1. 定位目标群聊

工具调用：aily-im（search-chats）

根据用户提供的群名/群 ID/群链接定位目标群聊，获取群聊的 chat_id。

A2. 拉取群聊消息

工具调用：aily-im（list-messages / search-messages）

按 chat_id + 时间范围拉取全部消息。

A3. 时间窗口定义

默认：过去 24 小时（用户时区）

支持自定义：

• "今天" / "本周" / "最近 3 天"
• 指定起止时间："{start_time} ~ {end_time}"

写入 draft.md — 执行 file(path: "/home/workspace/draft.md", mode: "append")：

## 群聊信息
- 群名：{群名}
- 群 ID：{chat_id}
- 统计范围：{start_date} {start_time} ~ {end_date} {end_time} (UTC+8)
- 消息总数：{msg_count} 条
- 参与人数：{user_count} 人

A4. 消息预处理

去噪规则：

• 纯表情/贴纸：标记但不纳入主分析
• 系统消息（入群/退群/群名变更）：单独记录或忽略
• 重复消息：去重，保留首次
• 纯闲聊（问候/感谢/无实质内容）：降权处理

消息分段：

• 按时间间隔（> 30 分钟无消息）自动切分
• 按话题切换辅助分段
• 每段标注：起止时间、参与人、主题标签

写入 draft.md — 执行 file(path: "/home/workspace/draft.md", mode: "append")：

## 消息分段

### 段落 1：{主题标签}
- 时间：{seg_start_time} ~ {seg_end_time}
- 参与人：{participant_list}
- 消息数：{seg_msg_count} 条
- 核心内容摘要：{segment_summary}

### 段落 2：{主题标签}
- 时间：{seg_start_time} ~ {seg_end_time}
- 参与人：{participant_list}
- 消息数：{seg_msg_count} 条
- 核心内容摘要：{segment_summary}

A5. 补充上下文（可选）

工具调用：knowledge_answer / aily-doc

当消息中涉及项目背景、历史决策时，使用 knowledge_answer 或 aily-doc 检索关联文档，补充上下文信息写入 draft.md。

---

4) Module B — 结构化提取（主 Agent 执行）

核心原则：提取"决策、行动、风险、资源"四类关键信息。每项必须可溯源到原始消息。

B1. 核心议题识别

识别方法：

• 从讨论段落中提取主要话题（3-7 个）
• 按讨论热度（消息数、参与人数）排序
• 合并高度重叠的子话题

写入 draft.md — 执行 file(path: "/home/workspace/draft.md", mode: "append")：

## 核心议题

| 序号 | 议题 | 热度 | 时间段 | 参与人 |
|------|------|------|--------|--------|
| 1 | {议题名称} | {高/中/低} | {time_range} | {participant_list} |
| 2 | {议题名称} | {高/中/低} | {time_range} | {participant_list} |
| ... | ... | ... | ... | ... |

---

B2. 关键决策提取

识别信号：

• "决定..."、"确认..."、"就这样定了"、"同意"、"通过"
• 投票结果
• 领导/关键人拍板

写入 draft.md — 执行 file(path: "/home/workspace/draft.md", mode: "append")：

## 关键决策

### 决策 1：{决策内容}
- **决策时间**：{decision_time}
- **决策人**：{decision_maker}
- **参与人**：{participant_list}
- **背景**：{decision_context}
- **原始消息**："{quoted_message}"

---

B3. 行动项提取

识别信号：

• "@{人名} 你来负责..."、"{人名} 跟进一下"
• "我来做..."、"我负责..."
• 截止时间提及："周五前"、"明天"、"{date}"

写入 draft.md — 执行 file(path: "/home/workspace/draft.md", mode: "append")：

## 行动项

| 任务 | 负责人 | 截止时间 | 状态 | 原始消息 |
|------|--------|---------|------|---------|
| {task_description} | {owner} | {due_date} | {status} | "{quoted_message}" |
| {task_description} | {owner} | {due_date} | {status} | "{quoted_message}" |

注意：若消息中未明确指定负责人，填写"待分配"并将该项列入"待跟进"。

---

B4. 风险与问题提取

识别信号：

• "问题是..."、"风险在于..."、"卡住了"、"阻塞"
• "谁能帮忙..."、"这个怎么解决"
• 依赖未就绪、资源不足等表述

写入 draft.md — 执行 file(path: "/home/workspace/draft.md", mode: "append")：

## 风险与问题

### 问题 1：{问题描述}
- **严重程度**：{高/中/低}
- **提出人**：{reporter}
- **提出时间**：{report_time}
- **状态**：{待解决/已解决}
- **解决方案**：{solution}（如有）
- **原始消息**："{quoted_message}"

---

B5. 重要链接与资源

提取类型：

• 飞书文档链接
• GitHub / GitLab 链接
• 外部链接（文章/工具）
• 文件附件

工具调用（可选）：对飞书文档链接使用 aily-doc 获取文档标题与摘要。

写入 draft.md — 执行 file(path: "/home/workspace/draft.md", mode: "append")：

## 重要链接

| 资源 | 类型 | 分享人 | 时间 | 关联议题 |
|------|------|--------|------|---------|
| {resource_name} | {飞书文档/GitHub/外部链接} | {sharer} | {share_time} | {related_topic} |
| {resource_name} | {飞书文档/GitHub/外部链接} | {sharer} | {share_time} | {related_topic} |

---

5) Module C — 调用 Writer Agent 生成摘要

C1. 素材完整性检查

在调用 Writer Agent 前，主 Agent 必须确认 draft.md 包含以下完整章节：

• 群聊信息（群名、时间范围、消息数、参与人数）
• 消息分段（每段含主题、时间、参与人、摘要）
• 核心议题表
• 关键决策（含决策人、时间、原始消息）
• 行动项（含负责人、截止时间、状态）
• 风险与问题
• 重要链接

C2. 任务分发

主 Agent 完成提取后，调用 task 工具分发给 Writer Agent：

{
  "description": "生成群聊摘要云文档",
  "prompt": "基于 /home/workspace/draft.md 中的群聊分析结果，生成一份飞书云文档群聊摘要。\n\n要求：\n1. TL;DR 放在最前面（3-5 条要点，使用 Callout 格式）\n2. 核心议题按热度排序展示\n3. 决策和行动项使用表格展示\n4. 行动项必须有负责人和截止时间\n5. 使用 Callout 突出高风险项\n6. 保留原始消息引用以支持溯源\n7. 末尾附待跟进清单\n\n摘要模板见 SKILL 文件第 6 节。",
  "subagent_type": "writer"
}

C3. Writer Agent 执行流程

1. file_read：读取 /home/workspace/draft.md
2. outline_generator：基于 draft.md 生成文档大纲
3. feishu_doc_create：按照下方摘要模板生成飞书云文档
   • 使用 Callout 突出决策和风险
   • 使用表格展示行动项
   • 保留消息溯源引用
4. end：返回文档链接

---

6) 文档结构模板（Writer Agent 遵循）

# 群聊摘要：{群名}

> 统计范围：{start_date} {start_time} ~ {end_date} {end_time} (UTC+8)
> 消息总数：{msg_count} 条 | 参与人数：{user_count} 人
> 生成时间：{gen_date} {gen_time}

---

## TL;DR

<!-- 3-5 条核心要点，使用 Callout -->

> **[决策]** {tldr_decision_summary}
> **[行动]** {action_count} 项待办，最近截止：{nearest_due_date}
> **[风险]** {tldr_risk_summary}

---

## 核心议题

### 1. {议题名称}

- **讨论摘要**：{topic_summary}
- **结论/共识**：{topic_conclusion}
- **参与人**：{participant_list}

---

### 2. {议题名称}

- **讨论摘要**：{topic_summary}
- **结论/共识**：{topic_conclusion}
- **参与人**：{participant_list}

---

## 关键决策

| 决策内容 | 决策人 | 时间 | 备注 |
|---------|-------|------|------|
| {decision_content} | {decision_maker} | {decision_time} | {decision_note} |
| {decision_content} | {decision_maker} | {decision_time} | {decision_note} |

---

## 行动项

| 任务 | 负责人 | 截止时间 | 状态 |
|-----|-------|---------|------|
| {task_description} | {owner} | {due_date} | {status} |
| {task_description} | {owner} | {due_date} | {status} |

---

## 风险与问题

<!-- 使用 Callout 突出高风险 -->

> **[高风险]** {risk_description}
> - 影响：{risk_impact}
> - 状态：{risk_status}
> - 建议：{risk_suggestion}

### 其他问题
- **{issue_name}**：{issue_description} —— 状态：{issue_status}

---

## 重要链接

- [{resource_name}]({resource_url}) - {sharer} 分享于 {share_time}
- [{resource_name}]({resource_url}) - {sharer} 分享于 {share_time}

---

## 待跟进

- [ ] {followup_item_1}
- [ ] {followup_item_2}
- [ ] 下次同步：{next_sync_date}

---

7) 执行流程图

用户: "帮我总结 {群名} 群的聊天记录"
          |
          v
+-------------------------------------------------------------+
|                    主 Agent 执行                              |
+-------------------------------------------------------------+
| 1. todo_write: 分解任务                                      |
|                                                             |
| 【Module A — 消息获取】                                      |
| 2. aily-im(search-chats): 定位目标群聊                       |
| 3. aily-im(list-messages): 拉取指定时间范围消息               |
| 4. 时间过滤 + 去噪 + 分段                                    |
| 5. file → draft.md (群聊信息 + 消息分段)               |
|                                                             |
| 【Module B — 结构化提取】                                    |
| 6. 识别核心议题 → file → draft.md                      |
| 7. 提取关键决策 → file → draft.md                      |
| 8. 提取行动项 (Owner/Due) → file → draft.md            |
| 9. 提取风险与问题 → file → draft.md                    |
| 10. 整理重要链接 → file → draft.md                     |
|                                                             |
| 【Module C — 分发任务】                                      |
| 11. 素材完整性检查                                           |
| 12. task(writer): 分发写作任务                               |
+-------------------------------------------------------------+
          |
          v
+-------------------------------------------------------------+
|                    Writer Agent 执行                         |
+-------------------------------------------------------------+
| 1. file_read: 读取 /home/workspace/draft.md                  |
| 2. outline_generator: 生成文档大纲                           |
| 3. feishu_doc_create: 生成飞书云文档                          |
|    - TL;DR (Callout)                                        |
|    - 核心议题                                                |
|    - 关键决策 (表格)                                         |
|    - 行动项 (表格)                                           |
|    - 风险与问题 (Callout)                                    |
|    - 重要链接                                                |
|    - 待跟进                                                  |
| 4. end: 返回文档链接                                         |
+-------------------------------------------------------------+
          |
          v
      飞书云文档群聊摘要

---

8) Checklist

主 Agent 检查项

• 群聊标识正确（已通过 aily-im 验证）
• 时间范围已明确标注（含时区 UTC+8）
• 消息已预处理（去噪、分段）
• 核心议题已识别（3-7 个，按热度排序）
• 关键决策已提取（含决策人、时间、原始消息）
• 行动项已提取（含 Owner / Due，无 Owner 标注"待分配"）
• 风险与问题已识别（含严重程度）
• 重要链接已整理（含类型、分享人）
• draft.md 所有章节完整
• 无编造数据，所有信息可溯源

Writer Agent 检查项

• TL;DR 完整（3-5 条，使用 Callout）
• 核心议题按热度排序
• 决策使用表格展示
• 行动项有负责人和截止时间
• 高风险使用 Callout 突出
• 重要链接可点击
• 待跟进清单完整
• 已创建飞书云文档

---

9) 常见失败模式与修复

失败模式	原因	修复方法
遗漏关键决策	识别信号词覆盖不全	扩大决策识别信号词，加入"拍板"、"OK就这样"
行动项无 Owner	消息中未明确分配	标注"待分配"，列入待跟进清单
噪音过多	闲聊/表情未过滤	加强去噪规则，降权非实质内容
时间范围错误	时区未统一	明确标注 UTC+8，解析用户意图时确认时区
摘要过于笼统	缺少具体信息	引用原始表述，补充具体时间、人名、数据
消息拉取不全	分页未处理	循环调用 list-messages 直至所有页获取完毕
议题识别偏差	话题切分不准	结合时间间隔 + 语义相似度双重分段
draft.md 数据缺失	跳过某提取步骤	执行前对照 Checklist 逐项检查

---

10) 扩展场景

10.1 主题追踪模式

• 用户指定关键词/话题
• 跨时间段追踪该话题演进
• 输出：话题时间线 + 各阶段结论
• 适用场景：跟踪某技术方案从提出到落地的全过程

10.2 多群聚合

• 多个相关群的讨论汇总
• 识别跨群关联话题
• 全局行动项汇总表
• 适用场景：项目涉及多个子群，需要统一视图

10.3 周期性摘要

• 每日/每周自动生成
• 与历史摘要对比，标注新增/变化项
• 追踪长期议题进展
• 适用场景：例会群/项目群的持续跟踪