Evidence ↔ 附录 C 双向同步 Skill (L2 · 复用组件)

> L2 工具组件:本 skill 强制执行"evidence/ 文件夹 PMID 集合"与"报告附录 C PMID 清单"的双向零差集同步。 > 设计目标:杜绝"作者凭印象手写附录 C 致 75% PMID 缺失"的反复失败模式。 > 上游依赖:market-sizing-mece-foundation (L0 evidence-driven pattern) + 任意 L1 疾病 skill (IFI / ICU 真菌 / 等)

> 诞生背景 (2026-04-25) · 血液科 IFI v2.5 项目交付后,用户审计发现:evidence/*.md 累积 44 条 PMID,但报告附录 C 仅列 11 条,缺失率 75%。根因不是数据丢失,而是"报告作者凭印象写附录 C,没有完整列出 evidence 中所有 PMID"。本 skill 将该校验流程标准化、可移植化。

一句话定义

报告交付前,机械地对齐 evidence/ 文件夹中所有 PMID 与报告附录 C 中所有 PMID,确保两个集合完全相等(双向零差集),并按"证据等级 × 研究类型"分组呈现。

何时调用本 skill

| 场景 | 触发动作 | |---|---| | 任何医学市场调研报告交付前最后一道关 | 强制调用,作为质控终点 | | 附录 C / 参考文献清单第一次起草 | 直接用本 skill 生成,而非手写 | | 报告迭代到 v2.x / v3.x 等大版本 | 每个大版本都要重跑同步,evidence 增量必须反映在附录 C | | 用户提出"参考文献是否完整" / "附录 C 看起来太少" | 立即用本 skill 做双向校验 | | 跨疾病移植项目(IFI → 呼吸科 真菌 → ICU 脓毒症) | 新项目第一次交付前必跑 |

何时不调用本 skill

| 场景 | 原因 | |---|---| | 报告还在数据收集阶段(evidence/ 还没稳定) | 同步无意义,evidence 还在变 | | 内部草稿、未交付版本 | 可延后到正式交付前再跑 | | 不基于 evidence/ 模式的报告(纯定性、纯访谈) | 没有 PMID 集合可对齐 | | 单纯改报告排版/UI,未触动文献 | evidence 与附录 C 都未变,无需重跑 |

核心规范 · Iron Law(违反即不通过)

Rule 1 · evidence/ → 附录 C 零遗漏

evidence/ 中所有 PMID 必须出现在附录 C。不允许"作者觉得不重要就不列"。

> 反例(血液科 v2.5 复现):evidence/ 有 44 条 PMID,附录 C 只列 11 条。33 条 evidence 中实际引用但附录未列 → 读者无法追溯。

bash
# 校验脚本(必须返回空)
diff <(grep -roh "PMID:[0-9]\+" evidence/ | sort -u) \
     <(grep -oh "PMID:[0-9]\+" 报告_附录C.html | sort -u)

Rule 2 · 附录 C → evidence/ 零幻觉

附录 C 中所有 PMID 必须能在 evidence/ 找到来源文件。不允许"凭记忆补一个 PubMed 号"。

> 反例:附录 C 列 PMID:34567890,但 grep 整个 evidence/ 找不到 → 幻觉,必须删除或补充对应 evidence/{PMID}.md 文件。

Rule 3 · 双维度分组(证据等级 × 研究类型)

附录 C 必须按以下分组层级展示:

附录 C · 参考文献清单(共 N 条)
├── 🟢 A 级证据(指南 / Meta 分析 / Cochrane)
├── 🔵 B 级证据(RCT / 大样本前瞻队列)
├── 🟡 C 级证据(回顾性研究 / 单中心队列 / 病例系列)
├── ⚪ 参考性资料(综述 / 述评 / 流行病学背景)
└── 🟠 待标注(评级未定的 PMID,必须在交付前清零)

禁止 把 PMID 平铺一个长列表 — 读者无法判断证据强度。

Rule 4 · 每条 PMID 四要素必含

| 要素 | 示例 | |---|---| | 第一作者 + 年份 | Maertens J, 2024 | | 研究类型 | RCT / Meta-analysis / Retrospective cohort | | 核心数据(1-2 句话) | 泊沙康唑 vs. 氟康唑预防 IFI,IFD 率从 8% → 2.3% (HR=0.28) | | 应用领域(指向报告章节) | 用于 §3.2 高危预防策略 Sankey 图 |

缺任一要素 → 阻塞交付。

Rule 5 · 每条 PMID 必含 5 项元数据(零裸数字)· v1.1 新增

附录 C 中每条 PMID 必须同时包含以下 5 项元数据,缺一即视为"占位式补录"(zombie PMID),禁止交付:

| # | 元数据 | 示例 | 缺失后果 | |---|---|---|---| | 1 | 标题(简化) | 泊沙康唑预防造血干细胞移植后 IFD 的 III 期 RCT | 读者无法判断主题 | | 2 | 第一作者 + 年份 | Maertens J, 2024 | 无法追溯/引用/同行讨论 | | 3 | 期刊名 | N Engl J Med / Blood / J Clin Oncol | 无法判断证据权威性 | | 4 | n=受试者数(或 study type) | n=575 或 Phase III RCT, multi-center | 无法判断证据强度 | | 5 | 核心数据一行(关键百分比/OR/HR) | IFD 率 2.3% vs 8% (HR=0.28, p<0.001) | 无法判断结果显著性 |

> 历史复现证据(血液科 v2.5.1):附录 C 子分组 C.5 / C.6 共 15 条 PMID 仅列裸数字,无标题、无作者、无期刊、无 n、无核心数据。用户立即指出"这些文献仍处于不明确/缺失状态"。根因:v1.0 skill 只规定 evidence/ ↔ 附录 C 集合差为零,但未强制每条 PMID 必含元数据。Sub-agent 把 evidence/ 中 grep 出的孤立 PMID 直接列入附录 C,留空元数据字段。

> 如何应用:发现 evidence/ 有 PMID 但缺元数据时,必须调用以下任一通道拉取元数据,再写入附录 C: > - medical-research skill > - pubmed-search skill > - WebFetch https://pubmed.ncbi.nlm.nih.gov/{PMID}/ > > 禁止:在元数据缺失时强行交付,或用"待补充"占位。

Rule 6 · PMID 主题相关性核查(防关键词污染)· v1.1 新增

每条进入附录 C 的 PMID,必须用 PubMed 元数据验证标题与项目主题相关。关键词污染(早期 evidence 采集时关键词模糊匹配混入主题无关 PMID)是一类隐蔽但严重的失败模式。

项目领域 → 标题关键词相关性矩阵:

血液科 IFI 项目  → 标题应含: hematolog* / leukemia / lymphoma / myeloma /
                            HSCT / CAR-T / fungal / aspergillus / candida /
                            mucor / pneumocystis / antifungal / IFD / IFI /
                            真菌 / 血液 / 移植

呼吸科真菌项目  → 标题应含: respirator* / pulmonar* / RICU / CAPA / CPA /
                            ABPA / aspergill* / pneumon* / 呼吸 / 肺

肿瘤免疫项目    → 标题应含: tumor / oncology / immune* / checkpoint / CAR /
                            antibody

> 历史复现证据(血液科 v2.5.2):经 PubMed 核查发现 4 条主题完全无关 PMID 混入血液科 IFI 附录 C: > - PMID:10793555 → 日本老年社会医学(2000) > - PMID:37293262 → 茶尺蠖昆虫学 > - PMID:39034762 → 钙钛矿太阳能电池 > - PMID:39039587 → 脊柱外科麻醉 > > 根因:v2.4 evidence 采集 sub-agent 关键词搜索时模糊匹配混入(搜 "hematology fungal" 返回邻近数字段落中无关文献),v1.0 skill 没有"PMID 主题相关性核查"步骤。zombie PMID 不仅占位,还可能让读者误以为有支撑数据。

> 如何应用:evidence-appendix-sync 阶段用 grep + PubMed 拉每条 PMID 的标题,与项目关键词矩阵 fuzzy match。无关项 → 从 evidence/ 删除并在附录 C 中透明披露(不要静默删除,留痕展示根因)。透明披露格式见 Step 8 模板。

Rule 7 · evidence/ 内部标注 vs PubMed 真实文献冲突时,信 PubMed · v1.2 新增

当 evidence/ 中的 PMID 标注(主题/作者/期刊)与 PubMed 实际返回的文献元数据直接冲突时,唯一正确处理是:信任 PubMed,删除 evidence 错误条目,留 TODO 让人类后续重找正确 PMID。禁止"保留 + ⚠️ 警告"的妥协式呈现。

数据源信任优先级链(物理真理 → 易错笔记):

PubMed (PMID → 文献的物理映射 · 不可争议)
  > 期刊官网 / DOI 映射
  > NMPA 批件原文
  > 项目 evidence/ 笔记 (可错 · 输入错误/OCR 错误/复制粘贴移位)
  > LLM 推断 / 印象 (最不可信)

Why 不能"保留 + 警告":

• PubMed 是 PMID → 文献的物理映射,绝对可靠;evidence/ 只是项目笔记,可能因人类输入错误 / OCR 错误 / 复制粘贴时数字移位导致 PMID 数字与标注不符
• "保留 + ⚠️ 警告"是最差妥协 — 读者扫描附录 C 时仍会误以为是真文献(警告框易被忽略),且警告框反而让报告显得不专业
• 正确做法是信 PubMed 删 evidence,在 evidence/ 原引用位置留 HTML TODO 注释("此处原引 X 研究,但 PMID:XXX 在 PubMed 上是 Y 主题,请人工重找正确 PMID"),并在附录 C 删除披露区透明列出

> 历史复现证据(血液科 v2.5.3):经 PubMed 复核发现 3 条 evidence/ 标注与 PubMed 真实文献直接冲突: > - PMID:37293262 · evidence/ 标 "Xu Y 2023 · DLBCL PJP 病例系列 · SAGE Open Med" / PubMed 实为 "Yang F 2023 · 茶尺蠖 CXE14 羧酯酶基因表达 · Front Physiol" > - PMID:39034762 · evidence/ 标"中华血液学杂志推断" / PubMed 实为钙钛矿太阳能电池 > - PMID:39039587 · evidence/ 标"中华血液学杂志推断" / PubMed 实为脊柱外科麻醉 > > v2.5.2 错误处理:把这 3 条"保留在附录 C C.5 + 加 ⚠️ 警告框"。v2.5.3 用户立即指出这是最差妥协 — 应该信 PubMed 物理真理,直接删除。

> 如何应用(6 步流程): > - Step 1:用 WebFetch https://pubmed.ncbi.nlm.nih.gov/{PMID}/ 或 pubmed-search skill 拉每条 evidence/ 中 PMID 的真实标题 > - Step 2:与 evidence/ 中标注做标题关键词 fuzzy match(同主题词共现 ≥1 即可) > - Step 3:不匹配 → 标记为"内外冲突" > - Step 4:从附录 C 直接删除该 PMID(不可"保留 + 警告") > - Step 5:在 evidence/ 原引用位置追加 HTML 注释: > html > <!-- TODO v2.5.3: PMID:37293262 evidence 笔记标注 DLBCL PJP 病例系列, > 但 PubMed 真实为茶尺蠖昆虫学(Yang F 2023 Front Physiol),内外冲突。 > 请人工重找正确 PMID 并替换。--> > > - Step 6:在附录 C "C.6 已删除条目"区块,新建"类型 B · 内外冲突"子表格透明披露(区别于 v1.1 的"类型 A · 关键词污染")

执行流程 · SOP(9 步)

Step 1 · 提取 evidence/ 中全部 PMID

bash
# Bash(Git Bash / WSL / macOS)
grep -roh "PMID:[0-9]\+" evidence/ | sort -u > /tmp/evidence_pmids.txt
wc -l /tmp/evidence_pmids.txt

powershell
# PowerShell 5.1 等价命令
Select-String -Path "evidence\*.md" -Pattern "PMID:\d+" -AllMatches |
  ForEach-Object { $_.Matches.Value } | Sort-Object -Unique |
  Out-File -Encoding utf8 evidence_pmids.txt
(Get-Content evidence_pmids.txt).Count

预期输出:每行一个 PMID:XXXXXXXX,总数应等于 evidence 文件夹独立 PMID 数。

Step 2 · 按证据等级分组

打开每个 evidence/{PMID}.md,读取 frontmatter 中的 evidence_level: A|B|C|D 字段,按 5 个分组桶整理:

yaml
# evidence/PMID_38381437.md 头部示例
---
pmid: "PMID:38381437"
first_author: "Maertens J"
year: 2024
study_type: "Phase III RCT"
evidence_level: "B"   # ← 核心字段
key_finding: "泊沙康唑 vs 氟康唑 IFD 率 2.3% vs 8%"
applies_to: "§3.2 高危预防策略"
---

若 evidence/ 文件没有 evidence_level 字段 → 进入 🟠 待标注桶,同时回到 evidence 补齐。

Step 3 · 每条 PMID 收集四要素元数据

可用 Python / 手工 / Bash 拼接,生成中间 JSON:

json
{
  "PMID:38381437": {
    "first_author": "Maertens J",
    "year": 2024,
    "study_type": "Phase III RCT",
    "level": "B",
    "key_finding": "泊沙康唑 vs 氟康唑预防 IFD 率 2.3% vs 8% (HR=0.28)",
    "applies_to": "§3.2 高危预防 / Sankey 图"
  },
  ...
}

Step 4 · 生成附录 C HTML 块

用下方"完整模板"直接替换报告中旧的附录 C <section>。

Step 5 · 双向数量校验

bash
# 必须返回完全一致的差集为空
EVIDENCE_COUNT=$(grep -roh "PMID:[0-9]\+" evidence/ | sort -u | wc -l)
APPENDIX_COUNT=$(grep -oh "PMID:[0-9]\+" 报告_附录C.html | sort -u | wc -l)
echo "evidence: $EVIDENCE_COUNT  appendix: $APPENDIX_COUNT"
# 两者必须相等
diff <(grep -roh "PMID:[0-9]\+" evidence/ | sort -u) \
     <(grep -oh "PMID:[0-9]\+" 报告_附录C.html | sort -u)
# 期望:无任何输出(空 diff = 通过)

差集非空 → 回到 Step 1 排查;严禁强行交付。

Step 6 · 用 PubMed 拉每条 PMID 元数据(v1.1 新增)

对每条 PMID,逐条确认 5 项元数据(Rule 5)是否齐全。任一缺失 → 调用以下通道补齐:

bash
# 通道 A:WebFetch(单条 PMID)
WebFetch https://pubmed.ncbi.nlm.nih.gov/{PMID}/
# 解析返回 HTML:<title>(标题) · authors · journal · year · abstract(找 n / OR / HR)

# 通道 B:medical-research / pubmed-search skill(批量更优)
# 输入 PMID 列表,返回结构化元数据 JSON

执行清单(对每条 PMID):

• ] 标题(简化):去掉冗余副标题,保留主诊断 + 干预 + 设计
• ] 第一作者 + 年份:Maertens J, 2024
• ] 期刊名:N Engl J Med(用标准 ISO 缩写)
• ] n(受试者数)或 study type:n=575 或 Phase III RCT
• ] 核心数据一行:关键百分比 / OR / HR / p 值

写入对应 evidence/{PMID}.md frontmatter,同步更新附录 C 条目。

Step 7 · 主题相关性核查(v1.1 新增)

对每条 PMID,把标题与"项目领域关键词矩阵"(见 Rule 6)做 fuzzy match:

bash
# 示例:血液科 IFI 项目核查
for pmid in $(cat /tmp/evidence_pmids.txt); do
  TITLE=$(curl -s "https://pubmed.ncbi.nlm.nih.gov/${pmid#PMID:}/" | \
          grep -oP '<title>\K[^<]+' | head -1)
  echo "$pmid: $TITLE" | \
    grep -iE "hematolog|leukemia|lymphoma|myeloma|HSCT|CAR-T|fungal|aspergillus|candida|mucor|pneumocystis|antifungal|IFD|IFI|真菌|血液|移植" || \
    echo "⚠️ OFF-TOPIC: $pmid - $TITLE"
done

判定规则: | 情况 | 处理 | |---|---| | 标题命中 ≥1 个领域关键词 | 通过 ✅ | | 标题完全不命中 | 标记为"主题无关",进入 Step 8 透明披露 | | 标题部分命中(交叉学科) | 人工复核摘要,有疑问保守保留 + 标注 |

Step 8 · 无关项透明删除 + 披露区块(v1.1 新增)

发现的无关 PMID,禁止静默删除(读者审计时无法追溯根因)。必须从 evidence/ 删除并在附录 C 末尾追加"删除披露区块":

html
<!-- 附录 C 末尾追加 -->
<details class="ref-group level-removed">
  <summary>⚠️ 已删除条目透明披露(v1.1 引入,共 <strong>4</strong> 条) ·
    <em>因主题无关 / 关键词污染 / 重复幻觉,从 evidence/ 与附录 C 同步删除</em>
  </summary>
  <table class="removed-table">
    <thead>
      <tr><th>已删 PMID</th><th>实际主题</th><th>删除原因</th><th>检测时间</th></tr>
    </thead>
    <tbody>
      <tr>
        <td><span class="pmid">PMID:10793555</span></td>
        <td>日本老年社会医学(2000)</td>
        <td>关键词污染 — 与血液科 IFI 主题完全无关</td>
        <td>2026-04-25</td>
      </tr>
      <tr>
        <td><span class="pmid">PMID:37293262</span></td>
        <td>茶尺蠖昆虫学</td>
        <td>关键词污染 — 模糊匹配混入</td>
        <td>2026-04-25</td>
      </tr>
      <tr>
        <td><span class="pmid">PMID:39034762</span></td>
        <td>钙钛矿太阳能电池</td>
        <td>关键词污染 — PubMed 邻近号段误抓</td>
        <td>2026-04-25</td>
      </tr>
      <tr>
        <td><span class="pmid">PMID:39039587</span></td>
        <td>脊柱外科麻醉</td>
        <td>关键词污染 — 非血液科文献</td>
        <td>2026-04-25</td>
      </tr>
    </tbody>
  </table>
  <p class="meta">
    根因分析:v2.4 evidence 采集 sub-agent 关键词搜索时模糊匹配混入。
    v1.1 起强制 Iron Law 6(主题相关性核查)防止再发生。
  </p>
</details>

重要:删除披露区块必须保留至所有后续版本(v2.6 / v3.0 等),让审计链路完整可见。

Step 9 · PMID 内外冲突核查(v1.2 新增)

Step 7 解决"evidence/ + PubMed 都无关"(关键词污染)。Step 9 解决更隐蔽的"evidence/ 标对题 + PubMed 显示无关"(内外冲突)— 即 evidence/ 笔记记录的主题/作者/期刊与 PubMed 真实文献元数据直接冲突。

为什么 Step 7 不够:Step 7 只比对 PubMed 标题与项目领域关键词。如果 evidence/ 笔记自身写得"看起来对题"(例:写"DLBCL PJP 病例系列"),Step 7 会通过领域关键词核查,但 PubMed 真实文献可能完全是另一篇(例:茶尺蠖昆虫学)。这种"内外冲突"必须独立核查。

执行流程:

bash
# 对每条 PMID,逐条比对 evidence/ 标注 vs PubMed 真实标题
for pmid in $(cat /tmp/evidence_pmids.txt); do
  # Step 9.1:从 evidence/{PMID}.md 提取笔记中的标注主题
  EVIDENCE_TITLE=$(grep -A1 "^title:" evidence/${pmid#PMID:}.md | head -1)

  # Step 9.2:从 PubMed 拉真实标题
  PUBMED_TITLE=$(curl -s "https://pubmed.ncbi.nlm.nih.gov/${pmid#PMID:}/" | \
                 grep -oP '<title>\K[^<]+' | head -1)

  # Step 9.3:fuzzy match(关键名词共现 ≥1 即认为一致)
  echo "=== $pmid ==="
  echo "Evidence: $EVIDENCE_TITLE"
  echo "PubMed:   $PUBMED_TITLE"
  # 人工核对 / LLM 判断关键词共现
done

判定 + 处理:

| 比对结果 | 处理 | |---|---| | evidence/ 标题与 PubMed 标题主题词共现 ≥1 | 通过 ✅(PMID 正确) | | 主题词完全不共现(内外冲突) | 删除该 PMID + evidence/ 留 TODO + 附录 C 透明披露 | | 部分共现(交叉学科 / 模糊) | 人工复核摘要,有疑问保守删除 |

evidence/ TODO 注释模板:

html
<!-- TODO v2.5.3: PMID:{pmid} evidence 笔记标注 "{evidence_title}",
     但 PubMed 真实文献为 "{pubmed_title}",内外冲突。
     疑似输入错误 / OCR 错误 / 复制粘贴时 PMID 数字移位。
     请人工重新查找正确 PMID 并替换;原 evidence 内容暂保留供参考。-->

附录 C 透明披露(类型 B 内外冲突)— 在 Step 8 的"已删除条目透明披露"区块中追加新表格:

html
<details class="ref-group level-removed">
  <summary>⚠️ 已删除条目透明披露 · 类型 B · 内外冲突(v1.2 引入,共 <strong>3</strong> 条)</summary>
  <p class="meta">
    <strong>定义</strong>:evidence/ 笔记标注主题与 PubMed 真实文献主题直接冲突。
    <strong>处理原则</strong>(Iron Law 7):信任 PubMed 物理真理,删除 evidence 错误条目。
  </p>
  <table class="removed-table">
    <thead>
      <tr><th>已删 PMID</th><th>evidence/ 笔记标注</th><th>PubMed 真实主题</th><th>检测时间</th></tr>
    </thead>
    <tbody>
      <tr>
        <td><span class="pmid">PMID:37293262</span></td>
        <td>Xu Y 2023 · DLBCL PJP 病例系列 · SAGE Open Med</td>
        <td>Yang F 2023 · 茶尺蠖 CXE14 羧酯酶基因表达 · Front Physiol</td>
        <td>2026-04-25</td>
      </tr>
      <tr>
        <td><span class="pmid">PMID:39034762</span></td>
        <td>(笔记推断为)中华血液学杂志</td>
        <td>钙钛矿太阳能电池</td>
        <td>2026-04-25</td>
      </tr>
      <tr>
        <td><span class="pmid">PMID:39039587</span></td>
        <td>(笔记推断为)中华血液学杂志</td>
        <td>脊柱外科麻醉</td>
        <td>2026-04-25</td>
      </tr>
    </tbody>
  </table>
  <p class="meta">
    根因分析:疑似 evidence 录入时人类输入错误 / OCR 错误 / 复制粘贴时 PMID 数字移位。
    v1.2 起强制 Iron Law 7 + Step 9 PMID 内外冲突核查防止再发生。
    evidence/ 原引用位置已留 TODO 注释,待人工重找正确 PMID。
  </p>
</details>

Why 必须删除而非"保留 + 警告"(再次强调,这是 v2.5.2 → v2.5.3 最重要的修正):

• 读者扫描附录 C 时警告框易被忽略,仍会误以为是真文献 → 引用错误传播
• "保留 + 警告"反而让报告显得不专业(读者疑问:为什么把已知有问题的文献仍然展示?)
• PubMed 是物理真理,evidence/ 笔记可错;遵循信任优先级链,应该信 PubMed
• 删除后留 TODO 是唯一正确的渐进修复:先去除错误信息,再让人类后续补正确 PMID

完整模板(直接复制粘贴)

html
<section id="appendix-c" class="appendix">
  <h2>附录 C · 参考文献清单(共 <span id="ref-total">44</span> 条)</h2>
  <p class="meta">PMID 与 evidence/ 文件夹双向同步 · 最后校验:2026-04-25</p>

  <!-- 🟢 A 级:指南 / Meta 分析 / Cochrane -->
  <details open class="ref-group level-a">
    <summary>🟢 A 级证据(指南 / Meta 分析 / Cochrane) · <strong>N 条</strong></summary>
    <ol>
      <li>
        <span class="pmid">PMID:38381437</span> · Maertens J, 2024 ·
        <em>Phase III RCT</em> ·
        泊沙康唑 vs 氟康唑预防 IFD 率 2.3% vs 8% (HR=0.28) ·
        <a href="#sec-3-2">用于 §3.2 高危预防策略</a>
      </li>
      <!-- ...依次列出 A 级所有 PMID... -->
    </ol>
  </details>

  <!-- 🔵 B 级:RCT / 大样本前瞻队列 -->
  <details open class="ref-group level-b">
    <summary>🔵 B 级证据(RCT / 大样本前瞻队列) · <strong>N 条</strong></summary>
    <ol>
      <!-- ...所有 B 级 PMID,四要素齐全... -->
    </ol>
  </details>

  <!-- 🟡 C 级:回顾性 / 单中心 / 病例系列 -->
  <details class="ref-group level-c">
    <summary>🟡 C 级证据(回顾性 / 单中心 / 病例系列) · <strong>N 条</strong></summary>
    <ol>
      <!-- ... -->
    </ol>
  </details>

  <!-- ⚪ 参考性资料 -->
  <details class="ref-group level-ref">
    <summary>⚪ 参考性资料(综述 / 述评 / 流行病学背景) · <strong>N 条</strong></summary>
    <ol>
      <!-- ... -->
    </ol>
  </details>

  <!-- 🟠 待标注:交付前必须清零 -->
  <details class="ref-group level-pending">
    <summary>🟠 待标注(交付前清零) · <strong>0 条</strong></summary>
    <ol>
      <!-- 空数组 = 通过 -->
    </ol>
  </details>

  <!-- 证据等级说明表 -->
  <table class="evidence-legend">
    <thead>
      <tr><th>等级</th><th>含义</th><th>典型来源</th></tr>
    </thead>
    <tbody>
      <tr><td>🟢 A</td><td>最强证据</td><td>系统综述 / Meta / Cochrane / 一线指南</td></tr>
      <tr><td>🔵 B</td><td>较强证据</td><td>多中心 RCT / 大样本前瞻队列</td></tr>
      <tr><td>🟡 C</td><td>中等证据</td><td>回顾性研究 / 单中心 / 病例系列</td></tr>
      <tr><td>⚪ 参考</td><td>背景参考</td><td>综述 / 述评 / 流行病学统计</td></tr>
      <tr><td>🟠 待定</td><td>评级未完成</td><td>交付前必须清零</td></tr>
    </tbody>
  </table>
</section>

配套 CSS(可选,放 <style> 中):

css
.appendix .ref-group { margin: 1rem 0; padding: 0.5rem 1rem; border-left: 4px solid; border-radius: 4px; }
.appendix .level-a { border-color: #16a34a; background: #f0fdf4; }
.appendix .level-b { border-color: #2563eb; background: #eff6ff; }
.appendix .level-c { border-color: #ca8a04; background: #fefce8; }
.appendix .level-ref { border-color: #94a3b8; background: #f8fafc; }
.appendix .level-pending { border-color: #ea580c; background: #fff7ed; }
.appendix .level-removed { border-color: #dc2626; background: #fef2f2; }  /* v1.1 删除披露区块 */
.appendix .removed-table { width: 100%; border-collapse: collapse; margin-top: 0.5rem; }
.appendix .removed-table th, .appendix .removed-table td { padding: 0.4rem 0.8rem; border: 1px solid #fecaca; text-align: left; }
.appendix .pmid { font-family: monospace; font-weight: 600; }
.evidence-legend { margin-top: 2rem; border-collapse: collapse; }
.evidence-legend th, .evidence-legend td { padding: 0.5rem 1rem; border: 1px solid #cbd5e1; }

跨疾病移植清单(下次"呼吸科 ICU 真菌"项目如何用)

下次启动新疾病项目(例:呼吸科 ICU 侵袭性曲霉),完整复制以下流程,无需重新设计:

1. 目录结构沿用

output/呼吸科ICU真菌/ ├── evidence/ ← 沿用,每个 PMID 一个 .md,头部 frontmatter 必有 evidence_level ├── 报告_主体.html └── 报告_附录C.html ← 由本 skill 生成

1. frontmatter 字段完全沿用(pmid / first_author / year / study_type / evidence_level / key_finding / applies_to)— 不要改字段名,改了下游脚本就坏。
2. 5 个分组桶沿用(🟢A / 🔵B / 🟡C / ⚪参考 / 🟠待标注)— 不要新增"D 级",会破坏读者已建立的色码心智模型。
3. 校验脚本直接复用 Step 1 + Step 5 的 bash/powershell 命令,只改 evidence 路径与附录 HTML 文件名。
4. 完整模板直接复制,只把 appendix-c 的标题、#sec-3-2 锚点、PMID 列表替换为新疾病数据。
5. 不要"省略 evidence_level 字段先交付,后面再补" — 这是血液科 v2.5 失败的最直接根因。
6. 不要"附录 C 只列代表性 11 条,完整 44 条放后面" — 没有"代表性",必须全列。

失败模式速查(至少 5 条)

| # | 失败模式 | 真实案例 | 预防措施 | |---|---|---|---| | 1 | 凭印象手写附录 C 致大面积缺失 | 血液科 IFI v2.5:evidence/ 44 条,附录 C 仅 11 条,缺失 75% | 强制 Step 5 双向 diff,差集非空禁止交付 | | 2 | 附录 C 列出 evidence 中没有的 PMID(幻觉) | 早期草稿曾出现 PMID 数字记错位,grep evidence/ 找不到 | Rule 2 反向校验,补 evidence/{PMID}.md 或删除该条 | | 3 | 缺等级分组,PMID 平铺成长列表 | 读者无法快速判断"哪些是 A 级强证据" | Rule 3 强制 5 桶分组 + 色码 | | 4 | 缺第一作者+年份,只给 PMID | 读者无法快速搜索 / 引用 / 与同行讨论 | Rule 4 四要素必含,缺一项即阻塞 | | 5 | 不同疾病版本附录 C 不一致(混入旧文献) | 跨疾病移植时,把血液科 PMID 留在呼吸科附录中 | 跨疾病每次重跑 Step 1,基于当前疾病 evidence/ 重新生成 | | 6 | "代表性引用"借口 | 作者说"挑 11 条最重要的,完整在 evidence 文件夹" | 报告读者不会去翻 evidence/,附录就是唯一入口,必须全列 | | 7 | evidence_level 字段缺失/为空 | frontmatter 没填 → 默认进 🟠 待标注桶 | 交付前 🟠 桶必须清零 | | 8 | applies_to 字段缺失致读者无法回溯报告章节 | PMID 列出来但不知道用在哪个图/段 | Rule 4 强制四要素之一,锚点链接到报告对应章节 | | 9 | 占位式补录(zombie PMIDs)· v1.1 新增 | 血液科 v2.5.1 附录 C C.5/C.6 共 15 条 PMID 仅列裸数字,无标题/作者/年份/期刊/n;用户反馈"仍处于不明确状态" | Rule 5 强制每条 PMID 必含 5 项元数据,缺一即阻塞;Step 6 用 PubMed 拉元数据补齐 | | 10 | 关键词污染(主题无关 PMID)· v1.1 新增 | 血液科 v2.5.2 发现 4 条无关 PMID 混入:10793555(老年社会医学)/ 37293262(茶尺蠖昆虫学)/ 39034762(钙钛矿太阳能电池)/ 39039587(脊柱外科麻醉);根因 v2.4 evidence 采集模糊匹配 | Rule 6 强制 PMID 主题相关性核查,Step 7 用关键词矩阵 fuzzy match;Step 8 透明披露删除条目 | | 11 | 内外冲突的"保留 + 警告"妥协(zombie warnings)· v1.2 新增 | 血液科 v2.5.3 发现 3 条 evidence/ 标注与 PubMed 真实文献直接冲突:37293262 evidence 标 DLBCL PJP 病例 / PubMed 实为茶尺蠖昆虫学;39034762 evidence 标中华血液学杂志推断 / PubMed 实为太阳能电池;39039587 evidence 标中华血液学杂志推断 / PubMed 实为脊柱麻醉。v2.5.2 错误处理为"保留在附录 C + 加 ⚠️ 警告框",读者扫描时易误以为是真文献 | Rule 7 数据源信任优先级链(PubMed > 期刊官网 > NMPA > evidence 笔记 > LLM),冲突时信 PubMed 删 evidence,禁止"保留 + 警告";Step 9 PMID 内外冲突核查,evidence/ 留 TODO 注释,附录 C "类型 B 内外冲突"子表格透明披露 |

根因(LLM 心智模型缺陷):LLM 不知道 evidence/ vs PubMed 该信谁时,默认选择"都展示 + 警告"的折中。v1.2 显式建立数据源信任优先级链消除该折中倾向 — PubMed 是 PMID 的物理映射,evidence 只是项目笔记可错。

验收清单(交付前自检)

交付前逐项打钩,全打钩才能发版:

• ] grep -roh "PMID:[0-9]\+" evidence/ | sort -u | wc -l 数量已记录
• ] grep -oh "PMID:[0-9]\+" 报告_附录C.html | sort -u | wc -l 数量已记录
• ] 两个数量完全相等
• ] diff 命令输出为空(双向零差集)
• ] 附录 C 按 5 个等级桶分组(🟢A / 🔵B / 🟡C / ⚪参考 / 🟠待标注)
• ] 🟠 待标注桶为空(N=0)
• ] 每条 PMID 含四要素:第一作者+年份 / 研究类型 / 核心数据 / 应用领域
• ] 每条 PMID 的 "应用领域" 链接到报告对应章节锚点(#sec-3-2 等)
• ] 证据等级说明表已附在附录 C 末尾
• ] 跨疾病移植场景:确认 evidence/ 不含其他疾病的 PMID(纯净校验)
• ] 报告页脚标注"附录 C 最后校验时间:YYYY-MM-DD"

