aily-doc-topic-trend-report

name	aily-doc-topic-trend-report
label	新闻总结
description	根据用户指定的**主题**和**时间范围**，自动检索权威动态，生成一份**飞书云文档动态报告**，按类别聚类，每条新闻含 intro / description / 索引链接。强调**时间筛选 + 权威优先 + 去重**。

SKILL: aily-doc-topic-trend-report

根据用户指定的主题和时间范围，自动检索权威动态，生成一份飞书云文档动态报告，按类别聚类，每条新闻含 intro / description / 索引链接。强调时间筛选 + 权威优先 + 去重。

---

1) Overview

⚠️ 输出形式（强制）

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

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

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

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

Agent	工具名	用途	使用阶段
主 Agent	web_search	多源检索公开信息 + 时间过滤	Phase 2: 多源检索
主 Agent	fetch	获取重要页面详情（提取时间、标题、核心内容）	Phase 2: 多源检索 / Phase 3: 时间核验
主 Agent	todo_write	分解并追踪任务进度	全流程
主 Agent	file	将整理后的素材写入 draft.md	Phase 4: 去重与分类
主 Agent	task	分发写作任务给 Writer Agent	Phase 5: 生成报告
Writer Agent	file_read	读取 draft.md 素材	报告生成
Writer Agent	outline_generator	生成结构化大纲	报告生成
Writer Agent	feishu_doc_create	生成飞书云文档	报告生成

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

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

可读性规则（强制）

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

触发方式（Triggers）

• "给我 {主题} 的日报/周报"
• "帮我整理 {日期/时间段} 的 {主题} 动态"
• "从 {日期} 到 {日期} 的 {主题} 新闻"
• "最近一周的 {主题} 动态"
• "{年月} 的 {主题} 大事"

输入（Inputs）

参数	是否必选	说明	示例
主题	必选	报告聚焦的领域/关键词	{主题关键词}
时间范围	可选	支持多种格式（默认：今日）	见下方时间格式说明
关注子领域	可选	主题下的细分方向	{子领域1}、{子领域2}、{子领域3}
关注公司/机构	可选	重点追踪的组织	{公司1}、{公司2}、{公司3}

时间范围格式支持

格式类型	示例	解析结果
单日	"今天"、"昨天"、"YYYY-MM-DD"	当日 00:00-23:59
日期范围	"M月D日到M月D日"、"YYYY-MM-DD ~ YYYY-MM-DD"	起始日 00:00 ~ 结束日 23:59
相对时间	"最近N天"、"过去一周"、"本月"	自动计算时间窗口
年月	"YYYY年M月"、"上个月"	整月范围

核心输出（Deliverables）

• 飞书云文档主题动态报告：按类别聚类、结构清晰、可追溯

质量标准

• 时间准确：所有条目必须验证发布时间在指定窗口内
• 权威优先：官方源 > 权威媒体 > 社区讨论
• 去重：同一事件多来源只保留主条目，其他作为补充链接

---

2) 任务分解示例（todo_write）

主 Agent 收到动态报告请求后，使用 todo_write 分解任务：

{
  "todos": [
    {"content": "Phase 1: 参数解析 — 提取主题、时间窗口、子领域/公司", "status": "in_progress"},
    {"content": "Phase 2: 多源检索 — 根据主题选择信息源组合，web_search + fetch", "status": "pending"},
    {"content": "Phase 3: 时间核验 — 逐条确认发布时间，剔除窗口外内容", "status": "pending"},
    {"content": "Phase 4: 去重与分类 — 合并重复事件，按类别归类，写入 draft.md", "status": "pending"},
    {"content": "Phase 5: 调用 Writer Agent 生成飞书云文档报告", "status": "pending"}
  ]
}

---

3) Module A — 参数解析与多源检索（主 Agent 执行）

Phase 1: 参数解析与确认

用户输入 → 解析主题 + 时间范围 → 确认参数

Agent 行为：

1. 从用户输入中提取：主题关键词、时间表述、可选的子领域/公司
2. 将时间表述转换为精确的时间窗口（UTC+8）
3. 向用户确认理解是否正确（如有歧义）

示例：

用户: "帮我整理上周的 {主题} 动态"
Agent 理解:
- 主题: {主题关键词}
- 时间窗口: {start_date} 00:00 ~ {end_date} 23:59 (UTC+8)
- 关注方向: {子领域1}、{子领域2}

---

Phase 2: 多源检索

核心原则：根据主题选择合适的信息源 + 时间过滤。权威优先。

2.1 信息源选择（按主题动态调整）

