# Literature Evidence Matcher

> Match manuscript claims against user-provided literature and produce a traceable claim-evidence table. Use when the user asks to add references, check whether PDFs support manuscript statements, find supporting or opposing evidence from a literature folder, distinguish strong support from background support, or create a 论点-证据匹配 report for an academic draft.

- Skill: `adoresever/literature-evidence-matcher` (Agent Skill)
- Install (CLI): `npx skillmds@latest add adoresever/literature-evidence-matcher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/adoresever/literature-evidence-matcher/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: adoresever (https://skillmd.com/u/adoresever)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/adoresever/literature-evidence-matcher

---


# 文献证据匹配

这个技能的目标不是“找几篇看起来相关的文献”，而是判断用户论文中的具体论点，是否能被用户提供的文献原文支撑。

默认只基于用户提供的文献、笔记、PDF 提取文本或明确允许查询的数据库工作。不能凭记忆编造参考文献。

## 适用场景

当用户想做以下事情时使用：

- 给论文段落补参考文献
- 检查已有引用是否真的支撑正文
- 从文献文件夹中找支持、反驳或背景支撑某个论点的证据
- 判断哪些句子证据不足
- 为综述、引言、相关工作、讨论部分建立“论点-文献-证据”表

## 输入

优先使用这些材料：

- 论文草稿、章节草稿、摘要、引言或提纲
- PDF 文献、文献提取文本、阅读笔记
- 已有参考文献列表
- 项目说明或目标期刊要求

如果没有文献材料，不能执行证据匹配。应提示用户补充 PDF、笔记、参考文献列表或允许联网检索。

## PDF 和 Word 处理

如果输入是 Word 或 PDF，先生成中间文本，原始文件不覆盖。

推荐输出到：

```text
04_中间文本/
```

建议工具：

- Word：用可用的文档解析工具提取段落，保留段落编号。
- 可复制文字的 PDF：优先用 `pdftotext` 或等价工具提取正文。
- 扫描版 PDF：如果没有文字识别能力，标记为无法可靠提取，不要猜内容。

中间文本命名示例：

```text
论文初稿.extracted.md
paper1.extracted.txt
```

提取文本要尽量保留标题、章节、页码、段落编号、行号或其他可追溯线索。

## 本地工具调用

执行时要把“文件读取”和“智能判断”分开：先用确定性工具把 Word 和 PDF 转成中间文本，再做论点和证据匹配。

### 1. 扫描材料

```bash
find . -maxdepth 3 -type f | sort
```

单独查找 PDF：

```bash
find . -maxdepth 3 -type f -iname '*.pdf' | sort
```

### 2. 提取 PDF

优先检查是否有 `pdftotext`：

```bash
which pdftotext
```

可复制文字的 PDF，用：

```bash
pdftotext -layout 输入.pdf 04_中间文本/输入.extracted.txt
```

如果输出几乎为空、乱码严重或全是图片，标记为“PDF 提取失败或疑似扫描版”，不要猜论文内容。

### 3. 提取 Word

如果没有专用 Word 工具，可用脚本读取 `.docx` 内部 XML，按段落输出到：

```text
04_中间文本/论文初稿.extracted.md
```

输出格式建议：

```text
【段落 001】……
【段落 002】……
```

这样后续报告可以引用段落位置。

### 4. 检索关键词

对中间文本用全文搜索工具定位证据。优先用：

```bash
rg -n "知识图谱|实体|关系|抽取|语义|图神经网络|自监督|推荐" 04_中间文本/
```

关键词应根据论文主题调整。搜索结果只能作为候选证据，最终仍要读上下文判断是否支撑。

### 5. 抽取上下文

找到候选行后，读取上下文：

```bash
sed -n '起始行,结束行p' 04_中间文本/某篇文献.extracted.txt
```

报告中的证据必须来自这些上下文，而不是只来自关键词命中。

### 6. 写入报告

将最终报告写入：

```text
05_输出报告/文献证据匹配报告.md
```

如果是多轮测试，可加后缀：

```text
05_输出报告/文献证据匹配报告_第一轮.md
```

## 工作流程

### 1. 抽取论文论点

从草稿中抽取需要文献支撑的句子或短段。

优先抽取：

- 背景判断
- 领域趋势
- 方法优劣
- 已有研究不足
- 技术定义
- 与前人工作的比较
- 需要引用支撑的定量陈述

跳过：

- 作者自己的研究问题
- 论文结构说明
- 明显的章节标题
- 没有实质论点的连接句

给每个论点分配编号，例如 `C001`、`C002`。

### 2. 检索文献证据

在用户提供的文献文本中查找证据。

每条候选证据必须包含：

- 文献名称
- 原文片段或精确转述
- 位置线索，例如页码、章节、提取文本行号或段落
- 与论文论点的关系

如果只能找到主题相关内容，但没有直接支撑，必须标为背景支撑或支撑不足。

### 3. 判断支撑强度

使用以下标签：

- `强支撑`：文献原文直接支持该论点，范围和语气基本一致。
- `部分支撑`：文献支持论点的一部分，但不能覆盖全部表述。
- `背景支撑`：文献能作为背景材料，但不能直接证明该句。
- `反驳`：文献与该论点相冲突或提出相反证据。
- `支撑不足`：文献主题相关，但原文不能支撑该论点。
- `无法确认`：PDF 提取失败、证据位置不清、材料不足或需要作者确认。
- `不能支撑`：该论点属于作者实验结果或作者原创发现，不能用外部文献代替。

### 4. 输出报告

默认输出到：

```text
05_输出报告/文献证据匹配报告.md
```

报告应包含：

```text
# 文献证据匹配报告

## 输入材料

## 总体结论

## 论点-证据匹配表
| 论文位置 | 论文论点 | 可用文献证据 | 支撑强度 | 建议 |
|---|---|---|---|---|

## 不能直接引用的内容

## 需要补充的文献类型

## 下一步建议
```

## 关键判断规则

- 不能因为文献标题相关就建议引用。
- 不能把综述中的泛泛背景，当成某个具体实验结论的直接支撑。
- 作者自己的实验结果不能靠外部文献支撑。
- 导师意见、会议纪要、审稿意见不能作为文献证据。
- 如果原文只能支持较弱说法，应建议降低正文表述强度。
- 如果文献和论文主题不是同一场景，要标为类比或背景支撑。

## 视频演示重点

这个技能最适合展示文章方法的实际价值：人工智能不是硬塞引用，而是帮作者判断“这篇文献到底能不能支撑这句话”。