deep-research 是一个用于多轮调查研究的技能，核心目标是把一个研究问题结构化地推进，并留下可追溯的证据记录。它通过一个在阶段之间传递的 JSON 持久化状态文件来管理研究进度；文档将其描述为一种契约——只要能描述这个文件，就可以在任意节点恢复研究。
【用途与定位】 当你需要的不只是单次摘要，而是多轮调查并带引用时，可使用此技能。文档给出如下选择标准：一句话总结一篇文章用 summarize；需要带引用的多轮调查时用本技能；快速查询单一来源直接使用网页搜索；对某个主题的持续监控则使用 digest/cron 类技能。本技能的设计触发词与 summarize 不同，它面向 "research"、"investigate"、"literature review"、"deep dive"，而 summarize 面向 "summarize"、"shorten"、"tl;dr"。
【阶段与流程】 整体流程为 Scope → Plan → Iterate（多轮）→ Compile → Deliver。状态保存在阶段之间传递的单一 JSON 文件中。
阶段 1：Plan。使用命令 python {baseDir}/scripts/plan.py --question "..." --depth thorough --out plan.json 生成计划。--depth 可选项包括：overview（3-5 个子问题，每个子问题目标 1 个来源）、thorough（6-10 个子问题，每个子问题目标 2-3 个来源）、exhaustive（12-20 个子问题，每个子问题目标 5+ 个来源）。计划是一个序列化为 JSON 的 pydantic 模型，其 schema 与各深度选项所实现的系统综述方法见 references/methodology.md。
阶段 2：Iterate。每一轮：读取计划，决定哪些子问题需要关注，打印抓取清单供宿主 agent 执行，并在宿主返回结果后把证据记录回计划。命令示例：python {baseDir}/scripts/iterate.py --plan plan.json --round 1 --print-fetches 用于展示本轮需抓取内容；抓取后用 python {baseDir}/scripts/iterate.py --plan plan.json --round 1 --record evidence_round_1.json 记录结果。证据文件为 JSON 数组，条目字段包括 subquestion_id、url、title、excerpt、relevance（如 0.85）、fetched_at。脚本会更新每个子问题的覆盖率估计；当所有子问题达到该深度的目标覆盖率时，计划的 done 标志翻转为 true，迭代循环终止。判断相关度时，应参考 references/sources.md 中的五轴来源评估：Authority（权威性）、Recency（时效性）、Evidence（证据）、Bias（偏差）、Corroboration（相互印证）。
阶段 3：Compile。使用 python {baseDir}/scripts/compile.py --plan plan.json --out report.md 生成报告。输出为 Markdown，包含：执行摘要（5-8 行）、方法论区块（深度、轮次、来源数）、带内嵌引用 [^N] 的逐子问题章节、列出每个来源及其 URL + fetched_at + relevance 的引用列表，以及 "What this report does not cover"（明确列出低覆盖子问题造成的空白）。引用链接指向引用列表；编译步骤绝不虚构来源，正文中每个 [^N] 都必须对应阶段 2 记录过的条目。
【主要能力】 提供三档研究深度；以 JSON 状态文件支持断点续做；由脚本维护子问题覆盖率并在达标后自动结束；按五轴框架评估来源相关度；生成带引用标注、来源可追溯、显式列出覆盖空白的报告。
【使用方式】 本技能不自行抓取网页，它是方法论加状态管理器，需与宿主 agent 的网页搜索/抓取工具配合使用。基本用法是依次运行 plan.py、iterate.py（多轮）、compile.py。
【适用场景】 需要研究综述、文献回顾、深度调研并带引用的多轮调查任务。
【限制】 不自行抓取网页，依赖宿主 agent 的搜索/抓取工具。不会自动解决来源之间的矛盾；编译步骤会在报告中标注冲突证据，由用户决定采信哪一方。它不是事实核查工具，来源质量评分是启发式的，输出应视为起点而非结论。若需持续监控（每日摘要、RSS 式更新），需另建一个 cron 技能，在每一轮以新问题调用本技能。与 summarize 的区别在于：summarize 针对单份文档生成更短版本；本技能针对一个问题、基于多份文档生成带明确证据追踪的研究报告。