关于 deep-research
deep-research 是用于规划、多源搜集并综合研究信息的技能,完成后会归档简报。它适合需要来源引用、明确呈现不确定性并保留可复用研究记录的场景。
主要功能
- 01明确研究问题
- 02规划并执行多源检索
- 03归纳主题与矛盾信息
- 04记录置信度和证据缺口
- 05归档简报并维护索引
适用场景
- 01以多来源发现支持决策
- 02比较不同来源的冲突说法
- 03通过可检索归档复用既有研究
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ coreyhaines31/ makerskills --skill deep-research安装后在 Claude Code 中输入/deep-research确认已加载。
详细介绍
/deep-research — 多来源研究与归档
从多个来源规划、执行并综合研究结果。归档输出,让知识库不断积累。
第 1 步 — 明确问题
用一句简洁的话重述研究问题。如果问题含糊,请询问用户:
- 这项研究将为哪项决策提供依据?
- 最低限度的有用答案是什么?(避免研究过度。)
- 有需要优先考虑或避开的来源吗?
输出:**研究问题:** <一句话>
第 2 步 — 规划来源
根据问题类型,从此菜单中选择来源。说明将使用哪些来源,以及原因。
| 来源 | 适用情况 | 使用方式(工具名称因 Agent 而异) |
|---|---|---|
| Web 搜索(Google) | 权威文章、文档、官方声明 | 使用你的 Agent 的 Web 搜索工具(例如 Claude Code 中的 WebSearch) |
/last30days | 了解人们当下实际在说什么——Reddit、X、YouTube、HN、近期网页内容 | 如果已安装,则使用 last30days 技能。否则跳过,并说明这一缺口 |
| 特定 URL | 用户提供了起始 URL 时 | 使用你的 Agent 的 URL 抓取工具(例如 WebFetch),或使用 curl + defuddle |
| 可浏览的网页(有身份验证墙、依赖大量 JavaScript) | 定价页面、产品介绍、个人资料 | 使用 agent-browser CLI(任何带 shell 的 Agent 均可) |
| 记忆 | 用户已记录的先前研究、决策或上下文 | 使用你的 Agent 的记忆,或 grep ${MAKERSKILLS_MEMORY:-${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/memory}/ |
| Notion | 主题涉及已知的 Notion 工作区时 | 直接调用 Notion API(密钥位于 $NOTION_API_KEY,参见 reference_notion_api.md) |
| 研究档案 | 先前涉及此主题的 /deep-research 运行记录 | grep ${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/deep-research/archive/ |
尽可能并行运行发现流程。只有在一个来源需要使用另一个来源的结果时才按顺序执行(例如,使用 agent-browser 浏览 Web 搜索发现的 URL)。
第 3 步 — 执行发现
运行每个选定的来源。对于每条结果,记录:
- 来源(URL 或系统)
- 对其内容的 1–3 句话概述
- 日期/时效性
- 对来源的可信度评估(高/中/低)
暂时不要综合——只收集信息。
第 4 步 — 综合
- 按主题或子问题对发现结果分组
- 检查矛盾——标出来源之间意见不一致之处。不要取平均值;明确呈现分歧。
- 可信度:高(多个独立来源意见一致),中(一条有力来源或数条较弱来源),低(单个轶事或推测)
- 信息缺口:哪些信息会改变答案?知识库中缺少什么?
第 5 步 — 输出简报
使用此模板:
# 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] ...
第 6 步 — 归档
档案存放在 ${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/deep-research/archive/(如果目录不存在,则创建该目录)。切勿将档案写入技能自身的文件夹——技能安装和升级会从源重新同步,并清除保存于该处的内容。**迁移:**如果此技能文件夹中存在包含用户条目的旧 references/research-archive/,请先将其中的文件移至档案目录。
将简报写入 <archive dir>/<YYYY-MM-DD>-<slug>.md,以便永久通过 grep 搜索。slug = 主题的 kebab-case 格式。
同时在 <archive dir>/INDEX.md 中追加一条单行记录(如果文件不存在,则创建):
- 2026-06-15 — [<topic>](./<filename>.md) — <one-line TL;DR>
第 7 步 — 呈现结果
归档后:
- 在聊天中显示完整简报
- 告知用户档案路径
- 询问是否:“推送到 Notion,或保存到某个项目的文档中?”
组合使用
business-brainstorm— 在市场验证步骤中调用此技能/domain— 研究内容包括“是否可以注册 .com”时使用/last30days— 数据来源之一
关于质量的说明
- 始终引用来源。 简报中的每项论断都需要标注来源。
- 时效性很重要——注明每个来源的日期。对于快速变化的领域(AI、初创公司),降低对超过 12 个月的来源的权重。
- 高风险论断不要只相信单一来源。 继续搜索,直到找到至少 2 个独立的佐证来源,或明确说明不确定性。
- 不要凑字数。 如果答案只有一段,就只返回一段。模板是上限,不是下限。
评论
支持 Markdown