前言¶
投期刊或写学位论文时，参考文献往往来自 Zotero、EndNote、网页复制或 Word 混排，字段顺序、标点、文献类型标识和 DOI 写法很容易和编辑部要求不一致。手工逐条改格式费时，也容易在返修阶段被指出「著录格式不符合规范」。
下面介绍 SkillHub 上的社区 Skill「参考文献排版」（坐标 @user_8d26dabd/qclaw-reference-formatter，当前版本 v2.1.11）。它在 Agent 对话里按国标 GB/T 7714 或 APA 整理条目，并强调在混乱导出场景下仍尽量保留 DOI，便于快速对齐期刊著录要求。
这是什么¶
「参考文献排版」是发布在 SkillHub 的 professional 类 Skill，来源为 community，由发布者 user_8d26dabd（页面展示作者为刘楠）维护。Skill 基于通用 SKILL.md 格式，供 Cursor、Claude Code、Codex 等支持 Skills 的客户端加载。
官方简介概括为：参考文献格式不规范可能导致退稿；可按 GB/T 7714 / APA 一键规范；对混乱导出的文献列表也能整理，并保留 DOI，目标是在较短时间内（简介中的「3 分钟」为产品表述）对齐期刊要求。标签标明 requires_api_key=false，安装后无需额外配置 API Key。
SkillHub 页面统计（以抓取资料为准）：评分 100000，下载约 1500 次。
核心功能¶
以下能力均来自官方简介与 SkillHub 页面，未在资料中出现的格式（如 Chicago、MLA 等）不在此列举。
- GB/T 7714 著录：面向中文期刊、学位论文等常见国标要求，统一条目结构与标点习惯。
- APA 著录：面向 APA 体例的期刊与课程作业场景。
- 混乱输入整理：接受从文献管理工具或文档中导出的、字段不齐或混排的列表，由 Agent 按 Skill 规则重排。
- 保留 DOI：在规范化过程中尽量保留 DOI 信息，避免为排版牺牲可检索性。
具体字段映射、文献类型缩写等细则在安装后由 Skill 包内的 SKILL.md 约束 Agent 行为；本文不展开未公开文档中的步骤。
安装与启用¶
方式一：用 SkillHub CLI 安装（推荐）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 官方安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时，必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 时，部分客户端不会自动识别。
skillhub install @user_8d26dabd/qclaw-reference-formatter --dir <你的 skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装完成后，按所用客户端说明重启或刷新 Agent，使新 Skill 生效。
方式二：让 Agent 按官方提示安装¶
SkillHub 页面提供的安装提示为：根据 SkillHub 安装与优先源配置，安装 @user_8d26dabd/qclaw-reference-formatter。可将该句发给已联网的 Agent，由它拉取文档并执行对应安装步骤。
典型用法¶
资料中未给出单独的命令行子工具示例，典型流程是在启用 Skill 后，用自然语言交代任务与目标体例。可复现的表述应至少包含：
- 说明目标格式为 GB/T 7714 或 APA（二选一或分批指定）。
- 粘贴待整理的参考文献原文（可为 EndNote/Zotero 导出文本、Word 列表或网页复制内容）。
- 明确要求 保留 DOI（与官方简介一致）。
示例（示意，非官方固定模板）：
请用参考文献排版 Skill，将下面文献列表规范为 GB/T 7714-2015 格式，保留每条 DOI：
[在此粘贴文献列表]
Agent 在 Skill 指导下输出整理后的列表；投稿前仍建议对照目标期刊的「作者须知」做终检。
适用场景与注意¶
适合谁
- 需要交稿前批量统一参考文献体例的研究生、科研写作人员。
- 已从文献管理软件导出但格式与编辑部要求不一致的作者。
- 在 Cursor / Claude Code / Codex 等环境中写作、希望减少手工改标点与字段顺序的用户。
限制与注意
- 官方仅明确支持 GB/T 7714 与 APA；其他体例是否可用取决于 Skill 包内规则，未在页面声明的不应默认支持。
- 不同期刊对国标细节、电子文献著录、预印本等有附加规定，Skill 输出应作为初稿，不能替代对期刊模板的核对。
- 安装统计与评分为 SkillHub 页面展示数据，会随时间变化；以打开官方页面时的信息为准。
- 本 Skill 不需要 API Key；若客户端要求联网安装，需在具备外网权限的环境中执行
skillhub或 curl 安装脚本。
结尾¶
「参考文献排版」把 GB/T 7714、APA 著录和 DOI 保留写进 Agent Skill，适合在混乱导出场景下快速整理参考文献列表。安装时记住坐标 @user_8d26dabd/qclaw-reference-formatter，并用 --dir 对准当前客户端的 skills 目录。
- SkillHub 页面：https://www.skillhub.cn/skills/user_8d26dabd/qclaw-reference-formatter
- API 坐标地址：https://api.skillhub.cn/user_8d26dabd/qclaw-reference-formatter
- 安装说明：https://skillhub.cn/install/skillhub.md
