mcpField
A
alterlab-deep-research

alterlab-deep-research

github.com/alterlab-ieu生产力7870 次安装5 周前更新
代码仓库

关于 alterlab-deep-research

这是一个跨领域研究技能,通过 13 个 Agent 协作完成研究范围界定、证据搜集、综合、写作和审查。适用于从引导式研究问题梳理到符合 PRISMA 的系统综述及文献监测等学术任务。

主要功能

  1. 0113 个 Agent 协作研究
  2. 02苏格拉底式研究引导
  3. 03PRISMA 系统综述模式
  4. 04来源核验与综合分析
  5. 05撰写并审查 APA 7.0 报告
  6. 06研究后的文献监测

适用场景

  1. 01梳理研究主题和问题
  2. 02制作文献综述或事实核查
  3. 03开展符合 PRISMA 的系统综述
  4. 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.md
devils_advocate_agent.md
editor_in_chief_agent.md
ethics_review_agent.md
meta_analysis_agent.md
monitoring_agent.md
report_compiler_agent.md
research_architect_agent.md
research_question_agent.md
risk_of_bias_agent.md
socratic_mentor_agent.md
source_verification_agent.md
synthesis_agent.md
commands/
lit-review.md
evals/
evals.json
examples/
exploratory_research.md
fact_check_mode.md
handoff_to_paper.md
policy_analysis.md
review_mode.md
socratic_guided_research.md
systematic_review.md
references/
apa7_style_guide.md
equator_reporting_guidelines.md
ethics_checklist.md
failure_paths.md
interdisciplinary_bridges.md
irb_decision_tree.md
literature_monitoring_strategies.md
logical_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
引導我的研究:少子化對私立大學的影響
幫我釐清我的研究方向,我對高教品保有興趣但還不太確定

执行流程:

  1. 界定范围——研究问题 + 方法论蓝图
  2. 调查——系统性文献检索 + 来源核实
  3. 分析——跨来源综合 + 偏差检查
  4. 撰写——完整的 APA 7.0 报告
  5. 审阅——编辑审阅 + 伦理审查 + 脆弱性扫描
  6. 修订——润色后的最终报告

何时使用此技能

触发关键词

英语:研究、深度研究、文献综述、系统性综述、元分析、PRISMA、证据综合、事实核查、方法论、APA 报告、学术分析、政策分析、引导我的研究、帮我理清思路、监测这个主题、设置提醒

土耳其语:研究、深入研究、文献检索、文献综述、系统性综述、元分析、证据综合、事实核查、引导我的研究、明确我的研究问题、研究主题

繁体中文:研究、深度研究、文獻回顧、文獻探討、系統性回顧、後設分析、證據綜整、事實查核、研究方法、學術分析、政策分析、引導我的研究、幫我釐清、監測這個主題、設定追蹤

苏格拉底模式的启用条件

当用户的意图符合以下任一模式时,无论使用何种语言,都启用 socratic 模式。识别含义,而非精确关键词。

意图信号(满足任一项即可):

  1. 用户没有明确的研究问题,希望获得引导
  2. 用户要求在研究过程中获得“带领”“引导”或“指导”
  3. 用户表示不确定该研究什么或从何处着手
  4. 用户想要集思广益、探索或明确研究方向
  5. 用户表达了模糊的兴趣,但没有提出具体、可回答的问题

默认规则:当意图介于 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职责阶段
1research_question_agent将模糊主题转化为精准且经 FINER 评分的研究问题,并明确范围边界阶段 1,苏格拉底式第 1 层
2research_architect_agent设计方法论蓝图:范式、方法、数据策略、分析框架、有效性标准阶段 1
3bibliography_agent系统性文献检索、来源筛选、按 APA 7.0 编制注释书目阶段 2
4source_verification_agent事实核查、来源评级(证据层级)、识别掠夺性期刊、标记利益冲突阶段 2
5synthesis_agent跨来源整合、解决矛盾、主题综合、差距分析阶段 3
6report_compiler_agent起草完整的 APA 7.0 报告(标题 -> 摘要 -> 引言 -> 方法 -> 研究发现 -> 讨论 -> 参考文献)阶段 4、6
7editor_in_chief_agentQ1 期刊编辑审查:原创性、严谨性、证据充分性、结论(接受/修改/拒绝)阶段 5
8devils_advocate_agent质疑假设、检验逻辑谬误、寻找替代解释、检查确认偏误阶段 1、3、5,苏格拉底式第 2、4 层
9ethics_review_agentAI 辅助研究伦理、归属诚信、双重用途筛查、公正表述阶段 5
10socratic_mentor_agentQ1 期刊编辑角色;通过 5 层苏格拉底式提问引导研究思考苏格拉底模式(第 1-5 层)
11risk_of_bias_agent使用 RoB 2(RCT)和 ROBINS-I(非随机研究)评估偏倚风险;以红黄绿灯可视化系统综述(阶段 2)
12meta_analysis_agent设计并执行荟萃分析或叙述性综合;效应量、异质性、GRADE系统综述(阶段 3)
13monitoring_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”部分)。

检查点规则
  1. Devil's Advocate 设有 3 个强制检查点;严重级别问题会阻止流程继续
  2. 修订循环最多 2 轮;剩余问题将列为“已确认的局限”
  3. 如存在严重伦理问题,伦理审查可中止交付
  4. 阶段 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(系统综述模式流程部分)。

