让 AI 代理处理 Word 文档，最常见的翻车方式不是改错内容，而是「看起来改好了」——编号从第三章重新开始、别人留的批注不翼而飞、发到同事电脑上表格整个挤成一团。这些问题都指向同一个根：把 .docx 当纯文本在改。Word / DOCX 这个技能包做的事，就是给代理装上一套基于 OOXML 底层架构的操作规范，让它在创建、检查、编辑 Word 文档时守住格式的底线。
它由独立开发者 ivangdavila 维护，当前版本 1.0.2，在 CocoLoop 专业技能榜排第 18 位，社区安装量 22 万量级，通过 CLS 安全性认证（2026-05-03）。整个包只有 3.6 kB，本体是一份 7.7 kB 的规则文档，不含任何可执行代码。
通过网盘分享的文件：word-docx-1.0.2.zip
链接: https://pan.baidu.com/s/1XEd1i2CD2KggD_jvUboKbA?pwd=5k7m 提取码: 5k7m 复制这段内容后打开百度网盘手机App，操作更方便哦一、基本信息
| 项目 | 内容 |
|---|---|
| 技能名称 | Word / DOCX |
| 定位 | 基于 OOXML 底层的专业 Word 文档处理规范 |
| 版本 | 1.0.2 |
| 社区数据 | 安装 225.5k 量级 · 专业技能榜 #18 |
| 安全认证 | CLS 安全性认证（2026-05-03） |
| 技能类型 | 纯知识型指南（无代码），指导 Agent 执行 |
| 包体大小 | 3.6 kB（SKILL.md 7.7 kB + 元信息） |
| 覆盖平台 | Linux、macOS、Windows；兼顾 LibreOffice 与 Google Docs 兼容 |
| 下载安装 | word-docx-1.0.2.zip（百度网盘，提取码 5k7m） |
| 标签 | docs、office、development-engineering、productivity |
二、为什么 Word 文档是代理的重灾区
普通文本文件改坏了顶多内容出错，Word 文档改坏的往往是「看不见的部分」。一个 .docx 本质上是一个 ZIP 压缩包，里面装着 document.xml（正文）、styles.xml（样式表）、numbering.xml（编号定义）、页眉页脚和关系文件等一堆 XML 部件。一段可见的文字，在底层可能被拆散在多个文本运行、书签、修订标记或域边界里——这正是很多脚本「全文替换」之后文档面目全非的原因。
常见的三类事故都源于此：样式漂移（直接改格式而不是改样式，换台电脑就乱）、编号错乱（不懂 abstractNum 与 num 的关联，列表从头重新编号）、审阅链断裂（大范围重写导致批注锚点失效、修订记录丢失）。对法律合同、学术论文、投标书这类严肃文档，这些不是小瑕疵，是直接报废。
这个技能的核心主张一句话就能说清：把 .docx 当 OOXML 看，把编辑当成有结构的手术，而不是文本替换。
三、三轨工作流：先分清你要干什么
规则文档把任务明确分成三条路径，要求代理动手前先判断自己属于哪一类。
| 工作轨 | 适用场景 | 关键原则 |
|---|---|---|
| 结构化提取 | 读取、检索、汇总文档内容 | 只读不改，注意文字可能分散在多个运行节点 |
| 样式驱动生成 | 从零创建新文档 | 用命名样式而非直接格式，显式设置页面尺寸 |
| OOXML 感知编辑 | 修改已有文档，尤其是带审阅记录的 | 最小化精准替换，不全文重写，保住批注与修订 |
这个区分看似简单，实际是整份技能里最有价值的一条规则。大部分翻车案例，都是把「编辑」当成了「生成」来做。
四、核心规则逐条看
4.1 样式系统：改样式，不改格式
优先使用命名样式（标题、正文、引用）而不是对段落逐个设置字体字号。文档里样式分三层：段落样式、字符样式、直接格式，层级关系搞反了就会出现「改了模板标题还是旧样式」的经典问题。
4.2 编号系统：先懂再动
列表编号由 numbering.xml 里的 abstractNum（抽象定义）和 num（实例）关联控制，多级列表的重启、扁平化问题都出在这里。规则要求代理在动编号前先理解现有定义，避免把法律文书的条款编号改成一锅粥。
4.3 节级布局：显式声明
页边距、横竖方向、页眉页脚都挂在「节」上，通过节断点管理。页面尺寸（A4 或 US Letter）要显式设置，不能依赖默认值——不同地区默认纸张不同，这也是跨国协作文档布局漂移的常见来源。
4.4 修订与批注：外科手术式操作
追踪修订、批注、交叉引用、书签、目录、脚注这些审阅要素，编辑时必须精准最小化：只替换目标文本，不触碰周边结构。规则里特别点名了「一个可见短语可能横跨书签、修订标签和域边界」，盲目替换会把引用关系一起切掉。
4.5 往返兼容：三套办公软件里各过一遍
文档要在 Word、LibreOffice、Google Docs 之间验证。已知的高危点包括：表格用自动调整宽度（三端渲染不一致）、嵌入字体缺失、样式复制不完整、域代码缓存滞后。规则要求对易漂移元素做显式处理。
五、显著优点
理念正确。「OOXML 优先」抓住了 Word 自动化处理的本质问题，和市面上那些只会教「怎么生成一份文档」的指南不在一个层面。
审阅场景深度优化。对修订、批注、交叉引用的处理规范，在同类技能里少见地细。法律、学术、合规这类靠审阅记录吃饭的场景，直接受益。
兼容性预警前置。把 LibreOffice 和 Google Docs 的已知漂移点写进了规则，而不是等出了问题再排查。
版本说明可信。更新日志写明这一版针对「脆弱审阅工作流、引用稳定性、布局漂移」做过外部审计加固，能看出维护者在持续打磨。
六、绕不开的问题
纯指南，不是工具。整个包没有一行可执行代码，所有规则要靠调用的 Agent 自行落实。Agent 的文档操作能力不足时，规则写得再好也落不了地。
学习曲线偏陡。要真正用起来，得理解 XML 包结构、样式继承、编号状态机这些概念，对非技术用户不友好。
对简单场景过重。日常写个通知、改个段落，用不上这套严规；它重度优化的审阅工作流，普通用户一年碰不到几次。
来源为个人开发者。可信度评级 T3，未声明开源许可证，没有企业背书。当前版本审查无安全威胁，但后续更新引入代码时需要重新评估。
七、风险提示与解读
| 风险项 | 说明 |
|---|---|
| 来源与信任 | 个人开发者维护，社区信誉暂无法验证，更新后需重估 |
| 执行依赖 | 效果完全取决于 Agent 的 OOXML 操作能力，能力不足可能改坏文件 |
| 知识过时 | Office 与 OOXML 标准在演进，维护滞后可能产生新的兼容问题 |
| 许可证未声明 | 元信息中许可标记为 unknown，商用前需确认 |
四条里最需要当心的是执行依赖：这套规则要求的是细粒度文档操作能力，如果手头的代理做不到，强行执行高级指令（比如改关系文件、动编号定义）反而可能损坏文件。稳妥做法是先在文档副本上验证。
八、适合谁，不适合谁
| 人群 | 是否适合 | 理由 |
|---|---|---|
| 文档管理员/模板维护者 | 适合 | 公司信头、产品手册这类长期模板最怕样式漂移 |
| 文档自动化工程师 | 适合 | 生成管线里加一层规范，避免产出的文档一周后崩 |
| 法律/学术审阅参与者 | 适合 | 修订批注的保护规则正中场景 |
| 轻度办公用户 | 不适合 | 概念门槛高，简单编辑用不上 |
| 期待「一键修复文档」的人 | 不适合 | 它是规则不是软件，需要 Agent 配合执行 |
九、落地路径
1. 解压通读。全文 7.7 kB，十几分钟能读完，重点记住三轨工作流和五个高危区。
2. 挂给你的 Agent。把 SKILL.md 放进代理的技能目录，让它在处理 .docx 任务时先读规则再动手。
3. 拿受损文档做测试。找一个被改坏过的多级编号文档，看按规则操作后能否恢复，校验执行能力。
4. 建立副本习惯。任何 OOXML 感知编辑前先留副本，这是规则之外最有效的一条人工纪律。
5. 定期核对版本。技能更新后重看变更日志，确认审阅与兼容规则有没有变化。
十、文件构成
| 文件 | 大小 | 作用 |
|---|---|---|
| SKILL.md | 7.7 kB | 规则本体：三轨工作流、核心规则、陷阱清单、兼容性检查 |
| _meta.json | <0.1 kB | 包元信息（名称、版本、适用系统） |
两个文件就是全部内容。体积小是这类「规范型」技能的常态——它交付的是方法，不是代码。
十一、常见问题
11.1 装了它就能自动处理 Word 文档吗？
不能。它是给 Agent 看的操作规范，没有可执行代码。文档处理仍由 Agent 完成，技能保证的是「按正确的方式做」。
11.2 它和常见的文档生成工具有什么区别？
生成工具解决「怎么造出一份文档」，它解决「怎么不把文档改坏」。两者互补，尤其适合串联在生成之后、交付之前的编辑环节。
11.3 个人开发者维护的包可信吗？
当前版本通过了 CLS 安全性认证且不含代码，风险可控。但许可证未声明、来源为 T3，商业环境使用前建议先在内部评审一次。
11.4 支持 WPS 吗？
规则明确覆盖 Word、LibreOffice、Google Docs 三端的兼容性验证，未提及 WPS。WPS 对 OOXML 兼容度较高，核心原则同样适用，但表格与域的表现需自行验证。
11.5 为什么改个字都这么讲究？
因为一段可见文字在底层可能横跨多个 XML 节点和审阅标记。直接文本替换会切断这些关联，引发编号错乱、批注丢失、引用失效——这些都是事后很难人工修复的。
11.6 新手最该先记住哪条？
动手前先分轨：只读就用结构化提取，新建就用样式驱动，改别人的文档就切 OOXML 感知编辑。分错了轨，后面全是坑。
结语
Word / DOCX 属于「便宜但值钱」的技能包：3.6 kB 的规则文档，22 万量级的安装量，换来的是代理处理 Word 时不犯低级错误的底线保障。它的价值高度依赖执行方的文档操作能力，规则本身则把 OOXML 这门手艺讲得足够清楚。
如果你的 Agent 工作流里经常出现合同、论文、标书这类带审阅记录的严肃文档，它值得装进技能列表；如果只是让 AI 帮你写两段文字贴进 Word，那它对你来说偏重了。
技能包下载：word-docx-1.0.2.zip（百度网盘，永久有效，提取码 5k7m）
通过网盘分享的文件：word-docx-1.0.2.zip
链接: https://pan.baidu.com/s/1XEd1i2CD2KggD_jvUboKbA?pwd=5k7m 提取码: 5k7m 复制这段内容后打开百度网盘手机App，操作更方便哦
暂无评论内容