前言¶
在 Cursor、Claude Code 等環境裏讓模型「寫一份 Word」，常見結果是零散腳本：中文字體沒設好、表格樣式各寫各的，封面和正文結構也不統一。自己每次在對話裏重複排版要求，成本高，也難沉澱成可複用的做法。
下面介紹 SkillHub 上的社區 Skill @user_5748365b/python-docx（版本 1.0.0）。它把 python-docx 的初始化、字體、標題層級、列表、表格、圖片和封面等步驟寫成標準模板，Agent 按同一套約定生成 .docx，更適合方案書、架構說明等需要固定版式的文檔。
這是什麼¶
python-docx 是 SkillHub 分類 office-efficiency（辦公效率）下的社區 Skill，座標 @user_5748365b/python-docx，發佈者爲 user_5748365b，來源爲 community。頁面標註 requires_api_key=false，安裝後不需要額外 API Key。
Skill 本體是一份 SKILL.md：說明適用場景、依賴的 Python 模塊（python-docx 及 docx.shared、docx.enum、docx.oxml.ns），並給出可直接套用的函數模板與完整示例。官方入口：
- API 座標：https://api.skillhub.cn/user_5748365b/python-docx
- SkillHub 頁面：https://www.skillhub.cn/skills/user_5748365b/python-docx
據 SkillHub 抓取數據，該 Skill 評分 100000，下載約 8740 次（騰訊雲 SkillHub 鏡像頁顯示約 8.7 千次下載，與上述數量一致）。
核心功能¶
以下內容均來自該 Skill 的 SKILL.md，只列已寫明的能力。
- 文檔初始化：創建
Document，併爲Normal樣式設置默認字體（示例使用 Microsoft YaHei，並通過qn('w:eastAsia')處理東亞字體）。 - 字體工具：
set_font(run)爲每個run統一設置西文與東亞字體，避免中文顯示爲方框。 - 標題：
add_heading_custom支持一至三級標題，並約定字號、顏色與加粗。 - 段落：
add_para_custom支持首行縮進、加粗與顏色。 - 列表：項目符號（
List Bullet）與編號列表（List Number），帶縮進級別。 - 表格：
create_table根據表頭與二維數據生成表格，示例樣式爲Light Grid Accent 1。 - 圖片：
insert_image居中插入圖片，可選圖注。 - 分頁與封面：
add_page_break；create_cover支持主副標題、客戶、日期、版本等封面信息。
文檔末尾附有「常見問題」（中文方框、表格樣式、圖片路徑、格式錯亂）及 python-docx 官方文檔 鏈接。
安裝與啓用¶
官方頁面給出的安裝方式是：讓 AI 按 SkillHub 安裝說明處理，座標寫爲 @user_5748365b/python-docx。
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_5748365b/python-docx`。
若本機已有 SkillHub CLI，可先檢查版本，再安裝到當前 Agent 的 skills 目錄（必須使用 --dir，否則默認裝到 ./skills/ 可能不會被 Agent 加載）。
command -v skillhub && skillhub --version
未安裝 CLI 時，可按 SkillHub 文檔執行完整安裝或僅 CLI：
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（命名空間與 slug 以 skillhub search python-docx 解析結果爲準）：
skillhub install python-docx --namespace user_5748365b --dir <你的 Agent skills 目錄>
常見 skills 目錄（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝完成後，按你所用客戶端的要求重啓或刷新 Agent，使新 Skill 生效。運行 Skill 中的示例代碼前，需在 Python 環境中已安裝 python-docx 庫（import 名爲 docx）；具體安裝命令以你項目環境爲準，Skill 正文未單獨列出 pip 行。
典型用法¶
Skill 建議的流程是：先 create_document()，再按需組封面、分頁、標題、正文、列表、表格，最後 save。
下面節選官方完整示例中的調用順序，便於對照 SKILL.md 復現（函數定義見 Skill 內各小節）。
doc = create_document()
create_cover(doc,
title='安全服務方案',
subtitle='Security Service Proposal',
customer='某某公司',
date='2026-03-23',
version='V1.0'
)
doc.add_page_break()
add_heading_custom(doc, '一、 服務概述', level=1)
add_heading_custom(doc, '1.1 服務背景', level=2)
add_para_custom(doc, '這是正文內容，首行縮進兩字符。', indent=0.5)
add_bullet_custom(doc, '項目符號內容')
add_numbered_custom(doc, '編號列表內容')
headers = ['列1', '列2', '列3']
data = [['A', 'B', 'C'], ['D', 'E', 'F']]
create_table(doc, headers, data)
doc.save('output.docx')
在對話裏使用時，可直接說明交付物爲 .docx，並引用本 Skill，讓 Agent 按上述函數名與字體設置生成腳本，而不是臨時拼湊 API 調用。
適用場景與注意¶
適合誰
- 需要反覆產出版式相近的 Word：安全服務方案、技術架構設計文檔等（Skill 概述中寫明的場景）。
- 希望 Agent 生成 Python 腳本時，默認帶上中文字體與表格樣式約定。
限制與注意
- Skill 聚焦「生成」與排版模板，不包含讀檔、修訂、批註等高級 Word 能力；複雜需求可能要結合其他文檔類 Skill 或自行擴展。
- 封面與配色、字號以 Skill 示例爲準；企業有嚴格公文規範時，應在對話中補充貴司模板或替換
create_cover/add_heading_custom中的參數。 - 插入圖片時需保證路徑有效；Skill 建議必要時使用絕對路徑。
- 每個文本
run都應走set_font()，否則易出現中文方框（Skill FAQ 已說明）。
結尾¶
@user_5748365b/python-docx 把 python-docx 寫成 Agent 可遵循的一套標準模板，減少「每次對話重新講排版」的成本。若你主要在 Cursor 等環境裏做辦公類自動化，可從 SkillHub 頁面或上述安裝命令接入，再讓 Agent 按 Skill 中的函數與示例落盤爲 .docx。
官方頁面：https://www.skillhub.cn/skills/user_5748365b/python-docx
