BibTeX Hygiene 是一个面向学术写作的参考文献清理与校验技能,核心目标是在投稿前让 .bib 文件保持正确、一致和可编译。它强调干净的参考文献是正确性问题而非表面美化:重复条目会虚增引用计数,缺失字段会在 PDF 中显示为“?”,小写缩写会被审稿人视为不严谨,错误的 DOI 会把读者引向别人的论文。
用途 该技能用于清理、去重和校验 BibTeX/BibLaTeX 参考文献。当 .bib 文件出现重复键或重复文献、缺失字段、DOI 格式错误、年份或作者格式错误、标题大小写问题、预印本未替换为正式发表版本等情况时,可使用本技能进行处理。
主要能力 技能捆绑了一个 linter 脚本,可对稿件使用的每个 .bib 文件运行检查: python scripts/bib_lint.py references.bib python scripts/bib_lint.py references.bib --json > bib-report.json 退出码含义:0 表示干净,1 表示发现问题,2 表示输入无法解析。
检查项按优先级分为错误和警告。错误包括:duplicate-key(两个条目共享同一键,LaTeX 会静默使用第一个,需重命名并更新 \cite{} 调用,可用 grep -rn "\cite.*{oldkey" *.tex 查找);duplicate-work(同一篇论文出现在两个键下,DOI 或标题相同,保留一个并重新指向引用);missing-field(从出版商页面或 Crossref 补充字段,不要凭记忆填写);doi-format / year-format / author-format(依据权威记录修正)。警告包括:title-case(将缩写、专有名词和化学/基因符号用花括号包裹,如 title = {{BERT}: Pre-training of Deep Bidirectional Transformers}、{Bayesian}、{CRISPR}-{Cas9}、{\textit{E. coli}},只包裹单词而非整个标题,整标题加括号会破坏句子大小写样式);doi-url(存储裸 DOI,如 10.1038/s41586-021-03819-2,样式会自行添加解析器);author-others(作者少于三人时应列出全部作者)。
技能还建议解析预印本:对每条预印本记录,检查是否存在同行评审版本(可在 Crossref/OpenAlex 搜索标题或使用 citation-verification 技能),引用已发表版本,并在允许的情况下将 arXiv ID 保留在 eprint 字段。
使用方式 可选执行规范化,仅做安全的机械修复(裸 DOI、-- 页码范围、一致的字段顺序): python scripts/bib_lint.py references.bib --fix references.clean.bib diff references.bib references.clean.bib 在替换前先审查差异。
最后验证构建:编译并读取日志,grep -i "warning.*citation|undefined" main.log,确保每个 \cite 都能解析,没有条目渲染为 ??。
约定 键名:authorYEARword,小写 ASCII,例如 vaswani2017attention,绝不为不同作品复用同一键。作者:Last, First 和 Last, First,团体作者用双花括号 {{World Health Organization}}。期刊/会议名称:整个文件中对同一 venue 使用一种拼写(按期刊样式选择全称或 ISO4 缩写)。会议论文:使用 @inproceedings 加 booktitle,而非 @article 加 journal。软件/数据:使用 @software / @dataset(BibLaTeX)或 @misc 加 version、doi/url、year。Unicode:使用 biber 时保持 UTF-8;经典 BibTeX 需转义重音符号({"u})。URL 与 DOI:若存在 DOI 则去掉出版商 URL;仅对纯网络来源保留 url(并加 urldate)。
反模式 不要凭记忆或让 LLM 生成 BibTeX,应始终从出版商、Crossref(https://api.crossref.org/works/{doi}/transform/application/x-bibtex)、DBLP 或参考文献管理器导出。不要盲目复制 Google Scholar 的 BibTeX,它常缺少 DOI、使用错误的条目类型并破坏大小写。不要用双花括号包裹整个标题来“修复”大小写。不要在带 DOI 的文章上保留 note = {Accessed ...}。
相关技能 citation-verification 检查每个条目是否匹配真实记录(可发现幻觉引用);reference-manager-interop 在 Zotero/Mendeley/EndNote 导出、RIS、CSL-JSON 和 BibTeX 之间转换;citation-management 从文献数据库搜索和检索参考文献。
适用场景与限制 适用于学术论文投稿前的参考文献清理、去重和校验,尤其适合使用 LaTeX/BibTeX/BibLaTeX 的写作流程。限制方面,资料未提供关于收费、价格、平台支持范围或具体效果保证的信息。