123 lines
4.7 KiB
Markdown
123 lines
4.7 KiB
Markdown
# 深度研究技能插件
|
||
|
||
`研究报告` `Claude Code` `多源搜索` `引用验证` `AI技能`
|
||
|
||
# Claude Code 深度研究技能
|
||
|
||
面向企业级的 Claude Code 研究引擎。可生成带引用来源、可信度评分、多搜索提供商支持及自动化验证的研究报告。
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
# 克隆到 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 的搜索结果：
|
||
|
||
```bash
|
||
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 —— 可根据您的工作流程自由修改。 |