前言¶

处理 Word 文档的自动化流程里，最常见的失败不是「读不到字」，而是改完之后样式跑了、编号重排了、修订和批注丢了。原因是 .docx 不是纯文本，它是一个 ZIP 包，里面装着 document.xml、styles.xml、numbering.xml、页眉页脚和关系文件，结构本身和可见文字一样重要。

下面介绍 Word Docx 1.02 这个 Skill。它把这类问题的处理原则写进了技能说明，让模型在生成、检查、修改 .docx 时按同一套规则走，而不是每次都凭感觉改 XML。

这是什么¶

Word Docx 1.02 是一个基于通用 SKILL.md 格式的 Agent Skill，坐标 @clawhub_cm1173710210/word-docx-1-02，版本 1.0.0，由 ClawHub 上的 cm1173710210 发布，属于 office-efficiency 分类。

它解决的问题是：当任务对象是 Word/.docx 文件，尤其是涉及修订、批注、页眉、编号、域、表格、模板或版面约束时，如何让模型做出结构正确、不会在来回编辑中漂移的改动。

上游仓库页面标注它是 @tonydesign1999/word-docx-1 的副本。该 Skill 不需要 API Key。

核心功能¶

官方简介给出的能力范围是：创建、检查和编辑 Microsoft Word 文档和 DOCX 文件，支持样式、编号、修订追踪、表格、分节及兼容性检查。

技能说明里明确列出的适用情形有三类：

1、任务对象是 Word 或 .docx 文件。
2、文件里包含修订、批注、域、表格、模板或版面约束。
3、文档需要在多次编辑往返后仍然保持格式稳定。

另外，技能把读取、生成、保存已审阅文档拆成三种不同的工作流：结构提取用于快速阅读，样式驱动生成用于新建文件，感知 OOXML 的编辑用于处理脆弱的既有文档。这一点比笼统的「支持 Word」更值得注意——它区分了任务类型，而不是用一种手法覆盖所有情况。

安装与启用¶

上游仓库给出的命令如下，在用户确认后执行：

openclaw skills install @cm1173710210/word-docx-1-02

技能说明的反馈部分还提到两个辅助命令：觉得有用可以 clawhub star word-docx，保持更新可以 clawhub sync。相关技能也可以用 clawhub install <slug> 安装。

SkillHub 页面上的安装入口显示为 CLI npx skills，与上游仓库的 openclaw skills 写法不同，以你实际使用的环境为准。官方页面没有给出 Cursor、Codex CLI 或 Claude Code 的独立启用方式，这里不展开。

典型用法¶

技能说明本身没有给出端到端的命令示例，它提供的是操作原则。下面摘录几条可以直接照做的。

读取类任务，先走结构保留的读取路径，再碰 OOXML：

1、把 .docx 当 OOXML 包看待，先确认 word/document.xml、styles.xml、numbering.xml、页眉页脚和关系文件的位置。
2、文字可能被拆在多个 run 里，不要假设一个词或一句话位于同一个 XML 节点。
3、Legacy 的 .doc 输入通常要先转换，才能信任现代 .docx 的假设。

生成类任务，优先用命名样式而不是直接格式化：

1、段落样式、字符样式和直接格式化的行为不同，优先命名样式，文档才保持可编辑。
2、编辑既有文件时，扩展它现有的样式体系，不要另造一套平行样式。
3、跨文档复制内容可能悄悄带入外来样式、主题设置和编号定义。

版面类任务，页边距、方向、页眉页脚和页码都是分节级行为：

1、同一文档内首页页眉、奇偶页页眉可以不同，改一个页眉不等于改好了全文档。
2、显式设置页面尺寸，因为 A4 和 US Letter 的默认值会改变分页和表格宽度。
3、版面变化用分节符，不要用手动空格和零散分页符，那通常会造成漂移。
4、页眉页脚里的图片走部件级关系，直接复用 ID 会破坏图片或链接。

修订和批注类任务，默认做最小替换：

1、开启修订时可见文字不等于文档全貌，插入、删除和批注都带着元数据。
2、屏幕上看不见的删除文字可能仍然存在于 XML 中。
3、目录、页码、日期、交叉引用和邮件合并占位符都是域，改域源时要谨慎，缓存的显示值在刷新前会滞后。
4、法律、学术或商务审阅文档，默认使用审阅式编辑，而不是整段重写，除非用户明确要求。

适用场景与注意¶

适合：需要在 Agent 流程里新建 Word 文档，或在既有 .docx 上做精确修改，尤其是有修订追踪、批注、页眉、编号、域、表格和分节约束的场景；也需要跨 Word、LibreOffice、Google Docs 保持版面稳定的场景。

要注意的坑，技能说明里列得比较具体：

1、复制粘贴会带入不需要的样式和编号定义。
2、页眉页脚图片使用部件级关系，盲目复用 ID 会弄坏它们。
3、用空段落充当间距会让模板变脆弱，间距应该放在段落设置里。
4、看起来干净的导出件，可能还藏着未解决的修订、批注或过期域值。
5、靠眼睛「重启」列表通常失败，因为编号状态在段落文字之外。
6、为了改一个分句而替换整段，常常破坏审阅质量、书签、批注或邻近的行内格式。
7、从段落或列表项删掉所有可见文字，仍可能留下空段落标记、空项目符号或不稳定的编号。
8、表格自动调整和百分比式宽度，在 Word 里看着可以接受，到了 Google Docs 或 LibreOffice 仍然可能漂移。
9、.docm 要当作带宏的高风险文件看待；.doc 是可能需要先转换的遗留输入。

交付前的检查建议：不要只跑文本校验。版面重要时，显式表格宽度比自动调整更安全；一个通过文本检查的文档，仍可能在收件人打开后出现分页、表格宽度或引用刷新的问题。

结尾¶

Word Docx 1.02 的价值不在多一个 Word 操作入口，而在它把 .docx 的结构约束写成了可执行规则，让模型在处理样式、编号、修订、页眉和表格时按同一套原则走，降低来回编辑中的格式漂移。如果你的流程里经常出现改完 Word 文档版面就乱的情况，可以按上面的原则试一遍。

官方地址：https://api.skillhub.cn/zcwl/word-docx-1-02
上游仓库：https://clawhub.ai/cm1173710210/word-docx-1-02