citation-audit

引文审核

在提交前审核引文、BibTeX 条目和 LaTeX 交叉引用。本技能用于检查提交前的正确性，而非广泛检索文献。

当论文已有草稿引文，且用户希望确认以下事项时，请使用本技能：

• TeX 中的每个 \cite{...} 键都存在于 BibTeX 中
• 每个 BibTeX 条目的语法都有效，且没有重复条目
• 每个 \ref{...}、\cref{...}、\eqref{...}、\autoref{...} 的目标都存在
• 每个 \label{...} 都是唯一的，并符合本地命名规范
• DOI、arXiv、OpenReview、URL、标题、作者、年份和会议信息与真实论文相符
• 附近正文中的引文主张确实得到所引文献的支持
• 参考文献格式已达到可提交状态

将本技能与 submit-paper 配合使用，完成更全面的投稿检查清单。当引文正确性问题应成为论文的阻塞风险或待办事项时，请与 research-project-memory 配合使用。

技能目录结构

<installed-skill-dir>/
├── SKILL.md
├── scripts/
│   └── audit_latex_refs.py
└── references/
    ├── citation-claim-audit.md
    ├── metadata-verification.md
    └── report-template.md

渐进式加载

• 始终运行 scripts/audit_latex_refs.py，以确定性地检查 TeX/BibTeX/交叉引用。
• 检查 DOI、arXiv、OpenReview、会议论文集或出版商元数据时，阅读 references/metadata-verification.md。
• 当用户询问引文是否支持论文中的主张，或需要进行完整的提交前审核时，阅读 references/citation-claim-audit.md。
• 使用 references/report-template.md 编写最终审核报告。

步骤 1 - 定位论文源文件

确定：

• 论文根目录
• 主 TeX 文件
• 所有包含的 TeX 文件
• 由 \bibliography{...} 或 \addbibresource{...} 引用的 BibTeX 文件
• 目标会议及投稿模式（如可明确判断）

可用的本地检查：

find . -maxdepth 4 -name "*.tex" -o -name "*.bib"
find . -maxdepth 3 -name "main.tex" -o -name "paper.tex"

如果用户提供了论文目录，请使用该目录。如果没有提供主文件，优先选择 main.tex，其次是 paper.tex，再其次是包含 \begin{document} 的 TeX 文件。

步骤 2 - 运行确定性本地审核

运行：

python3 <citation-audit-skill-dir>/scripts/audit_latex_refs.py --paper-dir "$PAPER_DIR" --main "$MAIN_TEX"

使用已安装技能脚本的绝对路径。不要假定安装路径特定于 Claude。

脚本会检查：

• 包含的 TeX 文件发现情况
• \cite、\citet、\citep、\citealp、\citeauthor、\citeyear、\textcite、\parencite 中的引文键
• BibTeX 键及基本语法
• 缺失的引文键
• 未使用的 BibTeX 条目
• 重复的 BibTeX 键
• 缺失的参考文献文件
• 重复标签
• 未定义的引用
• 未引用的标签
• 未解析的 LaTeX 占位符（例如 ??）和引文占位符（例如 [?]）

如果脚本报告了阻塞问题，请先修复或报告这些问题，再检查网络元数据。如果 TeX/BibTeX 关系图存在问题，元数据验证的价值会低得多。

步骤 3 - 对发现的问题分类

使用以下严重性模型：

• blocking：缺少已引用的键、BibTeX 键重复、未定义的引用、重复标签、BibTeX 结构无效、已引用文献的 DOI 无效
• important：元数据不匹配、会议或年份错误、可能存在重复条目、引文主张缺乏支持、引用了 arXiv 版本而应引用同行评审版本
• warning：未使用的 BibTeX 条目、未引用的标签、键命名不一致、缺少可选 DOI/URL
• note：格式清理、大小写、字段规范化、BibTeX 键重命名建议

除非目标会议或用户要求参考文献列表尽量精简，否则不要将未使用的 BibTeX 条目视为阻塞问题。

