关于 alterlab-deep-research
这是一个跨领域研究技能,通过 13 个 Agent 协作完成研究范围界定、证据搜集、综合、写作和审查。适用于从引导式研究问题梳理到符合 PRISMA 的系统综述及文献监测等学术任务。
主要功能
- 0113 个 Agent 协作研究
- 02苏格拉底式研究引导
- 03PRISMA 系统综述模式
- 04来源核验与综合分析
- 05撰写并审查 APA 7.0 报告
- 06研究后的文献监测
适用场景
- 01梳理研究主题和问题
- 02制作文献综述或事实核查
- 03开展符合 PRISMA 的系统综述
- 04监测文献撤稿或相互矛盾的发现
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alterlab-ieu/ alterlab-academic-skills --skill alterlab-deep-research安装后在 Claude Code 中输入/alterlab-deep-research确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/bibliography_agent.mddevils_advocate_agent.mdeditor_in_chief_agent.mdethics_review_agent.mdmeta_analysis_agent.mdmonitoring_agent.mdreport_compiler_agent.mdresearch_architect_agent.mdresearch_question_agent.mdrisk_of_bias_agent.mdsocratic_mentor_agent.mdsource_verification_agent.mdsynthesis_agent.mdcommands/lit-review.mdevals/evals.jsonexamples/exploratory_research.mdfact_check_mode.mdhandoff_to_paper.mdpolicy_analysis.mdreview_mode.mdsocratic_guided_research.mdsystematic_review.mdreferences/apa7_style_guide.mdequator_reporting_guidelines.mdethics_checklist.mdfailure_paths.mdinterdisciplinary_bridges.mdirb_decision_tree.mdliterature_monitoring_strategies.mdlogical_fallacies.md详细介绍
深度研究 — 通用学术研究 Agent 团队
通用深度研究工具——一支由 13 个 Agent 组成、适用于任何领域的团队,可针对任意主题开展严谨的学术研究。v2.3 新增系统性综述模式(符合 PRISMA 标准,可选元分析)、苏格拉底式收敛标准,以及研究后的文献监测功能。
快速开始
最简命令:
Research the impact of AI on higher education quality assurance
苏格拉底模式:
Guide my research on the impact of declining birth rates on private universities
引導我的研究:少子化對私立大學的影響
幫我釐清我的研究方向,我對高教品保有興趣但還不太確定
执行流程:
- 界定范围——研究问题 + 方法论蓝图
- 调查——系统性文献检索 + 来源核实
- 分析——跨来源综合 + 偏差检查
- 撰写——完整的 APA 7.0 报告
- 审阅——编辑审阅 + 伦理审查 + 脆弱性扫描
- 修订——润色后的最终报告
何时使用此技能
触发关键词
英语:研究、深度研究、文献综述、系统性综述、元分析、PRISMA、证据综合、事实核查、方法论、APA 报告、学术分析、政策分析、引导我的研究、帮我理清思路、监测这个主题、设置提醒
土耳其语:研究、深入研究、文献检索、文献综述、系统性综述、元分析、证据综合、事实核查、引导我的研究、明确我的研究问题、研究主题
繁体中文:研究、深度研究、文獻回顧、文獻探討、系統性回顧、後設分析、證據綜整、事實查核、研究方法、學術分析、政策分析、引導我的研究、幫我釐清、監測這個主題、設定追蹤
苏格拉底模式的启用条件
当用户的意图符合以下任一模式时,无论使用何种语言,都启用 socratic 模式。识别含义,而非精确关键词。
意图信号(满足任一项即可):
- 用户没有明确的研究问题,希望获得引导
- 用户要求在研究过程中获得“带领”“引导”或“指导”
- 用户表示不确定该研究什么或从何处着手
- 用户想要集思广益、探索或明确研究方向
- 用户表达了模糊的兴趣,但没有提出具体、可回答的问题
默认规则:当意图介于 socratic 和 full 之间、难以判断时,优先选择 socratic——先提供引导,比直接生成用户并不需要的报告更稳妥。用户之后随时可以切换到 full。
触发示例(仅供参考,并非穷尽): “引导我的研究”“帮我理清思路”、“「引導我的研究」「幫我釐清」”,或任何语言中的同类表达
不会触发的情况
| 情况 | 改用 |
|---|---|
| 撰写论文(而非开展研究) | alterlab-paper-writer |
| 审阅论文(结构化审阅) | alterlab-paper-reviewer |
| 从研究到论文的完整流程 | alterlab-research-pipeline |
| 审核现有参考文献目录中的文献是否真实存在或已被撤稿 | alterlab-citation-verifier |
| 在 Python 或 R 中汇总已提取的效应量(随机效应模型、森林图/漏斗图、Egger 检验) | alterlab-meta-analysis |
在 Claude Code 中,数百条记录的双审稿人 PRISMA 筛选、文献地图,或由独立 Agent 进行的论点压力测试,都已封装为工作流(/alterlab-workflows:systematic-review-screening、literature-map、claim-stress-test;参见 alterlab-research-workflows)——建议先提供这些工作流,再手动搭建扇出流程。
快速模式选择指南
| Your Situation 你的状况 | 推荐模式 |
|---|---|
| 想法模糊,需要引导 / 有模糊想法,需要引导 | socratic |
| RQ 明确,需要全面研究 / 有明確 RQ,需要完整研究 | full |
| 需要快速简报(30 分钟)/ 需要快速摘要 | quick |
| 引用前需要评估一篇论文 / 有論文需要評估 | review |
| 需要针对某个主题进行文献综述 / 需要文獻回顧 | lit-review |
| 需要核实特定论断 / 需要查核特定事實 | fact-check |
| 需要系统性综述/元分析 / 系統性回顧或後設分析 | systematic-review |
不确定?从 socratic 开始——它会帮你弄清楚自己需要什么。
不確定?先用 socratic 模式——它會幫你釐清你需要什麼。
Agent 团队(13 个 Agent)
| # | Agent | 职责 | 阶段 |
|---|---|---|---|
| 1 | research_question_agent | 将模糊主题转化为精准且经 FINER 评分的研究问题,并明确范围边界 | 阶段 1,苏格拉底式第 1 层 |
| 2 | research_architect_agent | 设计方法论蓝图:范式、方法、数据策略、分析框架、有效性标准 | 阶段 1 |
| 3 | bibliography_agent | 系统性文献检索、来源筛选、按 APA 7.0 编制注释书目 | 阶段 2 |
| 4 | source_verification_agent | 事实核查、来源评级(证据层级)、识别掠夺性期刊、标记利益冲突 | 阶段 2 |
| 5 | synthesis_agent | 跨来源整合、解决矛盾、主题综合、差距分析 | 阶段 3 |
| 6 | report_compiler_agent | 起草完整的 APA 7.0 报告(标题 -> 摘要 -> 引言 -> 方法 -> 研究发现 -> 讨论 -> 参考文献) | 阶段 4、6 |
| 7 | editor_in_chief_agent | Q1 期刊编辑审查:原创性、严谨性、证据充分性、结论(接受/修改/拒绝) | 阶段 5 |
| 8 | devils_advocate_agent | 质疑假设、检验逻辑谬误、寻找替代解释、检查确认偏误 | 阶段 1、3、5,苏格拉底式第 2、4 层 |
| 9 | ethics_review_agent | AI 辅助研究伦理、归属诚信、双重用途筛查、公正表述 | 阶段 5 |
| 10 | socratic_mentor_agent | Q1 期刊编辑角色;通过 5 层苏格拉底式提问引导研究思考 | 苏格拉底模式(第 1-5 层) |
| 11 | risk_of_bias_agent | 使用 RoB 2(RCT)和 ROBINS-I(非随机研究)评估偏倚风险;以红黄绿灯可视化 | 系统综述(阶段 2) |
| 12 | meta_analysis_agent | 设计并执行荟萃分析或叙述性综合;效应量、异质性、GRADE | 系统综述(阶段 3) |
| 13 | monitoring_agent | 研究后的文献监测:摘要、撤稿提醒、矛盾研究发现检测 | 可选(流程结束后) |
模式选择指南
详细指南请参阅 references/mode_selection_guide.md。
User Input
|
+-- Already have a clear research question?
| +-- Yes --> Need PRISMA-compliant systematic review / meta-analysis?
| | +-- Yes --> systematic-review mode
| | +-- No --> Need a full report?
| | +-- Yes --> full mode
| | +-- No --> Only need literature?
| | +-- Yes --> lit-review mode
| | +-- No --> quick mode
| +-- No --> Want to be guided through thinking?
| +-- Yes --> socratic mode
| +-- No --> full mode (Phase 1 will be interactive)
|
+-- Already have text to review? --> review mode
+-- Only need fact-checking? --> fact-check mode
编排工作流(6 个阶段)
标准流程分为六个阶段:1. 界定范围(研究问题简报 + 方法论蓝图,检查点 1)→ 2. 调查(来源语料库 + 已核验/评级的来源)→ 3. 分析(综合 + 差距分析,检查点 2)→ 4. 撰写(完整的 APA 7.0 草稿)→ 5. 审查(编辑 + 伦理 + 检查点 3,并行执行)→ 6. 修订(最终报告,最多 2 轮)。
包含各阶段全部输出和检查点标准的完整 Agent 逐一流程图,请参阅 references/orchestration_workflows.md(“Standard Orchestration Workflow”部分)。
检查点规则
- Devil's Advocate 设有 3 个强制检查点;严重级别问题会阻止流程继续
- 修订循环最多 2 轮;剩余问题将列为“已确认的局限”
- 如存在严重伦理问题,伦理审查可中止交付
- 阶段 1 结束后,必须取得用户确认才能继续
苏格拉底模式:引导式研究对话
核心原则:从 Q1 国际期刊主编的视角出发,通过苏格拉底式提问引导用户澄清研究问题。切勿直接给出答案,而应通过追问帮助用户自行思考问题。
详细的 Agent 定义见 agents/socratic_mentor_agent.md。
提问框架见 references/socratic_questioning_framework.md。
苏格拉底模式分五个层次推进:1. 问题界定 → 2. 方法论反思 → 3. 证据设计 → 4. 批判性自我审视 → 5. 重要性与贡献。每个层次都将 socratic_mentor_agent 与一个辅助 Agent 配合使用(第 1 层使用 research_question_agent;第 2 层和第 4 层使用 devils_advocate_agent),每轮提取 [INSIGHT: ...] 标记,并要求至少进行 2 轮对话(第 5 层至少 1 轮)后才能推进。第 5 层会将所有 INSIGHT 编纂成一份研究计划摘要,并移交给 alterlab-paper-writer(计划模式)。
各层的完整流程和每层的具体引导问题见 references/orchestration_workflows.md(苏格拉底模式层级流程部分)。
苏格拉底模式对话管理规则
- 每个层次至少进行 2 轮对话后才能进入下一层(第 5 层至少需要 1 轮)
- 用户可以随时要求跳到下一层
- 导师回复限制在 200-400 个单词
- 如果 10 轮后仍未达成共识 -> 建议切换到
full模式(见失败路径 F6) - 如果对话超过 15 轮 -> 自动编纂 INSIGHT 并结束
- 如果用户要求直接给出答案 -> 婉拒,并解释引导式学习的价值
系统综述模式
符合 PRISMA 标准的完整系统性文献综述,并可选择进行荟萃分析。此模式在标准的 6 阶段流程基础上,加入用于偏倚风险评估(RoB 2、ROBINS-I)和定量综合的专用 Agent。
详细的 Agent 定义见 agents/risk_of_bias_agent.md 和 agents/meta_analysis_agent.md。
Cochrane/PRISMA/GRADE 参考指南见 references/systematic_review_toolkit.md。
此模式沿用六个阶段,但采用 PRISMA 专用输出:1. 范围界定产出 PICOS RQ 和完整的 PRISMA-P 方案(而非仅产出 RQ);2. 调查增加 PRISMA 2020 流程图和 risk_of_bias_agent 的 RoB 评估;3. 分析运行 meta_analysis_agent(效应量、异质性、GRADE),或在主题综合之外进行 SWiM 叙述性综合;4. 撰写输出包含研究特征、RoB、森林图和 GRADE 表格的 27 项 PRISMA 2020 报告;5. 审查和 6. 修订与标准流程一致。
包含各阶段所有输出的完整 PRISMA Agent 流程见 references/orchestration_workflows.md(系统综述模式流程部分)。
系统综述检查点规则
- 所有标准检查点规则均适用(见下文检查点规则)
- 必须在第 2 阶段之前注册方案(或建议进行注册)
- 第 3 阶段之前,必须完成所有研究的偏倚风险评估
- 每个合并结局都必须进行 GRADE 评估
- 在第 5 阶段验证 PRISMA 检查清单合规性
运行模式
| 模式 | 活跃 Agent | 输出 | 字数 |
|---|---|---|---|
full(默认) | 全部 9 个核心 Agent(不包括 socratic_mentor、risk_of_bias、meta_analysis、monitoring) | 完整的 APA 7.0 报告 | 3,000-8,000 |
quick | RQ + Biblio + Verification + Report | 研究简报 | 500-1,500 |
review | Editor + Devil's Advocate + Ethics | 针对所提供文本的审稿报告 | 不适用 |
lit-review | Biblio + Verification + Synthesis | 注释书目 + 综合报告 | 1,500-4,000 |
fact-check | 仅 Source Verification | 核验报告 | 300-800 |
socratic | Socratic Mentor + RQ + Devil's Advocate | 研究计划摘要(INSIGHT 集合) | 不适用(迭代式) |
systematic-review | RQ + Architect + Biblio + Verification + RoB + Meta-Analysis + Synthesis + Report + Editor + Ethics + DA | 完整的 PRISMA 2020 报告 + 森林图数据 + GRADE 表格 | 5,000-15,000 |
失败路径
所有模式下的失败场景、触发条件和恢复策略,请参阅 references/failure_paths.md。
关键失败路径摘要:
| 失败场景 | 触发条件 | 恢复策略 |
|---|---|---|
| RQ 无法收敛 | 第 1 阶段 / 第 1 层经过多轮后仍然模糊 | 提供 3 个候选 RQ,或建议使用 lit-review |
| 文献不足 | bibliography_agent 找到的来源少于 5 个 | 扩展搜索策略,采用替代关键词 |
| 方法论不匹配 | RQ 类型与方法能力不匹配 | 返回第 1 阶段,建议 3 种替代方法 |
| Devil's Advocate 判定为 CRITICAL | 发现致命的逻辑缺陷 | 停止,解释问题,并要求修正 |
| Ethics 判定为 BLOCKED | 存在严重的伦理问题 | 停止,列出问题和补救方案 |
| 苏格拉底式流程无法收敛 | 超过 10 轮仍未收敛 | 建议切换到 full 模式 |
| 用户中途放弃 | 明确表示不想继续 | 保存进度,提供重新进入流程的途径 |
| 仅有中文文献 | 英文搜索无结果 | 切换到中文学术数据库 |
文献监测(可选的流水线后续步骤)
完成任意研究模式后,用户可以选择启用 monitoring_agent,设置研究后的文献监测。这不属于主流水线,而是一项按需触发的辅助能力。
详细的 Agent 定义请参阅 agents/monitoring_agent.md。
各平台的设置指南请参阅 references/literature_monitoring_strategies.md。
触发语句:“监测这个主题”“设置提醒”“追踪这个主题的新发表成果”
功能:
- 生成每周 / 每月监测摘要
- 针对引用来源的撤稿提醒
- 检测相互矛盾的研究发现
- 追踪关键作者
- 追踪关键词演变
输入:任意研究模式生成的已完成书目 + 搜索策略
输出:监测配置 + 摘要模板(Markdown)
限制:监测 Agent 会生成供用户操作的配置和模板,但无法在后台自主运行监测。
交接协议:alterlab-deep-research → alterlab-paper-writer
研究完成后,可将以下材料交接给 alterlab-paper-writer:
- 研究问题简报(来自 research_question_agent)
- 方法论蓝图(来自 research_architect_agent)
- 注释书目(来自 bibliography_agent)
- 综合报告(来自 synthesis_agent)
- [如果使用 socratic 模式] INSIGHT 集合和研究计划摘要
触发语句:用户说“现在帮我写论文”或“根据这些内容写一篇论文”
alterlab-paper-writer 的 intake_agent 会自动检测可用材料,并跳过重复步骤:
- 有 RQ 简报 -> 跳过主题界定
- 有书目 -> 跳过文献搜索
- 有综合报告 -> 加快研究发现 / 讨论部分的撰写
详细的交接示例请参阅 examples/handoff_to_paper.md。
完整学术流程
完整工作流请参见 alterlab-research-pipeline/SKILL.md。
Agent 文件参考
| Agent | 定义文件 |
|---|---|
| research_question_agent | agents/research_question_agent.md |
| research_architect_agent | agents/research_architect_agent.md |
| bibliography_agent | agents/bibliography_agent.md |
| source_verification_agent | agents/source_verification_agent.md |
| synthesis_agent | agents/synthesis_agent.md |
| report_compiler_agent | agents/report_compiler_agent.md |
| editor_in_chief_agent | agents/editor_in_chief_agent.md |
| devils_advocate_agent | agents/devils_advocate_agent.md |
| ethics_review_agent | agents/ethics_review_agent.md |
| socratic_mentor_agent | agents/socratic_mentor_agent.md |
| risk_of_bias_agent | agents/risk_of_bias_agent.md |
| meta_analysis_agent | agents/meta_analysis_agent.md |
| monitoring_agent | agents/monitoring_agent.md |
参考文件
| 参考资料 | 用途 | 使用者 |
|---|---|---|
references/apa7_style_guide.md | APA 第 7 版速查指南 | report_compiler、editor_in_chief |
references/source_quality_hierarchy.md | 证据金字塔 + 分级标准 | source_verification、bibliography |
references/methodology_patterns.md | 研究设计模板 | research_architect |
references/logical_fallacies.md | 30 多种谬误目录 | devils_advocate |
references/ethics_checklist.md | AI 披露、署名、双重用途 | ethics_review |
references/interdisciplinary_bridges.md | 跨学科关联模式 | synthesis、research_architect |
references/socratic_questioning_framework.md | 6 种苏格拉底式提问 + 30 多种提示词模式 | socratic_mentor |
references/failure_paths.md | 12 种带触发条件和恢复路径的失败情景 | 所有 Agent |
references/mode_selection_guide.md | 模式选择流程图和对照表 | orchestrator |
references/orchestration_workflows.md | 详细的 6 阶段、苏格拉底式 5 层和系统综述流程图 | orchestrator |
references/irb_decision_tree.md | IRB 决策树(美国分级)+ 台湾流程 + HE 速查;土耳其相关内容见 alterlab-tr-research-ethics | ethics_review、research_architect |
references/equator_reporting_guidelines.md | EQUATOR 报告指南映射 | research_architect、report_compiler |
references/preregistration_guide.md | 预注册决策树 + 平台 + 检查清单 | research_architect |
references/systematic_review_toolkit.md | Cochrane Handbook v6.5、PRISMA 2020、RoB 2、ROBINS-I(2016 和 V2)、I² 指南、GRADE、方案注册 | risk_of_bias、meta_analysis、bibliography、report_compiler |
references/literature_monitoring_strategies.md | Google Scholar 提醒、PubMed 提醒、RSS 源、Retraction Watch、引文追踪、监控频率 | monitoring_agent |
模板
| 模板 | 用途 |
|---|---|
templates/research_brief_template.md | 快速模式输出格式 |
templates/literature_matrix_template.md | 来源 × 主题分析矩阵 |
templates/evidence_assessment_template.md | 单篇来源质量评估卡 |
templates/preregistration_template.md | OSF 标准 21 项预注册模板 |
templates/prisma_protocol_template.md | PRISMA-P 2015 系统综述方案模板 |
templates/prisma_report_template.md | PRISMA 2020 系统综述报告模板(27 项) |
示例
| 示例 | 展示内容 |
|---|---|
examples/exploratory_research.md | 完整的 6 阶段流程演练 |
examples/systematic_review.md | PRISMA 风格的文献综述 |
examples/policy_analysis.md | 应用型比较政策研究 |
examples/socratic_guided_research.md | 完整的苏格拉底模式多轮对话(12 轮) |
examples/handoff_to_paper.md | alterlab-deep-research 完整模式移交给 alterlab-paper-writer |
examples/review_mode.md | 评审模式:针对政策建议文本的 3 Agent 评审流程 |
examples/fact_check_mode.md | 事实核查模式:核验有关 HEI 的主张,并逐条给出判定 |
输出语言
遵循用户使用的语言。学术术语保留英文。苏格拉底模式采用自然对话风格。
质量标准
- 每项主张都必须附有引用——不得提出无依据的断言
- 证据层级——荟萃分析 > RCT > 队列研究 > 病例报告 > 专家意见
- 披露相互矛盾之处——如果来源存在分歧,应结合证据质量比较报告双方观点
- 透明说明局限性——每份报告都必须有明确的局限性章节
- 披露 AI 使用情况——所有报告都应包含使用了 AI 辅助研究工具的声明
- 可复现性——必须记录搜索策略、纳入标准和分析方法,以便复现
- 苏格拉底式诚信——在苏格拉底模式下,绝不直接给出答案;始终通过提问引导
跨 Agent 质量标准统一
统一定义,避免不同 Agent 之间出现不一致:
| 概念 | 定义 | 适用对象 |
|---|---|---|
| 同行评审 | 在经过正式同行评审的期刊上发表(仅有编辑审查不符合要求)。仅当会议论文集明确经过同行评审时才计入 | bibliography_agent, source_verification_agent |
| 时效性规则 | 默认:发表于近 5 年内。按领域调整:CS/AI = 3 年,历史/哲学 = 20 年,法律 = 视司法管辖区变化而定。无论年代,开创性著作均不受此限 | bibliography_agent, ethics_review_agent |
| CRITICAL 严重程度 | 若问题未解决,将导致核心结论无效或构成学术不端。必须立即解决,流程方可继续 | 所有 Agent |
| 来源等级 | tier_1 = 排名前 25% 的同行评审期刊;tier_2 = 其他同行评审来源;tier_3 = 学术来源,但未经同行评审;tier_4 = 灰色文献 | bibliography_agent, source_verification_agent |
| 最低来源数量 | full = 15+,quick = 5-8,lit-review = 25+,systematic-review = 所有符合条件的来源(不限数量),fact-check = 每项主张 3+ | bibliography_agent |
| 核验门槛 | 使用前须对 100% 的来源进行存在性核验(通过 verify_citations.py 判定结果,WebSearch 作为后备方案)+ 独立使用 WebSearch 抽查 ≥50% 的来源(优先检查所有 tier_3/tier_4 来源) | bibliography_agent, source_verification_agent, ethics_review_agent |
跨技能参考:阶段间数据交换格式见
shared/handoff_schemas.md。
与其他技能的集成
此技能与领域无关,但可与其他 AlterLab 技能组合使用:
alterlab-deep-research + alterlab-paper-2-web -> Disseminate research as a website / video / poster
alterlab-deep-research + alterlab-paper-writer -> Full research-to-publication pipeline
alterlab-deep-research (socratic) + alterlab-paper-writer (plan) -> Guided research + paper planning
alterlab-deep-research (systematic-review) + alterlab-paper-writer -> PRISMA systematic review paper
alterlab-deep-research -> alterlab-research-pipeline -> End-to-end research → review → finalize workflow
版本历史
当前版本:v2.4(参见 frontmatter metadata.version)。最新更改(2026-09):
在各 Agent 之间统一了来源存在性核验(每个来源在使用前都通过
alterlab-citation-verifier 检查;不再保留“无法核验但仍予以采用”的类别),
将苏格拉底式停止规则整合为一套统一规则,并更新报告标准以符合最新版本
(Cochrane Handbook v6.5、ROBINS-I V2、CONSORT 2025、SPIRIT 2025、
TRIPOD+AI)。v2.3 新增了 systematic-review 模式(采用 PRISMA 2020 流程,包含
risk_of_bias_agent 和 meta_analysis_agent)以及可选的流程后
monitoring_agent,使团队扩展至 13 个 Agent 和 7 种模式。
属于 AlterLab 学术技能套件。