o0000-code/meta-analysis-skill/review-methodology-foundations

Claude Code and agent skill by o0000-code/meta-analysis-skill

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Shared methodology base for all academic literature review skills (field-overview-review, field-evolution-review, literature-set-review, systematic-review, meta-analysis, theoretical-review). NOT directly triggered by users — referenced by other review skills via references/. Houses 20 Single Source of Truth (SSOT) documents covering review type decision tree, 12-phase lifecycle, PICO frameworks, search strategy, PRISMA-S/flow diagram, data extraction fields, effect size decision tree, risk-of-bias tool mapping, synthesis methods (meta-analysis + SWiM + narrative), GRADE framework, reporting standards (PRISMA + APA JARS), AMSTAR 2 self-assessment, AI failure defenses, expert methodology insights, psychology supplements, Chinese context, strict/learning mode profiles, wordcount rules. Use only when another review skill needs to load shared methodology — do NOT activate for user-facing review tasks. Other review skills are the user-facing entry points.

Install

npx vskill@latest install o0000-code/meta-analysis-skill/review-methodology-foundations

SKILL.md

review-methodology-foundations

本 Skill 是底座,不是用户面 Skill。它的章节序与 6 个用户面 Skill 不同——不含触发场景、主 Agent 角色、12 阶段工作流、字数控制、模式选择等用户面 Skill 章节。本 Skill 仅承载 20 份 SSOT,并提供其他 Skill 引用 SSOT 的规范。

§1 你产出什么、不产出什么

§1.1 这个 Skill 是什么

review-methodology-foundations 是六个学术综述 Skill 共用的方法论底座。它不直接回应用户请求,而是承载 20 份 Single Source of Truth(SSOT)文档,供下列六个面向用户的综述 Skill 通过 references/ 引用:

  • field-overview-review(领域概览综述:整合 + 范围)
  • field-evolution-review(领域发展综述:叙述 + 元叙事)
  • literature-set-review(基于已有文献集的综述:整合 + 叙述)
  • systematic-review(系统综述:严格 PRISMA 2020)
  • meta-analysis(元分析:systematic-review + 量化合成)
  • theoretical-review(理论综述:构念分析与理论建构)
§1.2 这个 Skill 不是什么
  • 不是用户入口——用户不应直接触发本 Skill;description 中的"NOT directly triggered"是硬约束。
  • 不是工作流执行者——本 Skill 不发布 SubAgent、不调 MCP、不产出综述章节;执行由六个面向用户的综述 Skill 各自承担。
  • 不是教材原文重述——SSOT 是经过结构化、操作化、并经主 Agent 仲裁的方法论决策;不是 Cooper/Cochrane/Borenstein/JBI 的复读。
§1.3 为什么是底座(SSOT 集中维护理由)

