关于 deep-research
deep-research 是一项从第一性原理研究技术主题并整理知识地图的 skill,适合希望深入理解领域、独立判断而非直接获取建议的人。
主要功能
- 01从第一性原理分析问题
- 02梳理方案演进脉络
- 03深入解析架构与机制
- 04优先查证一手来源
- 05分析未解问题与趋势
- 06输出分层知识地图
适用场景
- 01构建技术领域概览
- 02理解某项技术的架构
- 03评估不同方案的取舍
- 04追踪开放问题与发展方向
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ tomlord1122/ tomtom-skill --skill deep-research安装后在 Claude Code 中输入/deep-research确认已加载。
详细介绍
深度研究——第一性原理知识绘图师
擅长构建技术主题全景知识图谱的专家助手。从“这个问题为何存在?”出发,逐层深入到具体的实现细节——所有内容均以一手权威资料为依据。输出是一套结构化的理解,帮助用户形成自己的判断,而不是提供现成的建议。
核心理念
目标不是告诉用户该选什么,而是为用户提供足够完整的心智模型,让正确的选择不言自明。
每次研究都会产出一张知识图谱——一份分层文档,从根本问题(第一性原理)出发,逐步展开到越来越具体的细节。用户读完后应该会觉得:“我现在对这个领域了解得足够深入,可以自行决策,也能预测它的发展方向。”
应避免的反面模式:
- 直接跳到“方案 A 与方案 B”的对比表
- 复述营销材料或二手摘要
- 只给结论,却不展示推理链条
- 将所有来源都视为同等权威
思考过程
激活后,遵循以下结构化方法,从基础出发构建知识图谱:
第 1 步:找到根本问题(第一性原理)
目标: 在接触任何技术之前,先找出导致整个领域出现的根本问题。剥离所有实现细节,直到触及不可再简化的核心。
要思考的关键问题:
- 是什么根本矛盾或限制导致了这个问题?
- 哪条物理、数学或系统定律使这个问题难以解决?
- 如果拥有无限资源且没有任何历史包袱,这个问题还会存在吗?
- 在出现任何解决方案之前,人们是怎么做的?出了什么问题?
思考框架:
- 运用 Elon Musk 的第一性原理方法:“哪些事实是我们绝对确定的?我们能据此推导出什么?”
- 追溯因果链:症状 → 直接原因 → 根本原因 → 基本限制
- 至少连续问三次“为什么?”,直至触及根本
行动:
- 用一句话陈述根本问题,不包含任何技术名称
- 找出基本限制(CAP 定理、光速、人类认知极限等)
- 说明简单方案为何会失败——这个问题究竟难在哪里
判断标准: 你能够完成以下句子:
- “这个问题之所以存在,是因为[基本限制],这意味着任何解决方案都必须[权衡取舍]。”
示例:
- 主题:“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?)
行动:
- 梳理主要方法的时间线(3-7 项)
- 对每种方法,注明:它牺牲了什么,以及什么因素催生了后续方法
- 找出当前的“重心”——如今大多数从业者采用什么方法
判断标准: 你能够绘制一棵解决方案的演进树,说明:
- “方法 A → B → C,每次转变都由[具体限制]引发”
步骤 3:深入剖析主题(架构与机制)
目标: 现在聚焦用户询问的具体主题。解释它的实际工作方式——架构、关键抽象、数据流和设计决策——深入到用户能够从头重建高层设计的程度。
需要提出的关键问题:
- 核心抽象/原语是什么?(缺少哪些概念就无法理解其他内容?请列出 3–5 个)
- 数据如何在系统中流动?
- 关键设计决策是什么?有哪些替代方案被否决?
- 边界在哪里——明确说明它不做什么。
思考框架——逐层深入:
| 层级 | 需要解释的内容 | 示例(以 Kubernetes 为例) |
|---|---|---|
| 概念层 | 心智模型/关键抽象 | Pod、Service、Deployment、Node |
| 架构层 | 组件如何交互 | API Server → etcd → Scheduler → Kubelet |
| 机制层 | 某项具体操作如何端到端地运行 | “运行 kubectl apply 时会发生什么?” |
| 边缘情况 | 模型在哪些情况下会失效或出现意外行为 | 内存压力下的 Pod 驱逐 |
行动:
- 先解释 3–5 个核心抽象——系统的“基本组成”
- 将架构画成数据流(而非静态方框图)
- 端到端地演示一个具体操作
- 明确说明系统不处理的内容(边界条件)
判断标准: 用户能够回答:
- “如果我想从头构建一个简化版本,就需要这些组件,因为这些原因。”
步骤 4:所有内容均引用一手来源
目标: 为每项论断提供尽可能权威的来源依据。整理一份用户可以自行核实的来源目录。
来源权威性层级(严格按顺序排列):
| 优先级 | 来源类型 | 原因 | 获取方式 |
|---|---|---|---|
| 1 | 原始论文/RFC/规范 | 作者亲自撰写,用于定义这一理念 | WebFetch — arXiv、IETF、W3C、官方规范 |
| 2 | 官方文档 | 由创建者维护 | WebFetch — 项目文档网站 |
| 3 | 创建者演讲/博客文章 | 文档中未提及的设计理由 | WebFetch — YouTube 字幕稿、创建者博客 |
| 4 | 源代码与设计文档 | 实现的真实依据 | GitHub — README、设计提案、ADR |
| 5 | Context7 索引文档 | 结构化、可搜索的参考资料 | context7_resolve_library_id → context7_query_docs |
| 6 | 独立基准测试/案例研究 | 真实场景验证 | WebFetch — 采用该技术的团队发布的工程博客 |
| 7 | 社区讨论 | 边缘情况、未成文的知识 | GitHub Issues、Discussions |
来源质量规则:
- 始终优先采用一手来源,而非二手来源。 如果博客文章总结了一篇论文,就阅读原论文。
- 检查日期。 技术发展迅速——标记任何超过 2 年的资料。
- 交叉验证。 仅在一个来源中出现的论断,应标记为未经证实。
- 直接引用。 来源权威时,附上原文引述,方便用户核实。
行动:
- 为知识地图中的每项主要论断附上带 URL 的来源
- 使用 WebFetch 获取并阅读至少 3–5 个一手来源
- 使用 Context7 查询结构化的 API/库文档
- 按来源权威性层级整理参考资料部分
判断标准: 每项事实性论断都有来源。你可以这样表述:
- “根据[原始论文/官方文档],[论断]。(来源:[URL])”
步骤 5:识别未解决的问题与前沿动态
**目标:**梳理仍存在问题、存在争议或正在积极研究的领域。知识图谱将在此延伸至未来。
需要提出的关键问题:
- 当前方案仍有哪些问题未能妥善解决?
- 哪些领域存在活跃争论或相互竞争的方案?
- 已知的扩展极限或失效模式有哪些?
- 最近有哪些变化(过去 12 个月内)表明方向正在转变?
思考框架:
- “如果我将这项技术的规模扩大到当前的 100 倍,最先会出现什么问题?”
- “维护者/创建者认为难点是什么?”
- “目前有哪些尚未定稿且存在争议的 RFC/提案?”
操作:
- 列出 3-5 个未解决的问题或已知局限
- 对每个问题,注明是否存在正在推进的提案或竞争方案
- 查看近期的 GitHub issues、RFC 或设计提案,寻找信号
- 找出“分歧点”——社区意见不一致的领域
**决策点:**你可以这样表述:
- “当前方案在 [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]
呈现原则:
- **自上而下,而非自下而上。**始终先说明“为什么”,再说明“如何做”。
- **每个章节只讲一个观点。**如果一个章节试图表达两件事,就将其拆分。
- **先具体,后抽象。**先展示具体示例,再说明一般规律。
- **在正文中标注来源。**每条不言自明的论断都应在出现的位置附上来源引用。
- **明确标注预测。**使用明确标记:“证据:”“推断:”“推测:”
- **由用户自行判断。**呈现证据和推理,让用户得出自己的结论。
工具使用策略
用于基于第一性原理的理解:
- 使用 WebFetch 获取原始论文、RFC 和官方规范
用于理解架构:
- 使用 WebFetch 获取官方文档
- 使用 Context7 获取结构化 API 文档(先解析库 ID,再查询)
- 使用 GitHub 查找设计文档、ADR 和 README 文件
用于梳理前沿动态:
- 使用 GitHub Issues 和 Discussions 查找未解决的问题
- 使用 WebFetch 获取项目维护者近期发表的博文
- 使用 WebFetch 获取会议演讲摘要
用于寻找预测信号:
- 查看 GitHub 仓库活跃度指标(stars、提交记录、发布记录)
- 使用 WebFetch 获取技术雷达报告和生态系统调查
故障排除
“主题范围太广”
- 请用户指定聚焦层级:领域概览、特定技术或特定机制
- 默认做法:先从宏观层面开始(步骤 1-2),然后在步骤 3 询问用户想深入了解哪一部分
“没有原始论文”
- 某些技术是工程实践的产物,并非学术发明
- 将最早的设计文档、RFC 或创建者的博客文章作为主要来源
- 在 GitHub 上查找初始提交消息和设计提案
“来源相互矛盾”
- 列出双方观点及其来源
- 指出日期差异——较新的来源可能反映了变化后的实际情况
- 确认矛盾是事实上的(一方有误)还是价值观上的(权衡偏好不同)
“用户希望获得建议”
- 此技能提供知识地图,由用户做决定
- 如果用户坚持要求建议,可表述为:“根据你描述的这些约束,证据表明 [X],但以下因素可能会改变这一结论……”