SuperAPI AI 工具集

citation-faithfulness

写作与研究

查看项目

更新于 10-15 17:17

技能介绍

用途:当用户提供论文 PDF 并询问其文中引用是否忠实于被引来源时,逐条判断论文声称“根据 [X]……”“[X] 报告……”等处,X 原文是否真的支持该说法,识别歪曲、结论反转、错误归属、数字不符及来源从未提出的主张。

与 pdf-citation-verifier 的区别:本技能回答“被引来源是否真的支持该主张”,靠读 PDF + 联网检索 + 智能体判断,无需密钥;后者回答“参考文献是否存在”,需上传 PDF 至 AMiner 服务并配置 AMINER_API_KEY。若用户实际想做存在性/幻觉检查,应改用 pdf-citation-verifier。

判定标签(JSON/表格保留英文,向用户解释用其语言):SUPPORTED(来源明确表述了论文所归属的内容)、PARTIALLY_SUPPORTED(来源支持部分,但论文夸大、缩小或添加来源没有的限定)、NOT_SUPPORTED(来源涉及该主题但说法不同或相反,属真正误述)、NOT_IN_SOURCE(检索到的全文不含该事实/结果)、UNVERIFIABLE(无法检索到来源,或仅有摘要而主张针对摘要未覆盖的细节;这是“无法核查”而非“引用有误”)。每条判定附来源原文引证、用户语言的简短理由、retrieval_level(full_text/abstract_only/metadata_only/not_found)与 confidence。

使用方式:通过自然语言或 /citation-faithfulness 调用。运行前需确认用户提供了本地 .pdf 路径;环境须具备 Read、WebSearch、WebFetch,若无联网则只能给出 UNVERIFIABLE。流程为:读取 PDF(Read 工具每次最多 20 页,长文分段读取,需覆盖正文与参考文献表)→ 抽取主张—引用对 → 解析参考文献表并按被引作品去重 → 联网检索来源(arXiv 摘要页 https://arxiv.org/abs/<id>,需要正文时试 https://arxiv.org/html/<id> 或 ar5iv.org 镜像;否则检索标题+第一作者+年份并抓取最佳结果页)→ 逐对判定 → 汇总报告。可设参数 scope(all/specific-only/refs:1,12,23)、max-refs、output(默认 ./citation-faithfulness-<pdf-stem>.json,无论用户是否要求都会写入并在界面展示中告知路径)。若设置了 AMINER_API_KEY,可选用 GET https://datacenter.aminer.cn/gateway/open_platform/api/paper/search?title=...(header Authorization: ${AMINER_API_KEY}, X-Platform: openclaw)加速解析 DOI/摘要,该密钥可选、不得打印其值。

限制:开放式检索常只能拿到摘要而非被引论文全文(付费墙、闭源 PDF),因此仅摘要可得而主张针对正文细节时必须判 UNVERIFIABLE,绝不判 NOT_SUPPORTED;只有全文才能支撑 NOT_IN_SOURCE;只有来源确实说法不同且可引用时才能判 NOT_SUPPORTED;不得从仅有标题/元数据给出高置信度,不得编造引证。本技能可稳定捕捉摘要层面可查的错误,无法保证发现被埋藏在付费正文中的错误;用户本地 Zotero 库可提供全文但本技能按设计仅做联网检索。NOT_SUPPORTED / NOT_IN_SOURCE 应视为供人工复核的线索而非最终指控。对 40 条参考文献的论文全量核查约需 40 次以上联网检索,建议先用 scope 或 max-refs 限定范围。

文件构成:SKILL.md / SKILL.zh.md、commands/citation-faithfulness.md、references/rubric.md、references/output-schema.md;无脚本、无 requirements.txt。