refs-verify
Skill2 starsChanged 56 days agoMITView on GitHub
Citation consistency and authenticity re-verification: after every revision recheck numbering, first-appearance order, orphan/duplicate entries, and whether each reference actually exists (Crossref/OpenAlex). (指导内容为中文 / guidance is in Chinese) 引注一致性重验:改稿后重核顺序编码制编号、首次出现顺序、孤儿条目与重复条目,修到退出码为 0
In this repository6 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- deliver-docxSkill
- lit-intakeSkill
- paper-writeSkill
- session-closeSkill
- style-calibrateSkill
The file
Files
引注重验
为什么每次都要跑
04 号文档:「编号严格按正文中首次出现顺序排列,不得跳号、提前引用。 修改正文后必须重新验证全部编号,未在正文引用的文献直接删除。」
删一段、加一句引用,编号就可能全乱。这件事人工做一次要十几分钟且容易漏, 脚本一秒出结果。
命令
python "tools/refs_check.py" --draft _输出文件/5_论文草稿目录模式默认排除 0_*、CLAUDE*、风格卡*、文献知识库、文献追踪总表、
_mineru_*、讨论摘要* 等非正文文件。
需要覆盖时用 --only '3_*.md' 或 --all。
参考文献区通过 ## 参考文献 标题自动识别;正文与参考文献在同一文件或分开成节均可。
检查项与修法
| 检查项 | 严重度 | 修法 |
| 正文引用编号在文末表中不存在 | 硬性 | 补条目,或删掉该引用 |
| 编号不连续(跳号) | 硬性 | 重排编号,使正文首次出现顺序为 1,2,3… |
| 首次出现顺序 ≠ 1,2,3… | 硬性 | 按正文首现顺序重新编号,这是顺序编码制的核心要求 |
| 表中条目从未被正文引用(孤儿) | 硬性 | 04 号文档要求直接删除该条目 |
| 表中编号重复 | 硬性 | 合并或改号 |
| 著者-出版年制下正文引注无对应条目 | 硬性 | 补条目或改正文 |
| 疑似重复条目(标题雷同) | 警告 | 人工确认是否同一篇 |
修编号的正确顺序
- 先定正文:把正文里每处引用的首次出现顺序列出来
- 按这个顺序重编编号(1 开始,连续)
- 按新编号重排文末参考文献表
- 再跑一次
refs_check.py确认退出码为 0
不要先改文末表再回头找正文——那样必然漏。
第二层:真实性核验(定稿前、投稿前)
上面 refs_check.py 查的是内部一致性——它不知道那条文献是否真实存在。
定稿前再跑一次外部核验:
python "tools/ref_verify.py" --draft _输出文件/5_论文草稿 \
--mailto <你的邮箱>三种判定:
- 已核实 —— Crossref/OpenAlex 找到且标题匹配
- DOI 失效 —— 硬性。条目里写了 DOI 但库中查不到,这是伪造的强信号
- 未检出 —— 不等于伪造。中文期刊在 Crossref/OpenAlex 覆盖不全, 需拿 CNKI/万方 人工核对。工具不会因此判失败
标题不匹配 = 条目信息可能被改动,人工核对。
这条纪律的由来:04 号文档要求"不概括、不转述、不臆造",但此前没有任何工具能验,
只有编号检查,编号正确不代表文献真实。核验结果缓存到
_输出文件/2_文献管理/_ref_verify_cache.json,重跑不重复请求。
改投其它制式期刊
顺序编码制 ↔ 著者-出版年制要全套转换,不能只改文末:
- 转著者-出版年:正文所有
[n]改为(作者,年);文末按字母或拼音排序;跑--style author-year - 转顺序编码:正文补编号;文末按首现顺序重排
转换后再跑一次,确认退出码为 0 才能交付。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

