← Back to Skills Marketplace
zlhad

ieee-reference-manager

by Linghaoz · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
439
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ieee-reference-manager
Description
IEEE Trans 论文参考文献全流程管理助手。负责参考文献的格式校验、引用审查、BibTeX 条目修复、期刊名标准化、DOI/元数据在线验证、Early Access 处理、作者数量合规、重复条目检测等。当用户需要"检查参考文献"、"修复引用格式"、"验证 DOI"、"整理 bib 文件"、"参考文献审查"时触发。
README (SKILL.md)

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_WCOMIEEE_J_VT
  • 检测直接写全名或非标准缩写的条目
  • 利用 IEEEabrv.bib / IEEEfull.bib 进行自动匹配和替换建议
  • Conference 条目检查 booktitle 是否完整

4. DOI 与元数据在线验证

  • 通过 DOI 在线查询验证论文元数据(标题、作者、年份、期刊)
  • 检测 DOI 与实际论文是否匹配
  • 检测疑似错误的 DOI(格式不正确、无法解析)
  • 验证论文标题是否存在明显拼写错误

5. 格式规范检查

  • @article vs @inproceedings 类型检查(期刊用 article,会议用 inproceedings)
  • Conference 条目是否有 booktitle(不应用 journal
  • 页码格式检查(应使用 -- 而非 -
  • 年份合理性检查
  • 检查 copyrightlangid 等非必要字段(可建议清理)
  • 标题大小写保护检查(缩写词、专有名词是否用 {{}} 包裹)

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 参考文献格式规范

  1. 作者:BibTeX 中使用全名(Last, First Middle),IEEEtran.bst 自动缩写为首字母
  2. 期刊名:必须使用 IEEE 标准宏(IEEEabrv.bib 中定义),不要硬编码全名或缩写
  3. 作者数量
    • ≤6 位:全部列出
    • ≥7 位:列第 1 位 + et al.
    • 通过 BSTcontrol 的 ctluse_forced_etalctlmax_names_forced_et_alctlnames_show_etal 控制
  4. Early Access 文章
    • 删除 pages 字段(pages = {1--1} 是 IEEE Xplore 占位符)
    • 添加 note = {early access}
    • 保留 doi 字段(唯一永久标识符)
    • 不需要 volumenumber
  5. 引用合并:相邻的 \cite{a}, \cite{b} 应合并为 \cite{a, b}
  6. 条目类型
    • 期刊论文 → @article(需要 journal
    • 会议论文 → @inproceedings(需要 booktitle,不用 journal
  7. 页码:使用双连字符 --(如 pages = {100--110}
  8. DOI:标准 IEEEtran.bst 默认不显示 DOI,但保留 doi 字段无害且有助于验证
  9. BSTcontrol:必须在 .bib 文件开头定义,且在 .tex 中用 \bstctlcite{IEEEexample:BSTcontrol} 调用

命名约定

BibTeX key 推荐格式:首作者姓年份+关键词,如 zhao2019computationli2025secrecy

常见错误清单

错误类型 示例 修复方法
重复条目 同一论文两个不同 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 用于全名匹配

注意事项

  1. 不修改 IEEEabrv.bib 和 IEEEfull.bib——这些是 IEEE 官方标准宏文件
  2. 修改前必须展示 Before/After,等用户确认后再执行(遵循全局 CLAUDE.md 规则)
  3. DOI 验证时注意:部分新发表或 Early Access 文章可能尚未被搜索引擎索引
  4. 标题中的特殊格式(如 {{...}})是 BibTeX 的大小写保护,不要随意删除
  5. 搜索验证论文时,优先使用 DOI 查询,其次使用标题+作者搜索
  6. 不要自动删除未引用条目——用户可能正在写作中,留待确认
Usage Guidance
This skill appears to do what it says: check and fix IEEE-style BibTeX references and validate DOIs. Before installing or running it, consider: (1) Make a backup or run it on a copy of your .bib/.tex files so accidental edits can be undone. (2) Ensure Python and a shell are available if you expect it to run auxiliary scripts (SKILL.md references python commands) — the skill doesn't declare these binaries. (3) DOI/metadata checks use web queries (WebSearch/WebFetch) — titles/DOIs will be sent to external resolvers; avoid running it on highly sensitive, private bibliographic data unless you're comfortable with that. (4) The skill claims it will show Before/After and ask confirmation before writing — verify this behavior on first use. If you need stronger guarantees, run the analysis-only path (no automatic edits) or inspect suggested changes before accepting them.
Capability Analysis
Type: OpenClaw Skill Name: ieee-reference-manager Version: 1.0.0 The skill bundle provides a comprehensive assistant for IEEE reference management, including BibTeX repair, DOI validation, and citation merging. It is classified as suspicious because it utilizes high-risk capabilities—specifically shell access (Bash) for running analysis scripts and network access (WebSearch, WebFetch) for metadata verification—which, while plausibly needed for the stated purpose, meet the threshold for risky behavior under the provided guidelines. The instructions in SKILL.md and utility-scripts.md are well-aligned with academic workflows, and no evidence of intentional malice, data exfiltration, or prompt injection was found.
Capability Assessment
Purpose & Capability
The name/description (IEEE Trans reference manager) match the actual instructions: parsing .bib/.tex, DOI checks, journal-name normalization, duplicate detection, and optional use of auxiliary scripts. The allowed tools (Read/Edit/Write/Bash/Glob/Grep/WebSearch/WebFetch/Agent) are appropriate for file scanning, local script invocation, and online DOI verification.
Instruction Scope
SKILL.md confines actions to bibliography-related tasks (locating .bib/.tex, parsing entries, cross-checking citations, and calling DOI resolvers). It explicitly requires showing Before/After and asking for confirmation before modifying files. Note: DOI/meta validation uses WebSearch/WebFetch which will send paper identifiers/titles to external services — this is expected for verification but is the main surface that could leak content externally if the user considers bibliographic contents sensitive.
Install Mechanism
Instruction-only skill with no install spec and no code files to write or download. This is lowest-risk from an installation perspective.
Credentials
The skill declares no required environment variables or credentials (appropriate). One minor mismatch: SKILL.md references running Python scripts (analyze_bib.py, nameTranslate.py) and shell commands (python analyze_bib.py), but the registry metadata lists no required binaries; the agent/platform must provide python/bash for script execution. No secrets or unrelated credentials are requested.
Persistence & Privilege
always:false and no install means the skill does not request permanent presence. The skill uses Read/Edit/Write tools and can modify files, but SKILL.md states it will show Before/After and requires user confirmation before changes. Be aware that autonomous invocation (default platform behavior) plus write access increases impact if misused — however this is a normal platform pattern and the skill documents confirmation behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ieee-reference-manager
  3. After installation, invoke the skill by name or use /ieee-reference-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
IEEE Trans 论文参考文献全流程管理助手首发版本: - 支持 BibTeX 条目结构化审查与修复:检测重复、缺失字段、Early Access 规范、条目类型等。 - 跨 .tex/.bib 检查引用一致性:查找未引用冗余或缺失引用条目,合并连续 \cite。 - 自动期刊名标准化:对接 IEEE abr/宏,修正硬编码期刊名及不规范条目。 - 支持 DOI 与元数据在线校验:自动比对论文标题、作者、年份及疑似错误 DOI。 - 多类型条目校验扩展:覆盖期刊、会议、书籍、技术报告、专利、学位论文等。 - 输出按严重程度分类的全面格式与一致性报告,辅助参考文献合规管理。
Metadata
Slug ieee-reference-manager
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is ieee-reference-manager?

IEEE Trans 论文参考文献全流程管理助手。负责参考文献的格式校验、引用审查、BibTeX 条目修复、期刊名标准化、DOI/元数据在线验证、Early Access 处理、作者数量合规、重复条目检测等。当用户需要"检查参考文献"、"修复引用格式"、"验证 DOI"、"整理 bib 文件"、"参考文献审查"时触发。 It is an AI Agent Skill for Claude Code / OpenClaw, with 439 downloads so far.

How do I install ieee-reference-manager?

Run "/install ieee-reference-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ieee-reference-manager free?

Yes, ieee-reference-manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ieee-reference-manager support?

ieee-reference-manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ieee-reference-manager?

It is built and maintained by Linghaoz (@zlhad); the current version is v1.0.0.

💬 Comments