用途
deep-research 用于在某个主题上做多来源、多步骤的研究,并把研究成果归档,使语料可以持续累积。资料提到的典型场景包括:销售电话前的竞品研究、新商业想法的市场研究、定位相关调研,以及任何需要“跨多个来源、分多步”回答的研究问题。
主要能力
技能以七个步骤组织研究流程:
- 框定问题:用一句紧凑的话复述研究问题。如果问题含糊,向用户确认:这项研究将支撑什么决策;最小可用的答案是什么(避免过度研究);是否有需要优先或回避的来源。输出格式为 Research question: <一句话>。
- 规划来源:根据问题类型从给定来源菜单中选择,并说明会使用哪些来源以及原因。
- 执行发现:运行选定的来源。每条结果记录:来源(URL 或系统)、1–3 句的内容摘要、日期/时效、对来源的置信度(high/medium/low)。此阶段不做综合,只做收集。
- 综合:按主题或子问题对发现分组;做矛盾检查,凡来源不一致处都标出,不做平均化处理而是呈现分歧;给出置信度(high 为多个独立来源一致,medium 为单一强来源或多个弱来源,low 为单一轶事或推测);列出缺口,即什么会改变答案、语料中缺了什么。
- 输出简报:使用固定模板,包含标题、日期、所支撑的决策、整体置信度、TL;DR、关键发现、矛盾/不确定性、缺口、建议的后续步骤、来源列表。
- 归档:把简报写入归档目录,文件名格式为
<YYYY-MM-DD>-<slug>.md,并在INDEX.md追加一行索引;归档位置默认为${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/deep-research/archive/。资料特别提示:不要把归档写在技能自己的文件夹内,因为技能安装和升级会从源重新同步并清空那里保存的内容;如果该技能文件夹中存在旧的references/research-archive/用户条目,应先把这些文件移入归档目录。 - 呈现:归档后在聊天中展示完整简报,告知归档路径,并询问“要推送到 Notion 或保存到某个项目的文档吗?”。
来源菜单
资料来源与使用时机如下:
- Web search (Google):权威文章、文档、官方声明。用法为所用代理的网络搜索(例如 Claude Code 中的 WebSearch)。
- /last30days:了解人们当下实际在说什么,覆盖 Reddit、X、YouTube、HN 及网络近期内容。若已安装 last30days 技能则使用,否则跳过并注明这一缺口。
- 特定 URL:当用户提供了起始链接时。用法为代理的 URL 抓取(例如 WebFetch),或 curl + defuddle。
- 可浏览页面(需登录、JS 较重):定价页、产品导览、个人资料页。用法为 agent-browser CLI(任何带 shell 的代理)。
- Memory:用户已记录过的先前研究、决策或上下文。用法为代理的记忆,或
grep ${MAKERSKILLS_MEMORY:-${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/memory}/。 - Notion:当主题涉及已知的 Notion 工作区时。通过 Notion 直接 API(key 在
$NOTION_API_KEY,参见 reference_notion_api.md)。 - Research archive:先前触及该主题的 /deep-research 运行结果。用法为
grep ${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/deep-research/archive/。
发现阶段的执行应尽可能并行;只有当某个来源需要另一个来源的输出时才串行(例如用 agent-browser 打开由网络搜索发现的 URL)。
使用方式
以 /deep-research 调用。技能会按上述步骤推进:复述问题、规划来源、收集带来源摘要与日期与置信度的条目、按主题综合并标注矛盾与缺口、按模板输出简报、归档到指定目录并写入索引行,最后在对话中展示简报与归档路径。
与其他技能的配合
资料列出了以下组合:
- business-brainstorm:在市场验证步骤中调用本技能。
- /domain:当研究涉及“.com 是否可用”时。
- /last30days:作为数据来源之一。
输出模板
# Research: <question>
**Date:** <YYYY-MM-DD>
**Decision this informs:** <one line>
**Confidence overall:** high / medium / low
## TL;DR
<2–4 sentences with the answer>
## Key findings
### 1. <Finding>
<2–4 sentences>. Sources: [1], [3], [5]
### 2. <Finding>
...
## Contradictions / uncertainty
- <where sources disagree, with each side cited>
## Gaps
- <what's missing from the corpus>
- <what to research next to close the gap>
## Recommended next steps
1. <action>
2. <action>
## Sources
[1] <Title> — <URL or system> (<date>) — <confidence>
[2] ...
限制与质量要求
- 必须引用:简报中的每一条主张都需要来源指针。
- 时效性重要:标注每个来源的日期;对于快速变化的主题(AI、创业公司),降低超过 12 个月的来源的权重。
- 高风险主张不要依赖单一来源:应持续检索直到至少有两个独立来源相互印证,或明确呈现不确定性。
- 不要填充内容:如果答案只有一段,就返回一段;模板是上限,不是下限。
- 归档不得写在技能自身文件夹内,技能安装与升级会从源重新同步并清除其中内容。
暂未提供的信息
资料未说明该技能的收费方式、价格、支持的具体代理平台范围、安装命令、可处理的数据量上限或性能指标,这些内容暂未提供。