Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

check-ref(核查已有论文的参考文献)

功能简介

对已有学术论文(LaTeX .tex+.bib 或 Word .docx)中已经存在的参考 文献做只读审计,覆盖两个维度:

  1. 真实性核查:每条参考文献条目本身的标题/作者/年份/期刊会议/出版社 等字段是否准确,是否张冠李戴到另一篇同名或相似的文献——通过 OpenAlex 和 Semantic Scholar 检索比对字段,再用 WebSearch/Tavily 独立确认文献 真实存在。
  2. 内容匹配核查:正文每一处引用点的论断,是否真的被所引用文献的摘要 内容支持,而不只是话题相关或标题看起来像。

最终产出一份 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

首次运行时会依次询问/提示两件事(之后的运行会记住选择,不会重复打扰):

  1. Tavily MCP 检测:告知本次运行是否检测到 Tavily MCP(已连接会优先用它 做网页核实,未连接则退回内置 WebSearch,同时给出安装指引)。
  2. 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.orgapi.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, 不会被提交)。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages