manage-refs 是一个面向学术投稿的参考文献处理 Skill，遵循“写入与审计分离”的原则：它负责渲染、注入与格式转换，而文献条目与 PubMed/CrossRef 的核对交由 /verify-refs 只读审计完成。
主要能力与用法：
- 引文键校验：运行 python3 "${CLAUDE_SKILL_DIR}/scripts/check_citation_keys.py" manuscript.md refs.bib，对 UNDEFINED / UNUSED 键报错，是构建前的硬性闸门。
- 用 pandoc 渲染："${CLAUDE_SKILL_DIR}/scripts/render_pandoc.sh" -j european-radiology -i manuscript.md -b refs.bib -o manuscript_final.docx，按期刊 CSL 生成参考文献表；换刊（如级联拒稿后改投）只需更换 -j。被引但不在 .bib 中的键会使渲染以退出码 5 失败并报出键名。
- 交叉引用 QC：python3 "${CLAUDE_SKILL_DIR}/scripts/check_xref.py" --md manuscript.md --docx manuscript_final.docx --out qc/xref_audit.json --strict，MISSING_DOCX / MISSING_BODY / MISMATCH 均视为阻断；图表以单独附件投稿的期刊可加 --allow-separate-attachments。
- Zotero CWYW 流程：先用 md_marker_convert.py --to-keys 将 [N] 转为 [@key]（未映射标记保留并报错），再用 inject_zotero_cwyw.py 注入原生字段码；该脚本从本机 Zotero 连接器（端口 23119）获取元数据，需本地运行 Zotero，无 Web API 回退。首次构建后必须在 Word 中手动执行一次 Zotero → Add/Edit Bibliography，之后 Refresh 才能同步。
- 其它脚本：fill_journal_abbrev.py 依据 DOI → PMID → PubMed NLM 缩写补全 .bib；check_reference_duplication.py 检测重复参考文献表；check_bib_title_markup.py 检测 .bib 标题中的出版商标记；pre_submission_gate.sh 串联上述检查，成功时写出 qc/pre_submission_gate.json。
限制：不要手工键入参考文献表；不虚构 Zotero 元数据或期刊缩写；CWYW 首次构建需人工操作；"Table 1 and 2" 这类写法只会解析出 Table 1，应写 "Tables 1 and 2"。CSL 清单与各样式渲染效果以 citation_styles/README.md 为准；Webpage 等非期刊条目依赖已修补的 zotero_to_csl_json，不可绕过。