o0000-code/meta-analysis-skill · Archived

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-…

Installation

$ npx skills add o0000-code/meta-analysis-skill --skill review-methodology-foundations

Summary

  • 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.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from o0000-code/meta-analysis-skill.

npx skills add o0000-code/meta-analysis-skill

Browse all from o0000-code/meta-analysis-skill

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
License LICENSES
Default branch main
Open issues 0
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.1.0
LicensePolyForm-Noncommercial-1.0.0 AND CC-BY-NC-SA-4.0
More metadata
author
Bo
version
1.1.0
is_foundation
1
consumed_by
["field-overview-review","field-evolution-review","literature-set-review","systematic-review","meta-analysis","theoretical-review"]

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 22,126 B
  • docs SUMMARY.md 1,006 B

History

  1. First recorded snapshot · 1 installs

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 阶段 + 横切类的索引

触发情境(具体决策动作) 引用 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 + W5FIXPLAN 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 的 harddependencies 不得含 1.B / 1.C SSOT;boundarypartners 仅同层(仅 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, 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 强制激活基线(应用 W5FIXPLAN 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 引用语法应含版本号(应用 W5FIXPLAN 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 自身的落盘前查)

  • frontmatter name 与文件夹名一致review-methodology-foundations,kebab-case)
  • description < 1024 字符(实际 < 1024)
  • description 含"NOT directly triggered"明示(第二句)
  • frontmatter 含 isfoundation: trueconsumedby 列表(6 个综述 Skill)
  • 20 个 SSOT 全部在 references/(已在创建前验证)
  • SSOT 索引决策表覆盖 12 阶段 + 横切类(§2.1 共 20 行;触发情境采用具体决策动作粒度)
  • SSOT 间引用关系图无循环(§3 + §3.2 自检规则)
  • 边界伙伴 3 场景跳转明示(§3.1,应用 W5FIXPLAN A.P1.1)
  • SSOT-AI-FAILURE-DEFENSES 6 Skill 强制激活基线明示(§4.1,应用 W5FIXPLAN A.P2.2)
  • 跨 Skill 引用语法含版本号(§5.1,应用 W5FIXPLAN A.P2.1)
  • SKILL.md 主体 < 500 行(实际约 280 行)
  • 不含 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 场景跳转明示(应用 W5FIXPLAN A.P1.1);(4) SSOT-AI-FAILURE-DEFENSES 6 Skill 强制激活基线显式(应用 W5FIXPLAN A.P2.2);(5) 跨 Skill 引用语法含版本号(应用 W5FIXPLAN A.P2.1);(6) §3 引用关系图同步 frontmatter 三字段类型分层(应用 C7)。

下次预期更新触发:(1) Wave 2 完成后,按下游 Skill 实际引用情况补充 §4.1 强弱引用矩阵的精度;(2) 任一教材发布新版;(3) 累积新的 LLM 失败模式案例需要纳入 SSOT-AI-FAILURE-DEFENSES。