前言¶
在自动化办公里，Word 文档往往是「看起来简单、改起来麻烦」的一类产物：列表会莫名重编号，页眉页脚和分节一碰就乱，带修订和批注的文件更不能当成纯文本去替换。用脚本硬拼 XML 或只做全文替换，经常在 Word、LibreOffice、Google Docs 之间来回打开后出现版式漂移。
下面介绍 SkillHub 上的 Word / DOCX 技能（坐标 @clawhub_ivangdavila/word-docx，SkillHub 页面常称「创建、检查、编辑」类能力）。它把 DOCX 当作 OOXML 包来理解与操作，引导 Agent 在创建、检查、编辑时兼顾样式、编号、修订与兼容性，而不是只改可见文字。
这是什么¶
Word / DOCX 是一条面向 Microsoft Word 与 .docx 的 Agent Skill，当前版本 1.0.2，分类为 office-efficiency，发布者为 ivangdavila，来源为 clawhub，上游说明见 ClawHub。SkillHub 收录页：Word / DOCX。官方入口：https://api.skillhub.cn/zcwl/word-docx。
简介中的定位是：创建、检查和编辑 Microsoft Word 文档及 DOCX 文件，并覆盖样式、编号、修订记录、表格、分节符及兼容性检查等场景。标签标明 requires_api_key=false，不依赖额外 API Key。
核心功能¶
以下能力均来自 SkillHub 与 ClawHub 上的官方描述，可按任务类型理解分工：
- 创建与生成：按样式体系生成新文档，优先命名样式而非堆叠直接格式，便于后续人工编辑。
- 检查与阅读：把
.docx视为 ZIP 内的 XML 部件（如word/document.xml、styles.xml、numbering.xml及页眉页脚关系），在「只读、提取、审阅」场景下先走结构保留路径，再决定是否深入改 OOXML。 - 编辑现有文件：针对已有文档做 OOXML 感知编辑，强调往返编辑后尽量不产生格式漂移；对带修订、批注、域、表格、模板或分页约束的文件尤其适用。
- 样式与编号：区分段落样式、字符样式与直接格式；列表依赖 Word 编号定义（
abstractNum、num等），而非粘贴 Unicode 项目符号。 - 版式与分节：页边距、方向、页眉页脚、页码等按分节处理；需要改版式时用分节符，而非用空段落撑版面。
- 修订、批注与域：在启用修订时区分插入、删除与批注元数据；目录、页码、交叉引用等按域处理，并注意缓存显示值刷新。
- 兼容性检查：在交付前考虑 Word、LibreOffice、Google Docs 及转换工具之间的往返差异；对
.docm、遗留.doc等格式有相应风险提示。
ClawHub 页还列出关联技能（需用户确认后再装）：documents（通用文档与转换）、brief（简洁商务写作）、article（长文结构与起草）。
安装与启用¶
通过 SkillHub（国内收录）¶
SkillHub 页面给出的安装方式是：让 Agent 依照 SkillHub 安装说明 安装坐标 @clawhub_ivangdavila/word-docx。
若本机已有 skillhub CLI，安装时需用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。Cursor 常用目录示例：
command -v skillhub && skillhub --version
skillhub install clawhub_ivangdavila/word-docx --dir ~/.cursor/skills/
未安装 CLI 时，可按 SkillHub 文档执行一键安装（完整或仅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
通过 ClawHub / OpenClaw 上游¶
上游 ClawHub 提供的安装命令为：
openclaw skills install @ivangdavila/word-docx
坐标在 SkillHub 侧为 @clawhub_ivangdavila/word-docx，在 clawhub 源为 @ivangdavila/word-docx，安装时以你当前使用的商店与 CLI 为准。
安装完成后，在对话中明确任务与 .docx 路径，并说明是否涉及修订、批注、域或版式约束，便于 Skill 内的工作流生效。
典型用法¶
官方「When to Use」的触发条件可以概括为：
- 主要交付物是 Word 或
.docx； - 文件包含修订、批注、页眉页脚、编号、域、表格、模板或分页限制；
- 需要在多次打开、编辑后仍保持版式与审阅信息稳定。
结合 Skill 正文，常见操作顺序可以是：
- 判定任务类型：新建文档、只读提取/审阅，还是在已有审阅稿上做最小改动——三类工作流不同，不宜混用「整段重写」。
- 读取 fragile 文档：先结构化提取或检查包内部件，再改 OOXML；勿假设一个词对应一个 XML 节点（文字可能分布在多个 run 中）。
- 改列表与样式：改编号定义与段落编号属性，而不是手工「看起来对齐」；跨文档粘贴时注意外来样式与编号定义被一并导入。
- 改版式：在分节级别调整页边距、页眉页脚；表格宽度与页面宽度、边距相关，复杂表格建议显式宽度而非完全依赖各编辑器对 auto-fit 的解释。
- 审阅场景：默认做 span 级替换，避免整段重写导致修订噪音、书签或批注锚点错位；法律、学术、商务审阅稿尤其如此。
- 交付前：在目标环境（或等价编辑器）中检查分页、表格、域刷新与交叉引用，避免「文本对了、打开后版式变了」。
上述步骤是 Skill 内建的最佳实践摘要，具体实现由 Agent 在启用该 Skill 后按 SKILL.md 指引执行。
适用场景与注意¶
适合谁
- 需要 Agent 生成或维护正式 Word 模板、报告、合同审阅稿的团队；
- 自动化流水线里要把 Markdown/数据填进 DOCX，且要求样式、多级列表、分节页眉可维护；
- 要在保留修订、批注、域的前提下做局部修改，而不是全文替换。
限制与常见坑（来自官方 Common Traps，安装前宜知晓）
- 复制粘贴易带入多余样式与编号定义；页眉页脚图片依赖部件关系，盲目复用 ID 会断链。
- 用空段落当间距会让模板脆弱；列表「肉眼重启」往往失败，因为编号状态不在可见文字里。
- 删光段落文字仍可能留下空段标记或不稳定列表项；表格在各编辑器间可能对 auto-fit、百分比宽度解释不一致。
- 兼容模式可能限制新特性；改页面尺寸或默认边距会牵动目录、脚注与交叉引用。
- 遗留
.doc通常需先转换再按现代.docx假设处理；.docm含宏，风险更高。
SkillHub 统计（以抓取资料为准）：评分 100000，下载 275304，安装 23940。
结尾¶
若你的工作流里频繁出现「Agent 改了 DOCX，同事一打开编号全乱」或「审阅稿被整段重写」，可以把 Word / DOCX 作为默认 Skill，让创建、检查、编辑都按 OOXML 与 Word 语义来走。安装与说明以 SkillHub 为准：https://api.skillhub.cn/zcwl/word-docx，页面详情：https://www.skillhub.cn/skills/clawhub_ivangdavila/word-docx。