主题类型	优先信息源	补充信息源
AI/科技	官方博客、arXiv、GitHub	Hacker News、Product Hunt、Twitter
区块链/Web3	项目官网、CoinDesk、The Block	Twitter、Discord、GitHub
游戏	官方公告、IGN、Polygon	Steam、Reddit、YouTube
金融	官方公告、Reuters、Bloomberg	SEC Filings、财报
通用	Google News、权威媒体	社交媒体、行业论坛

主题不在上表中时，参考"通用"行，优先选择该领域的官方源和头部媒体。

2.2 检索策略

web_search 查询模板：

"{主题关键词}" (发布 OR 更新 OR 公告) {时间限定词}
site:{权威域名} "{主题关键词}" {日期}
"{关注公司}" "{主题关键词}" (release OR announcement) {时间}

fetch 深入获取：

fetch(
  url: "{搜索结果中的重要链接}",
  prompt: "提取发布时间、标题、核心内容、关键数据"
)

写入 draft.md： 每完成一批检索后，使用 file 追加写入素材：

file(path: "/home/workspace/draft.md", mode: "append")

---

4) Module B — 时间核验与分类（主 Agent 执行）

Phase 3: 时间核验与筛选

本 Skill 的核心差异点：严格的时间筛选是动态报告质量的生命线。

核验规则：

• 每条候选必须确认发布时间
• 时间不在指定窗口：直接剔除
• 无法确认时间：不纳入

核验方式（按优先级）：

1. 页面内查找发布时间/更新时间
2. URL 中的日期信息
3. 页面 meta 信息（og:published_time 等）

fetch 核验示例：

fetch(
  url: "{候选条目URL}",
  prompt: "确认该页面的发布时间/更新时间，精确到日期"
)

---

Phase 4: 去重与分类

去重规则：

• 同一事件多来源：保留原始来源（官方 > 权威媒体 > 转载），其他作为补充链接
• 同一主体多更新：合并为一条，按时间排列要点

通用分类框架（按主题调整）：

类别编号	类别名称	适用内容
一	官方发布 & 重大更新	来自官方的第一手信息
二	产品 & 技术	新产品、技术突破、版本更新
三	研究 & 论文	学术成果、研究报告
四	开源 & 工具	开源项目、开发者工具
五	行业 & 市场	投融资、合作、市场动态
六	观点 & 分析	深度分析、行业评论

仅保留有内容的类别，空类别不出现在最终报告中。

整理后写入 draft.md：

file(path: "/home/workspace/draft.md", mode: "append")

写入内容格式：

## {类别名称}

### [{来源}] {标题}
- **发布时间**: {YYYY-MM-DD}
- **简介**: {1-2句概述}
- **详情**: {核心内容、关键数据、影响/意义}
- **链接**: {原文URL}

---

5) Module C — 调用 Writer Agent（主 Agent 执行）

任务分发

主 Agent 完成素材收集和分类后，调用 task 工具分发给 Writer Agent：

{
  "description": "生成主题动态报告云文档",
  "prompt": "基于 /home/workspace/draft.md 中的主题动态素材，生成一份飞书云文档动态报告。\n\n要求：\n1. 严格按照动态报告模板结构\n2. 核心要点使用 Callout 突出\n3. 每条新闻含来源链接和发布时间\n4. 所有内容已通过时间核验\n5. 空类别不出现\n\n报告模板见 skill 中的文档结构模板。",
  "subagent_type": "writer"
}

Writer Agent 执行流程

1. file_read: 读取 /home/workspace/draft.md
2. outline_generator: 按模板生成结构化大纲
3. feishu_doc_create: 生成飞书云文档
4. end: 结束

---

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

# {主题} 动态报告 · {时间范围描述}

> **统计窗口**：{起始时间} ~ {结束时间} (UTC+8)
> **生成时间**：{当前时间}
> **主题关键词**：{主题} {子领域}

---

## 核心要点

<!-- 3-5 条最重要的动态，使用 Callout 突出 -->

> **[重要]** {事件1简述}
> **[热门]** {事件2简述}
> **[突破]** {事件3简述}

---

## 一、官方发布 & 重大更新

**本类概述**：{1-2句总结本类别的整体情况}

### [{来源}] {标题}

**简介**：{1-2句：发生了什么 + 为什么重要}

**详情**：
- 核心内容：{具体内容}
- 关键数据：{数据指标}
- 影响/意义：{行业影响}

**链接**：[原文]({url}) | **发布时间**：{YYYY-MM-DD}

---

## 二、产品 & 技术

**本类概述**：{1-2句总结}

### {标题}

**简介**：{概述}

