4.7 KiB
4.7 KiB
深度研究技能插件
研究报告 Claude Code 多源搜索 引用验证 自动化
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 —— 可根据您的工作流程自由修改。