前言¶
用 AI 寫報告、備忘錄、合同模板時，常見結果是 Markdown 或純文本——排版、頁眉頁腳、目錄、修訂批註這些 Word 裏才用得上的能力，往往得自己再手工整理一遍。Anthropic 在 GitHub 開源參考倉庫 anthropics/skills 裏放出了 docx Skill：它正是 Claude 產品裏「創建與編輯文件」能力背後、面向 Word 文檔（.docx / .dotx）的那套生產級實現。把整份 Skill 目錄（SKILL.md 指令 + 輔助腳本 + 模板資源）裝進 Cursor、Claude Code 等支持 Agent Skills 的工具後，Agent 不再只會「描述怎麼寫 Word」，而是按統一流程去創建、讀取、編輯和校驗真實文檔。
這是什麼¶
docx 是 Anthropic 維護的 Agent Skill，官方目錄：
https://github.com/anthropics/skills/tree/main/skills/docx
它在 SKILL.md 的 YAML 前言裏寫清了觸發條件：只要用戶提到 Word 文檔、.docx、.dotx，或需要帶目錄、標題層級、頁碼、信箋頭、修訂批註、批註評論、圖片替換、查找替換等格式的交付物（報告、備忘錄、信件、模板等），Agent 就應啓用該 Skill。PDF、電子表格、Google Docs 等不在其範圍內。
與倉庫裏多數 Apache 2.0 示例 Skill 不同，docx 屬於 source-available（源碼可參考，許可見目錄內 LICENSE.txt，爲 Proprietary），Anthropic 在 README 中說明：它與 pdf、pptx、xlsx 等 Skill 一起，支撐了 Claude 創建與編輯文件 的產品能力。對開發者而言，它的價值不只是「能寫 docx」，更是 複雜 Skill 如何打包腳本與多文件資源 的公開樣板。
核心功能與亮點¶
docx Skill 把 Word 當作「ZIP 包裏的 XML」來分工處理，官方 SKILL.md 用一張表概括三種主路徑：
| 任務 | 推薦方式 |
|---|---|
| 新建文檔 | 用 docx（npm，即 docx-js）寫腳本生成 |
| 編輯已有文檔 | unzip → 改 word/document.xml → 再 zip 打包（docx-js 無法打開已有文件） |
| 讀取內容 | pandoc -t markdown file.docx |
在此基礎上，Skill 還 bundled 了一整套 Python 輔助腳本（均在 Skill 目錄的 scripts/ 下，路徑相對該目錄解析），覆蓋生產環境常見需求：
- 版式與結構：目錄（TOC）需用內置
HeadingLevel.*；表格列寬、列表編號、分頁、圖片插入等，SKILL.md 列出了 docx-js 的若干「踩坑點」（如默認 A4、表格需雙寬度、不能用字面量\n換行等）。 - 修訂與批註：支持 tracked changes（
w:ins/w:del）的編寫與校驗；accept_changes.py可生成接受全部修訂後的乾淨副本；comment.py可寫入跨六個 XML 文件關聯的評論，並輸出需插入document.xml的錨點片段。 - 編輯已有 docx 的穩健流程：
merge_runs.py合併 Word 拆散的文本 run，便於查找替換；scripts/office/validate.py做 XSD 校驗與常見修復；舊版.doc可先經 LibreOffice 轉成 docx。 - 輸出驗收：生成後可用 LibreOffice 轉 PDF，再用
pdftoppm出圖，讓 Agent 目視檢查排版是否正確。
依賴方面，官方列出的工具有：docx（npm，環境預裝，僅 require 失敗時再 npm install docx）、pandoc、LibreOffice（soffice）、pdftoppm（Poppler）。
安裝與啓用¶
Agent Skills 基於通用 SKILL.md 格式，可在 Cursor、Claude Code、Claude.ai、Claude API 等環境中使用；各工具的安裝入口略有不同，以下均來自 Anthropic 官方倉庫說明。
Cursor（項目級）¶
將 docx 整個文件夾放到項目的 .cursor/skills/docx/（或用戶級 ~/.cursor/skills/docx/）。Cursor 啓動 Agent 時會自動發現；也可在 Agent 對話裏用 /docx 手動喚起。一種常見做法是從官方倉庫拷貝：
git clone --depth 1 https://github.com/anthropics/skills.git /tmp/anthropics-skills
cp -r /tmp/anthropics-skills/skills/docx .cursor/skills/docx
注意：必須保留 SKILL.md 與同級的 scripts/、LICENSE.txt 等完整目錄結構，腳本路徑在 Skill 內是相對引用。
Claude Code¶
在 Claude Code 中可將 anthropics/skills 註冊爲插件市場，並安裝文檔類 Skill 集合：
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
安裝後直接在對話中說明需求即可，例如：「用 docx skill 把這份大綱做成帶目錄的 Word 報告」。
Claude.ai 與 Claude API¶
Anthropic 說明：倉庫中的示例 Skill 對已付費 Claude.ai 計劃大多已內置可用；自定義 Skill 的上傳方式見 Using skills in Claude。通過 API 使用預置或自定義 Skill，可參考 Skills API Quickstart。
典型用法示例¶
以下命令與流程均摘自官方 SKILL.md，路徑相對於 Skill 目錄下的 scripts/。
1. 讀取現有 Word 內容
pandoc -t markdown contract.docx
2. 編輯已有 docx（解壓—改 XML—打包—校驗）
unzip -q doc.docx -d unpacked/
find unpacked -type l -delete
python scripts/merge_runs.py unpacked/
# 就地編輯 unpacked/word/document.xml，勿 pretty-print
(cd unpacked && rm -f ../out.docx && zip -Xr ../out.docx .)
python scripts/office/validate.py out.docx --original doc.docx
若涉及修訂批註，校驗時可加 --author "Your Name"，確保改動都包在 tracked change 標記內。
3. 添加評論
python scripts/comment.py unpacked/ "Fees & expenses cap is too low"
python scripts/comment.py contract.docx "This cap is too low" -o annotated.docx
腳本會寫好評論相關 XML，並打印需插入 document.xml 的錨點代碼；錨點未放置前，評論在文檔中不可見。
4. 生成後目視驗收
python scripts/office/soffice.py --headless --convert-to pdf output.docx
pdftoppm -jpeg -r 100 output.pdf page
5. 在 Cursor 裏向 Agent 提需求（提示詞示例）
請使用 docx skill，根據附件大綱生成一份 US Letter 尺寸的 Word 備忘錄，
包含一級/二級標題、自動目錄、頁腳頁碼；生成後用 PDF 預覽檢查排版。
Agent 會按 Skill 內指令選擇 docx-js 建稿或解壓編輯，並調用 bundled 腳本做校驗。
適用場景與注意事項¶
適合誰、什麼場景
- 需要 AI 直接產出 可下載、可協作的 .docx，而非 Markdown 預覽。
- 法務、商務、學術寫作中涉及 修訂模式、批註、模板（.dotx） 的文檔流水線。
- 團隊希望參考 Anthropic 生產級 Skill 目錄佈局（指令 + 腳本 + 校驗 + 許可證），自建企業文檔類 Skill。
限制與注意
- 許可：docx 爲 source-available，非 Apache 2.0；商用或二次分發前請閱讀
LICENSE.txt。 - 環境與依賴：LibreOffice、pandoc、Poppler 等需在 Agent 可執行的沙箱/本機環境中可用；僅拷貝
SKILL.md而不帶scripts/會丟失大半能力。 - docx-js 邊界：只能 創建 新文檔，不能 打開已有 docx 再改；編輯舊文件必須走 unzip/XML 路徑。
- 官方免責聲明：倉庫 README 指出，Claude 產品中的實際行爲可能與參考 Skill 存在差異，關鍵任務應在自有環境充分測試。
小結¶
docx Skill 把「AI 寫 Word」從聊天裏的文字描述，拉到了可腳本化、可校驗、可修訂的生產流程。對 Cursor 等工具的開發者來說，它既是即用的文檔能力包，也是學習 如何把複雜領域知識封裝進 Agent Skill 的公開範本。官方目錄與 Claude 文件能力介紹：
- Skill 源碼：https://github.com/anthropics/skills/tree/main/skills/docx
- Claude 創建文件：https://www.anthropic.com/news/create-files
