深度研究技能插件

研究报告 Claude Code 多源搜索 引用验证 AI技能

Claude Code 深度研究技能

面向企业级的 Claude Code 研究引擎。可生成带引用来源、可信度评分、多搜索提供商支持及自动化验证的研究报告。

安装

# 克隆到 Claude Code 技能目录
git clone https://github.com/199-biotechnologies/claude-deep-research-skill.git ~/.claude/skills/deep-research

基本用法无需额外依赖。

可选：search-cli（多搜索提供商）

聚合 Brave、Serper、Exa、Jina 和 Firecrawl 的搜索结果：

brew tap 199-biotechnologies/tap && brew install search-cli
search config set keys.brave YOUR_KEY  # 至少配置一个提供商

使用方法

deep research on the current state of quantum computing

deep research in ultradeep mode: compare PostgreSQL vs Supabase for our stack

研究模式

模式	阶段数	时长	适用场景
Quick（快速）	3	2-5 分钟	初步探索
Standard（标准）	6	5-10 分钟	大多数研究问题
Deep（深度）	8	10-20 分钟	复杂课题、关键决策
UltraDeep（超深度）	8+	20-45 分钟	综合报告、最高严谨度

处理流水线

界定范围 → 制定计划 → 检索（并行搜索 + 子代理）→ 三角验证 → 提纲优化 → 综合分析 → 批判审查（含回环）→ 精炼 → 打包输出

核心特性：

第 0 步：搜索前获取当前日期（防止使用陈旧训练数据的年份假设）
并行检索：5-10 个并发搜索 + 2-3 个专注子代理，返回结构化证据对象
首完成搜索：按模式自适应调整质量阈值
批判回环：第 6 阶段若发现关键缺口，可携带增量查询返回第 3 阶段
多角色红队测试：怀疑派实践者、对抗性审查员、实施工程师（深度/超深度模式）
磁盘持久化引用：sources.json 在上下文压缩和续写代理间保持存活

输出

报告保存至 ~/Documents/[主题]_Research_[日期]/：

Markdown（主要可信来源）
HTML（麦肯锡风格，自动在浏览器中打开）
PDF（通过 WeasyPrint 生成专业打印版）

超过 18,000 字的报告将通过递归代理生成自动续写，并保留上下文。

质量标准

来源 10 篇以上，每个主要论点至少 3 篇
执行摘要 200-400 字
每项发现 600-2,000 字，散文比例 ≥80%
完整参考文献含 URL，无占位符
自动化验证：validate_report.py（9 项检查）+ verify_citations.py（DOI/URL/幻觉检测）
验证循环：验证 → 修复 → 重试（最多 3 轮）

搜索工具

工具	使用时机	配置要求
WebSearch	默认，始终可用	无
Exa MCP	语义/神经网络搜索	MCP 配置
search-cli	多提供商聚合	`brew install search-cli` + API 密钥

架构

deep-research/
├── SKILL.md                          # 技能入口（精简，约 100 行）
├── reference/
│   ├── methodology.md                # 8 阶段流水线详情
│   ├── report-assembly.md            # 渐进式生成策略
│   ├── quality-gates.md              # 验证标准
│   ├── html-generation.md            # 麦肯锡 HTML 转换
│   ├── continuation.md               # 自动续写协议
│   └── weasyprint_guidelines.md      # PDF 生成指南
├── templates/
│   ├── report_template.md            # 报告结构模板
│   └── mckinsey_report_template.html # HTML 报告模板
├── scripts/
│   ├── validate_report.py            # 9 项结构验证器
│   ├── verify_citations.py           # DOI/URL/幻觉检查器
│   ├── source_evaluator.py           # 来源可信度评分
│   ├── citation_manager.py           # 引用追踪管理
│   ├── md_to_html.py                 # Markdown 转 HTML
│   ├── verify_html.py                # HTML 验证
│   └── research_engine.py            # 核心编排引擎
└── tests/
    └── fixtures/                     # 测试报告固件

版本历史

版本	日期	变更内容
2.3.1	2026-03-19	模板/验证器协调、结构化证据对象、批判回环、多角色红队测试
2.3	2026-03-19	合约协调、search-cli 集成、动态年份检测、磁盘持久化引用、验证循环
2.2	2025-11-05	无限长度自动续写系统
2.1	2025-11-05	渐进式文件组装
1.0	2025-11-04	首次发布

许可证

MIT —— 可根据您的工作流程自由修改。

4.7 KiB Raw Permalink Blame History Unescape Escape