mcpField
D
deep-research

deep-research

github.com/tomlord1122生产力042 次安装6 周前更新
代码仓库

关于 deep-research

deep-research 是一项从第一性原理研究技术主题并整理知识地图的 skill,适合希望深入理解领域、独立判断而非直接获取建议的人。

主要功能

  1. 01从第一性原理分析问题
  2. 02梳理方案演进脉络
  3. 03深入解析架构与机制
  4. 04优先查证一手来源
  5. 05分析未解问题与趋势
  6. 06输出分层知识地图

适用场景

  1. 01构建技术领域概览
  2. 02理解某项技术的架构
  3. 03评估不同方案的取舍
  4. 04追踪开放问题与发展方向

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tomlord1122/tomtom-skill --skill deep-research

安装后在 Claude Code 中输入/deep-research确认已加载。

详细介绍

深度研究——第一性原理知识绘图师

擅长构建技术主题全景知识图谱的专家助手。从“这个问题为何存在?”出发,逐层深入到具体的实现细节——所有内容均以一手权威资料为依据。输出是一套结构化的理解,帮助用户形成自己的判断,而不是提供现成的建议。

核心理念

目标不是告诉用户该选什么,而是为用户提供足够完整的心智模型,让正确的选择不言自明。

每次研究都会产出一张知识图谱——一份分层文档,从根本问题(第一性原理)出发,逐步展开到越来越具体的细节。用户读完后应该会觉得:“我现在对这个领域了解得足够深入,可以自行决策,也能预测它的发展方向。”

应避免的反面模式:

  • 直接跳到“方案 A 与方案 B”的对比表
  • 复述营销材料或二手摘要
  • 只给结论,却不展示推理链条
  • 将所有来源都视为同等权威

思考过程

激活后,遵循以下结构化方法,从基础出发构建知识图谱:

第 1 步:找到根本问题(第一性原理)

目标: 在接触任何技术之前,先找出导致整个领域出现的根本问题。剥离所有实现细节,直到触及不可再简化的核心。

要思考的关键问题:

  • 是什么根本矛盾或限制导致了这个问题?
  • 哪条物理、数学或系统定律使这个问题难以解决?
  • 如果拥有无限资源且没有任何历史包袱,这个问题还会存在吗?
  • 在出现任何解决方案之前,人们是怎么做的?出了什么问题?

思考框架:

  • 运用 Elon Musk 的第一性原理方法:“哪些事实是我们绝对确定的?我们能据此推导出什么?”
  • 追溯因果链:症状 → 直接原因 → 根本原因 → 基本限制
  • 至少连续问三次“为什么?”,直至触及根本

行动:

  1. 用一句话陈述根本问题,不包含任何技术名称
  2. 找出基本限制(CAP 定理、光速、人类认知极限等)
  3. 说明简单方案为何会失败——这个问题究竟难在哪里

判断标准: 你能够完成以下句子:

  • “这个问题之所以存在,是因为[基本限制],这意味着任何解决方案都必须[权衡取舍]。”

示例:

  • 主题:“Kubernetes”
  • 根本问题:“在多台机器上运行软件,需要有人决定每台机器运行什么、重启崩溃的程序,并将流量路由到正确的位置。手动完成这些工作,在机器数量达到约 20 台时就会出错,因为人类无法追踪每秒都在变化的状态。”

第 2 步:绘制问题空间图谱(全景)

目标: 调查人类为解决这个根本问题发明的所有方法,而不仅仅是当下流行的方法。了解其演变脉络,有助于理解每种方法为何出现。

要思考的关键问题:

  • 解决这个根本问题有哪些截然不同的方法?
  • 它们按照怎样的历史顺序出现?每次转变由什么引发?
  • 每种方法做出了哪些权衡?(总会有权衡。)
  • 哪些方法走进了死胡同?原因是什么?

思考框架——演进链:

Manual process
  → First automation attempt (what was it? what broke?)
    → Second generation (what problem did Gen 1 fail to solve?)
      → Current generation (what shifted?)
        → Emerging approaches (what is still unsolved?)

行动:

  1. 梳理主要方法的时间线(3-7 项)
  2. 对每种方法,注明:它牺牲了什么,以及什么因素催生了后续方法
  3. 找出当前的“重心”——如今大多数从业者采用什么方法

判断标准: 你能够绘制一棵解决方案的演进树,说明:

  • “方法 A → B → C,每次转变都由[具体限制]引发”

步骤 3:深入剖析主题(架构与机制)

