Overview
docx skill 能做什么
docx skill 面向完整的 Microsoft Word .docx 工作流而设计。它适合这样的场景：你需要创建、读取、编辑、分析、验证、添加批注或重新打包 Word 文档，而不只是生成纯文本。
仓库中的内容展示了一套基于 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 文件本质上是一个 ZIP 压缩包，里面包含 XML 和相关资源。仓库中包含如下脚本：
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 仓库安装 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 的实际工作路径，也是评估是否值得安装的最佳起点。
决定采用前先确认前置条件
根据仓库内容，可以确认有以下几项实际依赖和前提：
- 运行附带脚本需要 Python
- 某些操作需要 LibreOffice
soffice，包括接受修订脚本以及.doc到.docx的转换流程 - 文档中提到了使用
pandoc从.docx中提取文本
如果你的环境无法运行 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，那么这一步转换对稳定工作流非常重要。
读取文档内容
在文档读取和分析方面，仓库指出了两种实用方案：
- 当你需要提取文本时，使用
pandoc，其中也包括对修订的处理 - 当你需要访问原始 XML 时，直接解包文档
这使得 docx 既适合内容分析，也适合感知结构的编辑场景。
解包 Word 文档以便编辑
解包脚本是整个编辑工作流的基础。它会提取 Office 压缩包、对 XML 文件进行格式化输出，并且对于 DOCX 还可以选择合并相邻 runs 或简化修订。
仓库中给出的典型用法是：
python unpack.py document.docx unpacked/
实际脚本文件位于 scripts/office/unpack.py，因此在实际使用中，你通常会从该位置运行它，或根据自己的环境进行调整。
谨慎编辑 XML
解包后，你将直接处理提取目录中的 WordprocessingML 文件。这种方式最适合受控修改，例如：
- 在已知 XML 位置替换文本
- 调整文档元数据或结构
- 插入批注引用
- 为下游生成准备一个清理过的文档包
这非常适合自动化工程师和 agent 工作流，但对于非技术用户临时做一次性编辑就不太理想。
向 DOCX 文档包添加批注
仓库提供了 scripts/comment.py，用于向已解包的 DOCX 内容中添加批注。脚本文档显示，不仅可以添加批注，还可以通过父批注引用附加回复。
源码支持的一个实际细节是：批注文本必须进行 XML 转义，并且批注标记也必须正确写入 document.xml。这意味着 docx 适合程序化审阅工作流，但前提是要谨慎处理 Word XML 的约定。
接受修订
如果你需要一个已审阅 Word 文档的干净版本，scripts/accept_changes.py 用于借助 LibreOffice 接受所有修订。源码中已明确说明此功能需要 LibreOffice。
这也是安装 docx 时很有价值的考量点之一：如果你的工作流依赖修订处理，附带脚本可以提供自动化路径，而无需在 Word 中手动逐项接受。
重新打包并验证最终文件
修改完成后，scripts/office/pack.py 会重新构建 Office 文件。根据源码，它支持校验、自动修复、压缩 XML 格式输出，并生成 .docx、.pptx 或 .xlsx 文档包。
对于 Word 工作流来说，最大的价值在于：在直接修改 XML 之后，仍能生成有效的 .docx。之所以需要校验，是因为手动更改文档包后，Office 文件很容易出现一些不易察觉的问题。
环境与沙箱注意事项
scripts/office/soffice.py 包含辅助逻辑，用于在 AF_UNIX sockets 可能受限的环境中运行 LibreOffice。这一点在容器、远程沙箱或基于 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 文件吗？
支持，但不是直接编辑。仓库说明建议先将旧版 .doc 文件转换为 .docx，再通过基于 LibreOffice 的 scripts/office/soffice.py 工作流处理。
docx 可以处理修订吗？
可以。仓库内容显示它支持与修订相关的工作流。scripts/accept_changes.py 可借助 LibreOffice 接受修订，而解包流程也可以简化 DOCX 文件中相邻的修订内容。
我可以用 docx skill 添加批注吗？
可以。scripts/comment.py 就是专门用于向 DOCX 文档添加批注的，也支持回复关系。这是该 skill 提供的一个非常明确的 Word 审阅能力。
docx 会在编辑后验证文档吗？
会。仓库在 scripts/office/validate.py 和 scripts/office/validators/ 下提供了校验逻辑。重新打包流程本身也支持在重建文件时进行验证。
docx 只适用于 Word 文件吗？
docx skill 以 Word 为中心，但 scripts/office/ 下的一些辅助脚本也支持 .pptx 和 .xlsx 的打包与校验。不过从安装决策角度看，docx 的主要价值仍然在于 DOCX 文档处理。
docx 适合非技术用户吗？
通常不适合作为主要编辑工具。docx 更适合技术型、agent 辅助型或自动化密集型工作流，因为它依赖于解包 Office 文件、编辑 XML，然后重新打包。如果只是想快速手动改一下内容，直接用 Word 往往更简单。
我应该优先查看仓库里的哪些内容？
建议先看 SKILL.md，然后查看 scripts/office/unpack.py、scripts/office/pack.py、scripts/comment.py、scripts/accept_changes.py 以及各类校验模块。这样可以比较真实地判断 docx skill 是否符合你的工作流和运行环境。