前言¶
本科畢業論文在 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
