| name | literature-survey |
| description | 当用户说"调研""survey""了解研究现状"，或需要系统了解某主题的文献全貌时，以 DomainMap 为认知基线、近期 survey paper 为文献锚点，批量 digest 后综合生成调研报告 |
| argument-hint | <topic> |
| allowed-tools | Read, Write, Edit, Glob, Grep, Task, WebSearch, WebFetch |
Purpose
给定一个研究主题，以 DomainMaps/ 为认知基线、以近期 survey paper 为文献锚点，批量 digest 相关论文，综合出 Topics/{Topic}-Survey.md —— 作为对相关 domain 当前认知的 delta 报告（无对应 DomainMap 时退化为完整领域分析）。
Steps
1. 基线建立
- 认知基线：读
DomainMaps/_index.md 找相关 domain；若有，读对应 DomainMaps/{Name}.md
- 内容基线：检查
Topics/{Topic}-Survey.md；若存在，读取该文件，用 frontmatter 的 date_updated 作为截止日期，扫描 body 中形如 [[YYMM-ShortTitle]]（如 [[2510-XVLA]]、[[2602-DM0]]）的 wikilinks 作为已收录论文清单，作为增量调研的起点；若无，本次是新建
2. Scoping
2.1 搜索相关 Survey
搜索本主题近期新出现的 survey paper（若 Step 1 存在内容基线，优先找其截止日期之后的）。先在已有 Papers/里寻找，再结合 WebSearch，挑 1-3 篇最相关的。若本 topic 无专门 survey，退而找相邻 / 上位 topic 的 survey paper。
为挑选出来的 survey paper 启动 subagent 并行调用 paper-digest 生成笔记，主 agent 读取这些 survey paper 的笔记文件。
2.2 确定候选论文清单
与 Step 1 已收录清单去重后得到候选论文清单，分两类：
- 需 digest：从侦察到的 survey 中提取反复引用的 canonical 论文 → 进入 Step 3
- 已有笔记：从
Papers/ 搜索本 topic 相关笔记 → 无需 digest，直接参与 Step 4 综合
3. 批量 paper-digest
为每篇待 digest 的论文启动 subagent 并行调用 paper-digest 生成笔记；若 paper-digest 发现论文已有笔记，则跳过（不覆盖、不询问）。等所有 subagent 完成后，进入下一步。
4. 综合写作
读取笔记：只读取候选论文清单里 rating >= 2 的论文笔记，作为新增论文（筛 rating 用 Bash 批处理 frontmatter，避免对每篇 Read）
确定 section 结构： 下列必备元素为骨架；各元素内部的子分类由已有对应 DomainMap + 已有 Topics/{Topic}-Survey.md（增量时） + Step 2.1 新侦察的 survey paper 综合提炼：
- Overview：一句话定位 + 领域活跃度（时间线 / 参与格局 / 学术产出等） + 整体趋势
- Problem & Motivation：本领域在解决什么核心问题，为什么重要，为什么适合现在做
- 技术路线对比：分析各主流路线的核心思路，实际效果，优缺点等，嵌入代表性论文
- Datasets & Benchmarks：整理常用的 Training Datasets，Benchmarks（包含 SOTA methods 和 performance），可以用多个表格方式呈现
- Open Problems：真实的 open，不是教科书式列举
- 调研日志：元数据（日期、论文统计、未能获取说明）
写作基线：Survey 定位为 DomainMap 的 delta 报告——已在对应 DomainMap 中 Established 的内容不重述，聚焦窗口内的新技术路线、对既有 claim 的支持/挑战、新 open problems；必要时用 [[DomainMaps/{Name}#某节]] 引用基线。无对应 DomainMap 时完整展开所有必备元素。
若调研中发现明显应纳入 DomainMap 的内容，在 ## 调研日志 之前加 ## DomainMap 更新建议 节显式列出；无则不加此节。
Frontmatter（新建或更新时写入/刷新）：
---
title: <Topic 全名>
description: <一句话描述本 Survey 覆盖的范围与核心发现>
tags: [...]
date_updated: YYYY-MM-DD
year_range: YYYY-YYYY
---
Tag 选择：阅读 vault 目录下的 {vault_root}/references/tags.md，按照规范选择 tag。
Obsidian syntax：写入前参照 {vault_root}/references/obsidian-syntax.md Obsidian-specific quirks。
新建或增量更新 Topics/{Topic}-Survey.md。
5. 日志
追加 log entry 到 Workbench/logs/YYYY-MM-DD.md（文件不存在则新建并加一级标题 # YYYY-MM-DD）：
### [HH:MM] literature-survey
- **input**: <topic>
- **output**: [[Topics/{Topic}-Survey]]
- **stats**: 侦察 survey N 篇，新增论文 N 篇
- **observation**: <一句话领域核心发现>
- **issues**: <未能获取的论文及原因；无则 none>
Verify
Step 1 · 基线建立
Step 2 · Scoping
Step 3 · 批量 paper-digest
Step 4 · 综合写作
Step 5 · 日志
