前言¶

在對話裏寫完報告、紀要或說明文檔後，常見下一步是導出 Word：要標題層級、段落間距、頁內結構，又不想手工在 Office 裏排版一遍。自己寫腳本可以，但每次都要回憶 python-docx 的 API、段落樣式和保存路徑，成本不低。下面介紹 SkillHub 上的社區 Skill python-docx-creator：把「生成格式化 Word」收斂成 Agent 可遵循的 SKILL.md 工作流，在觸發條件滿足時由模型按技能說明調用 python-docx 產出 .docx 文件。

這是什麼¶

python-docx-creator 是面向辦公效率（分類 office-efficiency）的 Agent Skill，座標爲 @user_e60b9cd9/python-docx-creator，當前版本 1.0.0，來源爲 community，由發佈者 user_e60b9cd9 維護。技能定位一句話：使用 python-docx 庫生成 Word 文檔（.docx），在用戶需要將 Markdown 或純文本 轉爲帶格式的 Word 時使用。

與臨時讓模型「隨便寫個腳本」相比，Skill 把依賴庫、輸出形態和觸發語義寫進標準 SKILL.md，便於在 Cursor、Claude Code 等支持 Skills 的客戶端里長期啓用，而不是每次從零描述需求。

核心功能¶

以下能力均來自 SkillHub 公開簡介，未在頁面展開的 API 細節不作延伸：

1. 生成 .docx：以 python-docx 爲底層，輸出標準 Word 文件。
2. 內容來源：支持將 Markdown 或 純文本 轉爲格式化文檔（具體標題、列表、樣式映射由技能內說明約束 Agent 行爲）。
3. 觸發語義：當用戶要求生成 Word、將內容保存到 .docx、或創建「專業格式」文檔時，Agent 應選用本技能。
4. 無需 API Key：標籤 requires_api_key=false，不依賴外部付費接口即可完成本地文檔生成（運行環境仍需能安裝/執行 Python 與 python-docx）。

SkillHub 頁面統計（以抓取資料爲準）：評分 100000，下載 2138 次。

安裝與啓用¶

Skill 遵循通用 SKILL.md 格式。在 SkillHub 生態中安裝時，需讓 CLI 把文件落到當前 Agent 能識別的 skills 目錄，否則默認路徑可能不被加載。

1、安裝 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

2、安裝本 Skill 到對應目錄¶

將 @user_e60b9cd9/python-docx-creator 安裝到當前環境的 skills 目錄。官方模板命令如下，--dir 需替換爲實際路徑：

skillhub install @user_e60b9cd9/python-docx-creator --dir <skills 目錄>

常用客戶端 skills 路徑（摘自 SkillHub 安裝說明）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可把下面提示詞發給 AI，由其按 SkillHub 安裝文檔 完成安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_e60b9cd9/python-docx-creator`。

安裝後按所用客戶端要求刷新或重啓，使新 Skill 被索引。

典型用法¶

公開頁面未提供獨立代碼倉庫示例；可復現的用法是自然語言觸發 + Agent 按 SKILL.md 執行。經過上面的安裝步驟後，在對話中明確以下意圖即可：

1. 提供 Markdown 或純文本正文（或指定工作區中的 .md / .txt 路徑）。
2. 說明輸出要求，例如：「生成 Word」「保存爲 report.docx」「需要標題層級和專業排版」。
3. 由 Agent 加載 python-docx-creator，在本地用 python-docx 寫文件並返回生成路徑。

示例提示（表述需與技能觸發條件一致）：

把下面這份 Markdown 轉成 Word，保存爲 ./output/weekly-report.docx，保留二級標題和列表格式。

（正文或文件路徑）

若環境缺少 python-docx，Agent 通常需先 pip install python-docx 再執行生成；具體步驟以技能包內 SKILL.md 爲準（安裝後可在 skills 目錄中查看）。

適用場景與注意¶

適合誰

• 經常在 Agent 裏起草文檔、又要交給同事 Word 版的開發者或運營。
• 希望統一「Markdown/純文本 → .docx」流程，減少每次手寫 Document() 樣板代碼的情況。

限制與注意

• 技能描述側重 python-docx 生成 與 格式化轉換；複雜版式（頁眉頁腳模板、域、修訂模式等）是否覆蓋，取決於 SKILL.md 內指引，本文無法從公開元數據覈實細節。
• 生成質量依賴模型對 Markdown 結構的解析及技能中的樣式約定；極複雜的 Office 模板仍可能需要人工微調。
• 社區來源（community），升級與問題反饋需通過 SkillHub 座標與發佈者渠道跟進。
• 頁面展示的「安裝」計數爲 0，與下載量分開統計；以你本機 skillhub install 是否成功、Agent 是否識別目錄爲準。

結尾¶

python-docx-creator 把 Word 導出從「臨時腳本」變成可安裝的 Agent Skill：在需要 .docx、專業排版或保存 Word 時自動對齊 python-docx 工作流，且無需 API Key。查閱元數據與安裝入口可使用：

• SkillHub 頁面：https://www.skillhub.cn/skills/user_e60b9cd9/python-docx-creator
• 技能座標 API 入口：https://api.skillhub.cn/user_e60b9cd9/python-docx-creator