用途:修复被 Google Docs 或 Word Online 往返编辑损坏的 .docx。云编辑器会以不同方式破坏文件,本技能是各类损坏的统一入口,只需运行所需的轨道。
主要能力(按损坏类别):A. 包/OOXML 接线:Word 提示“恢复不可读内容”或拒绝打开、LibreOffice 无法加载、出现幽灵空白页,使用 ${CLAUDE_PLUGIN_ROOT}/scripts/docx_repair.py,详见 references/package-repair.md。B. 脚注与交叉引用标记:脚注显示 1,2,3 而非 *,†,‡、编号起点错误、“supra note N”指向错误脚注、缺少分隔线,使用脚注脚本,详见 references/footnote-procedure.md;B1 交叉引用指向错误来源时用 check_crossrefs.py <file.docx>(只读,有问题退出码 1)。C. 文档内容:新编辑文本出现可见方框、标题样式不一致、空白标题行、XML 臃肿(全零 rsid、无操作底纹、显式 b=0/i=0/u=none 等),由 fix_footnotes.py 的 document.xml 处理,详见 references/content-cleanup.md。D. 呈现卫生:PDF 中脚注变蓝/带下划线、链接显示与跳转地址不一致、标题间距不均、链接含跟踪参数,使用 docx_links.py、docx_spacers.py,详见 references/presentation-hygiene.md。
使用方式:各轨道解耦,可单独或全部运行。不确定时先跑包检查(对干净包为空操作),再跑脚注处理(含内容清理)。docx-render 的 Word 路径已自动将 docx_repair.py 作为预检,Google 导出可直接渲染;若需修复后的文件本身(回传、编辑或修脚注)再手动运行 Track A。所有流程细节在 references/ 中,按需阅读。
适用场景:处理云编辑器往返后的 .docx 损坏、脚注与交叉引用修复、内容与样式清理、链接与间距等呈现问题。
限制:check_crossrefs.py 仅做宽松名称匹配,能发现指向错误来源,但无法发现错误页码;create_crossrefs.py --dry-run 只是转换预检而非审计。脚注修复仅此一处,fix_footnotes.py 是唯一规范修复器。具体安装命令与更多平台、收费信息暂未提供。