Overview
docx skill 的功能
docx skill 是為端到端的 Microsoft Word .docx 工作流程而設計。它適用於需要建立、讀取、編輯、分析、驗證、加註解或重新封裝 Word 文件的情境，而不只是產生純文字內容。
從 repository 內容可以看出，這套工具提供以 XML 為核心的實用 Office 檔案工作流程，並針對 Word 提供支援，包括解開 .docx 封存檔、編輯內部 XML、重新封裝檔案、驗證結構、加入註解，以及處理追蹤修訂。skill 也包含指引與輔助工具，可在編輯前先將舊版 .doc 檔轉換為 .docx。
這個 skill 適合誰
這個 skill 很適合：
- 需要產出精緻 Word 文件成品的團隊，例如報告、備忘錄、信件與範本
- 需要檢查或轉換既有
.docx檔案，而不是從零開始撰寫的使用者 - 必須保留 Word 原生功能（例如註解或追蹤修訂）的工作流程
- 比起手動編輯，更適合直接存取 XML 的文件自動化任務
docx skill 可協助解決的問題
當你需要以下能力時，可以使用 docx：
- 從既有
.docx讀取文件內容 - 將 Word 檔解開為可編輯的 XML
- 進行結構化編輯後再重建文件
- 在文件封裝中加入審閱註解
- 使用以 LibreOffice 為基礎的工具接受追蹤修訂
- 在交付前驗證重建後的 Office 檔案
- 將舊版
.doc檔轉成.docx，以便安全處理
高層次運作方式
docx 的核心概念是：.docx 檔其實是包含 XML 與相關資產的 ZIP 封存檔。repository 內含的腳本包括：
scripts/office/unpack.py：用來擷取並格式化輸出 Office 文件內容scripts/office/pack.py：從已解開的目錄重建.docx、.pptx或.xlsx檔案scripts/office/validate.py與scripts/office/validators/下的驗證模組：用來檢查文件結構scripts/comment.py：將 Word 註解加入已解開的文件scripts/accept_changes.py：使用 LibreOffice 接受追蹤修訂scripts/office/soffice.py：在受限環境中更可靠地執行soffice
什麼情況下 docx 特別適合
如果你的主要工作是處理 Word 文件，建議選擇 docx。特別是當使用者明確要求 Word 檔、提到 .docx，或需要 Word 專屬功能時，例如：
- 標題、頁碼與專業排版
- 擷取或重整文件內容
- 註解與審閱流程
- 追蹤修訂處理
- 需要精準轉換的 XML 層級編輯
什麼情況下 docx 不是最佳選擇
這個 skill 並不適合所有檔案工作流程。如果你的主要需求是以下類型，它就不是最理想的選擇：
- 以 PDF 為主的處理流程
- 主要工作是試算表或簡報
- 需要的是 Google Docs 協作，而非 Office 封裝編輯
- 與文件產生或轉換無關的一般程式開發協助
安裝摘要
若要從 Anthropic skills repository 安裝 docx skill，請使用：
npx skills add https://github.com/anthropics/skills --skill docx
安裝完成後，建議先閱讀 SKILL.md，再查看 scripts/ 底下的輔助腳本，以了解有哪些文件操作可用。
How to Use
安裝 docx skill
使用以下指令安裝 docx：
npx skills add https://github.com/anthropics/skills --skill docx
加入後，建議先看這些檔案：
SKILL.mdscripts/office/unpack.pyscripts/office/pack.pyscripts/office/validate.pyscripts/comment.pyscripts/accept_changes.pyscripts/office/soffice.py
這些檔案最能反映此 skill 的實際運作路徑，也是評估是否值得安裝的最佳起點。
正式採用前先確認相依條件
根據 repository 內容，可以確認幾項實務上的相依條件與前提：
- 內附腳本需要 Python
- 某些操作需要 LibreOffice
soffice，包括接受追蹤修訂的腳本，以及.doc轉.docx的工作流程 - 從
.docx擷取文字時有提到pandoc
如果你的環境無法執行 Python 腳本或 LibreOffice，docx 在概念上仍可能有參考價值，但內建工作流程的便利性會大打折扣。
典型工作流程：檢查、編輯、重建
常見的 docx 工作流程如下：
- 如有需要，先將舊版
.doc檔轉換為.docx。 - 將
.docx封存檔解開到工作目錄。 - 編輯解出的 XML 與相關資產。
- 視需求加入註解或處理修訂標記。
- 將目錄重新封裝成新的
.docx。 - 驗證重建後的文件。
這種方式特別適合可重複執行的文件轉換流程，尤其是在精準度比在 Word 內互動式編輯更重要的情況下。
先轉換舊版 .doc 檔
skill 文件明確指出，舊版 .doc 檔應在編輯前先完成轉換。文件中的指令如下：
python scripts/office/soffice.py --headless --convert-to docx document.doc
如果你收到的是較舊的 Word 二進位檔，而不是現代的 .docx，這個轉換步驟對穩定工作流程很重要。
讀取文件內容
在文件讀取與分析方面，repository 指出兩種實用作法：
- 若你想擷取文字內容，可使用
pandoc，也包含追蹤修訂的處理情境 - 若你需要直接存取原始 XML，則可將文件解開
這讓 docx 同時適合做內容分析與結構導向的編輯。
解開 Word 文件以便編輯
解包腳本是整個編輯流程的基礎。它會擷取 Office 封存內容、將 XML 格式化輸出，並且在 DOCX 情境下可選擇合併相鄰 runs，或簡化追蹤修訂。
repository 中常見的使用方式是：
python unpack.py document.docx unpacked/
實際腳本檔案是 scripts/office/unpack.py，因此在實務上你通常會從該位置執行，或依你的環境調整使用方式。
謹慎編輯 XML
解開後，你會直接操作目錄中的 WordprocessingML 檔案。這特別適合以下受控變更：
- 在已知 XML 位置取代文字
- 調整文件中繼資料或結構
- 插入註解參照
- 為後續產生流程準備乾淨的封裝內容
這很適合自動化工程師與 agent 工作流程，但若是非技術使用者偶爾一次性的手動修改，就沒那麼理想。
在 DOCX 封裝中加入註解
repository 內含 scripts/comment.py，可用來替已解開的 DOCX 內容加入註解。腳本文件顯示，除了新增註解外，也能透過父註解參照附加回覆。
根據原始內容，有一個實務細節必須注意：註解文字需要先做 XML escape，且註解標記也必須正確放入 document.xml。這表示 docx 很適合程式化的審閱流程，但也要求你細心處理 Word XML 的慣例。
接受追蹤修訂
如果你需要取得審閱後的乾淨版本，scripts/accept_changes.py 就是設計來透過 LibreOffice 接受所有追蹤修訂的。原始內容也明確指出，這項功能需要 LibreOffice。
這是安裝 docx 時相當值得評估的一點：如果你的工作流程仰賴處理追蹤修訂，內附腳本可提供自動化路徑，不必再手動到 Word 裡逐一接受。
重新封裝並驗證最終檔案
編輯完成後，可用 scripts/office/pack.py 重建 Office 檔案。根據原始內容，它支援驗證、自動修復、壓縮 XML 格式，並輸出 .docx、.pptx 或 .xlsx 封裝檔。
對 Word 工作流程來說，最大的價值在於：即使你直接編輯過 XML，仍能產出有效的 .docx。驗證功能特別重要，因為 Office 檔在手動修改封裝後，很可能以不易察覺的方式出現錯誤。
環境與 sandbox 注意事項
scripts/office/soffice.py 內含輔助邏輯，可在 AF_UNIX sockets 可能受限的環境中執行 LibreOffice。若你是在容器、遠端 sandbox 或 VM 型自動化環境中跑文件流程，這會是很實用的實作細節。
簡單來說，docx 不只是提供文件編輯指令；它也包含讓這些指令能在較難預測的執行環境中順利運作的操作工具。
團隊最適合的使用情境
當你的團隊需要以下能力時，docx skill 會非常合適：
- 可重複執行的 Word 文件產生或清理流程
- 自動化審閱與註解插入
- 一般 Office 腳本不易乾淨處理的 XML 層級轉換
- 交付給客戶或內部利害關係人前的驗證
- 將舊版
.doc資產遷移到現代.docx工作流程
什麼情況下你可能會選擇其他方案
若有以下需求，你可能會想考慮其他工具：
- 你只需要簡單匯出文字，並不在乎 Word 原生格式保真度
- 使用者大多會直接在 Word 互動編輯，而不是透過自動化流程
- 你需要的是完全開放、可再散布的函式庫式工作流程，而不是以 skill 為核心的素材
- 你的環境無法支援 Python 與 LibreOffice 這組工具鏈
FAQ
docx skill 主要拿來做什麼？
docx 主要用於 Word .docx 工作流程，包括建立、讀取、編輯、驗證、加註解與轉換 Word 文件。當任務仰賴 Word 專屬結構，而不只是純文字內容時，它特別實用。
要怎麼安裝 docx skill？
可使用 npx skills add https://github.com/anthropics/skills --skill docx 安裝。安裝後，建議先查看 SKILL.md 與 scripts/ 底下的腳本，以了解支援的工作流程。
docx 支援舊版 .doc 檔嗎？
有，但屬於間接支援。repository 指引指出，舊版 .doc 檔應先轉成 .docx 再進行編輯，做法是使用以 LibreOffice 為基礎的 scripts/office/soffice.py 工作流程。
docx 可以處理追蹤修訂嗎？
可以。repository 內容顯示它支援與追蹤修訂相關的工作流程。scripts/accept_changes.py 可透過 LibreOffice 接受追蹤修訂，而解包流程也能簡化 DOCX 檔中的相鄰追蹤修訂。
我可以用 docx skill 加入註解嗎？
可以。scripts/comment.py 就是專門用來替 DOCX 文件加入註解的，也支援回覆關係。這是此 skill 提供的 Word 審閱功能中最明確的一項。
docx 會在編輯後驗證文件嗎？
會。repository 在 scripts/office/validate.py 與 scripts/office/validators/ 中提供了驗證邏輯。重建檔案時的 pack 流程也支援驗證。
docx 只適用於 Word 檔嗎？
docx skill 的核心是 Word，但 scripts/office/ 底下部分輔助腳本也支援 .pptx 與 .xlsx 的封裝與驗證。不過若從安裝評估角度來看，docx 的主要價值仍然是 DOCX 文件處理。
docx 適合非技術使用者嗎？
通常不太適合作為主要編輯工具。docx 更適合技術型、agent 輔助或高度自動化的工作流程，因為它依賴 Office 檔解包、XML 編輯與重新封裝。如果只是想快速手動修改，直接用 Word 往往更簡單。
我應該先看 repository 裡的哪些內容？
建議先從 SKILL.md 開始，再查看 scripts/office/unpack.py、scripts/office/pack.py、scripts/comment.py、scripts/accept_changes.py 與驗證模組。這能幫助你更實際地判斷 docx skill 是否符合你的工作流程與執行環境。