前言¶
在 Cursor、Claude Code 等環境裏讓模型「寫一份 Word」，常見結果是 Markdown 或結構混亂的導出文件：目錄、修訂痕跡、批註、頁眉頁腳很難一次做對。自己寫腳本則要同時應付 OOXML、docx-js 的坑，以及解包改 XML 再打包的流水線。
下面介紹 SkillHub 上的 DOCX 創建、編輯與分析（@org-02qudk26/docx，v1.0.0）。它用標準 SKILL.md 把讀、建、改、驗 Word 文檔的步驟和命令寫進 Agent 上下文，用戶只需用自然語言描述需求，由 Agent 按技能內的流程執行。
這是什麼¶
DOCX 創建、編輯與分析 是面向 .docx 的 Agent Skill：當任務涉及創建、讀取、編輯或操作 Word 文檔時，應優先加載本技能。
| 項 | 說明 |
|---|---|
| 座標 | @org-02qudk26/docx |
| 版本 | 1.0.0 |
| 發佈者 | 智雨科技 |
| 來源 | enterprise（SkillHub） |
| 分類 | office-efficiency |
| 標籤 | requires_api_key=false（無需額外 API Key） |
| SkillHub 頁面 | https://www.skillhub.cn/skills/org-02qudk26/docx |
| 技能 API 地址 | https://api.skillhub.cn/org-02qudk26/docx |
技能包內 README 將能力概括爲：創建、讀取、編輯和驗證專業 Word 文檔，覆蓋樣式、目錄、表格、頁眉頁腳、圖片、批註、修訂與 OOXML 級編輯。
核心功能¶
以下內容來自技能包 SKILL.md 與配套腳本，安裝後 Agent 會按該文檔路由任務。
觸發範圍¶
除「Word doc」「.docx」等字面提及外，技能說明還覆蓋：生成帶目錄、標題、頁碼或信頭的正式文檔；從 .docx 提取或重組內容；插入或替換圖片；查找替換；處理修訂痕跡或批註；以 report、memo、letter、template 等形式交付 .docx。明確不用於 PDF、電子表格、Google Docs 等與 Word 生成無關的通用編碼。
三類主路徑¶
技能將 .docx 視爲「XML 文件的 ZIP 包」，按任務選方法：
| 任務 | 方法 |
|---|---|
| 讀取 / 分析 | pandoc，或解包讀取原始 XML |
| 創建新文檔 | docx-js（npm 包 docx） |
| 編輯已有文檔 | 解包 → 改 XML → 重新打包 |
讀取與預覽¶
- 帶修訂的文本：
pandoc --track-changes=all document.docx -o output.md - 解包：
python scripts/office/unpack.py document.docx unpacked/ - 轉 PDF / 分頁圖：
scripts/office/soffice.py與pdftoppm（技能內寫明用於驗證排版）
創建新文檔¶
通過 Node 腳本調用 docx 庫生成文件，並用 python scripts/office/validate.py 校驗。文檔中強調頁面尺寸（默認 A4）、表格雙重寬度、列表用編號配置而非 Unicode 項目符號、ImageRun 必須帶 type、目錄需 HeadingLevel 等易錯點。
編輯已有文檔¶
固定三步：
python scripts/office/unpack.py document.docx unpacked/- 編輯
unpacked/word/下 XML；批註可用python scripts/comment.py；修訂痕跡需符合 OOXML 模式 python scripts/office/pack.py unpacked/ output.docx --original document.docx
舊版 .doc 需先轉換：
python scripts/office/soffice.py --headless --convert-to docx document.doc
接受全部修訂可執行：
python scripts/accept_changes.py input.docx output.docx
依賴¶
技能列出的運行時依賴：pandoc、docx（npm install -g docx）、LibreOffice（經 scripts/office/soffice.py）、Poppler 的 pdftoppm。
安裝與啓用¶
安裝流程以 SkillHub 官方說明爲準：https://skillhub.cn/install/skillhub.md 。技能詳情頁給出的安裝座標爲 @org-02qudk26/docx。
1、安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可執行完整安裝或僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝技能到當前 Agent 的 skills 目錄¶
必須用 --dir 指向 Agent 實際讀取的 skills 目錄，否則默認落在 ./skills/ 可能不被加載。
skillhub install @org-02qudk26/docx --dir <skills 目錄>
常見路徑（以官方文檔爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝成功後，本機目錄結構類似：.../@org-02qudk26/docx/SKILL.md 及 scripts/ 等共 22 個文件（與平臺簽名元數據中的 file_count 一致）。
3、（可選）校驗包完整性¶
SkillHub 支持對已安裝版本驗籤，需 CLI 版本不低於 2026.7.29：
skillhub self-upgrade
skillhub verify @org-02qudk26/docx
通過時終端會提示簽名與內容校驗通過；具體含義見 https://skillhub.cn/docs/verify-signature?namespace=org-02qudk26&slug=docx&version=1.0.0 。
4、在對話中啓用¶
向 Agent 說明需求即可，例如：「請根據 https://skillhub.cn/install/skillhub.md，安裝 @org-02qudk26/docx。」安裝並重啓或刷新技能加載後，提及 Word / .docx 的任務應自動命中本技能。
典型用法¶
自然語言驅動¶
安裝完成後，可直接描述業務目標，由 Agent 選擇讀、建、改路徑。技能包 README 中的示例場景包括：合同草稿統一標題與目錄；處理帶修訂的客戶文檔；報告插圖與腳註並做渲染驗證。這些是技能內文檔給出的說明，而非第三方案例。
讀取現有文檔爲 Markdown¶
pandoc --track-changes=all document.docx -o output.md
適合先摸清正文與修訂內容，再決定是否解包改 XML。
從零生成並校驗¶
Agent 按 SKILL.md 編寫 docx-js 腳本生成 doc.docx，然後：
python scripts/office/validate.py doc.docx
若需目視檢查，技能建議先轉 PDF 再分頁導出圖片（命令見 SKILL.md「轉換爲圖片」一節）。
解包編輯後回寫¶
python scripts/office/unpack.py document.docx unpacked/
# 編輯 unpacked/word/document.xml 等
python scripts/office/pack.py unpacked/ output.docx --original document.docx
批註可配合：
python scripts/comment.py unpacked/ 0 "批註正文（注意 XML 轉義）"
適用場景與注意¶
適合誰
- 經常在 Agent 裏交付
.docx的開發者、法務、運營、諮詢等角色 - 需要修訂痕跡、批註、OOXML 級改動，而不只是「導出一段文字」的團隊
- 已使用 Cursor / Claude Code / Codex 等支持 Skill 目錄的客戶端的用戶
限制與注意
- 技能明確不處理 PDF、表格文件、Google Docs；
.doc必須先轉.docx - 創建文檔依賴 Node 與全局或可用的
docx包；預覽與轉換依賴 LibreOffice、pandoc、Poppler，環境缺組件時對應步驟會失敗 - 編輯路徑要求遵守 OOXML 與技能中的 schema 順序說明；打包階段的自動修復只能處理部分問題（如部分 ID、空白保留），不能替代合法 XML
- SkillHub 統計（以抓取資料爲準）：評分 100000，下載 37141；enterprise 技能與公開 registry 的安裝方式一致，均通過
skillhub install @org-02qudk26/docx
結尾¶
DOCX 創建、編輯與分析 把 Word 文檔在 Agent 場景下的標準流水線寫進 SKILL.md：讀用 pandoc/解包，建用 docx-js，改用解包—編輯—打包，並附帶校驗、批註與修訂的腳本約定。若你的工作流裏頻繁出現 .docx，可通過 SkillHub 安裝 @org-02qudk26/docx，減少每次從零摸索 OOXML 的成本。
官方入口：
- SkillHub 詳情：https://www.skillhub.cn/skills/org-02qudk26/docx
- 技能 API：https://api.skillhub.cn/org-02qudk26/docx
- 安裝說明：https://skillhub.cn/install/skillhub.md
