| 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 行为：
- 从用户输入中提取：主题关键词、时间表述、可选的子领域/公司
- 将时间表述转换为精确的时间窗口（UTC+8）
- 向用户确认理解是否正确（如有歧义）
示例：
用户: "帮我整理上周的 {主题} 动态"
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 的核心差异点：严格的时间筛选是动态报告质量的生命线。
核验规则：
- 每条候选必须确认发布时间
- 时间不在指定窗口：直接剔除
- 无法确认时间：不纳入
核验方式（按优先级）：
- 页面内查找发布时间/更新时间
- URL 中的日期信息
- 页面 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 执行流程
file_read: 读取 /home/workspace/draft.mdoutline_generator: 按模板生成结构化大纲feishu_doc_create: 生成飞书云文档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) 质量检查清单
参数解析
信息检索
时间核验
内容整理
文档输出
9) 常见问题处理
| 问题 | 处理方式 |
|---|
| 时间范围模糊 | 向用户确认具体日期，转换为精确时间窗口 |
| 主题过于宽泛 | 建议用户缩小范围或指定子领域 |
| 某时间段无内容 | 如实告知，建议扩大时间范围 |
| 信息源受限 | 说明限制，使用替代源，在附录中注明 |
| 内容过多 | 按重要性筛选，保留 Top N，权威源优先 |
| 发布时间无法确认 | 该条目不纳入报告，在核验统计中计入剔除数 |
| 同一事件多来源冲突 | 保留原始来源为主条目，差异部分在详情中说明 |
