anthropic-docx 快速入门

Anthropic 官方 Word 文档 Skill,基于 python-docx,支持追踪修订(Redlining)、批量模板填充、复杂排版。

这是什么?解决什么问题?

anthropic-docx 是 Anthropic 在 anthropics/skills 仓库中维护的 Word 文档处理 Skill,基于 python-docx 库封装。它能做的远不止”AI 写一篇文章然后导出 docx”这么简单——还包括:模板填充(把 JSON 数据塞进合同模板批量生成)、追踪修订(Redlining,模拟律师改稿)、页眉页脚、表格样式、目录生成、批注、文档对比等。

对小白来说,这个 Skill 解决的是”AI 写的文字怎么变成公司能用的 Word 文档”。没有它,你只能让 AI 输出 Markdown 然后手动复制粘贴;有了它,AI 直接生成格式规范、可被法务/HR 直接用的 .docx 文件。

准备工作

• 支持 Agent:Claude Code(主推)、支持 Skills 协议的 Agent。
• 运行环境:Python 3.10+;pip install python-docx。
• 目标场景:合同批量生成、报告自动排版、模板填充、文档对比。
• 可选工具:LibreOffice(用于转换或预览)、Pandoc(多格式转换)。

3 步快速上手

第 1 步:安装依赖

pip install python-docx

克隆或拉取 Skill:

git clone https://github.com/anthropics/skills.git
cp -r skills/docx ~/.claude/skills/

第 2 步:在 Claude Code 中调用

claude

发起任务:

请用 docx Skill 帮我生成 10 份劳动合同,模板是 template.docx,员工信息在 employees.json。要求:每份合同自动填入员工姓名、岗位、薪资、合同期限。

AI 会读取模板、用 python-docx 填字段、循环生成 10 份独立的 .docx。

第 3 步:验证产物

# 用 LibreOffice 转 PDF 预览
libreoffice --headless --convert-to pdf contract-001.docx

或者直接用 Word 打开检查格式。

常见踩坑

1. python-docx 版本不匹配:老版本对 OOXML 支持不全,务必用 python-docx >= 1.0。
2. 中文字体丢失:生成的 docx 在 Windows 上正常,在 macOS 上字体变成宋体,需要在生成时显式指定中文字体(SimSun、Microsoft YaHei)。
3. 复杂表格崩溃:合并单元格、嵌套表格容易让 python-docx 抛异常,Skill 提供了示例代码,先看示例再改。
4. 追踪修订(Redlining)实现复杂:python-docx 本身不直接支持,Skill 封装了底层 XML 操作,需要信任 Skill 给的脚本而不是自己造。
5. 模板路径写死:模板路径在 prompt 里要明确是相对路径还是绝对路径,否则 Skill 找不到文件。
6. 批量任务内存爆掉:一次生成 1000 份 docx 时,Python 进程可能被吃满,Skill 建议分批处理。

初级用法

• 合同批量生成:模板 + JSON 数据,一次出 N 份。
• 周报自动排版:把 Markdown 周报转成符合公司模板的 docx。
• 报告合并:把多个 markdown 章节合并成一个目录完整的 docx 报告。

高级玩法

• 追踪修订模拟:Skill 支持”以另一作者身份插入修订痕迹”,适合 AI 模拟法务审稿。
• 条件渲染:模板里加 Jinja2 风格占位符,根据 JSON 字段值决定显示/隐藏某些段落。
• 批量加水印:给所有生成的 docx 加公司 logo 水印,作为版权保护。

小技巧

• 模板设计时多用”内容控件”而不是普通文本框,Skill 填充时更稳。
• 复杂模板先用一份样例数据跑通,再批量铺数据。
• 中文字体相关问题,在 ~/.config/matplotlib 之前先解决 docx 的字体问题,优先级更高。
• 生成的 docx 用 LibreOffice 转 PDF 可以跨平台预览,避免发给同事后格式乱。
• 不要试图用 python-docx 实现”公式编辑器”,太复杂,先转成图片插入。

常见问题 FAQ

Q1: 这个 Skill 跟 anthropic-docx 有什么关系?必须装吗?

