前言¶

在自動化辦公里，Word 文檔往往是「看起來簡單、改起來麻煩」的一類產物：列表會莫名重編號，頁眉頁腳和分節一碰就亂，帶修訂和批註的文件更不能當成純文本去替換。用腳本硬拼 XML 或只做全文替換，經常在 Word、LibreOffice、Google Docs 之間來回打開後出現版式漂移。

下面介紹 SkillHub 上的 Word / DOCX 技能（座標 @clawhub_ivangdavila/word-docx，SkillHub 頁面常稱「創建、檢查、編輯」類能力）。它把 DOCX 當作 OOXML 包來理解與操作，引導 Agent 在創建、檢查、編輯時兼顧樣式、編號、修訂與兼容性，而不是隻改可見文字。

這是什麼¶

Word / DOCX 是一條面向 Microsoft Word 與 .docx 的 Agent Skill，當前版本 1.0.2，分類爲 office-efficiency，發佈者爲 ivangdavila，來源爲 clawhub，上游說明見 ClawHub。SkillHub 收錄頁：Word / DOCX。官方入口：https://api.skillhub.cn/zcwl/word-docx。

簡介中的定位是：創建、檢查和編輯 Microsoft Word 文檔及 DOCX 文件，並覆蓋樣式、編號、修訂記錄、表格、分節符及兼容性檢查等場景。標籤標明 requires_api_key=false，不依賴額外 API Key。

核心功能¶

以下能力均來自 SkillHub 與 ClawHub 上的官方描述，可按任務類型理解分工：

1. 創建與生成：按樣式體系生成新文檔，優先命名樣式而非堆疊直接格式，便於後續人工編輯。
2. 檢查與閱讀：把 .docx 視爲 ZIP 內的 XML 部件（如 word/document.xml、styles.xml、numbering.xml 及頁眉頁腳關係），在「只讀、提取、審閱」場景下先走結構保留路徑，再決定是否深入改 OOXML。
3. 編輯現有文件：針對已有文檔做 OOXML 感知編輯，強調往返編輯後儘量不產生格式漂移；對帶修訂、批註、域、表格、模板或分頁約束的文件尤其適用。
4. 樣式與編號：區分段落樣式、字符樣式與直接格式；列表依賴 Word 編號定義（abstractNum、num 等），而非粘貼 Unicode 項目符號。
5. 版式與分節：頁邊距、方向、頁眉頁腳、頁碼等按分節處理；需要改版式時用分節符，而非用空段落撐版面。
6. 修訂、批註與域：在啓用修訂時區分插入、刪除與批註元數據；目錄、頁碼、交叉引用等按域處理，並注意緩存顯示值刷新。
7. 兼容性檢查：在交付前考慮 Word、LibreOffice、Google Docs 及轉換工具之間的往返差異；對 .docm、遺留 .doc 等格式有相應風險提示。

ClawHub 頁還列出關聯技能（需用戶確認後再裝）：documents（通用文檔與轉換）、brief（簡潔商務寫作）、article（長文結構與起草）。

安裝與啓用¶

通過 SkillHub（國內收錄）¶

SkillHub 頁面給出的安裝方式是：讓 Agent 依照 SkillHub 安裝說明 安裝座標 @clawhub_ivangdavila/word-docx。

若本機已有 skillhub CLI，安裝時需用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。Cursor 常用目錄示例：

command -v skillhub && skillhub --version
skillhub install clawhub_ivangdavila/word-docx --dir ~/.cursor/skills/

未安裝 CLI 時，可按 SkillHub 文檔執行一鍵安裝（完整或僅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

通過 ClawHub / OpenClaw 上游¶

上游 ClawHub 提供的安裝命令爲：

openclaw skills install @ivangdavila/word-docx

座標在 SkillHub 側爲 @clawhub_ivangdavila/word-docx，在 clawhub 源爲 @ivangdavila/word-docx，安裝時以你當前使用的商店與 CLI 爲準。

安裝完成後，在對話中明確任務與 .docx 路徑，並說明是否涉及修訂、批註、域或版式約束，便於 Skill 內的工作流生效。

典型用法¶

官方「When to Use」的觸發條件可以概括爲：

• 主要交付物是 Word 或 .docx；
• 文件包含修訂、批註、頁眉頁腳、編號、域、表格、模板或分頁限制；
• 需要在多次打開、編輯後仍保持版式與審閱信息穩定。

結合 Skill 正文，常見操作順序可以是：

1. 判定任務類型：新建文檔、只讀提取/審閱，還是在已有審閱稿上做最小改動——三類工作流不同，不宜混用「整段重寫」。
2. 讀取 fragile 文檔：先結構化提取或檢查包內部件，再改 OOXML；勿假設一個詞對應一個 XML 節點（文字可能分佈在多個 run 中）。
3. 改列表與樣式：改編號定義與段落編號屬性，而不是手工「看起來對齊」；跨文檔粘貼時注意外來樣式與編號定義被一併導入。
4. 改版式：在分節級別調整頁邊距、頁眉頁腳；表格寬度與頁面寬度、邊距相關，複雜表格建議顯式寬度而非完全依賴各編輯器對 auto-fit 的解釋。
5. 審閱場景：默認做 span 級替換，避免整段重寫導致修訂噪音、書籤或批註錨點錯位；法律、學術、商務審閱稿尤其如此。
6. 交付前：在目標環境（或等價編輯器）中檢查分頁、表格、域刷新與交叉引用，避免「文本對了、打開後版式變了」。

上述步驟是 Skill 內建的最佳實踐摘要，具體實現由 Agent 在啓用該 Skill 後按 SKILL.md 指引執行。

適用場景與注意¶

適合誰

• 需要 Agent 生成或維護正式 Word 模板、報告、合同審閱稿的團隊；
• 自動化流水線裏要把 Markdown/數據填進 DOCX，且要求樣式、多級列表、分節頁眉可維護；
• 要在保留修訂、批註、域的前提下做局部修改，而不是全文替換。

限制與常見坑（來自官方 Common Traps，安裝前宜知曉）

• 複製粘貼易帶入多餘樣式與編號定義；頁眉頁腳圖片依賴部件關係，盲目複用 ID 會斷鏈。
• 用空段落當間距會讓模板脆弱；列表「肉眼重啓」往往失敗，因爲編號狀態不在可見文字裏。
• 刪光段落文字仍可能留下空段標記或不穩定列表項；表格在各編輯器間可能對 auto-fit、百分比寬度解釋不一致。
• 兼容模式可能限制新特性；改頁面尺寸或默認邊距會牽動目錄、腳註與交叉引用。
• 遺留 .doc 通常需先轉換再按現代 .docx 假設處理；.docm 含宏，風險更高。

SkillHub 統計（以抓取資料爲準）：評分 100000，下載 275304，安裝 23940。

結尾¶

若你的工作流裏頻繁出現「Agent 改了 DOCX，同事一打開編號全亂」或「審閱稿被整段重寫」，可以把 Word / DOCX 作爲默認 Skill，讓創建、檢查、編輯都按 OOXML 與 Word 語義來走。安裝與說明以 SkillHub 爲準：https://api.skillhub.cn/zcwl/word-docx，頁面詳情：https://www.skillhub.cn/skills/clawhub_ivangdavila/word-docx。