| name | review-methodology-foundations |
| description | 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. |
| license | PolyForm-Noncommercial-1.0.0 AND CC-BY-NC-SA-4.0 |
| metadata | {"author":"Bo","version":"1.1.0","is_foundation":true,"consumed_by":["field-overview-review","field-evolution-review","literature-set-review","systematic-review","meta-analysis","theoretical-review"]} |
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 阶段 + 横切类的索引
| 触发情境（具体决策动作） | 引用 SSOT | Layer |
|---|
| 主 Agent 在 L1 需要做综述类型 5 问决策 / Skill 间切换决策 | SSOT-REVIEW-TYPES.md | 1.A |
| 主 Agent 在 L2 需要从 14 PICO 框架中选一个 / 派 PICO Constructor SubAgent | SSOT-PICO-FRAMEWORKS.md | 1.B |
| 主 Agent 在 L4 需要确定数据库列表 / PICO 关键词转布尔字符串 | SSOT-SEARCH-STRATEGY.md | 1.B |
| 主 Agent 在 L5 需要 PRISMA-S 16 项穷尽要求文档化检索 | SSOT-PRISMA-S-TEMPLATE.md | 1.B |
| 主 Agent 在 L6/L11 需要绘制 PRISMA 2020 流程图（4 阶段计数） | SSOT-PRISMA-FLOW-DIAGRAM.md | 1.B |
| 主 Agent 在 L7 需要确定提取字段（六大类 R/P/I/C/O/M）/ SR L7 → MA L9.1 字段映射 | SSOT-EXTRACTION-FIELDS.md | 1.B |
| 主 Agent 在 L8 需要按研究设计选 RoB 工具（10 类设计） | SSOT-ROB-TOOL-MAPPING.md | 1.B |
| 主 Agent 在 L9 需要选择综合方法（meta-analysis / SWiM / Whittemore / Wong / Popay） | SSOT-SYNTHESIS-METHODS.md | 1.B |
| 主 Agent 在 L9.1 需要做单研究效应量类型决策 + SE 反算 | SSOT-EFFECT-SIZE-DECISION.md | 1.B |
| 主 Agent 在 L10 需要 GRADE 5 降级 + 3 升级评估 | SSOT-GRADE-FRAMEWORK.md | 1.B |
| 主 Agent 在 L11 需要按综述类型选报告标准（PRISMA / PRISMA-ScR / RAMESES / APA JARS） | SSOT-REPORTING-STANDARDS.md | 1.B |
| 主 Agent 在 L12 需要做 AMSTAR 2 16 项自评（仅 SR/MA 严格模式） | SSOT-AMSTAR-2-CHECKLIST.md | 1.B |
| 主 Agent 启动后立即必读（全 6 Skill 共享） | SSOT-LIFECYCLE-12-PHASES.md | 1.A |
| SubAgent 在术语含义上卡壳 / 跨 Skill 术语统一性核查 | SSOT-METHODOLOGY-TERMINOLOGY.md | 1.A |
| 主 Agent 启动后立即必读（全 6 Skill 共享，强制激活，无条件加载） | SSOT-AI-FAILURE-DEFENSES.md | 1.A |
| 教材方法在某具体决策上观点冲突 / LLM 框架边界问题 / Open Science 时代审查 | SSOT-EXPERT-METHODOLOGY-INSIGHTS.md | 1.A |
| 用户场景含心理学触发词（APA、JARS、量表、构念、复制危机等）/ APA 89 期刊投稿 |
§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-2theoretical-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 个具体场景：
- SubAgent 加载 EFFECT-SIZE 后，发现需要做 I² / τ² / 出版偏倚 → 主动跳 SYNTHESIS-METHODS
- SubAgent 加载 SYNTHESIS-METHODS 后，发现需要先反算单研究 SE / 处理 unit-of-analysis → 主动跳 EFFECT-SIZE
- 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 个具体场景：
- SubAgent 加载 EXPERT 后，遇到 LLM 实现差异需要披露 → 主动跳 AI-FAILURE 看 §1-§4 防御机制
- SubAgent 加载 AI-FAILURE 后，遇到教材方法的可实现性边界冲突 → 主动跳 EXPERT 看维度 1（LLM 框架可实现性边界）
- 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：meta-analysis L9.6 → references/L9.6-subgroup-metaregression.md → SSOT-SYNTHESIS-METHODS §3.6 → SSOT-METHODOLOGY-TERMINOLOGY
- 期望：第 4 级（METHODOLOGY-TERMINOLOGY）跳转率 ≤ 30%（设计预期：术语 SSOT 是兜底，不是常规跳转）
- 链 2：systematic-review L11 → references/L11-prisma-reporting.md → SSOT-REPORTING-STANDARDS → SSOT-PSYCHOLOGY-SUPPLEMENTS
- 链 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, MODE | TERMINOLOGY, EXPERT, GRADE, PSYCHOLOGY, CHINESE |
| field-evolution-review（叙述 + 元叙事） | REVIEW-TYPES, LIFECYCLE, AI-FAILURE, SEARCH, EXTRACTION, SYNTHESIS, REPORTING, WORDCOUNT, MODE | TERMINOLOGY, EXPERT, PICO, PSYCHOLOGY, CHINESE |
| literature-set-review（已有文献集） | REVIEW-TYPES, LIFECYCLE, AI-FAILURE, EXTRACTION, SYNTHESIS, REPORTING, WORDCOUNT, MODE | TERMINOLOGY, EXPERT, ROB, GRADE, PSYCHOLOGY, CHINESE |
| systematic-review（严格 PRISMA） | 全部 16 个 1.A+1.B SSOT + WORDCOUNT, MODE | PSYCHOLOGY, 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, MODE | EXTRACTION, 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 引用格式
参见 review-methodology-foundations/references/SSOT-PICO-FRAMEWORKS.md §2.3（v1.0.0）
或在引用密集处使用脚注/段尾标记：
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：
本节遵循 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：
- MAJOR/MINOR 更新：维护者应审视所有引用该 SSOT 的 Skill，确认引用位置仍准确（节号未漂移）；下游 Skill 引用时记录的版本号应同步更新
- PATCH 更新：通常无需下游审视，但应在 SSOT 末"版本与维护"章节记录变更说明
每个 SSOT 末必有"§N 版本与维护"小节，按时间倒序记录变更日志。
§7 自检清单（对本 SKILL.md 自身的落盘前查）
§8 版本与维护
| 版本 | 日期 | 变更 |
|---|
| 1.0.0 | 2026-04-26 | 初版。20 SSOT（5 + 11 + 4）按 Layer 1.A/1.B/1.C 完成。 |
| 1.1.0 | 2026-04-28 | Wave 5.2.2-A 修缮：(1) 应用 C5 章节序模板（底座 Skill 简化版，§1-§8）；(2) 索引决策表入口粒度细化为"具体决策动作"（应用 C3.1）；(3) 边界伙伴 3 场景跳转明示（应用 W5_FIX_PLAN A.P1.1）；(4) SSOT-AI-FAILURE-DEFENSES 6 Skill 强制激活基线显式（应用 W5_FIX_PLAN A.P2.2）；(5) 跨 Skill 引用语法含版本号（应用 W5_FIX_PLAN A.P2.1）；(6) §3 引用关系图同步 frontmatter 三字段类型分层（应用 C7）。 |
下次预期更新触发：(1) Wave 2 完成后，按下游 Skill 实际引用情况补充 §4.1 强弱引用矩阵的精度；(2) 任一教材发布新版；(3) 累积新的 LLM 失败模式案例需要纳入 SSOT-AI-FAILURE-DEFENSES。
