Claude Deep Research Skill:企业级 AI 调研引擎
8 阶段流水线 + 来源可信度评分 + 自动验证:让 Claude Code 产出"每个数字都能追溯到出处"的深度研究报告(Markdown / 麦肯锡风 HTML / PDF)。高中生可读,细节拉满。
↗ 打开 GitHub 仓库原链一、它解决什么问题
一句话定位:一个「企业级」深度研究 Skill——你给它一个问题(比如「量子计算现在发展到哪了」),它会派出一支调研小队并行搜集资料、给每个来源打可信度分、用 3 个以上独立来源交叉验证每个关键结论,最后交出一份带完整引用、能追溯到原文的研究报告,还附带「机器质检」自动验一遍。
README 里它自称 Enterprise-grade(企业级),意思是:不是 demo 级别的玩具,而是有固定流水线、质量门禁、自动验证的生产工具——报告质量号称超过 OpenAI、Gemini 和 Claude Desktop 自带的深度研究功能。
普通 AI 写调研报告,像一个记忆力超群但爱现的实习生:张口就来,引用随手编,错了还特自信。这个 Skill 干的事,是给实习生配一个完整的"调研特种兵小队 + 质检部":先遣侦察兵(5-10 路并行搜索 + 2-3 个子智能体分头深挖);情报分析官(每个来源打 0-100 可信度分,低分来源重点盯防);交叉验证组(关键结论必须 3 个独立来源对上才算数);红队(三个"找茬人格"专门挑报告的毛病);机器质检员(9 项自动检查 + 引用真伪验证,不过就打回去重写,最多 3 轮)。小队 + 质检部 = 可信的深度研究。
它要消灭的 4 种「调研事故」
- 事故一:年份穿越。AI 用训练数据里的旧知识回答「现在」的问题——2026 年了还在引用 2023 年的「最新进展」。对策:Step 0 强制先查今天日期,所有时效性搜索都按当前年份过滤。
- 事故二:单一信源。整篇报告的结论都来自同一篇营销软文。对策:关键结论必须 3 个以上独立来源交叉验证(Triangulate)。
- 事故三:引用编造。参考文献列表里混着不存在的论文/链接。对策:verify_citations.py 自动验证 DOI 和 URL,抓幻觉引用。
- 事故四:上下文丢失。报告写一半,AI「忘了」前面的证据。对策:证据落盘——引用和证据存进磁盘上的 JSON 文件,不只活在 AI 的记忆里。
一句话怎么用(先睹为快)
deep research on the current state of quantum computing
(对量子计算现状做一次深度研究)
deep research in ultradeep mode: compare PostgreSQL vs Supabase for our stack
(用最深模式:对比 PostgreSQL 和 Supabase,帮我们做技术选型)
就这么一句话,剩下的(搜集、验证、写报告、质检)全是 Skill 的流水线自动完成的。报告默认存到 ~/Documents/[主题]_Research_[日期]/,一次给你三个版本:Markdown(源文件)、HTML(麦肯锡风格排版,自动在浏览器打开)、PDF(可打印)。超长报告(超过 18000 词)会自动「续写」——派新的子智能体接着写,上下文不断。
二、仓库结构导览
32 个文件,分工非常「工程化」——像一家小公司的组织架构:
deep-research/ <- Skill 根目录(clone 到 ~/.claude/skills/deep-research)
|-- SKILL.md <- 总指挥:精简入口(约 100 行),只讲怎么调度
|-- reference/ <- 作战手册:各阶段详细方法论(6 份)
| |-- methodology.md <- 8 阶段流水线详解(本课件第四节)
| |-- quality-gates.md <- 质量门禁:验证标准 + 防幻觉协议
| |-- report-assembly.md <- 报告渐进式组装策略
| |-- html-generation.md <- 麦肯锡风 HTML 转换指南
| |-- continuation.md <- 超长报告自动续写协议
| `-- weasyprint_guidelines.md <- PDF 生成指南
|-- schemas/ <- 数据格式契约:JSON Schema(4 份)
| |-- claim.schema.json <- "一条主张"长什么样
| |-- evidence.schema.json <- "一条证据"长什么样
| |-- source.schema.json <- "一个来源"长什么样
| `-- run_manifest.schema.json <- "一次研究任务"的清单
|-- scripts/ <- 机器质检员:Python 工具链
| |-- validate_report.py <- 报告结构 9 项自动检查
| |-- verify_citations.py <- 引用验证:DOI/URL/幻觉检测
| |-- verify_claim_support.py <- 主张-证据支撑验证
| |-- extract_claims.py <- 从报告中抽取所有主张
| |-- source_evaluator.py <- 来源可信度 0-100 打分
| |-- citation_manager.py <- 引用追踪管理
| |-- evidence_store.py <- 证据落盘存储
| |-- md_to_html.py / verify_html.py <- HTML 转换与校验
| `-- research_engine.py <- 核心编排引擎
|-- templates/ <- 报告模板
| |-- report_template.md <- Markdown 报告结构模板
| `-- mckinsey_report_template.html <- 麦肯锡风格 HTML 模板
|-- tests/fixtures/ <- 测试用的"好报告/坏报告"样本
`-- requirements.txt <- Python 依赖
只有约 100 行,故意不写细节——细节全在 reference/ 里。这是 Skill 设计的经典手法:入口文件只负责「调度」,需要深挖时再按需加载手册,避免一次塞太多进上下文。
methodology.md:8 阶段流水线每一阶段的目标、动作、输出(本课件第四节逐段讲)。quality-gates.md:质量门禁——9 项自动检查、引用验证、防幻觉协议、参考文献零容忍(本课件第五节)。report-assembly.md:渐进式生成策略——报告不是一口气写完,而是一节一节组装,每节都过质检。html-generation.md+weasyprint_guidelines.md:怎么把 Markdown 变成麦肯锡风 HTML 和可打印 PDF。continuation.md:超长报告(超过 18000 词)的自动续写协议——递归派子智能体,保证上下文不断。
4 个 JSON Schema 文件,规定了「主张 / 证据 / 来源 / 任务清单」这四种数据的标准格式。比如每条证据必须包含:主张文本、原文引用、来源 URL、来源标题、置信度。格式统一,机器才能自动验证「这条主张有没有证据撑着」。(详见第六节)
这是「企业级」三个字的主要底气:质量不靠 AI 自觉,靠脚本硬检查。
validate_report.py:9 项结构检查(摘要长度、章节齐全、引用格式、参考文献对得上、无占位符、词数合理、至少 10 个来源、无坏链)。verify_citations.py:引用真伪验证——DOI 能不能解析、标题年份对不对得上、抓可疑条目(比如很新的年份却没有 DOI)。verify_claim_support.py:主张-证据支撑验证——报告里每个主张,在证据库里真有出处吗?source_evaluator.py:给每个来源打 0-100 可信度分。citation_manager.py+evidence_store.py:引用追踪 + 证据落盘(可信机制核心)。
templates/:报告的标准骨架(Markdown 版 + 麦肯锡风 HTML 版),保证每次输出格式统一、专业。tests/fixtures/:一份「好报告」样本 + 一份「坏报告」样本——质检脚本的考试卷,用来保证检查逻辑本身没坏。
三、四种研究模式:按需选火力
不是所有问题都值得「火力全开」。Skill 提供 4 档模式:
| 模式 | 阶段数 | 耗时 | 适合什么时候用 |
|---|---|---|---|
| Quick 快速 |
3 阶段 | 2-5 分钟 | 初步探索:「这个概念大概是什么」 |
| Standard 标准 |
6 阶段 | 5-10 分钟 | 大多数研究问题(默认档) |
| Deep 深度 |
8 阶段 | 10-20 分钟 | 复杂主题、关键决策 |
| UltraDeep 超深 |
8+ 阶段 | 20-45 分钟 | 要交差的完整报告、最高严谨度 |
就像去医院看病:Quick 是门诊问诊(5 分钟给你个方向),Standard 是常规检查(该查的都查),Deep 是住院详查(多科室会诊),UltraDeep 是疑难杂症专家会诊(顶级专家团 + 全部检查手段)。小感冒别做全身 CT,做决策前别只问诊——火力要和问题匹配。
触发方式很简单,在需求里加一句就行:deep research in ultradeep mode: ...
四、八阶段流水线:从问题到报告的完整旅程
这是 reference/methodology.md 的核心——8 个阶段(外加一个 4.5),每个阶段都有明确的目标、动作、输出。先看全景图:
图 1:八阶段流水线全景(据 reference/methodology.md 绘制)
检索阶段的 8 个搜索角度(阶段 3 的拆解套路)
动手搜之前,先把问题拆成 5-10 个独立的搜索角度,一次并行发出。官方示例(以量子计算为例):
- 核心主题(语义搜索):量子计算现状
- 技术细节(关键词):量子纠错、具体技术名词
- 最新进展(按日期过滤):过去 12-18 个月的新东西
- 学术来源:论文、正式分析
- 对立视角:批评、质疑、竞争路线
- 数据/统计:量化证据、基准数字
- 产业分析:商业应用、市场趋势
- 局限与失败:已知问题、失败模式、边界情况
这就像记者写深度调查:不只采访支持者,还要采访批评者、查数据、翻旧账、问失败案例。8 个角度 = 8 个话筒,堵住"只听一面之词"的漏洞。
搜索工具链:三级火箭
| 工具 | 定位 | 说明 |
|---|---|---|
| search-cli | 主力 | 自研多源聚合搜索(Brave / Serper / Exa / Jina / Firecrawl),按查询类型自动选最合适的源。brew install search-cli 安装,需配至少一个 API key。 |
| WebSearch | 备胎 | Claude 内置搜索,search-cli 挂了或被限流时顶上,零配置。 |
| Exa MCP | 外援 | 可选的语义/神经搜索,和 search-cli 打配合。 |
五、可信机制深讲:五道安检门
「可信」是这个 Skill 的立身之本。拆开看五道门:
第一道门:来源可信度评分(0-100)
source_evaluator.py 给每个来源打分:高于 80 分的来源优先用来支撑核心结论;低于 40 分的标为低可信度,要额外验证。检索时还要保证来源多样性:学术、产业、新闻、技术文档至少 3 类,时间上有新有旧,观点上有支持有批评,地域上不只看美国。
就像法庭采信证据:官方档案、学术论文 = 高可信度证人;营销软文、自媒体 = 低可信度证人,要交叉佐证才能用。不能全案只靠一个"证人"定罪。
第二道门:三角验证(Triangulate)
- 关键主张必须有 3 个以上独立来源交叉印证;
- 单个来源的信息要明确标记出来;
- 有矛盾的地方不掩盖——记下来,标出「共识区」和「争议区」。
第三道门:结构化证据 + 磁盘持久化(证据链)
子智能体不许只返回自由文本,必须返回结构化证据对象:
{"claim": "具体的主张文本",
"evidence_quote": "来源中的原文引用",
"source_url": "https://...",
"source_title": "...",
"confidence": 0.85}
并且每批检索结果立即落盘:先用 citation_manager.py 注册来源(拿到稳定 ID),再用 evidence_store.py 把证据写进 evidence.jsonl。证据不只活在 AI 的记忆里——这样即使中途换智能体续写、即使上下文被压缩,证据链也不会丢,后续的「主张-证据支撑验证」也能查到。
第四道门:机器质检(9 项自动检查 + 引用真伪验证)
报告生成后,必须跑两遍机器质检(reference/quality-gates.md 规定的 Validation Loop):
python scripts/validate_report.py --report [报告路径] # 9 项结构检查
python scripts/verify_citations.py --report [报告路径] # 引用真伪检查
9 项结构检查包括:执行摘要 200-400 词、必需章节齐全、引用格式 [1][2][3] 规范、参考文献与正文引用对得上、无 TBD/TODO 占位符、词数合理、至少 10 个来源、无坏链。引用真伪检查包括:DOI 能不能解析、标题年份对不对得上、可疑条目(很新的年份却没有 DOI/URL)直接标出。
验证循环:检查 → 修 → 重跑,最多 3 轮。3 轮还不过?停下来,把问题如实报告给用户——不许「差不多得了」就交差。
图 2:验证循环(据 reference/quality-gates.md 绘制)
第五道门:防幻觉写作协议
- 事实 vs 合成必须分清:来自来源的叫事实("According to [1]……"),AI 自己的分析叫推断("This suggests……")——不许把推测写成事实。
- 即时引用:每个事实主张后面当句跟引用编号,不许攒到段末。
- 不许模糊甩锅:不许写"研究表明",必须写"Smith 等人 (2024) 发现…… [1]"(谁、在哪年、发现了什么)。
- 不确定就承认:没搜到就是"没找到直接相关的来源",绝不编一条引用来填空。
- 参考文献零容忍:正文用了 [N],文末必须有第 N 条;不许"[8-75] 等"这种省略,不许截断。
六、Schema 与脚本工具链:机器能读懂的"填空表"
JSON Schema 是什么?先看个比喻
快递单就是一种 Schema:寄件人、收件人、电话、地址——每个格子规定好,分拣机器才能自动处理。如果每个人随便写,机器就瞎了。
schemas/ 里的 4 个 JSON Schema 文件,就是给「主张 / 证据 / 来源 / 任务清单」这四种数据定的快递单格式:每条证据必须有哪几个字段、字段是什么类型,写得明明白白。格式统一了,verify_claim_support.py 这种脚本才能自动检查"这条主张到底有没有证据撑着"。4 个 Schema 管什么
| Schema 文件 | 规定什么数据的格式 | 为什么重要 |
|---|---|---|
claim.schema.json |
一条「主张」:文本、类型、置信度 | 让脚本能从报告里自动抽取所有主张(extract_claims.py) |
evidence.schema.json |
一条「证据」:原文引用、来源 ID、定位(如第几页) | 证据链的最小单元,落盘到 evidence.jsonl |
source.schema.json |
一个「来源」:URL、标题、作者、日期、可信度分 | 引用追踪的基础,DOI/URL 验证的对象 |
run_manifest.schema.json |
一次「研究任务」的清单:模式、阶段、产物位置 | 超长报告续写时,新智能体靠它接上上下文 |
脚本工具链的分工(9 个脚本,一句话版)
research_engine.py:总调度——按 8 阶段编排整个流程。source_evaluator.py:打分员——来源可信度 0-100。citation_manager.py:户籍警——给每个来源注册稳定 ID。evidence_store.py:档案员——证据写入 evidence.jsonl 落盘。extract_claims.py:摘抄员——从报告里抽出所有主张。verify_claim_support.py:审计员——每个主张在证据库里有出处吗?verify_citations.py:打假员——DOI/URL 真伪、幻觉引用检测。validate_report.py:质检员——9 项结构检查。md_to_html.py/verify_html.py:排版员——转麦肯锡风 HTML 并校验。
记住这个感觉:AI 负责"动脑"(搜索、综合、写作),脚本负责"较真"(打分、验证、落盘)——动脑的和较真的是两拨人,质量才靠得住。
七、安装与上手
基础安装(一行命令)
git clone https://github.com/199-biotechnologies/claude-deep-research-skill.git ~/.claude/skills/deep-research
# 基础用法零依赖,装完就能用
可选:search-cli(多源聚合搜索,让检索火力翻倍)
brew tap 199-biotechnologies/tap && brew install search-cli
search config set keys.brave YOUR_KEY # 至少配置一个搜索源的 API key
# 支持 Brave / Serper / Exa / Jina / Firecrawl 多家聚合
然后这样用(可复制的提示词)
deep research on the current state of quantum computing
deep research in ultradeep mode: compare PostgreSQL vs Supabase for our stack
# 报告自动存到 ~/Documents/[主题]_Research_[日期]/
# Markdown + HTML(自动在浏览器打开)+ PDF 三件套一次给齐tests/fixtures/ 有一份好报告样本和一份坏报告样本,跑一遍 validate_report.py 就知道 9 项检查是怎么抓毛病的。八、三个适用场景小故事
CTO 老方要在 PostgreSQL 和 Supabase 之间选型,网上观点两极分化。他甩了一句:「deep research in ultradeep mode: compare PostgreSQL vs Supabase for our stack」。40 分钟后,一份带 30+ 来源的报告摆在面前:性能基准有出处、成本对比有数字、争议点(比如"Supabase 锁不锁定")单独列了「共识 vs 争议」——每个数字后面都跟著引用编号,点进去就是原文。老方说:「这比我自己搜三天还扎实。」
研一的小夏要做量子计算方向的开题,导师让她先交一份领域现状综述。她用标准模式跑了一次,报告里「近 18 个月进展」那一节让她很惊喜——因为 Step 0 先查了当前日期,所有"最新"都是真最新,没有混进 2023 年的旧闻。她把 HTML 版(麦肯锡风格排版)直接发给导师,导师问的第一个问题是:「你这参考文献都是真的吗?」——她点开 verify_citations 的思路解释:「每个 DOI 都是脚本验证过的。」
分析师阿南让 Skill 调研某新兴 AI 硬件公司,初稿结论很乐观。结果第 6 阶段的「对抗型审稿人」人格跳出来挑刺:「核心增长数据只来自该公司自己的新闻稿,3 个独立来源呢?」流水线自动回环到第 3 阶段补了增量搜索,挖出两家独立媒体的质疑报道。终稿里专门加了一节「争议与风险」。阿南把报告递给老板时多说了一句:「乐观结论旁边,我放了反方证据。」——这正是 Triangulate + 红队存在的意义。
九、总结与延伸思考
一句话总结
这是一个「调研工业化」的 Skill:8 阶段流水线管流程、4 档模式管火力、可信度评分 + 三角验证 + 证据落盘管「可信」、9 项检查 + 引用打假管「质检」——目标是让 AI 的深度研究报告每个结论都找得到出处。
它的 3 个最大特点
- 证据链工程化:主张 → 原文引用 → 来源 URL → 可信度分,全部结构化、全部落盘,不只活在 AI 的记忆里。
- 质量靠脚本不靠自觉:9 项自动检查 + DOI/URL 打假 + 最多 3 轮验证循环,不过就打回,3 轮不过就如实上报。
- 会自我批评:红队三人格 + 关键盲区自动回环补搜,不带盲区交报告。
延伸思考
- 第 10 个课件(ai-research-skill)解决的是「实验可信」,这个解决的是「文献/调研可信」——如果把两个 Skill 串起来用,一个完整的 AI 科研工作站长什么样?(先用 deep-research 做领域调研,再用 ai-research 跑实验,最后用第 09 个课件的 research-paper-writing 写论文。)
- 「事实 vs 推断必须分清」这条写作协议,其实适用于你写的任何东西——试着检查你上次写的报告/作文:有没有把推测写成事实?有没有"研究表明"式甩锅?
- 1165 个 star 是三个仓库里最高的——你觉得它最打动人的是哪一点?是 8 阶段流水线,还是"机器质检"的不妥协?
↗ GitHub 仓库原链:199-biotechnologies/claude-deep-research-skill
术语翻卡:点击卡片看高中生版解释
自测:单选,点击选项即判对错
点一个选项,绿色=答对,红色=答错,解析会自动展开。