步骤 4 - 验证元数据

阅读 references/metadata-verification.md。

对每个已引用的键，验证可用的最佳标识符：

• 通过出版商、CrossRef 或 doi.org 验证 DOI
• 通过 arXiv 验证 arXiv ID
• 通过 OpenReview 验证 OpenReview URL 或论坛 ID
• 验证 NeurIPS、ICML、ICLR、ACL Anthology、CVF、ACM、IEEE、Springer 或 PMLR 的会议论文集 URL

检查：

• 标题
• 作者列表，或第一作者和作者人数
• 年份
• 会议或出版状态
• DOI/arXiv/OpenReview/会议论文集 URL
• 是否存在同行评审版本

无法验证元数据时，请明确标注，不要猜测。

步骤 5 - 审计引文主张

阅读 references/citation-claim-audit.md，了解完整指南。

对于每个引文上下文，判断正文要求引文支持什么内容：

• 背景事实
• 既有方法的存在
• 最相关的相关工作
• 实证结果
• 理论结果
• 数据集或基准
• 否定性主张或局限
• 比较或最先进水平的主张

然后检查被引论文是否确实支持这一用途。对于高风险主张，检查摘要、引言、方法／结果部分，必要时查看 PDF。

高风险上下文：

• “首个”“唯一”“最先进”“显著”“可证明”“保证”
• 关于论文结果或局限的主张
• 用于论证基线选择的引文
• 用于理论假设的引文
• 贡献要点或问题动机中的引文

不要悄悄改写科学主张。如果引文不支持某项主张，请提出以下其中一项建议：

• 替换引文
• 弱化主张
• 补充更具体的引文
• 将该主张移至相关工作
• 标记为需要作者确认

步骤 6 - 修复安全问题

可安全自动修复的问题：

• 在报告中补充缺失的 .bib 扩展名解析
• 仅在确认 BibTeX 条目确实完全相同时，删除明显重复的条目
• 规范标题中的大小写保护括号
• 在核实后补充缺失的 DOI／arXiv／URL 字段
• 修正 BibTeX 字段拼写
• 仅在所有 TeX 调用位置都一致更新时，重命名标签或引文键

切勿自动修复：

• 支持关系存在歧义的引文主张
• 未说明科学差异便用另一篇被引论文替换原论文
• 存在多个版本时的发表状态
• 来源对作者顺序存在分歧时的作者顺序

任何编辑都应尽可能缩小差异。

步骤 7 - 撰写审计报告

使用 references/report-template.md。

最终报告应包括：

• 检查过的文件
• 本地 TeX／BibTeX 图状态
• 元数据核验状态
• 引文主张支持状态
• 投稿前必须解决的阻塞问题
• 建议进行的非阻塞清理
• 需要作者判断的未决事项

如果用户要求保存报告但未指定路径，请使用：

docs/reports/citation_audit_YYYY-MM-DD.md

步骤 8 - 最终检查

完成前：

• 所有被引键都恰好解析为一个 BibTeX 条目
• 所有必需的 TeX 引用都恰好解析为一个标签
• 如果项目存在记忆文件，则将阻塞性引文／引用问题作为行动项记录

步骤 9 - 写回项目记忆

如果项目使用 research-project-memory，请更新：

• memory/risk-board.md：阻塞性或重要的引文、元数据、标签、引用或引文主张风险
• memory/action-board.md：针对缺失键、元数据更正、不受支持的主张或失效引用的具体修复措施
• memory/claim-board.md：因引文不支持而必须弱化的主张
• paper/.agent/paper-status.md：引文审计状态和待作者决定的事项

对确定性的 TeX／BibTeX 图检查结果使用 observed；对尚未完全核验的元数据或主张支持问题使用 needs-verification。

• 修复所有阻塞性元数据问题，或明确列出这些问题
• 审计所有高风险引文主张
• 不得隐瞒尚未解决的引文正确性问题
• 最终答复应区分确定性的脚本检查结果与网络／语义核验结果