对已有学术论文(LaTeX .tex+.bib 或 Word .docx)中已经存在的参考
文献做只读审计,覆盖两个维度:
- 真实性核查:每条参考文献条目本身的标题/作者/年份/期刊会议/出版社 等字段是否准确,是否张冠李戴到另一篇同名或相似的文献——通过 OpenAlex 和 Semantic Scholar 检索比对字段,再用 WebSearch/Tavily 独立确认文献 真实存在。
- 内容匹配核查:正文每一处引用点的论断,是否真的被所引用文献的摘要 内容支持,而不只是话题相关或标题看起来像。
最终产出一份 Markdown 审计报告。本技能全程只读,不会修改论文原文,
不会修改 .bib 文件。
适用场景:
- 怀疑论文里有引用张冠李戴(标题相似但引错了另一篇文献)。
- 想核实引用是否真的支持了对应的论断,而非凑数或蹭话题。
- 论文投稿/答辩前,想对已有引用做一次全面审计。
不适用场景(应使用姊妹技能 add-ref):
- 想找出正文里缺引用的地方并补充新引用——那是新增引用,不是审计已有
引用,请用
add-ref。
推荐用 skills CLI 一键安装(个人级, 对所有项目生效):
npx skills add helloxAI/check-cite@check-ref -g -y也可以直接给 Claude Code 下指令,让它代为安装:
安装这个 skill:https://github.com/helloxAI/check-cite.git
Claude 会自动完成:克隆该仓库到临时目录 → 把 skills/check-ref/ 目录复制到
~/.claude/skills/check-ref/(个人级,对所有项目生效)→ 清理临时克隆文件。
安装完成后新开一个对话即可使用。
或者自己手动执行(效果相同):
git clone https://github.com/helloxAI/check-cite.git /tmp/check-cite
cp -r /tmp/check-cite/skills/check-ref ~/.claude/skills/check-ref在 Claude Code 中,于论文所在项目目录下直接说明需求即可触发,例如:
帮我检查一下这篇论文的参考文献是否可靠,有没有引用张冠李戴的情况。
或显式调用:
/check-ref
首次运行时会依次询问/提示两件事(之后的运行会记住选择,不会重复打扰):
- Tavily MCP 检测:告知本次运行是否检测到 Tavily MCP(已连接会优先用它 做网页核实,未连接则退回内置 WebSearch,同时给出安装指引)。
- API Key 询问:是否要提供 OpenAlex / Semantic Scholar 的 API Key
(用于提升检索限流上限)。不提供也能正常工作,只是限流阈值更低。
选择会保存在
scripts/api_keys.local.json(不会被提交到 git),以后 不再重复询问。
运行过程中会:
- 完整读一遍全文,解析全部
.bib条目(或 Word 参考文献列表)以及正文 全部引用点,逐条/逐处处理,不抽样、不跳过。 - 对每一条参考文献,用
scripts/search_paper.py检索权威记录并比对关键 字段(逐条串行,避免触发限流),再用 WebSearch 独立确认真实存在—— 两项都通过才算这条通过。 - 对每一处引用点,复用已获取的摘要判断论断是否被实质支持,判"有疑问" 的会归类疑点类型(摘要不支持/话题层面假阳性/找不到摘要/数字或方法 归属对不上)。
- 一份 Markdown 审计报告,默认写入论文同目录下的
check-ref-report.md(若已存在会询问是覆盖还是改用带时间戳的文件名)。 - 报告内容包含:
- 总体统计摘要(两个维度各自的总数/通过数/不通过或有疑问数)。
- 维度一:通过表(含字段差异备注)+ 不通过表(含不一致字段、
.bib原值、核实到的正确值、核查方式)。 - 维度二:匹配通过表 + 有疑问表(含疑点类型)。
- 结论与建议:明确说明未对论文原文或
.bib文件做任何修改。
- 若用户要求"只在对话里说,不用写文件",则只在回复中给出报告内容。
- 需要能访问
api.openalex.org和api.semanticscholar.org(无 API Key 也可访问,只是限流阈值更低)。 - 需要 WebSearch 工具,或已连接的 Tavily MCP,用于对每一条参考文献做 真实性独立确认。
- LaTeX 论文需要
.tex源文件及其对应的.bib文件;Word 论文需要.docx文件。 - 无需 git 工作区检查(本技能全程只读,唯一写入的文件是审计报告本身,
以及 Phase 0 的
scripts/api_keys.local.json配置元信息)。
- skills/check-ref/SKILL.md:执行清单(每次运行对照)。
- skills/check-ref/reference.md:完整规则细节(首次运行建议先读)。
skills/check-ref/scripts/search_paper.py:OpenAlex / Semantic Scholar 检索脚本。skills/check-ref/scripts/api_keys.local.json:本地 API Key 配置(已加入.gitignore, 不会被提交)。