storm-research

name	storm-research
description	Full STORM multi-agent research pipeline — 5 parallel perspectives, contradiction mapping, independent peer review, cited synthesis. Outputs MD + HTML + PDF.
author	無為师兄 (WaySage)

STORM Research Pipeline

全功能多 Agent 研究流水线，实现斯坦福 STORM 方法论的全部工程细节：并行多视角检索 → 矛盾图谱分析 → 综合简报 → 独立审稿 → 终稿输出（Markdown + HTML + PDF）。

作者：無為师兄 (WaySage)

用法

/storm-research <研究话题>

项目结构

.claude/
├── skills/storm-research/
│   ├── SKILL.md              ← 本文件（skill 入口）
│   └── references/
│       └── sample-topics.md  ← 已验证的研究话题库
└── workflows/
    └── storm-research.js     ← 核心工作流引擎

research-output/              ← 研究报告输出目录
└── <YYYY-MM-DD>-<topic-slug>/
    ├── report.md             ← Markdown 格式报告
    ├── report.html           ← 精美 HTML 网页报告（含目录导航、卡片式布局、响应式设计）
    └── report.pdf            ← PDF 打印版（通过 PowerShell + Edge headless 自动生成）

架构

用户输入话题
    │
    ├── 准备层（并行）: 搜参考报告 + 知识校准 + 话题拆解
    │
    ├── 研究层（5个独立Agent并行，互不可见）:
    │   ├── 实践者 Agent（WebSearch + WebFetch）
    │   ├── 学术研究者 Agent（WebSearch + WebFetch）
    │   ├── 怀疑论者 Agent（WebSearch + WebFetch）
    │   ├── 经济学家 Agent（WebSearch + WebFetch）
    │   └── 历史学家 Agent（WebSearch + WebFetch）
    │
    ├── 矛盾图谱 Agent: 映射冲突/共识/盲点
    │
    ├── 综合简报 Agent: 整合所有视角
    │
    ├── 独立审稿 Agent（他检）: 专业评审规则，不看推理过程，必须抽查来源URL
    │
    ├── 终稿编译 Agent: 整合审稿意见 → Markdown 报告
    │
    └── HTML 输出 Agent: Markdown → 精美自包含 HTML

执行流程

第一步：启动 Workflow

调用 Workflow 工具：

• scriptPath: .claude/workflows/storm-research.js
• args: { "topic": "<用户的话题>" }

向用户展示各阶段进度。

第二步：落地文件（Workflow 完成后）

从返回结果中获取 output_dir_name、md_report、html_report。

1. 使用 Bash 创建输出目录：

mkdir -p "research-output/<output_dir_name>"

2. 使用 Write 工具写入 Markdown 报告：

file_path: research-output/<output_dir_name>/report.md
content: <md_report>

3. 使用 Write 工具写入 HTML 报告：

file_path: research-output/<output_dir_name>/report.html
content: <html_report>

4. 使用 PowerShell 生成 PDF（通过 Edge headless）：

$outDir = "research-output/<output_dir_name>"
$htmlPath = "$outDir/report.html"
$pdfPath = "$outDir/report.pdf"
Start-Process "msedge" -ArgumentList "--headless --disable-gpu --print-to-pdf=`"$pdfPath`" `"$htmlPath`"" -Wait

如果 Edge 不可用（PDF 生成失败），告知用户可在浏览器中打开 HTML 文件后「打印 → 另存为 PDF」。

第三步：展示结果

向用户展示：

• 输出目录路径和文件列表
• 执行摘要
• 5 大关键发现（附可靠性评分）
• 审稿总评