A: Skill 是给 AI Agent 用的”技能包”,能告诉 Agent 怎么按特定规范工作。不是必须装——如果你的项目规模小、要求不高,不装也能用。但装上能让 Agent 输出的质量更高、更符合最佳实践,推荐装。

Q2: 这个 Skill 适合哪些 AI Agent?Cursor?Claude Code?其他?

A: anthropic-docx 来自 Anthropic,主要面向支持 Skill 机制的 Agent。常见兼容 Agent 包括 Claude Code、Cursor、OpenCode、Windsurf 等。具体兼容性请查 Skill 官方文档。

Q3: 装了这个 Skill 后,会拖慢 Agent 响应吗?

A: 会的——Skill 通常会增加 prompt 长度,导致响应变慢、token 消耗增加。但质量提升明显。建议:1) 只装项目必需的 Skill;2) 用 Skill 启动/加载/卸载机制按需加载;3) 定期清理不用的 Skill。

Q4: 怎么验证 Skill 装对了?

A: 在 Agent 中输入”列出已加载的 Skill”或类似命令。如果 Skill 出现在列表里,说明装对了。然后用 Skill 跑一个相关任务,看输出是否符合 Skill 规范。

Q5: 这个 Skill 有许可证吗?能商用吗?

A: 取决于 anthropic-docx 的许可证。常见许可证包括 MIT(完全自由)、Apache-2.0(自由但有专利条款)、源可用(可看不能用)、GPL(强开源)。商用前请查仓库 LICENSE 文件。

参考链接

• 官方仓库:https://github.com/anthropics/skills
• 该 Skill 目录:https://github.com/anthropics/skills/tree/main/skills/docx
• python-docx 文档:https://python-docx.readthedocs.io/
• 模板示例:https://github.com/anthropics/skills/tree/main/skills/docx/examples
• 微软 OOXML 规范:https://learn.microsoft.com/en-us/openspecs/office_standards/ms-docx/
• LibreOffice 下载:https://www.libreoffice.org/

docx 处理的实际价值

对个人开发者来说,docx 处理的最大价值是”批量生成结构化文档”。常见的应用场景:批量生成员工合同(从员工信息 JSON + 公司模板)、批量生成发票(从订单数据 + 发票模板)、批量生成证书(从名单 + 证书模板)、批量生成通知书(从学校数据 + 录取通知书模板)等。

对法律和金融从业者,价值在于”模板填充 + 追踪修订”,可以快速完成大量标准化文书的初稿,再人工微调。对 HR 来说,价值在于”批量生成 offer、入职材料、转正材料”。

Anthropic 官方 docx Skill 之所以评分高达 9.0,就是因为它把”AI 写文字 + 模板填充 + 排版样式 + 修订痕迹”这一整条链路打通了,真正做到”AI 一句话,Word 文件出来”。

进一步阅读

• python-docx 官方文档(https://python-docx.readthedocs.io/) 是必读,讲清 OOXML 结构的封装。
• 微软 OOXML 规范(https://learn.microsoft.com/en-us/openspecs/office_standards/ms-docx/) 解释 docx 文件的底层格式。
• LibreOffice(https://www.libreoffice.org/) 是开源的 Office 套件,可作为兼容性测试工具。
• python-docx-template(https://docxtpl.readthedocs.io/) 是 docx 的 Jinja2 模板引擎,Skill 内部可能用到。
• 模板示例(https://github.com/anthropics/skills/tree/main/skills/docx/examples) 里有大量可参考的真实案例。

实战建议

1. 合同批量生成:模板 + JSON 数据,一次出 N 份不同员工的合同。
2. 周报/月报自动排版:把 Markdown 周报转成符合公司模板的 docx,邮件发送。
3. 报告合并:把多个 markdown 章节合并成一个目录完整的 docx 报告。
4. 追踪修订模拟:Skill 支持”以另一作者身份插入修订痕迹”,适合 AI 模拟法务审稿。
5. 条件渲染:模板里加 Jinja2 风格占位符,根据 JSON 字段值决定显示/隐藏某些段落。
6. 批量加水印:给所有生成的 docx 加公司 logo 水印,作为版权保护。

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。