survey

name	survey
description	Trigger automated literature surveys on research topics. When the user says "调研 XXX", "survey XXX", "帮我调研一下 XXX", or asks for a literature review on a topic, first check existing surveys with list_surveys, then confirm with user, then trigger_survey. Also supports follow-up investigations on existing surveys with followup_survey.

Survey Pilot — 文献调研系统

你有四个工具：

• list_surveys — 查看已有的调研报告（topic、日期、Notion 链接、摘要、follow-up 列表）
• trigger_survey — 启动新的全量文献调研（Opus，500+ 篇论文，~$40，2h+）
• cancel_survey — 取消正在运行的调研（用户说"不想调研了""取消""停掉"时使用）
• followup_survey — 对已有调研进行 follow-up（Opus，规模根据问题自适应）

何时触发

当用户说以下类似的话时：

• "调研一下 XXX"
• "帮我调研 XXX 方向"
• "做一个 XXX 的文献综述"
• "survey XXX"
• "literature review on XXX"
• "了解一下 XXX 领域的研究进展"

⚠️ 完整流程（三步，缺一不可）

绝对禁止直接调用 trigger_survey。必须按以下顺序执行：

第一步：检查已有调研

收到调研请求后，立即调用 list_surveys()，查看是否已有相关调研。

第二步：告知用户 + 确认主题

根据 list_surveys 的结果分两种情况：

情况 A — 有相关调研：

用户: 调研一下 depth estimation
Agent: [调用 list_surveys]
Agent: 我发现你已经有一篇相关的调研报告：
       📄 **Monocular Depth Estimation** (2026-02-20)
       摘要：从单张 RGB 图像预测像素级深度...
       Notion: [查看报告](https://...)

       你想：
       1. 直接看这篇已有的报告
       2. 重新调研这个方向（会生成新报告）
       3. 调研一个不同的子方向
       4. 对这篇 survey 做 follow-up（补充/深挖某个方向）
用户: 重新调研吧，加上最新的论文
Agent: → trigger_survey(topic="monocular depth estimation")

情况 B — 无相关调研：

用户: 调研一下 deep estimation
Agent: [调用 list_surveys，无相关结果]
Agent: 你是想调研 **Monocular Depth Estimation（单目深度估计）** 方向吗？
       这个方向主要涉及从单张图像预测像素级深度，包括判别式方法、自监督方法、
       扩散模型方法、基础模型（如 Depth Anything）等子方向。
       确认后我就启动调研，调研过程在后台执行，完成后飞书通知你。
用户: 对
Agent: → trigger_survey(topic="monocular depth estimation")

第三步：启动调研

用户确认后才调用 trigger_survey(topic="规范化的英文研究主题")。

Follow-up 调研

当用户针对已有 survey 想补充或深挖时，使用 followup_survey 而非 trigger_survey。

何时使用 follow-up

• "这篇 survey 没有覆盖 Y 方向"
• "X 方向讲得太浅了，帮我深入调研一下"
• "对某个结论有疑问，帮我验证一下"
• "survey 里的 XXX 部分能展开讲讲吗"
• 用户看完 survey 后说"再补充一下 XXX"

Follow-up 流程

用户: HOI 那篇 survey 没有覆盖 implicit representation 方向
Agent: [调用 list_surveys，找到 hoi-motion-gen]
Agent: 你的 **HOI in Motion Generation** survey 确实没覆盖 implicit representation 方向。
       我可以启动一个 follow-up 调研，针对性搜索论文（规模根据问题范围自适应），
       结果会发布为 Notion 子页面，挂在原 survey 下面。
       确认要 follow-up 吗？
用户: 好
Agent: → followup_survey(slug="hoi-motion-gen", question="survey 没有覆盖 implicit HOI representation 方向，需要补充这个子领域的方法和进展")

Follow-up vs 全量调研对比

	trigger_survey	followup_survey
模型	Opus（全量方法论）	Opus（自适应方法论）
论文数	500+	自适应（验证 ~20，补充 ~50，广域比较 ~200）
产出	survey.md（完整报告）	followup_N.md（增量报告）
Notion	独立页面	基础 survey 的子页面
可多次	不同主题	同一 survey 可多次 follow-up

主题规范化规则

• 解析用户意图：用户说"调研 XXX"时，理解他真正想调研什么
• 规范化为英文学术主题：将口语化表述转为准确的英文研究领域名
• 用户可能有错别字（如 "deep estimation" → "depth estimation"）
• 用户表述可能模糊，需要明确子方向

用户: 帮我调研 HOI 方向
Agent: [调用 list_surveys，发现已有 hoi-motion-gen]
Agent: 你之前调研过 **HOI in Motion Generation**，这是 HOI 的一个子方向。
       你想调研 HOI 的哪个方面？
       1. HOI Detection（图像中检测人-物交互关系）— 还没调研过
       2. HOI in Motion Generation — 已有报告，要更新吗？
       3. 整体综述（涵盖检测、生成、理解等）
       4. 对已有 HOI Motion Gen survey 做 follow-up
用户: 1
Agent: → trigger_survey(topic="human-object interaction detection")

调研流程说明

trigger_survey 启动后，系统在后台自动：

1. 启动 Claude Code (Opus 4.6) 会话
2. 搜索 Semantic Scholar + arXiv + Brave Search 论文
3. 筛选、阅读、分析核心论文
4. 撰写结构化调研报告（含目标树、现状树、未来树等分析框架）
5. 生成图表（时间线、分类树、Pipeline 图等）
6. 发布到 Notion
7. 完成后通过飞书通知用户

取消调研

用户说"不想调研了""取消""停掉"时，调用 cancel_survey()。不需要参数（自动取消最近启动的调研），也可以指定 slug。

绝对禁止用 exec 手动 kill 进程。必须用 cancel_survey 工具，它会正确终止 Claude 进程并清理任务状态。

注意事项

• 调研在后台执行，不影响当前对话，用户可以继续聊其他事情
• 不要重复触发同一个主题的调研
• topic 参数必须用英文（规范化后的学术术语）
• 调研完成后用户会收到飞书卡片通知，包含 Notion 报告链接
• follow-up 调研轻量快速，同一 survey 可以多次 follow-up（自动编号 #1, #2, ...）
• follow-up 结果发布为 Notion 子页面，自动挂在基础 survey 页面下