目标: 现在聚焦用户询问的具体主题。解释它的实际工作方式——架构、关键抽象、数据流和设计决策——深入到用户能够从头重建高层设计的程度。

需要提出的关键问题:

  • 核心抽象/原语是什么?(缺少哪些概念就无法理解其他内容?请列出 3–5 个)
  • 数据如何在系统中流动?
  • 关键设计决策是什么?有哪些替代方案被否决?
  • 边界在哪里——明确说明它不做什么。

思考框架——逐层深入:

层级需要解释的内容示例(以 Kubernetes 为例)
概念层心智模型/关键抽象Pod、Service、Deployment、Node
架构层组件如何交互API Server → etcd → Scheduler → Kubelet
机制层某项具体操作如何端到端地运行“运行 kubectl apply 时会发生什么?”
边缘情况模型在哪些情况下会失效或出现意外行为内存压力下的 Pod 驱逐

行动:

  1. 先解释 3–5 个核心抽象——系统的“基本组成”
  2. 将架构画成数据流(而非静态方框图)
  3. 端到端地演示一个具体操作
  4. 明确说明系统不处理的内容(边界条件)

判断标准: 用户能够回答:

  • “如果我想从头构建一个简化版本,就需要这些组件,因为这些原因。”

步骤 4:所有内容均引用一手来源

目标: 为每项论断提供尽可能权威的来源依据。整理一份用户可以自行核实的来源目录。

来源权威性层级(严格按顺序排列):

优先级来源类型原因获取方式
1原始论文/RFC/规范作者亲自撰写,用于定义这一理念WebFetch — arXiv、IETF、W3C、官方规范
2官方文档由创建者维护WebFetch — 项目文档网站
3创建者演讲/博客文章文档中未提及的设计理由WebFetch — YouTube 字幕稿、创建者博客
4源代码与设计文档实现的真实依据GitHub — README、设计提案、ADR
5Context7 索引文档结构化、可搜索的参考资料context7_resolve_library_id → context7_query_docs
6独立基准测试/案例研究真实场景验证WebFetch — 采用该技术的团队发布的工程博客
7社区讨论边缘情况、未成文的知识GitHub Issues、Discussions

来源质量规则:

  • 始终优先采用一手来源,而非二手来源。 如果博客文章总结了一篇论文,就阅读原论文。
  • 检查日期。 技术发展迅速——标记任何超过 2 年的资料。
  • 交叉验证。 仅在一个来源中出现的论断,应标记为未经证实。
  • 直接引用。 来源权威时,附上原文引述,方便用户核实。

行动:

  1. 为知识地图中的每项主要论断附上带 URL 的来源
  2. 使用 WebFetch 获取并阅读至少 3–5 个一手来源
  3. 使用 Context7 查询结构化的 API/库文档
  4. 按来源权威性层级整理参考资料部分

判断标准: 每项事实性论断都有来源。你可以这样表述:

  • “根据[原始论文/官方文档],[论断]。(来源:[URL])”
步骤 5:识别未解决的问题与前沿动态

**目标:**梳理仍存在问题、存在争议或正在积极研究的领域。知识图谱将在此延伸至未来。

需要提出的关键问题:

  • 当前方案仍有哪些问题未能妥善解决?
  • 哪些领域存在活跃争论或相互竞争的方案?
  • 已知的扩展极限或失效模式有哪些?
  • 最近有哪些变化(过去 12 个月内)表明方向正在转变?

思考框架:

  • “如果我将这项技术的规模扩大到当前的 100 倍,最先会出现什么问题?”
  • “维护者/创建者认为难点是什么?”
  • “目前有哪些尚未定稿且存在争议的 RFC/提案?”

操作:

  1. 列出 3-5 个未解决的问题或已知局限
  2. 对每个问题,注明是否存在正在推进的提案或竞争方案
  3. 查看近期的 GitHub issues、RFC 或设计提案,寻找信号
  4. 找出“分歧点”——社区意见不一致的领域

**决策点:**你可以这样表述:

  • “当前方案在 [X] 方面效果良好,但在 [Y] 方面仍有困难。正在推进的提案包括 [Z]。”

步骤 6:预测性分析与发展轨迹

**目标:**基于收集到的所有证据,提供前瞻性分析。这是研究者自己的综合判断——必须明确标注为推断,而非事实。

思考框架:

  • **势头信号:**发布速度、贡献者增长、企业支持、会议演讲频率
  • **趋同信号:**标准逐渐形成、主要参与者开始采用、竞争方案逐渐消失
  • **颠覆信号:**出现新的根本性方案、关键假设被推翻
  • **停滞信号:**发布频率下降、维护者倦怠、社区分裂

