关于 systematic-review
面向临床与科学问题的系统综述工作流,依据 PRISMA 2020 记录检索、筛选和证据综合。它结合多数据库搜索、偏倚评估与 GRADE 分级,强调过程可复核且不编造结果。
主要功能
- 01PICOTS 协议与检索策略
- 02多数据库及灰色文献检索
- 03PRISMA 流程与去重筛选
- 04全文提取及偏倚评估
- 05GRADE 证据分级
适用场景
- 01制定 PROSPERO-ready 综述方案
- 02记录可审计的数据库检索
- 03筛选研究并记录排除理由
- 04评估证据质量并综合结果
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ poemswe/ co-researcher --skill systematic-review安装后在 Claude Code 中输入/systematic-review确认已加载。
详细介绍
<search_backend>
执行数据库检索时,使用 literature-review 技能自带的 CLI 后端,位于其 scripts/ 目录中。通过其绝对路径调用各后端(uv run <literature-review-dir>/scripts/X.py …);切勿 cd 到技能目录。在用户调用该技能时所在的目录下,将综述工作区锚定为绝对路径 --workspace "$(pwd)/review/{slug}"——切勿使用相对路径,否则会写入已安装的插件目录。
前提条件——必须已安装 uv。 运行一次 bash <plugin-root>/scripts/setup.sh。有关后端的完整详情、调用模式和备用安装说明,请参阅 literature-review 技能的 <search_backend> 部分。
| 来源 | 脚本 | 在 PRISMA 中的作用 |
|---|---|---|
| OpenAlex | openalex_cli.py | 跨学科主要数据库——引用次数、作者/机构元数据 |
| Europe PMC | europepmc_api.py | 生命科学全文;前向/后向引文追踪;通过 SRC:PPR 覆盖预印本 |
| arXiv | search_arxiv.py | 计算机科学/物理/定量生物学预印本的灰色文献 |
| 全文 | read_paper.py | 用于资格评估和数据提取的文献获取;在 PRISMA 流程图中将仅有摘要的文献记录为“报告未获取” |
对每个数据库,逐字记录:
- 完整检索式
- 执行日期
- 总命中数(Europe PMC 使用
hitCount字段;OpenAlex/arXiv 使用分页后的results长度)
这些元数据将用于 PRISMA 流程图和发表所需的补充检索日志。
所有综述状态均按 literature-review 技能协议的规定保存在 review/{slug}/ 中:protocol.md、corpus.json、papers/{id}/、synthesis.md。corpus.json 是所有 PRISMA 流程计数的唯一可信来源。请在工作过程中持续更新:每项筛选决定都需要填写 status,排除时还需填写 reason;每篇已获取的论文都需要将 read_paper.py 的 status 写入其 fulltext 字段。保留为 null 的记录会被计为尚未筛选或未获取,流程数字会因此在不知不觉中少计。
</search_backend>
1. 制定方案(符合 PROSPERO 要求)
- PICOTS 框架:人群、干预、对照、结局、时间、场景。
- 检索逻辑:全面扩展检索词(MeSH + Emtree 同义词 + 自由词);将相同的布尔检索意图转换为各后端的语法。
2. 执行 PRISMA 2020
- 流程图:追踪识别 → 筛选 → 资格评估 → 纳入各阶段,并记录每个数据库的命中数。
- 去重:跨数据库去重时,先按 DOI,再按规范化标题 + 第一作者姓氏 + 年份匹配。
3. 偏倚风险分析
- 工具:Cochrane RoB 2.0(RCT)、ROBINS-I(非随机研究)、QUADAS-2(诊断准确性)。
- 综合决策:仅当异质性(
I²)和效应量兼容性允许时进行定量荟萃分析;否则进行结构化定性综合。
<output_format>
系统综述:[问题]
PRISMA 阶段:[识别 | 筛选 | 合格性评估 | 纳入 | 综合] PICO(TS):P=… I=… C=… O=… T=… S=…
搜索日志:
| 数据库 | 查询 | 日期 | 命中数 |
|---|---|---|---|
| OpenAlex | … | YYYY-MM-DD | N |
| Europe PMC | … | YYYY-MM-DD | N |
| arXiv | … | YYYY-MM-DD | N |
PRISMA 流程:从 protocol.md 中按数据库记录的命中数获取“已识别”数量。使用 uv run <literature-review-dir>/scripts/prisma_counts.py --corpus "$WS/corpus.json" 生成其余数量(去重后、已筛选、已排除、检索情况、已纳入)——切勿手动计数;如果任何排除项缺少原因,该脚本将以状态码 1 退出。
- 已识别:N(去重后:N)
- 已筛选(标题/摘要):N → 已排除 N(原因见 corpus.json)
- 已寻求检索:N → 未检索到 N(仅摘要)
- 已评估全文:N → 已排除 N(已记录原因)
- 已纳入:N
证据表:
| 研究 ID | 设计 | N | RoB | 关键结局 | GRADE |
|---|
后续 PRISMA 步骤:
- [步骤]
- [步骤] </output_format>