docx 面向 Word 文档的创建、阅读和修改。三类任务用的路径不同:新文档通常通过 docx 库生成;已有文档要保留原结构时,会处理文档内部的 XML;快速阅读可以用 Pandoc 提取文字。先说清楚你要“重新排一份”还是“只改原文件几处”,能避免把有复杂样式的原稿重建成普通报告。
安装与调用
在 Claude Code 的聊天输入框依次发送下面两条命令。这是插件命令,不是在系统终端运行的 Shell 命令;第二条安装的是包含 docx 的官方技能包。
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
安装后,在同一项目的会话里明确说“使用 docx”,再提供文件或任务。下面的提示词是可修改的首次输入示例。安装会加入技能说明与资源;它不会替你准备输入资料,也不代表所有依赖已经在本机安装。若找不到技能,先检查插件是否安装并启用,以及会话是否已加载最新插件,再继续任务。
从一份两页简报开始
使用 docx 把 notes.md 整理成 A4 两页项目简报,保存为 briefing.docx。
保留提供的数字和人名,用真正的标题样式、一个进度表和页码。
未知内容标为待补。生成后检查文档结构,并渲染每页查看表格和分页。
同时给我可编辑的 Word 文件和 PDF 预览,不覆盖 notes.md。
提供读者、页数、纸张方向和必须保留的内容。如果要目录,应使用 Word 的标题层级,不要只把文字放大加粗;如果有表格,明确列含义与预期宽度。创建流程中特别容易出问题的是表格和分页:表格整体宽度与每个单元格宽度需要一致,分页应发生在段落结构内。
技能文件描述了一个预先配置依赖的运行环境。自己的 Claude Code 项目未必已经装好 docx、Pandoc、LibreOffice 或 Poppler;遇到缺少命令时,先确认实际缺的是生成、转换还是渲染工具,不要把“安装 Skill”理解成同时安装完整办公软件环境。
修改原稿时保留可追踪的信息
如果任务变为修改合同或审阅报告,应提供原文件、修改范围和修订作者名称,明确要求保留修订或批注。Word 会把一段看似连续的文字拆成多个 runs,直接按整句字符串查找可能找不到;技能包含合并相邻格式片段与校验工具,适合处理这类结构问题。
读取修订时可让 Agent 使用 pandoc --track-changes=all 查看插入、删除和批注;Pandoc 默认接受修订的文字视图不会显示全部审阅信息。需要干净副本时,另存接受修订版本,不要用它替代保留审阅过程的原件。段落删除也可能在提取或转换后留下空项目,应回到文档结构核查。
交付前先检查内容是否齐全,再渲染每页看标题孤行、表格跨页、页码和字体。结构验证通过不代表分页一定好看;PDF 预览正常,也不保证另一台电脑的字体替换完全一致。最终至少在实际使用的 Word 或兼容软件中打开一次,把“可编辑文件”和“固定版式预览”一起保留。
把“改原件”与“另做新稿”分开交代
例如收到一份有批注的合同,只要求修改第 4 条并保留审阅记录时,应给出原始 DOCX、目标段落、修改文字和修订作者。让 Agent 先确认目标段落是否跨多个 XML runs,再编辑并验证修订;不要用一次全文字符串替换冒险破坏编号、粗体或批注。输出文件另命名,保留原件供对照。
对于新建简报,验收顺序相反:先看内容结构和标题层级,再看逐页渲染。若表格被拆到下一页,优先调列宽、段前段后与分页,而不是把字体缩到无法阅读。缺少 LibreOffice 时可以说明版式预览尚未完成,不能把“DOCX 文件已写入”当作最终视觉检查。
交付前让文件经受一次“往返”
生成 DOCX 后,让 Agent 重新读取自己输出的文件,确认标题、表格、备注和文中数字还在;再渲染页面检查视觉。修改原件时,则把输出和输入并排比较,确认变化只发生在指定位置。Word 的 XML 结构有时让文本提取看起来正确,却丢失样式或追踪标记;单看纯文本或单看 PDF 都不够。若对修订有法律或审计要求,还应由熟悉该流程的人在目标软件里检查。
交付给别人前用目标软件打开
复杂脚注和表格的 DOCX 即使文本抽取正常,也可能在 Microsoft Word 中弹出“修复文件”提示。有使用者对一份含脚注和表格的长文档做过修复前后的 XML 对照。若文件要给客户或同事,请在实际使用的 Word 版本里打开,检查是否无修复提示、脚注编号和表格仍可编辑;出现提示时保留原稿与生成过程,先定位结构问题再交付。