Evidence Appendix Sync

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 中实际引用但附录未列 → 读者无法追溯。

# 校验脚本(必须返回空)
diff  反例:附录 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 **历史复现证据(血液科 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
>   
>   ```
> - **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 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 个分组桶整理:

# 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:

{
  "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 ``。

Step 5 · 双向数量校验

# 必须返回完全一致的差集为空
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 (标题) · 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:

# 示例:血液科 IFI 项目核查
for pmid in $(cat /tmp/evidence_pmids.txt); do
  TITLE=$(curl -s "https://pubmed.ncbi.nlm.nih.gov/${pmid#PMID:}/" | \
          grep -oP '\K[^
  ⚠️ 已删除条目透明披露(v1.1 引入,共 4 条) ·
    因主题无关 / 关键词污染 / 重复幻觉,从 evidence/ 与附录 C 同步删除
  
  
    
      已删 PMID实际主题删除原因检测时间
    
    
      
        PMID:10793555
        日本老年社会医学(2000)
        关键词污染 — 与血液科 IFI 主题完全无关
        2026-04-25
      
      
        PMID:37293262
        茶尺蠖昆虫学
        关键词污染 — 模糊匹配混入
        2026-04-25
      
      
        PMID:39034762
        钙钛矿太阳能电池
        关键词污染 — PubMed 邻近号段误抓
        2026-04-25
      
      
        PMID:39039587
        脊柱外科麻醉
        关键词污染 — 非血液科文献
        2026-04-25
      
    
  
  
    根因分析:v2.4 evidence 采集 sub-agent 关键词搜索时模糊匹配混入。
    v1.1 起强制 Iron Law 6(主题相关性核查)防止再发生。
  

重要:删除披露区块必须保留至所有后续版本(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 真实文献可能完全是另一篇(例:茶尺蠖昆虫学)。这种"内外冲突"必须独立核查。

执行流程:

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

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

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

---

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

  附录 C · 参考文献清单(共 44 条)
  PMID 与 evidence/ 文件夹双向同步 · 最后校验:2026-04-25

  
  
    🟢 A 级证据(指南 / Meta 分析 / Cochrane) · N 条
    
      
        PMID:38381437 · Maertens J, 2024 ·
        Phase III RCT ·
        泊沙康唑 vs 氟康唑预防 IFD 率 2.3% vs 8% (HR=0.28) ·
        用于 §3.2 高危预防策略
      
      
    
  

  
  
    🔵 B 级证据(RCT / 大样本前瞻队列) · N 条
    
      
    
  

  
  
    🟡 C 级证据(回顾性 / 单中心 / 病例系列) · N 条
    
      
    
  

  
  
    ⚪ 参考性资料(综述 / 述评 / 流行病学背景) · N 条
    
      
    
  

  
  
    🟠 待标注(交付前清零) · 0 条
    
      
    
  

  
  
    
      等级含义典型来源
    
    
      🟢 A最强证据系统综述 / Meta / Cochrane / 一线指南
      🔵 B较强证据多中心 RCT / 大样本前瞻队列
      🟡 C中等证据回顾性研究 / 单中心 / 病例系列
      ⚪ 参考背景参考综述 / 述评 / 流行病学统计
      🟠 待定评级未完成交付前必须清零
    
  

配套 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 | evidencelevel 字段缺失/为空 | frontmatter 没填 → 默认进 🟠 待标注桶 | 交付前 🟠 桶必须清零 | | 8 | appliesto 字段缺失致读者无法回溯报告章节 | 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 注释留痕(``)
• [ ] Step 9 PMID 内外冲突核查已对每条 PMID 执行(evidence/ 标注 vs PubMed 真实标题 fuzzy match)
• [ ] 附录 C 删除披露区块按两种类型分列子表格:类型 A · 关键词污染(Step 8 / v1.1)+ 类型 B · 内外冲突(Step 9 / v1.2)
• [ ] 数据源信任优先级链已落实:遇 PubMed vs evidence 冲突时,信 PubMed,

…

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: EthanYoQ
• Source: EthanYoQ/Skill-hub
• License: MIT

Install and usage instructions live in the source repository linked above.