如果不存在底座 Skill,则 20 份方法论文档需要分别复制到 6 个综述 Skill 中,造成:

  • 冗余存储:同一份 PRISMA-S 模板被复制 6 份,任一更新需人工同步 6 处
  • 版本漂移:6 个 Skill 各自维护后,定义会逐步分歧(如 Cohen's d 解读阈值、I² 阈值、AMSTAR 2 关键域计数)
  • 判断不一致:用户在不同 Skill 间切换时,遇到对同一议题(如出版偏倚检验工具选择)的不同回答

底座架构通过"一处定义、多处引用"消除这些风险。任何 SSOT 更新自动惠及所有引用它的 Skill。


§2 SSOT 索引:何时引用哪个

下列决策表按综述方法论 12 阶段生命周期(L1–L12)+ 横切类组织。每条触发情境采用"具体决策动作"粒度(应用 C3.1 入口粒度规则),避免 SubAgent 在阶段名级粗粒度下错读 SSOT。

§2.1 按 12 阶段 + 横切类的索引
触发情境(具体决策动作)引用 SSOTLayer
主 Agent 在 L1 需要做综述类型 5 问决策 / Skill 间切换决策SSOT-REVIEW-TYPES.md1.A
主 Agent 在 L2 需要从 14 PICO 框架中选一个 / 派 PICO Constructor SubAgentSSOT-PICO-FRAMEWORKS.md1.B
主 Agent 在 L4 需要确定数据库列表 / PICO 关键词转布尔字符串SSOT-SEARCH-STRATEGY.md1.B
主 Agent 在 L5 需要 PRISMA-S 16 项穷尽要求文档化检索SSOT-PRISMA-S-TEMPLATE.md1.B
主 Agent 在 L6/L11 需要绘制 PRISMA 2020 流程图(4 阶段计数)SSOT-PRISMA-FLOW-DIAGRAM.md1.B
主 Agent 在 L7 需要确定提取字段(六大类 R/P/I/C/O/M)/ SR L7 → MA L9.1 字段映射SSOT-EXTRACTION-FIELDS.md1.B
主 Agent 在 L8 需要按研究设计选 RoB 工具(10 类设计)SSOT-ROB-TOOL-MAPPING.md1.B
主 Agent 在 L9 需要选择综合方法(meta-analysis / SWiM / Whittemore / Wong / Popay)SSOT-SYNTHESIS-METHODS.md1.B
主 Agent 在 L9.1 需要做单研究效应量类型决策 + SE 反算SSOT-EFFECT-SIZE-DECISION.md1.B
主 Agent 在 L10 需要 GRADE 5 降级 + 3 升级评估SSOT-GRADE-FRAMEWORK.md1.B
主 Agent 在 L11 需要按综述类型选报告标准(PRISMA / PRISMA-ScR / RAMESES / APA JARS)SSOT-REPORTING-STANDARDS.md1.B
主 Agent 在 L12 需要做 AMSTAR 2 16 项自评(仅 SR/MA 严格模式)SSOT-AMSTAR-2-CHECKLIST.md1.B
主 Agent 启动后立即必读(全 6 Skill 共享)SSOT-LIFECYCLE-12-PHASES.md1.A
SubAgent 在术语含义上卡壳 / 跨 Skill 术语统一性核查SSOT-METHODOLOGY-TERMINOLOGY.md1.A
主 Agent 启动后立即必读(全 6 Skill 共享,强制激活,无条件加载)SSOT-AI-FAILURE-DEFENSES.md1.A
教材方法在某具体决策上观点冲突 / LLM 框架边界问题 / Open Science 时代审查SSOT-EXPERT-METHODOLOGY-INSIGHTS.md1.A
用户场景含心理学触发词(APA、JARS、量表、构念、复制危机等)/ APA 89 期刊投稿SSOT-PSYCHOLOGY-SUPPLEMENTS.md1.C
用户输入含中文 / 投稿中文期刊 / GB/T 7714 引用格式 / MCP 中文检索回退SSOT-CHINESE-CONTEXT.md1.C
主 Agent 在 L3 需要决定严格 vs 学习模式 / 学习模式简化点披露SSOT-MODE-PROFILES.md1.C
主 Agent 在 L1/L11 需要确定字数公式 / 字数严重不匹配阈值判定SSOT-WORDCOUNT-RULES.md1.C
§2.2 SubAgent 加载规则(应用 C7 frontmatter 类型分层)

每个 SSOT 的 frontmatter 按"必读依赖 / 边界伙伴 / 弱引用"三字段分层:

字段语义SubAgent 行为
hard_dependencies必读依赖(不读则该 SSOT 无法独立使用)加载本 SSOT 时必须先加载这些
boundary_partners边界伙伴(同层互补,说明范围边界)按需跳转,不强制
weak_references弱引用(仅术语对接 / 概念补充)可选加载(仅术语含义不清时)

每个 SSOT 文件首部含 > 使用判定 块(明示触发条件),文件末尾含"应用与回归导航"段(明示被哪些 Skill 在哪个阶段引用、读完应回到哪)。SubAgent 在加载 SSOT 时只需读首部判定块即可决定是否加载,无需读 SKILL.md 决策表(progressive disclosure 第 3 级)。

§2.3 下游 Skill 的小决策表

下游 Skill 在自身 SKILL.md "§8 何时加载底座 SSOT" 章节给出与本 Skill 相关的子集小决策表(不复制本节全部 20 行)。例如:

  • meta-analysis §8 重点列 EFFECT-SIZE / SYNTHESIS / PSYCHOLOGY / GRADE / AMSTAR-2
  • theoretical-review §8 不列 PRISMA-FLOW-DIAGRAM / ROB-TOOL-MAPPING(不适用)

§3 SSOT 间引用关系图

20 个 SSOT 按层级分布。引用方向严格自下而上(高 Layer → 低 Layer),不存在反向或循环引用。

Layer 1.A(基础层,5 SSOT,无对外引用或仅引用 1.A 内部)
├── SSOT-REVIEW-TYPES
├── SSOT-LIFECYCLE-12-PHASES (→ REVIEW-TYPES)
├── SSOT-METHODOLOGY-TERMINOLOGY
├── SSOT-AI-FAILURE-DEFENSES
└── SSOT-EXPERT-METHODOLOGY-INSIGHTS (→ AI-FAILURE-DEFENSES)
│
▼
Layer 1.B(功能层,11 SSOT,向 1.A 引用;同层仅"边界伙伴"互引)
├── SSOT-PICO-FRAMEWORKS (→ REVIEW-TYPES, LIFECYCLE)
├── SSOT-SEARCH-STRATEGY (→ REVIEW-TYPES, LIFECYCLE, PICO)
├── SSOT-PRISMA-S-TEMPLATE (→ SEARCH-STRATEGY)
├── SSOT-PRISMA-FLOW-DIAGRAM (→ LIFECYCLE)
├── SSOT-EXTRACTION-FIELDS (→ LIFECYCLE)
├── SSOT-EFFECT-SIZE-DECISION (→ TERMINOLOGY; ⇄ EXTRACTION, SYNTHESIS [边界伙伴])
├── SSOT-ROB-TOOL-MAPPING (→ LIFECYCLE, TERMINOLOGY, REVIEW-TYPES)
├── SSOT-SYNTHESIS-METHODS (→ TERMINOLOGY, REVIEW-TYPES, LIFECYCLE; ⇄ EFFECT-SIZE [边界伙伴])
├── SSOT-GRADE-FRAMEWORK (→ REVIEW-TYPES, LIFECYCLE, TERMINOLOGY, ROB, SYNTHESIS)
├── SSOT-REPORTING-STANDARDS (→ REVIEW-TYPES, LIFECYCLE)
└── SSOT-AMSTAR-2-CHECKLIST (→ LIFECYCLE)
│
▼
Layer 1.C(语境层,4 SSOT,向 1.A + 1.B 引用)
├── SSOT-PSYCHOLOGY-SUPPLEMENTS (→ REPORTING, SYNTHESIS, EFFECT-SIZE, ROB, EXPERT, AI-FAILURE, LIFECYCLE)
├── SSOT-CHINESE-CONTEXT (→ SEARCH, REPORTING, REVIEW-TYPES, LIFECYCLE, PSYCHOLOGY)
├── SSOT-MODE-PROFILES (→ LIFECYCLE, REVIEW-TYPES)
└── SSOT-WORDCOUNT-RULES (→ REVIEW-TYPES)
§3.1 边界伙伴说明(应用 C7 §A.2 + W5_FIX_PLAN A.P1.1 + W5.4 R4 R11)

当前 SSOT 中存在 2 对边界伙伴双向互引:

边界伙伴对 1:EFFECT-SIZE-DECISION ⇄ SYNTHESIS-METHODS(Layer 1.B 同层)

EFFECT-SIZE-DECISION 与 SYNTHESIS-METHODS 各自声明对方为 boundary_partners。两者范围分工:

  • EFFECT-SIZE-DECISION 覆盖单研究效应量计算与解读
  • SYNTHESIS-METHODS 覆盖跨研究合并、异质性、出版偏倚

SubAgent 主动跳转的 3 个具体场景:

  1. SubAgent 加载 EFFECT-SIZE 后,发现需要做 I² / τ² / 出版偏倚 → 主动跳 SYNTHESIS-METHODS
  2. SubAgent 加载 SYNTHESIS-METHODS 后,发现需要先反算单研究 SE / 处理 unit-of-analysis → 主动跳 EFFECT-SIZE
  3. SubAgent 在 L9 决策"切到 meta-analysis vs 留在 SR L9 SWiM" → 同时加载两份 SSOT 比较决策门槛(k 阈值 + 异质性)

不在以上 3 场景时,读任一 SSOT 都不会被强制跳到另一份(按需跳转,不强制)。

边界伙伴对 2:AI-FAILURE-DEFENSES ⇄ EXPERT-METHODOLOGY-INSIGHTS(Layer 1.A 同层,W5.4 R4 新增)

两者各自声明对方为 boundary_partners(双向互引)。范围分工:

  • AI-FAILURE-DEFENSES 覆盖LLM 失败模式的识别与防御机制(4 类失败:引用幻觉 / 效应夸大 / 置信幻觉 / 采样偏倚放大)
  • EXPERT-METHODOLOGY-INSIGHTS 覆盖方法论可实现性边界 + 教材冲突仲裁立场 + 时代现实约束(5 维度判断)

SubAgent 主动跳转的 3 个具体场景:

  1. SubAgent 加载 EXPERT 后,遇到 LLM 实现差异需要披露 → 主动跳 AI-FAILURE 看 §1-§4 防御机制
  2. SubAgent 加载 AI-FAILURE 后,遇到教材方法的可实现性边界冲突 → 主动跳 EXPERT 看维度 1(LLM 框架可实现性边界)
  3. SubAgent 在 C4 三段披露写作时,需同时引用 AI-FAILURE 的失败防御 + EXPERT 的方法论立场 → 同时加载两份 SSOT

不在以上 3 场景时按需跳转,不强制。

§3.2 引用循环自检

落盘前查:

  • Layer 1.A SSOT 的 hard_dependencies 应只含 1.A 内部 SSOT(或为空)
  • Layer 1.B SSOT 的 hard_dependencies 不得含 1.B / 1.C SSOT;boundary_partners 仅同层(仅 EFFECT-SIZE ⇄ SYNTHESIS 一对)
  • Layer 1.C SSOT 可引用 1.A 或 1.B,绝不能引用其他 1.C SSOT 形成横向闭环

实际状态(截至 v1.1.0):上述 20 份 SSOT 的 frontmatter 三字段全部满足上述约束。

§3.3 长引用链 SubAgent 加载效率验证(W5.4 R6 注脚)

背景:W5.3-B 子维度 3"长引用链 SubAgent 加载效率"评分 9.0/10,剩余 1.0 分缺口为"未端到端 fresh SubAgent 模拟测试验证"。当前每条 4 级引用链(如 MA L9.6 → references/L9.6-subgroup-metaregression.md → SSOT-SYNTHESIS-METHODS §3.6 → SSOT-METHODOLOGY-TERMINOLOGY)的"清晰跳转条件"已通过结构修缮齐备(§A 使用判定 + §B 何时该读 / 读完回到哪 双块),但 fresh SubAgent 实际行为验证待 Wave 5.4 之后的端到端模拟补充。

验证方法(待执行):派 fresh SubAgent(无任何上下文),按下列 3 条链条端到端跑,量化每级跳转的实际生效率:

  1. 链 1:meta-analysis L9.6 → references/L9.6-subgroup-metaregression.md → SSOT-SYNTHESIS-METHODS §3.6 → SSOT-METHODOLOGY-TERMINOLOGY
  • 期望:第 4 级(METHODOLOGY-TERMINOLOGY)跳转率 ≤ 30%(设计预期:术语 SSOT 是兜底,不是常规跳转)
  1. 链 2:systematic-review L11 → references/L11-prisma-reporting.md → SSOT-REPORTING-STANDARDS → SSOT-PSYCHOLOGY-SUPPLEMENTS
  • 期望:心理学场景下整链生效率 ≥ 50%
  1. 链 3:literature-set-review L4 D11 → SSOT-AI-FAILURE-DEFENSES
  • 期望:保持 ≥ 86% 生效率(修缮前已达 86%)

已识别约束:MCP MCP-METHODOLOGY-TERMINOLOGY 是术语兜底,不是常规跳转目标——SubAgent 在术语含义清晰时不应跳转。本注脚显式声明此设计预期,避免后续审计误判 30% 跳转率为缺陷。

追踪:本验证由 Wave 5.4 之后的端到端模拟 SubAgent 完成,结果回写本节"实际状态"段。


§4 与六个综述 Skill 的关系

§4.1 六个综述 Skill 各自的强引用 SSOT
Skill强引用 SSOT(必读)弱引用 SSOT(按需)
field-overview-review(整合 + 范围)REVIEW-TYPES, LIFECYCLE, AI-FAILURE, PICO, SEARCH, EXTRACTION, SYNTHESIS, REPORTING, WORDCOUNT, MODETERMINOLOGY, EXPERT, GRADE, PSYCHOLOGY, CHINESE
field-evolution-review(叙述 + 元叙事)REVIEW-TYPES, LIFECYCLE, AI-FAILURE, SEARCH, EXTRACTION, SYNTHESIS, REPORTING, WORDCOUNT, MODETERMINOLOGY, EXPERT, PICO, PSYCHOLOGY, CHINESE
literature-set-review(已有文献集)REVIEW-TYPES, LIFECYCLE, AI-FAILURE, EXTRACTION, SYNTHESIS, REPORTING, WORDCOUNT, MODETERMINOLOGY, EXPERT, ROB, GRADE, PSYCHOLOGY, CHINESE
systematic-review(严格 PRISMA)全部 16 个 1.A+1.B SSOT + WORDCOUNT, MODEPSYCHOLOGY, CHINESE
meta-analysis(systematic + 量化合成)全部 16 个 1.A+1.B + EFFECT-SIZE 重点 + PSYCHOLOGY 重点CHINESE, MODE, WORDCOUNT
theoretical-review(构念分析)REVIEW-TYPES, LIFECYCLE, TERMINOLOGY, AI-FAILURE, EXPERT, SEARCH, REPORTING, WORDCOUNT, MODEEXTRACTION, SYNTHESIS, PSYCHOLOGY, CHINESE

下游 Skill 在自身 SKILL.md 顶层引用决策表中应明示其强弱引用集,避免一次任务读光所有 20 SSOT。

SSOT-AI-FAILURE-DEFENSES 强制激活基线(应用 W5_FIX_PLAN A.P2.2): 全部 6 个用户面 Skill 必须在"§3.1 主 Agent 必读(启动后立即加载)"小节显式列 SSOT-AI-FAILURE-DEFENSES。具体集成强度(强 / 中 / 基础)见 SSOT-AI-FAILURE-DEFENSES §6.2 的 6 Skill 集成矩阵。

§4.2 综述类型决策树(高层)

用户进入综述任务时通常不知道该用哪个 Skill。决策树骨架如下(详细决策见 references/SSOT-REVIEW-TYPES.md §2 判断 5 问):

用户场景
│
├─ 是否有现成文献集?
│ ├─ 是 → literature-set-review
│ └─ 否 → 继续
│
├─ 综述目的是什么?
│ ├─ 系统梳理领域全貌(无严格 PRISMA 要求)→ field-overview-review
│ ├─ 追溯领域发展史/演化路径 → field-evolution-review
│ ├─ 严格 PRISMA 2020 系统综述(医学/公共政策)→ systematic-review
│ ├─ 量化合并效应量(含 systematic 全套)→ meta-analysis
│ └─ 构念分析/理论建构/理论比较(无穷尽检索)→ theoretical-review
│
└─ 用户场景模糊 → 加载 SSOT-REVIEW-TYPES 全文 + 5 问决策

下游 Skill 不必复制本决策树,应直接引用 SSOT-REVIEW-TYPES.md。

§4.3 Skill 间能力委托

当一个 Skill 在执行中发现用户实际需求超出本 Skill 范围时,应主动建议切换而非勉强承担:

  • field-overview-review 发现用户实际想做严格 PRISMA → 建议切到 systematic-review
  • literature-set-review 发现文献集足够同质且需要量化合并 → 建议切到 meta-analysis
  • systematic-review 发现用户只想做范围概览 → 建议切到 field-overview-review
  • theoretical-review 发现用户实际想做实证综述 → 建议切到对应实证综述 Skill

下游 Skill 在 SKILL.md "§13 与其他 Skill 的关系"章节应明确列出其委托规则。


§5 引用规范(其他 Skill 引用 SSOT 的方式)

§5.1 引用格式
markdown
参见 review-methodology-foundations/references/SSOT-PICO-FRAMEWORKS.md §2.3(v1.0.0)

或在引用密集处使用脚注/段尾标记:

markdown
14 个 PICO 框架 [SSOT-PICO §1] 中,PEO 适用于质性综述 [SSOT-PICO §2.7]。

跨 Skill 引用语法应含版本号(应用 W5_FIX_PLAN A.P2.1)——SSOT 大版本升级时便于识别需要审视的 Skill。

§5.2 不允许复制粘贴 SSOT 内容

下游 Skill 的 SKILL.md / references/ 文件不得重复定义 SSOT 已覆盖的标准、公式、阈值、字段表。如:

  • 不在 6 个 Skill 中各自重写 PRISMA 2020 27 条
  • 不在 6 个 Skill 中各自定义 Cohen's d 解读阈值
  • 不在 6 个 Skill 中各自重写 AMSTAR 2 16 项

下游 Skill 应仅写"在哪个阶段引用 SSOT 的哪一节",而不是把内容搬过来。

§5.3 SSOT 版本号对接

每个 SSOT 在 frontmatter 中声明 version: X.Y.Z。下游 Skill 在引用时可选记录引用时所对接的版本,便于 SSOT 大版本升级时识别需要审视的 Skill:

markdown
本节遵循 SSOT-EFFECT-SIZE-DECISION.md v1.0.0 §3 决策树。

§6 SSOT 维护规则

§6.1 何时更新 SSOT

更新 SSOT 的合法触发:

  • 教材新版——Cooper / Cochrane / Borenstein / JBI / Booth / APA Manual 发布新版后审视相关 SSOT
  • 新失败模式——使用过程中发现新的 LLM 综述失败模式(更新 SSOT-AI-FAILURE-DEFENSES)
  • 用户反馈——多次用户反馈指向 SSOT 表达不清/缺漏,且属于 SSOT 范畴
  • 报告标准更新——PRISMA、APA JARS、AMSTAR 等扩展或新版发布
  • 统计方法更新——重要新统计方法在领域内被广泛接受(如 RoBMA、selection models 进展)

不属于 SSOT 更新触发:

  • 单次任务的偶发问题(应在该 Skill 自身 references/ 处理)
  • 与 SSOT 无关的 Skill 工作流调整
  • 个人偏好
§6.2 版本号约定
  • MAJOR(X+1.0.0)——SSOT 结构重大变更(删除整章、合并多份 SSOT、改变 Layer 归属)
  • MINOR(X.Y+1.0)——新增章节、新增决策项、补充新工具或框架
  • PATCH(X.Y.Z+1)——勘误、表述清晰化、引用补全、不影响判断结果的修订
§6.3 更新后的下游通知

SSOT 更新后,按"更新维度"通知下游 Skill:

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 98 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/o0000-code/meta-analysis-skill/review-methodology-foundations/badge)](https://verified-skill.com/skills/o0000-code/meta-analysis-skill/review-methodology-foundations)

Something wrong with this skill or its page? Tell us.