🧪 Skills
ieee-reference-manager
IEEE Trans 论文参考文献全流程管理助手。负责参考文献的格式校验、引用审查、BibTeX 条目修复、期刊名标准化、DOI/元数据在线验证、Early Access 处理、作
v1.0.0
Description
name: ieee-reference-manager description: IEEE Trans 论文参考文献全流程管理助手。负责参考文献的格式校验、引用审查、BibTeX 条目修复、期刊名标准化、DOI/元数据在线验证、Early Access 处理、作者数量合规、重复条目检测等。当用户需要"检查参考文献"、"修复引用格式"、"验证 DOI"、"整理 bib 文件"、"参考文献审查"时触发。 allowed-tools: Read, Edit, Write, Bash, Glob, Grep, WebSearch, WebFetch, Agent model: opus
IEEE Trans 论文参考文献管理助手
核心能力
1. BibTeX 文件审查与修复
- 检测重复条目(相同 DOI / 相似标题 / 重复 key)
- 检测缺失必要字段(author, title, year, journal/booktitle, pages, volume, number)
- Early Access 文章识别与格式修正(删除占位 pages,添加
note = {early access}) - 作者数量合规检查(IEEE 规范:≤6 位全列,≥7 位用 et al.)
- BSTcontrol 配置检查与建议
- 清理未引用的冗余条目
2. 引用格式审查
- 连续
\cite{}合并检查(如\cite{a}, \cite{b}→\cite{a, b}) - 引用键名与 .bib 文件交叉验证(检测 missing/undefined references)
- 检查是否有被引用但 .bib 中不存在的条目
- 检查 .bib 中存在但未被引用的条目
3. 期刊名标准化
- 检查 journal 字段是否使用 IEEE 标准宏(如
IEEE_J_WCOM、IEEE_J_VT) - 检测直接写全名或非标准缩写的条目
- 利用 IEEEabrv.bib / IEEEfull.bib 进行自动匹配和替换建议
- Conference 条目检查
booktitle是否完整
4. DOI 与元数据在线验证
- 通过 DOI 在线查询验证论文元数据(标题、作者、年份、期刊)
- 检测 DOI 与实际论文是否匹配
- 检测疑似错误的 DOI(格式不正确、无法解析)
- 验证论文标题是否存在明显拼写错误
5. 格式规范检查
@articlevs@inproceedings类型检查(期刊用 article,会议用 inproceedings)- Conference 条目是否有
booktitle(不应用journal) - 页码格式检查(应使用
--而非-) - 年份合理性检查
- 检查
copyright、langid等非必要字段(可建议清理) - 标题大小写保护检查(缩写词、专有名词是否用
{{}}包裹)
6. 扩展条目类型支持
@book/@incollection:书籍和章节(需 publisher + address)@techreport:技术报告(需 institution + number)@standard:技术标准(IEEE / 3GPP / ISO,需 organization + number)@electronic:在线资源和网页(需 url + year)@misc:arXiv 预印本、待发表论文、RFC、白皮书等@phdthesis/@mastersthesis:学位论文(需 school + address)@patent:专利(需 nationality + number)
工作流程
模式 A:全面审查(用户说"检查参考文献"、"审查 ref"、"review references")
步骤 1:文件定位
- 自动查找工作目录下的
.bib文件和主.tex文件 - 识别 IEEEabrv.bib / IEEEfull.bib(标准宏文件,不修改)
- 识别用户的 Ref.bib(待审查文件)
步骤 2:结构性检查
- 解析所有 .bib 条目,提取 key、类型、字段
- 检测重复条目(基于 DOI 精确匹配 + 标题模糊匹配)
- 检测缺失必要字段
- 检查条目类型是否正确(article/inproceedings)
步骤 3:引用交叉验证
- 从 main.tex 提取所有
\cite{...}引用键 - 与 .bib 文件条目交叉比对
- 报告:missing references(cited but not in bib)、unused entries(in bib but not cited)
步骤 4:格式检查
- 连续 \cite 合并检查
- 期刊名宏检查
- Early Access 识别
- 作者数量 + BSTcontrol 检查
- 页码格式检查
步骤 5:输出报告 以表格形式汇总所有问题,按严重程度排序:
- 严重(会导致编译错误或参考文献列表错误)
- 警告(格式不规范但不影响编译)
- 建议(可改可不改的优化项)
模式 B:DOI 验证(用户说"验证 DOI"、"verify references"、"检查论文真实性")
步骤 1:提取所有 .bib 条目的 DOI 步骤 2:逐条通过 WebSearch 或 DOI resolver 验证 步骤 3:比对返回的元数据与 .bib 中的 title/author/year 步骤 4:标记不匹配或无法解析的条目
模式 C:单条修复(用户指定某个条目或某个问题)
直接定位并修复,遵循学术写作工作流(先展示 Before/After,等确认后修改)。
模式 D:新增参考文献(用户提供论文信息,需要生成 BibTeX 条目)
步骤 1:根据用户提供的信息(DOI / 标题 / 作者)搜索论文 步骤 2:生成规范的 BibTeX 条目(使用 IEEE 宏、完整字段) 步骤 3:检查是否与现有条目重复 步骤 4:建议插入位置和引用键命名
核心规则
IEEE 参考文献格式规范
- 作者:BibTeX 中使用全名(
Last, First Middle),IEEEtran.bst 自动缩写为首字母 - 期刊名:必须使用 IEEE 标准宏(IEEEabrv.bib 中定义),不要硬编码全名或缩写
- 作者数量:
- ≤6 位:全部列出
- ≥7 位:列第 1 位 + et al.
- 通过 BSTcontrol 的
ctluse_forced_etal、ctlmax_names_forced_et_al、ctlnames_show_etal控制
- Early Access 文章:
- 删除
pages字段(pages = {1--1}是 IEEE Xplore 占位符) - 添加
note = {early access} - 保留
doi字段(唯一永久标识符) - 不需要
volume和number
- 删除
- 引用合并:相邻的
\cite{a}, \cite{b}应合并为\cite{a, b} - 条目类型:
- 期刊论文 →
@article(需要journal) - 会议论文 →
@inproceedings(需要booktitle,不用journal)
- 期刊论文 →
- 页码:使用双连字符
--(如pages = {100--110}) - DOI:标准 IEEEtran.bst 默认不显示 DOI,但保留
doi字段无害且有助于验证 - BSTcontrol:必须在 .bib 文件开头定义,且在 .tex 中用
\bstctlcite{IEEEexample:BSTcontrol}调用
命名约定
BibTeX key 推荐格式:首作者姓年份+关键词,如 zhao2019computation、li2025secrecy
常见错误清单
| 错误类型 | 示例 | 修复方法 |
|---|---|---|
| 重复条目 | 同一论文两个不同 key | 删除重复,统一引用 |
| \cite 未合并 | \cite{a}, \cite{b} |
→ \cite{a, b} |
| Early Access 保留占位页码 | pages = {1--1} |
删除 pages,加 note |
| Conference 用了 @article | @article + booktitle |
改为 @inproceedings |
| 期刊名硬编码 | journal = {IEEE Trans. Wireless Commun.} |
→ journal = IEEE_J_WCOM |
| 标题拼写错误 | "Computation Computational" | 核实原文实际标题 |
| 作者过多未截断 | 7+ 作者全列 | BSTcontrol 启用 et al. |
| 缺失必要字段 | 无 volume/number/pages | 通过 DOI 补全 |
辅助工具集成
项目中可能存在以下辅助脚本,如存在则优先利用:
analyze_bib.py
- 功能:解析 .bib 文件,检测重复、分析引用覆盖率
- 调用:
python analyze_bib.py - 输出:详细分析报告
nameTranslate.py
- 功能:将 .bib 中硬编码的期刊名替换为 IEEE 标准宏
- 调用:
python nameTranslate.py - 依赖:IEEEfull.bib 用于全名匹配
注意事项
- 不修改 IEEEabrv.bib 和 IEEEfull.bib——这些是 IEEE 官方标准宏文件
- 修改前必须展示 Before/After,等用户确认后再执行(遵循全局 CLAUDE.md 规则)
- DOI 验证时注意:部分新发表或 Early Access 文章可能尚未被搜索引擎索引
- 标题中的特殊格式(如
{{...}})是 BibTeX 的大小写保护,不要随意删除 - 搜索验证论文时,优先使用 DOI 查询,其次使用标题+作者搜索
- 不要自动删除未引用条目——用户可能正在写作中,留待确认
Reviews (0)
Sign in to write a review.
No reviews yet. Be the first to review!
Comments (0)
No comments yet. Be the first to share your thoughts!