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.

소스 정보

저장소
O0000-code/meta-analysis-skill
최근 소스 활동
2026년 7월 7일 09:45
감지된 SKILL.md 언어
중국어
스타
1
포크
0

설치 방법

기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.

소스 파일 검토

설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.

파일 탐색기
100 개 파일

SKILL.md 표시 중

SKILL.md
소스 지침 · 읽기 전용 미리보기
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。
GitHub에서 보기