SuperAPI AI 工具集

citation-verifier

写作与研究

查看项目

更新于 10-16 01:25

技能介绍

用途:当已有 papers/paper_notes.jsonl,需要为 prose/LaTeX 准备可追溯引用时使用该技能,生成 citations/ref.bib 并确保每个条目在 citations/verified.jsonl 有可追溯的核验记录。触发词包括 citation、BibTeX、ref.bib、verified.jsonl、references、引用、参考文献。

主要能力:从论文笔记中收集 bibkey、title、url、year、authors 生成/刷新 ref.bib;存在 arxiv_id / primary_category 时优先采用 arXiv 风格字段(eprint、archivePrefix、primaryClass);为每条 BibTeX 条目写一条核验记录,至少含 bibkey、title、url、date。脚本会清理标题中多余或不配对的 {},转义 & % $ # _ 等 LaTeX 特殊字符,并将 X^N 或 X$^N$ 形式改写为 X\textsuperscript{N};url 字段保留原始 URL,@misc 使用 howpublished=\url{...}。

使用方式:快速开始可运行 uv run python .codex/skills/citation-verifier/scripts/run.py --help。离线生成:uv run python .codex/skills/citation-verifier/scripts/run.py --workspace <workspace> --offline;可加 --verification-note <text> 写入 notes。之后联网时运行 --verify-only 核验已有记录,且不重写 BibTeX。

verification_status 取值:offline_generated(未联网核验,待后续核验)、verified_online(URL/标题核验成功)、verify_failed(核验失败,如网络错误或标题不匹配)、needs_manual_verification(字段缺失或含糊,如空 url/title)。质量要求:每条 BibTeX 条目都要有对应 verified.jsonl 记录,且核验记录不得缺少 url/date/title。

限制:离线模式记录并非真正核验,应视为待人工或联网核验的待办。若 papers/paper_notes.jsonl 缺少 bibkey/url,ref.bib 会缺条目或核验记录出现空 url/title,需先补齐稳定 bibkey 与规范 url 后重跑。除上述命令与状态外,其余平台或收费信息暂未提供。