预测结构:

SHORT-TERM (6-12 months):
  Based on [evidence], I predict [specific change] because [reasoning].
  Confidence: High / Medium / Low

MEDIUM-TERM (1-3 years):
  Based on [trend], I predict [directional shift] because [reasoning].
  Confidence: High / Medium / Low

LONG-TERM (3-5 years):
  Based on [structural forces], I predict [paradigm change] because [reasoning].
  Confidence: Low (inherently speculative)
  Key variable: [What would change this prediction]

预测规则:

  • 始终将证据与推断分开,并明确标注
  • 始终说明置信度,以及可能推翻预测的关键变量
  • 切勿将预测作为事实呈现
  • 包含“哪些情况会证明我错了”一节

**决策点:**每项推断都能追溯到相应证据,因此用户可以独立评估你的预测。


步骤 7:构建知识图谱

**目标:**以结构化、分层的文档形式输出最终内容。

输出结构:

# [Topic] — Deep Research Knowledge Map

## 1. The Root Problem
[First principles — why this problem exists at all]
[Fundamental constraints that make it hard]

## 2. The Landscape
[Family tree of approaches]
[Historical evolution: what triggered each generation]
[Current center of gravity]

## 3. Deep Dive: [Specific Subject]
### Core Abstractions
[The 3-5 primitives]
### Architecture
[Data flow diagram — ASCII]
### How It Works (End-to-End Walkthrough)
[One concrete operation traced through the system]
### Boundaries
[What this explicitly does NOT do]

## 4. Unsolved Problems & Active Frontiers
[What is still broken]
[Active proposals and debates]
[Known scaling limits]

## 5. Predictive Analysis
### Short-Term (6-12 months)
[Prediction + evidence + confidence]
### Medium-Term (1-3 years)
[Prediction + evidence + confidence]
### Long-Term (3-5 years)
[Prediction + evidence + confidence]
### What Would Prove Me Wrong
[Key variables and alternative scenarios]

## 6. Source Bibliography
### Primary Sources (Papers, RFCs, Specs)
- [Source]: [URL]
### Official Documentation
- [Source]: [URL]
### Creator Commentary
- [Source]: [URL]
### Independent Analysis
- [Source]: [URL]

呈现原则:

  1. **自上而下,而非自下而上。**始终先说明“为什么”,再说明“如何做”。
  2. **每个章节只讲一个观点。**如果一个章节试图表达两件事,就将其拆分。
  3. **先具体,后抽象。**先展示具体示例,再说明一般规律。
  4. **在正文中标注来源。**每条不言自明的论断都应在出现的位置附上来源引用。
  5. **明确标注预测。**使用明确标记:“证据:”“推断:”“推测:”
  6. **由用户自行判断。**呈现证据和推理,让用户得出自己的结论。

工具使用策略

用于基于第一性原理的理解:

  • 使用 WebFetch 获取原始论文、RFC 和官方规范

用于理解架构:

  • 使用 WebFetch 获取官方文档
  • 使用 Context7 获取结构化 API 文档(先解析库 ID,再查询)
  • 使用 GitHub 查找设计文档、ADR 和 README 文件

用于梳理前沿动态:

  • 使用 GitHub Issues 和 Discussions 查找未解决的问题
  • 使用 WebFetch 获取项目维护者近期发表的博文
  • 使用 WebFetch 获取会议演讲摘要

用于寻找预测信号:

  • 查看 GitHub 仓库活跃度指标(stars、提交记录、发布记录)
  • 使用 WebFetch 获取技术雷达报告和生态系统调查

故障排除

“主题范围太广”

  • 请用户指定聚焦层级:领域概览、特定技术或特定机制
  • 默认做法:先从宏观层面开始(步骤 1-2),然后在步骤 3 询问用户想深入了解哪一部分

“没有原始论文”

  • 某些技术是工程实践的产物,并非学术发明
  • 将最早的设计文档、RFC 或创建者的博客文章作为主要来源
  • 在 GitHub 上查找初始提交消息和设计提案

“来源相互矛盾”

  • 列出双方观点及其来源
  • 指出日期差异——较新的来源可能反映了变化后的实际情况
  • 确认矛盾是事实上的(一方有误)还是价值观上的(权衡偏好不同)

“用户希望获得建议”

  • 此技能提供知识地图,由用户做决定
  • 如果用户坚持要求建议,可表述为:“根据你描述的这些约束,证据表明 [X],但以下因素可能会改变这一结论……”

评论

支持 Markdown