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` 分解任务：

```json
{
  "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")
```

写入内容格式：
```markdown
## {类别名称}

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

---

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

### 任务分发

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

```json
{
  "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 遵循）

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

> **统计窗口**：{起始时间} ~ {结束时间} (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，权威源优先 |
| 发布时间无法确认 | 该条目不纳入报告，在核验统计中计入剔除数 |
| 同一事件多来源冲突 | 保留原始来源为主条目，差异部分在详情中说明 |