| name | literature-evidence-matcher |
| description | 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. |
文献证据匹配
这个技能的目标不是“找几篇看起来相关的文献”，而是判断用户论文中的具体论点，是否能被用户提供的文献原文支撑。
默认只基于用户提供的文献、笔记、PDF 提取文本或明确允许查询的数据库工作。不能凭记忆编造参考文献。
适用场景
当用户想做以下事情时使用：
- 给论文段落补参考文献
- 检查已有引用是否真的支撑正文
- 从文献文件夹中找支持、反驳或背景支撑某个论点的证据
- 判断哪些句子证据不足
- 为综述、引言、相关工作、讨论部分建立“论点-文献-证据”表
输入
优先使用这些材料：
- 论文草稿、章节草稿、摘要、引言或提纲
- PDF 文献、文献提取文本、阅读笔记
- 已有参考文献列表
- 项目说明或目标期刊要求
如果没有文献材料，不能执行证据匹配。应提示用户补充 PDF、笔记、参考文献列表或允许联网检索。
PDF 和 Word 处理
如果输入是 Word 或 PDF，先生成中间文本，原始文件不覆盖。
推荐输出到：
04_中间文本/
建议工具：
- Word：用可用的文档解析工具提取段落，保留段落编号。
- 可复制文字的 PDF：优先用
pdftotext 或等价工具提取正文。
- 扫描版 PDF：如果没有文字识别能力，标记为无法可靠提取，不要猜内容。
中间文本命名示例：
论文初稿.extracted.md
paper1.extracted.txt
提取文本要尽量保留标题、章节、页码、段落编号、行号或其他可追溯线索。
本地工具调用
执行时要把“文件读取”和“智能判断”分开：先用确定性工具把 Word 和 PDF 转成中间文本，再做论点和证据匹配。
1. 扫描材料
find . -maxdepth 3 -type f | sort
单独查找 PDF：
find . -maxdepth 3 -type f -iname '*.pdf' | sort
2. 提取 PDF
优先检查是否有 pdftotext：
which pdftotext
可复制文字的 PDF，用：
pdftotext -layout 输入.pdf 04_中间文本/输入.extracted.txt
如果输出几乎为空、乱码严重或全是图片，标记为“PDF 提取失败或疑似扫描版”，不要猜论文内容。
3. 提取 Word
如果没有专用 Word 工具，可用脚本读取 .docx 内部 XML，按段落输出到：
04_中间文本/论文初稿.extracted.md
输出格式建议：
【段落 001】……
【段落 002】……
这样后续报告可以引用段落位置。
4. 检索关键词
对中间文本用全文搜索工具定位证据。优先用：
rg -n "知识图谱|实体|关系|抽取|语义|图神经网络|自监督|推荐" 04_中间文本/
关键词应根据论文主题调整。搜索结果只能作为候选证据，最终仍要读上下文判断是否支撑。
5. 抽取上下文
找到候选行后，读取上下文：
sed -n '起始行,结束行p' 04_中间文本/某篇文献.extracted.txt
报告中的证据必须来自这些上下文，而不是只来自关键词命中。
6. 写入报告
将最终报告写入：
05_输出报告/文献证据匹配报告.md
如果是多轮测试，可加后缀：
05_输出报告/文献证据匹配报告_第一轮.md
工作流程
1. 抽取论文论点
从草稿中抽取需要文献支撑的句子或短段。
优先抽取：
- 背景判断
- 领域趋势
- 方法优劣
- 已有研究不足
- 技术定义
- 与前人工作的比较
- 需要引用支撑的定量陈述
跳过：
- 作者自己的研究问题
- 论文结构说明
- 明显的章节标题
- 没有实质论点的连接句
给每个论点分配编号，例如 C001、C002。
2. 检索文献证据
在用户提供的文献文本中查找证据。
每条候选证据必须包含：
- 文献名称
- 原文片段或精确转述
- 位置线索，例如页码、章节、提取文本行号或段落
- 与论文论点的关系
如果只能找到主题相关内容，但没有直接支撑，必须标为背景支撑或支撑不足。
3. 判断支撑强度
使用以下标签：
强支撑：文献原文直接支持该论点，范围和语气基本一致。部分支撑：文献支持论点的一部分，但不能覆盖全部表述。背景支撑：文献能作为背景材料，但不能直接证明该句。反驳：文献与该论点相冲突或提出相反证据。支撑不足：文献主题相关，但原文不能支撑该论点。无法确认：PDF 提取失败、证据位置不清、材料不足或需要作者确认。不能支撑：该论点属于作者实验结果或作者原创发现，不能用外部文献代替。
4. 输出报告
默认输出到：
05_输出报告/文献证据匹配报告.md
报告应包含：
# 文献证据匹配报告
## 输入材料
## 总体结论
## 论点-证据匹配表
| 论文位置 | 论文论点 | 可用文献证据 | 支撑强度 | 建议 |
|---|---|---|---|---|
## 不能直接引用的内容
## 需要补充的文献类型
## 下一步建议
关键判断规则
- 不能因为文献标题相关就建议引用。
- 不能把综述中的泛泛背景，当成某个具体实验结论的直接支撑。
- 作者自己的实验结果不能靠外部文献支撑。
- 导师意见、会议纪要、审稿意见不能作为文献证据。
- 如果原文只能支持较弱说法，应建议降低正文表述强度。
- 如果文献和论文主题不是同一场景，要标为类比或背景支撑。
视频演示重点
这个技能最适合展示文章方法的实际价值：人工智能不是硬塞引用，而是帮作者判断“这篇文献到底能不能支撑这句话”。
