Word Docx Formatting Repair Helper

诊断并修复Word DOCX文件中的格式问题,支持样式、编号、页眉页脚等自动修复。

已扫描
适合谁
需要批量处理Word文档格式的企业办公人员、使用自动化工具生成或编辑DOCX文件的技术用户
不适合谁
无需处理复杂格式的普通文档使用者、不熟悉DOCX结构或OOXML技术的初级用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好(★☆☆)。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @kyro-ma/word-docx-formatting-repair-helper

Skill 说明

命令、参数、文件名以原文为准

Word DOCX 格式修复助手

当 Word 文档显示异常、DOCX 自动化任务导致格式损坏,或用户需要一种无需逐页手动编辑的可靠修复方案时,请使用此技能。

工作流程

  1. 确定故障类型:视觉格式偏差、编号失效、标题缺失、节分隔混乱、修订标记/批注问题、模板不匹配或 OOXML 损坏。
  2. 仅在需要检查时要求提供 DOCX 文件。若用户已清晰描述问题,可先制定修复计划,并注明假设条件。
  3. 保留原始文件。在副本上操作,除非用户明确要求,否则避免清除修订标记或批注。
  4. 编辑前检查文档结构:

- 使用 ZIP/OOXML 检查 word/document.xmlword/styles.xmlword/numbering.xmlword/settings.xml、关系文件、页眉页脚等。

- 仅使用 Word 兼容库(如 python-docx)执行其安全支持的操作。

- 对于不支持的功能(如复杂编号、批注、内容控件、部分修订结构),直接编辑 OOXML。

  1. 建立修复映射表,将每个可见问题与其可能来源关联:段落样式、直接格式、编号定义、节属性、关系目标或主题/字体设置。
  2. 实施最小且安全的修改。优先通过样式修正和编号定义修复,而非重写所有段落。
  3. 尽可能通过重新打开或渲染文档进行验证,检查页数、标题、编号序列、页眉页脚、批注、修订标记及表格。

常见修复模式

  • 多级编号失效:检查 numbering.xml,确认 abstractNumnumId 映射关系,通过重新链接段落而非替换文本内容修复。
  • 标题样式偏移:对比 styles.xml 与模板定义,修复样式配置,随后清除受影响段落中的冗余直接格式。
  • 节分隔问题:检查 w:sectPr 的位置、页面方向、页边距及页眉页脚引用,在移动内容前完成评估。
  • 修订标记与批注:除非用户明确要求生成无痕最终版本,否则不得删除 w:insw:del 或批注关系。
  • 兼容性问题:检查生成的 OOXML 是否符合 Word 期望,重点关注命名空间、关系 ID、内容类型以及非标准库输出。

输出内容

向用户提供:

  • 对问题根源的诊断,说明其在 DOCX 包中的具体位置。
  • 精确的修复方案或已实施的文档/代码变更。
  • 验证说明,描述如何对修复后的 DOCX 进行检查。
  • 任何潜在风险提示,特别是本地无法完全验证 Word 桌面行为的情况。

仅在需求分析阶段有证据支持时,查阅 references/requirement-plan.md

KM
@kyro-ma

已收录 8 个 Skill

相关推荐