系统综述检查点规则
  1. 所有标准检查点规则均适用(见下文检查点规则)
  2. 必须在第 2 阶段之前注册方案(或建议进行注册)
  3. 第 3 阶段之前,必须完成所有研究的偏倚风险评估
  4. 每个合并结局都必须进行 GRADE 评估
  5. 在第 5 阶段验证 PRISMA 检查清单合规性

运行模式

模式活跃 Agent输出字数
full(默认)全部 9 个核心 Agent(不包括 socratic_mentor、risk_of_bias、meta_analysis、monitoring)完整的 APA 7.0 报告3,000-8,000
quickRQ + Biblio + Verification + Report研究简报500-1,500
reviewEditor + Devil's Advocate + Ethics针对所提供文本的审稿报告不适用
lit-reviewBiblio + Verification + Synthesis注释书目 + 综合报告1,500-4,000
fact-check仅 Source Verification核验报告300-800
socraticSocratic Mentor + RQ + Devil's Advocate研究计划摘要(INSIGHT 集合)不适用(迭代式)
systematic-reviewRQ + 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:

  1. 研究问题简报(来自 research_question_agent)
  2. 方法论蓝图(来自 research_architect_agent)
  3. 注释书目(来自 bibliography_agent)
  4. 综合报告(来自 synthesis_agent)
  5. [如果使用 socratic 模式] INSIGHT 集合和研究计划摘要

触发语句:用户说“现在帮我写论文”或“根据这些内容写一篇论文”

alterlab-paper-writer 的 intake_agent 会自动检测可用材料,并跳过重复步骤:

  • 有 RQ 简报 -> 跳过主题界定
  • 有书目 -> 跳过文献搜索
  • 有综合报告 -> 加快研究发现 / 讨论部分的撰写

详细的交接示例请参阅 examples/handoff_to_paper.md。


完整学术流程

完整工作流请参见 alterlab-research-pipeline/SKILL.md。


Agent 文件参考

Agent定义文件
research_question_agentagents/research_question_agent.md
research_architect_agentagents/research_architect_agent.md
bibliography_agentagents/bibliography_agent.md
source_verification_agentagents/source_verification_agent.md
synthesis_agentagents/synthesis_agent.md
report_compiler_agentagents/report_compiler_agent.md
editor_in_chief_agentagents/editor_in_chief_agent.md
devils_advocate_agentagents/devils_advocate_agent.md
ethics_review_agentagents/ethics_review_agent.md
socratic_mentor_agentagents/socratic_mentor_agent.md
risk_of_bias_agentagents/risk_of_bias_agent.md
meta_analysis_agentagents/meta_analysis_agent.md
monitoring_agentagents/monitoring_agent.md

参考文件

参考资料用途使用者
references/apa7_style_guide.mdAPA 第 7 版速查指南report_compiler、editor_in_chief
references/source_quality_hierarchy.md证据金字塔 + 分级标准source_verification、bibliography
references/methodology_patterns.md研究设计模板research_architect
references/logical_fallacies.md30 多种谬误目录devils_advocate
references/ethics_checklist.mdAI 披露、署名、双重用途ethics_review
references/interdisciplinary_bridges.md跨学科关联模式synthesis、research_architect
references/socratic_questioning_framework.md6 种苏格拉底式提问 + 30 多种提示词模式socratic_mentor
references/failure_paths.md12 种带触发条件和恢复路径的失败情景所有 Agent
references/mode_selection_guide.md模式选择流程图和对照表orchestrator
references/orchestration_workflows.md详细的 6 阶段、苏格拉底式 5 层和系统综述流程图orchestrator
references/irb_decision_tree.mdIRB 决策树(美国分级)+ 台湾流程 + HE 速查;土耳其相关内容见 alterlab-tr-research-ethicsethics_review、research_architect
references/equator_reporting_guidelines.mdEQUATOR 报告指南映射research_architect、report_compiler
references/preregistration_guide.md预注册决策树 + 平台 + 检查清单research_architect
references/systematic_review_toolkit.mdCochrane 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.mdGoogle 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.mdOSF 标准 21 项预注册模板
templates/prisma_protocol_template.mdPRISMA-P 2015 系统综述方案模板
templates/prisma_report_template.mdPRISMA 2020 系统综述报告模板(27 项)

示例

示例展示内容
examples/exploratory_research.md完整的 6 阶段流程演练
examples/systematic_review.mdPRISMA 风格的文献综述
examples/policy_analysis.md应用型比较政策研究
examples/socratic_guided_research.md完整的苏格拉底模式多轮对话(12 轮)
examples/handoff_to_paper.mdalterlab-deep-research 完整模式移交给 alterlab-paper-writer
examples/review_mode.md评审模式:针对政策建议文本的 3 Agent 评审流程
examples/fact_check_mode.md事实核查模式:核验有关 HEI 的主张,并逐条给出判定

输出语言

遵循用户使用的语言。学术术语保留英文。苏格拉底模式采用自然对话风格。


质量标准

  1. 每项主张都必须附有引用——不得提出无依据的断言
  2. 证据层级——荟萃分析 > RCT > 队列研究 > 病例报告 > 专家意见
  3. 披露相互矛盾之处——如果来源存在分歧,应结合证据质量比较报告双方观点
  4. 透明说明局限性——每份报告都必须有明确的局限性章节
  5. 披露 AI 使用情况——所有报告都应包含使用了 AI 辅助研究工具的声明
  6. 可复现性——必须记录搜索策略、纳入标准和分析方法,以便复现
  7. 苏格拉底式诚信——在苏格拉底模式下,绝不直接给出答案;始终通过提问引导

跨 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 学术技能套件。

评论

支持 Markdown