Skip to main content

review-methodology-foundations

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.

Source facts

Repository
O0000-code/meta-analysis-skill
Last source activity
July 7, 2026 at 09:45
Detected SKILL.md language
Chinese
Stars
1
Forks
0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
100 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
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 期刊投稿 | `SSOT-PSYCHOLOGY-SUPPLEMENTS.md` | 1.C | | 用户输入含中文 / 投稿中文期刊 / GB/T 7714 引用格式 / MCP 中文检索回退 | `SSOT-CHINESE-CONTEXT.md` | 1.C | | 主 Agent 在 L3 需要决定严格 vs 学习模式 / 学习模式简化点披露 | `SSOT-MODE-PROFILES.md` | 1.C | | 主 Agent 在 L1/L11 需要确定字数公式 / 字数严重不匹配阈值判定 | `SSOT-WORDCOUNT-RULES.md` | 1.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 是兜底,不是常规跳转) 2. **链 2**:systematic-review L11 → references/L11-prisma-reporting.md → SSOT-REPORTING-STANDARDS → SSOT-PSYCHOLOGY-SUPPLEMENTS - 期望:心理学场景下整链生效率 ≥ 50% 3. **链 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 引用格式 ```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: - **MAJOR/MINOR 更新**:维护者应审视所有引用该 SSOT 的 Skill,确认引用位置仍准确(节号未漂移);下游 Skill 引用时记录的版本号应同步更新 - **PATCH 更新**:通常无需下游审视,但应在 SSOT 末"版本与维护"章节记录变更说明 每个 SSOT 末必有"§N 版本与维护"小节,按时间倒序记录变更日志。 --- ## §7 自检清单(对本 SKILL.md 自身的落盘前查) - [x] **frontmatter `name` 与文件夹名一致**(`review-methodology-foundations`,kebab-case) - [x] **description < 1024 字符**(实际 < 1024) - [x] **description 含"NOT directly triggered"明示**(第二句) - [x] **frontmatter 含 `is_foundation: true` 与 `consumed_by` 列表**(6 个综述 Skill) - [x] **20 个 SSOT 全部在 `references/` 下**(已在创建前验证) - [x] **SSOT 索引决策表覆盖 12 阶段 + 横切类**(§2.1 共 20 行;触发情境采用具体决策动作粒度) - [x] **SSOT 间引用关系图无循环**(§3 + §3.2 自检规则) - [x] **边界伙伴 3 场景跳转明示**(§3.1,应用 W5_FIX_PLAN A.P1.1) - [x] **SSOT-AI-FAILURE-DEFENSES 6 Skill 强制激活基线明示**(§4.1,应用 W5_FIX_PLAN A.P2.2) - [x] **跨 Skill 引用语法含版本号**(§5.1,应用 W5_FIX_PLAN A.P2.1) - [x] **SKILL.md 主体 < 500 行**(实际约 280 行) - [x] **不含 README.md / XML 角括号 / 大写下划线 name** --- ## §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。
View on GitHub