catalog/repos/adebayobraimah--claude-deep-research-skill.md

4.7 KiB
Raw Blame History

深度研究技能插件

研究报告 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.py9 项检查)+ verify_citations.pyDOI/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 —— 可根据您的工作流程自由修改。