v1.1 新增验收项

• ] 每条 PMID 含 5 项元数据(标题 / 第一作者+年份 / 期刊名 / n 或 study type / 核心数据一行),无裸数字
• ] 每条 PMID 标题含项目领域关键词(对照 Rule 6 关键词矩阵 fuzzy match);未命中条目已从 evidence/ 删除并在删除披露区列出
• ] 透明披露区已列出所有删除条目 + 根因(关键词污染 / 幻觉 / 重复),并记录检测时间
• ] Step 6 已对所有 PMID 执行 PubMed 元数据拉取(WebFetch / medical-research / pubmed-search)
• ] Step 7 主题相关性核查日志已留档(便于审计)

v1.2 新增验收项

• ] 附录 C 中无任何"保留 + ⚠️ 警告"的 zombie 文献 — 检测到 evidence/ vs PubMed 内外冲突的条目,应删除而非保留(Iron Law 7)
• ] evidence/ 中所有删除的冲突条目都有 HTML TODO 注释留痕(<!-- TODO v2.5.3: PMID:XXX 与 PubMed 实际文献冲突,需重找正确 PMID -->)
• ] Step 9 PMID 内外冲突核查已对每条 PMID 执行(evidence/ 标注 vs PubMed 真实标题 fuzzy match)
• ] 附录 C 删除披露区块按两种类型分列子表格:类型 A · 关键词污染(Step 8 / v1.1)+ 类型 B · 内外冲突(Step 9 / v1.2)
• ] 数据源信任优先级链已落实:遇 PubMed vs evidence 冲突时,信 PubMed,删 evidence/

