word-docx

name	Word / DOCX
slug	word-docx-zh
version	1.0.2
homepage	https://clawic.com/skills/word-docx
description	创建、检查和编辑 Microsoft Word 文档和 DOCX 文件，支持可靠的样式、编号、修订跟踪、表格、节和兼容性检查。适用于以下场景：(1) 任务涉及 Word 或 `.docx` 文件；(2) 文件包含修订跟踪、批注、域、表格、模板或页面布局约束；(3) 文档需要在往返编辑后保持格式不漂移。
changelog	围绕脆弱的审阅工作流、引用稳定性和布局漂移进行了更严格的审计和优化。
metadata	{"clawdbot":{"emoji":"📘","os":["linux","darwin","win32"]}}

适用场景

当主要处理对象是 Microsoft Word 文档或 .docx 文件时使用，尤其在涉及修订跟踪、批注、页眉页脚、编号、域、表格、模板或兼容性问题时。

核心规则

1. 将 DOCX 视为 OOXML，而非纯文本

• .docx 文件是 XML 部件的 ZIP 包，因此结构与可见文本同样重要。
• 关键部件通常是 word/document.xml、styles.xml、numbering.xml、页眉、页脚和关系文件。
• 文本可能被拆分到多个运行节点中；绝不能假设一个词或一句话只存在于一个 XML 节点中。
• 应有目的地使用不同的工作流：结构化提取用于快速阅读，样式驱动生成用于新建文件，OOXML 感知编辑用于处理脆弱的现有文档。
• 如果工作主要是读取、提取或审阅，应在接触 OOXML 之前优先使用结构保留的读取路径。
• 进行深度编辑时，应检查包布局，而不是仅依赖渲染输出。
• 读取、生成和保留已有的已审阅文档是不同的工作，即使格式相同。
• 旧版 .doc 输入通常需要转换后才能信任现代 .docx 的假设。

2. 有意识地保留样式和直接格式

• 优先使用命名样式而非直接格式，以便文档保持可编辑性。
• 样式层级：段落样式、字符样式和直接格式的行为并不相同。
• 移除直接格式通常比叠加更多内联格式更安全。
• 编辑现有文件时，应扩展现有样式系统，而非创建平行的样式体系。
• 在文档之间复制内容可能会静默地导入外部样式、主题设置和编号定义。

3. 列表和编号是独立的系统

• 项目符号和编号属于 Word 的编号定义，而非粘贴的 Unicode 字符。
• abstractNum、num 和段落编号属性都很重要，因此重启行为很少是"仅视觉效果"。
• 缩进和编号相关但不等同；即使缩进看起来正确，列表编号也可能是错误的。
• 在一个编辑器中看起来正确的列表，如果底层编号状态有误，在后续可能会重启、扁平化或重新编号。

4. 页面布局存在于节中

• 边距、方向、页眉、页脚和页码都是节级行为。
• 首页和奇偶页眉可以在同一文档中不同，因此修复一个页眉可能无法修复整个文档。
• 应明确设置页面大小，因为 A4 和 US Letter 的默认值会影响分页和表格宽度。
• 使用分节符进行布局更改；手动间距和散落的分页符通常会导致漂移。
• 页眉页脚中的媒体使用部件特定的关系，因此复制 ID 经常会导致图片或链接失效。
• 表格、分页符和页眉经常一起漂移，因此应将布局修复视为文档级别的操作，而非局部的外观调整。
• 表格几何形状取决于页面宽度、边距和固定宽度，因此"差不多就行"的表格编辑往往会在 Google Docs 或 LibreOffice 中出问题。

5. 修订跟踪、批注和域需要精确编辑

• 启用修订跟踪时，可见文本并非文档的全部。
• 插入、删除和批注携带的元数据可能在粗心的编辑中存活下来。
• 被删除的文本即使不再显示在屏幕上，可能仍然存在于 XML 中。
• 如果编辑移动文本时没有保留周围的结构，批注锚点和审阅范围可能会失效。
• 批注标记和审阅包装器的行为不像内联格式，因此随意移动文本可能导致批注孤立或错位。
• 批注、脚注、书签和链接媒体可能存在于单独的部件中，而不仅仅在主文档正文中。
• 目录、页码、日期、交叉引用和邮件合并占位符都是域。
• 应谨慎编辑域源，并预期缓存的显示值在刷新之前会滞后。
• 如果 ID 或关系不再匹配，超链接、书签和引用可能会失效。
• 书签、脚注、批注范围和交叉引用依赖稳定的锚点，即使可见文本看起来未被触动。
• 文档可能看起来正确，但仍包含过时的域输出，刷新后会变成不同的内容。
• 对于审阅工作流，应进行最小化替换，而非重写整个段落。
• 在修订跟踪工作流中，只有被更改的跨度应该看起来有所更改；大范围重写会产生嘈杂的审阅记录，并可能破坏原始格式上下文。
• 对于法律、学术或商务审阅文档，默认使用审阅风格编辑，而非整段重写，除非用户明确要求重写。

6. 交付前验证往返兼容性

• 复杂文档在 Word、LibreOffice、Google Docs 和转换工具之间可能会有偏移。
• 表格、页眉、嵌入字体和复制的样式是布局漂移的常见来源。
• 将 .docm 视为带宏的、高风险文件；将 .doc 视为可能需要先转换的旧版输入。
• 当布局很重要时，明确的表格宽度比自动调整或百分比样式的行为更安全，后者在不同编辑器中会被重新解释。
• 通过文本检查的文档在收件人打开后，仍可能在分页、表格宽度或引用刷新上出问题。

常见陷阱

• 复制粘贴可能会导入不需要的样式和编号定义。
• 页眉或页脚中的图片使用部件特定的关系，因此盲目重用 ID 会导致它们失效。
• 用作间距的空段落会使模板变得脆弱；间距应放在段落设置中。
• 看起来干净的导出仍可能隐藏未解决的修订、批注或过时的域值。
• 靠"肉眼"重启列表通常会失败，因为编号状态存在于段落文本之外。
• 一个可见的短语可能被拆分到多个运行节点、书签、修订标签或域边界中。
• 为了更改一个从句而替换整个段落，通常会破坏审阅质量、书签、批注或附近的内联格式。
• 从段落或列表项中删除所有可见文本仍可能留下空段落标记、空项目符号或不稳定的编号。
• 表格自动调整和百分比宽度行为在 Word 中可能看起来可以接受，但在 Google Docs 或 LibreOffice 中仍会漂移。
• LibreOffice 和 Google Docs 可能会偏移复杂的表格、节行为和嵌入字体，即使 Word 中看起来完美无缺。
• 兼容模式可能会静默限制较新的功能或更改分页行为。
• 页面大小或边距默认值的单个更改可能会波及表格、页眉、目录和交叉引用。
• 修订工作流可能在屏幕上看起来已接受，但残留的元数据、批注或域缓存仍可能导致文件后续不稳定。
• 目录条目、脚注和交叉引用可能看起来正确，直到收件人更新域后暴露出断开的锚点。

相关技能

经用户确认后，使用 clawhub install <slug> 安装：

• documents — 通用文档处理和格式转换。
• brief — 简洁商务写作和结构化摘要。
• article — 长篇起草和编辑结构。

反馈

• 如果觉得有用：clawhub star word-docx
• 保持更新：clawhub sync