**详情**：
| 维度 | 内容 |
|------|------|
| 发布方 | {发布方名称} |
| 核心特性 | {特性描述} |
| 关键指标 | {指标数据} |

**链接**：[原文]({url}) | **发布时间**：{YYYY-MM-DD}

---

## 三、研究 & 论文

（如适用）

---

## 四、开源 & 工具

（如适用）

---

## 五、行业 & 市场

（如适用）

---

## 六、观点 & 分析

（如适用）

---

## 本期重点关注

1. **{事件1}**：{为什么值得关注}
2. **{事件2}**：{为什么值得关注}
3. **{事件3}**：{为什么值得关注}

---

## 附录：信息来源统计

| 来源类型 | 数量 | 主要来源 |
|---------|------|---------|
| 官方发布 | {N} | {列举} |
| 媒体报道 | {N} | {列举} |
| 社区/论坛 | {N} | {列举} |

**时间核验**：共检索 {X} 条，通过核验 {Y} 条，剔除 {Z} 条

---

7) 执行流程图

用户: "帮我整理 {时间} 的 {主题} 动态"
                    ↓
┌───────────────────────────────────────────────────────┐
│              Phase 1: 参数解析                          │
├───────────────────────────────────────────────────────┤
│  • 提取主题关键词                                       │
│  • 解析时间范围 → 精确时间窗口（UTC+8）                  │
│  • 识别子领域/关注公司（可选）                           │
│  • 确认参数（如有歧义）                                  │
│  • todo_write: 记录任务分解                             │
└───────────────────────────────────────────────────────┘
                    ↓
┌───────────────────────────────────────────────────────┐
│              Phase 2: 多源检索                          │
├───────────────────────────────────────────────────────┤
│  • 根据主题选择信息源组合（见信息源选择表）              │
│  • web_search: 官方源 + 权威媒体                        │
│  • web_search: 社区源 + 行业论坛                        │
│  • fetch: 获取重要页面详情                              │
│  • file(draft.md, append): 追加原始素材           │
└───────────────────────────────────────────────────────┘
                    ↓
┌───────────────────────────────────────────────────────┐
│              Phase 3: 时间核验                          │
├───────────────────────────────────────────────────────┤
│  • 逐条核验发布时间                                     │
│  • 剔除时间窗口外的内容                                  │
│  • 无法确认时间的内容不纳入                              │
│  • 记录核验结果（通过/剔除数量）                         │
└───────────────────────────────────────────────────────┘
                    ↓
┌───────────────────────────────────────────────────────┐
│              Phase 4: 去重与分类                        │
├───────────────────────────────────────────────────────┤
│  • 合并重复事件（权威优先保留）                          │
│  • 按通用分类框架归类                                    │
│  • file(draft.md, append): 写入分类结果           │
└───────────────────────────────────────────────────────┘
                    ↓
┌───────────────────────────────────────────────────────┐
│              Phase 5: 生成报告                          │
├───────────────────────────────────────────────────────┤
│  • task(writer): 调用 Writer Agent                     │
│  • Writer: file_read → outline_generator               │
│  •         → feishu_doc_create → end                   │
└───────────────────────────────────────────────────────┘
                    ↓
              飞书云文档动态报告

---

8) 质量检查清单

参数解析

• 主题关键词已明确
• 时间窗口已精确（含时区 UTC+8）
• 歧义已与用户确认
• todo_write 已记录任务分解

信息检索

• 已根据主题选择合适的信息源组合
• 官方/权威源已优先检索
• 补充源已检索
• 重要链接已 fetch 获取详情

时间核验

• 所有条目已核验发布时间
• 时间窗口外内容已剔除
• 无法确认时间的内容已排除
• 核验统计已记录（检索数/通过数/剔除数）

内容整理

• 已完成去重（同事件多来源仅保留主条目）
• 已按通用分类框架归类
• 每条含完整信息（标题/简介/详情/链接/时间）
• 已通过 file 写入 draft.md

文档输出

• 结构完整（核心要点/分类正文/本期关注/附录）
• 核心要点使用 Callout 突出
• 空类别未出现在报告中
• 附录含信息来源统计和时间核验结果
• 已转换为飞书云文档

---

9) 常见问题处理

问题	处理方式
时间范围模糊	向用户确认具体日期，转换为精确时间窗口
主题过于宽泛	建议用户缩小范围或指定子领域
某时间段无内容	如实告知，建议扩大时间范围
信息源受限	说明限制，使用替代源，在附录中注明
内容过多	按重要性筛选，保留 Top N，权威源优先
发布时间无法确认	该条目不纳入报告，在核验统计中计入剔除数
同一事件多来源冲突	保留原始来源为主条目，差异部分在详情中说明