前言¶
本科毕业论文在 Word 里往往要对照学校或选集稿件说明，逐项改页边距、行距、封面字号、摘要与标题层级。手工在样式面板里点一遍，既慢也容易漏项；只让模型「口头建议」又很难直接落到 .docx 文件上。下面介绍 SkillHub 上的 paper-formatting（坐标 @user_1f949bb0/paper-formatting）：在 Agent 对话里用自然语言触发，按《本科生优秀毕业论文（设计）选集》稿件格式要求，对 Word 文档做检查或批量改写，并附带脚本可在本地命令行执行。
这是什么¶
paper-formatting 是社区来源（community）的 Agent Skill，分类为 office-efficiency，当前版本 1.0.0，由 SkillHub 用户 user_1f949bb0 发布；技能包内 SKILL.md 标注作者为 WorkBuddy。标签 requires_api_key=false，不依赖额外 API Key。
一句话定位：当用户提到论文格式修改、检查、排版、格式化毕业论文等需求时触发，依据上述选集稿件格式要求，自动调整 Word（.docx） 论文格式。
核心功能¶
以下能力来自技能包 SKILL.md 与配套 scripts，可与 Agent 编排或命令行配合使用。
格式规范范围¶
- 页面：A4；上下左右页边距 25mm；行距固定值 20 磅；页码暂不设置。
- 封面：题目三号黑体居中；副标题四号黑体居中；专业信息小四号楷体居中。
- 摘要：「摘要」「关键词」标签小四号黑体；摘要与关键词正文五号楷体；关键词 3–6 个、分号分隔。
- 正文：五号宋体（英文 Times New Roman 12）；表格按三线表处理。
- 标题层级：默认 文经管法（一、（一）、1. 等五级）；可选 理工类（1、1.1、1.1.1）。
- 参考文献：「参考文献」四号黑体居中；条目
[1]、[2]等五号宋体。 - 英文摘要（若有）：Title、Abstract、Key Words 等按文档规定的英文字号与加粗规则处理。
工作模式¶
- 格式检查：解析封面、摘要、正文、参考文献等结构，逐项对照规范，输出 Markdown 检查报告（含评分与问题列表）。
- 格式修改：在保留正文内容的前提下应用上述规范，输出
原文件名_formatted.docx及 修改报告。 - 批量处理：技能说明支持多篇文档依次处理（由 Agent 按流程调用脚本）。
技能说明写明会 备份原文件；三线表、公式与复杂表格等仍可能需要人工复核。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 CLI：
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
说明与路径约定见：SkillHub 安装与优先源配置。
2. 安装 paper-formatting 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。
skillhub install paper-formatting --namespace user_1f949bb0 --dir <你的 skills 目录>
常见目录（来自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在支持 SkillHub 的客户端中，让 AI 按官方提示安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_1f949bb0/paper-formatting`。
安装后按所用客户端要求 重启或刷新技能索引（以各客户端文档为准）。
3. Python 依赖¶
技能脚本依赖 Python 3.7+ 与 python-docx 0.8.11+。在将要运行 scripts/main.py 的环境中安装：
pip install python-docx
典型用法¶
在 Agent 对话中触发¶
技能描述的触发场景包括：修改/调整/检查论文格式、格式化毕业论文、论文排版，以及出现「格式规范」「排版要求」等表述。对话中应提供 Word 文档路径，并说明是否需要仅检查、是否属于 理工类（默认文经管法）。
示例表述（与技能包 README 一致，可按需改写路径与文件名）：
请帮我按照格式要求修改这个论文的格式：论文.docx
请帮我修改这篇理工类论文的格式：算法论文.docx
请检查这篇论文的格式是否符合要求：论文.docx
经过上面的步骤，Agent 会按 SKILL.md 确认文档路径、学科类别与输出位置，并调用捆绑脚本执行检查或格式化。
命令行直接调用¶
进入已安装技能目录下的 scripts 文件夹（路径随 --dir 安装位置而定，例如 ~/.cursor/skills/@user_1f949bb0/paper-formatting/scripts）。
检查格式（文经管法为默认 liberal，理工类用 tech）：
python main.py check 论文.docx
python main.py check 论文.docx --discipline tech
应用格式并写出新文件：
python main.py format 论文.docx
python main.py format 论文.docx --discipline tech -o 格式化后的论文.docx
只检查、不写回文档（format 子命令）：
python main.py format 论文.docx --check-only
输出约定（技能说明）：格式化结果为 *_formatted.docx；检查报告为 *_check_report.md；修改报告为对应的 *_report.md。
适用场景与注意¶
适合谁
- 需要按《本科生优秀毕业论文（设计）选集》稿件格式交稿的本科生或助教。
- 已在 Cursor、Claude Code、Codex 等环境使用 SkillHub 技能，希望用对话驱动 Word 排版而非纯手工改样式。
限制与注意
- 文档需具备可识别的结构（封面、摘要、正文、参考文献等）；结构混乱时识别与套用可能不准。
- 理工类标题规则与文经管法不同，须在对话或
--discipline tech中明确。 - 页码、复杂表格与公式等，技能说明中标注为暂不设置或需人工检查。
- SkillHub 页面统计（以预抓取资料为准）：评分 100000，下载约 2100 次，安装约 81 次；与站内展示可能随时间变化，以 SkillHub 为准。
结尾¶
paper-formatting 把选集稿件里的字号、行距与标题层级写进可执行的检查与格式化流程，适合在 Agent 里用一句话处理 .docx，也适合在本地用 main.py 复现同一套规范。官方 Skill 页与 API 入口：
- SkillHub：https://www.skillhub.cn/skills/user_1f949bb0/paper-formatting
- https://api.skillhub.cn/user_1f949bb0/paper-formatting
