评分明细
适用场景
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 打开检查格式。
常见踩坑
- python-docx 版本不匹配:老版本对 OOXML 支持不全,务必用
python-docx >= 1.0。 - 中文字体丢失:生成的 docx 在 Windows 上正常,在 macOS 上字体变成宋体,需要在生成时显式指定中文字体(
SimSun、Microsoft YaHei)。 - 复杂表格崩溃:合并单元格、嵌套表格容易让 python-docx 抛异常,Skill 提供了示例代码,先看示例再改。
- 追踪修订(Redlining)实现复杂:python-docx 本身不直接支持,Skill 封装了底层 XML 操作,需要信任 Skill 给的脚本而不是自己造。
- 模板路径写死:模板路径在 prompt 里要明确是相对路径还是绝对路径,否则 Skill 找不到文件。
- 批量任务内存爆掉:一次生成 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 文件。
参考链接
docx Skill 多维度简评
来源:anthropics/skills(官方) 类别:文档处理 / Word 文档
说明:本文基于官方文档和公开资料整理,未经 MagicNetWorld 实测。
一、核心定位与价值
docx Skill 是 Anthropic 官方 4 个文档处理 Skills(PDF/XLSX/PPTX/DOCX)之一,覆盖 Word 文档的创建、读取、编辑、操作全套能力。Word 是商务、合同、技术方案的事实标准格式,该 Skill 解决了 AI 自动生成规范化文档的核心需求。
技术实现基于对 .docx 文件格式的理解:.docx 本质是一个 ZIP 压缩包,内含 XML 文件,可通过编程方式精确控制。
二、核心能力清单
| 操作 | 实现方式 | 适用场景 |
|---|---|---|
| 创建文档 | python-docx / docx-js | 报告、合同、方案生成 |
| 读取文档 | pandoc / XML 解析 | 提取内容、结构分析 |
| 编辑文档 | XML 解包→编辑→重新打包 | 修改、插入、替换 |
| TOC(目录) | 自动生成 | 长篇文档 |
| 样式排版 | 字体、字号、颜色控制 | 格式统一 |
| 页眉页脚 | 模板配置 | 公司模板应用 |
| 修订批注 | tracked changes | 合同 Redlining |
| 模板填充 | 变量替换 | 批量生成合同 |
| 图片插入 | 支持 Logo、图表 | 报告美化 |
三、10 大实战场景
场景 1:会议纪要生成
生成项目周会纪要,包含:会议基本信息、上周任务完成情况表格、本周议题、决议事项(责任人+截止日期)、下周计划。
场景 2:技术方案文档
生成系统技术方案:需求概述、技术选型对比表、系统架构描述、接口定义、部署方案。
场景 3:Markdown → Word
将 Markdown 笔记转为 Word 文档,保留标题层级、代码块、表格样式。
场景 4:合同 Redlining
使用追踪修订功能审阅合同:修改条款、删除冗余内容、添加批注。
场景 5:批量合同生成
合同模板 + Excel 客户数据 → 批量生成填写完毕的合同。
场景 6:格式统一
统一文档格式:正文字体字号、标题样式、行距、首行缩进。
场景 7:样式提取 + 应用
参考公司模板样式,为新文档应用一致的排版。
场景 8:内容提取
提取 Word 文档的标题、表格、图片位置,整理为 Markdown。
场景 9:报告生成
基于数据分析结果生成正式 Word 报告(封面、目录、章节、图表)。
场景 10:跨格式转换
Word → PDF 带密码保护(结合 pdf Skill 链式调用)。
四、关键技巧
- 描述结构:列出具体章节(“需求概述、技术选型、接口定义”),而非笼统说”写份报告”
- 提供模板:丢入公司 .docx 模板让风格统一
- 明确样式要求:字体、字号、行距、缩进都要具体
- 链式调用:xlsx 提取数据 → docx 生成报告 → pdf 加密分发
五、安装与限制
安装
# Claude Code
/plugin install document-skills@anthropic-agent-skills
# 通用
npx skills add anthropics/skills --skill docx
限制
| 限制 | 说明 |
|---|---|
| 复杂排版 | 多栏、艺术字可能不完全保留 |
| 嵌入对象 | Excel 嵌入图表可能不完美 |
| 旧版 .doc | 需先转换为 .docx |
| 宏(VBA) | 安全考虑不支持 |
六、总结
核心价值:完整 Word 文档能力(不只读文本)、模板填充批量生成、Redlining 支持。
适用人群:所有需要生成规范化 Word 文档的用户。
投入产出比:⭐⭐⭐⭐⭐——必装。
参考资料
- Anthropic Skills 官方仓库 — GitHub
- docx Skill 详情 (SkillsMP) — 官方 Skill 文档
- Agent Skills 开放规范 — 官方网站
- Anthropic Official Skills Complete Guide — 技术文章
- Anthropic Skills Research — 研究分析
- python-docx 文档 — 官方文档
📊 评分与标签
评分说明
总分 8.4/10 · P_优选
📊 可观测社区指标(数据核验日期:2026-07-07)
- GitHub: anthropics/skills ★159k, 🔱18.8k, Issues 281, PRs 730, 43 Commits
- 页面访问核验:Apache 2.0 许可,最新 commit last week
- 许可证: Apache 2.0
📦 可安装性 2.4/2.5
git clone https://github.com/anthropics/skills克隆后将 skills/docx 软链到 Skills 目录,或通过 Claude Code 插件一键安装。依赖 Python 3.8+ 和 python-docx 库(pip install python-docx),首次安装需 2-3 分钟。Skill 含完整的 Word 文档对象模型操作指南,支持追踪修订、样式模板、页眉页脚等高级功能。- 竞品对比 1:python-docx 直接
pip install更轻量,但缺少 AI 辅助的文档对象模型操作指南 - 竞品对比 2:python-docx-template 专注 Jinja2 模板填充,功能覆盖不如本 Skill 全面(缺少追踪修订、目录生成等)
- 来源:docxtpl 文档
🎯 实用性 2.2/2.5
- Anthropic 官方 Word 文档 Skill,基于 python-docx 实现全功能 Word 操作:创建新文档、段落/表格/图片插入、样式模板应用(标题/正文/引用)、页眉页脚设置、目录生成、追踪修订(Redlining)模拟、邮件合并批量填充。适合自动生成合同/报告/标书等正式文档,输出 .docx 格式与原 Office 完全兼容。
- 竞品对比 1:Pandoc 支持 Markdown→docx 转换但无模板填充、追踪修订等高级功能
- 来源:Pandoc
- 竞品对比 2:LibreOffice UNO API 功能最全但编程复杂度高、AI 难以直接操控
📖 文档质量 1.5/2.0
- SKILL.md 含 python-docx 完整 API 速查表(段落/样式/表格/图片/修订),提供 5+ 种常见文档模板(报告/合同/信件/简历/发票)。README 含安装依赖和基础示例代码,GitHub Issues 含中文文档兼容性问题解决。缺少复杂排版(多栏/文本框)和公式编辑的详细文档。
- 竞品对比 1:python-docx 官方文档 API 更详尽但仅面向开发者,无模板示例
- 竞品对比 2:python-docx-template 文档深度一般,主要覆盖模板语法
- 来源:docxtpl 文档
👥 社区活跃 1.5/1.5
- GitHub 159k Stars(anthropics/skills 仓库),Anthropic 官方持续维护。docx 是文档处理类最受欢迎 Skill 之一,对企业用户价值极高。Apache 2.0 许可证,社区 PR 和 Issue 活跃(281 Issues / 730 PRs)。
- 竞品对比 1:python-docx(★4.8k)社区体量远小于本 Skill 所属仓库
- 来源:python-docx
- 竞品对比 2:python-docx-template(★2k)社区更小,专注模板场景
- 来源:docxtpl
🔗 兼容性 0.8/1.5
- 基于 Python + python-docx 运行,兼容 Claude Code、Cursor、OpenCode 等所有 Agent Skills 标准工具。输出标准 .docx 格式可被 Microsoft Word/WPS/LibreOffice 直接打开,Apache 2.0 许可自由商用。需 AI Agent 具备 Python 代码执行环境。
- 竞品对比 1:LibreOffice UNO 跨平台兼容性最好但需安装完整 Office 套件
- 来源:LibreOffice
- 竞品对比 2:Google Docs API 兼容性好但需网络连接和 Google 账号
评分依据可追溯至公开来源,每项分数均有明确理由和数据支撑。
🏷️ 标签说明
- 免费: 核心功能完全免费,Apache 2.0 开源许可,无强制付费墙。来源:anthropics/skills
- 文档: 提供 Word 文档自动生成、处理和格式管理。来源:skills/docx
- Anthropic: Anthropic 官方产物,Claude 生态核心工具。来源:anthropics/skills
📋 来源与核验记录
- ✅ 已核验: anthropics/skills(★159k / 🔱18.8k / Issues 281 / PRs 730 / 43 Commits,Apache 2.0 许可,最新 commit last week)
- ✅ 已核验: Apache 2.0 LICENSE(确认开源许可证)
- ⚠️ 间接来源: 竞品对比数据来自竞品官方网站及公开文档
- ❌ 已删除死链: 无