版本历史

| 版本 | 日期 | 变更 | |---|---|---| | v1.0 | 2026-04-25 | 初始版本。基于血液科 IFI v2.5 交付时发现的"附录 C 缺失 75% PMID"失败模式标准化 | | v1.1 | 2026-04-25 | 基于血液科 v2.5.2 复盘新增:Iron Law 5(每条 PMID 必含 5 项元数据,零裸数字,堵 v2.5.1 C.5/C.6 共 15 条占位 PMID 漏洞)+ Iron Law 6(PMID 主题相关性核查 + 透明披露,堵 v2.5.2 发现的 4 条主题无关 PMID 关键词污染漏洞)。配套 SOP Step 6/7/8(PubMed 元数据拉取 / 主题核查 / 透明删除披露)、失败模式 #9/#10、5 项验收清单升级、level-removed CSS 区块样式 | | v1.2 | 2026-04-25 | 基于血液科 v2.5.3 复盘新增:Iron Law 7(evidence/ 内部标注 vs PubMed 真实文献冲突时,信 PubMed 删 evidence,禁止"保留 + 警告"妥协),确立数据源信任优先级链(PubMed > 期刊官网 > NMPA > evidence 笔记 > LLM 推断),堵 v2.5.2 → v2.5.3 发现的 3 条 zombie warning 文献(37293262/39034762/39039587 evidence 标注与 PubMed 真实文献直接冲突)。配套 SOP Step 9(PMID 内外冲突核查)、失败模式 #11(zombie warnings)、5 项验收清单升级、附录 C 删除披露区按"类型 A 关键词污染 / 类型 B 内外冲突"双子表格分列 |

Skill Presented by:YongQi, SimonSu, RuiYu, YingJi