装了这个技能，让AI替我写Word文档后，我再也没碰过排版

上个月帮一个银行项目做验收测试，临上线前两天，PM突然发消息说报告要提前交。

说实话，功能测试我早就跑完了，改Bug也改完了，最烦的就是写报告。

不是不会写，是排版太烦了。

Word这东西吧，内容写完了，30%的时间在排版——宋体还是Times New Roman、标题几级、行距1.5倍还是固定值、表格列宽怎么对齐、页眉要不要加公司Logo、目录怎么自动更新……有时候改一个样式，要弄半个小时……

改一行，全乱了。

当时就一个念头：能不能让AI把这些破事全干了？

我被Word格式折腾的那些年

说出来不怕你们笑话，我做测试这行好多年了，真正让我头疼的从来不是测出多少Bug。

是每次写报告。

最夸张的一次，我花了半天写一份系统测试报告，结果花在格式上的时间比写内容还多。标题从一级改成三级，全文的行距全乱了。表格在Windows上排得好好的，发给客户打开列宽全跑偏。最崩溃的是客户那边用的是Mac + 老版本Word，格式直接崩给你看。

后来我学乖了，模板先做好，每次只填内容。

但问题是——模板这东西维护起来也烦。换个项目，封面要改、页眉要改、编号规则要改，有时候改模板花的时间比写报告还多。

我就在想，能不能直接告诉AI：我需要一份XX测试报告，包含这些内容，你给我生成一个格式完整的Word文档？

答案是：能。

试了几个方案，最后留下了这个

我前前后后试过三个方案。

第一个是Markdown写完转Word。快是真快，但表格会变形、标题层级会丢、段落间距全变成默认值，拿到手还得手动调一圈。

第二个是让AI直接输出Word格式的文本，用的官网docx技能。比如”### 二级标题”这种，AI能理解，但输出完还是纯文本，生成到Word里又是一坨。而且字体颜色不对，表格填充也不对。

第三个就是我现在在用的方案——docx-cn技能。这个是大叔自己在官方docx技能基础上，优化后的技能，适配了中文文档样式。

这是大叔用docx-cn生成接口文档示例：

这个技能本质上是一个AI Agent的扩展，装上之后你就可以直接用自然语言让AI帮你操作Word文档了。不是生成文本再复制粘贴，是直接生成 .docx文件，标题层级、页眉页脚、表格样式、段落间距全部自动处理。

具体是怎么工作的呢？

它底层用的是 docx-js（一个JavaScript库），AI生成一段脚本跑一下，就输出一个格式正确的 .docx文件。中文文档的排版规范——宋体配Times New Roman、12pt字号、1.5倍行距、首行缩进2字符——全部内置好了，不用每次都跟AI交代一遍。

表格是我之前最头疼的，列宽动不动就跑。这个技能要求表格同时在表级和单元格两级都设置宽度，渲染出来就不会歪，亲测Mac和Windows上表现一致。表注也自动设置好了。^_^

我第一次用的时候，让AI生成了一份”互联网金融系统功能测试报告”，描述了报告的基本结构和几个核心测试用例的结论。生成完之后打开文档，封面有了、目录自动生成了、各级标题层级清晰、表格列宽也整整齐齐。

从那之后，我写测试报告的工作流就变成了两步：第一步，告诉AI你要什么文档；第二步，填入真实的测试数据。

之前花40分钟的活，现在10分钟搞定。

这个技能具体能干啥

直接生成新文档。你描述一下需要什么报告、包含哪些章节、要不要封面和目录，AI给你生成一个格式完整的.docx文件。中文文档的排版规范全部自动处理，不需要你操心。编辑已有的文档。比如你有一份旧模板，想把里面的”XX系统”全部替换成”YY系统”，直接让AI操作就行，不用自己一个个找。它支持修订模式——改动的地方会标红显示，方便你和同事核对哪里改了。读取现有文档。你发一份Word文件给AI，它能提取内容、转成Markdown、帮你分析文档结构。这个功能我用来批量处理历史报告的信息提取，挺方便的。

支持的文档类型包括但不限于测试计划、缺陷报告、接口测试文档、需求评审记录、阶段性总结汇报。

你关心的问题

需要什么环境？你用的AI助手需要能执行命令。这个技能的工作原理是AI生成JavaScript脚本然后运行，如果你用的AI工具支持这个能力就可以用。复杂排版能搞定吗？说实话，如果你对格式的要求非常具体，那你需要把这些细节在需求里描述清楚。AI不是读心术，但它很听话，你说得越清楚，输出越准。Mac和Windows格式会不一致吗？之前确实踩过这个坑，后来发现是表格宽度的设置问题。这个技能统一用DXA单位（一种Word内部的尺寸单位），Mac和Windows表现一致。生成失败了怎么办？第一次生成的时候如果有问题，AI通常会在错误信息里告诉你原因。你把错误信息扔回去，AI会自己修正再跑一遍。

拿这个干了点别的

测试报告是最直接的应用，但我后来发现这玩意能用的地方挺多的。

上周帮朋友写了一份项目验收文档，他那边要求用公司指定模板，封面、签章页、版本记录一个都不能少。我把模板发过去，让AI照着格式生成内容，再把真实数据填进去，前后大概半小时搞定。

上个月还帮一个需求评审会整理了会议纪要，生成的是标准的 yyyy-MM-dd-评审纪要-项目名格式，自动加了页码和页眉。

说白了，任何需要你反复处理Word格式的场景，这个技能都能省不少事。

最后说几句

docx-cn这个技能也有局限，不是所有排版需求都能零成本满足。但对我而言，它解决了测试工程师日常最高频的痛点——格式消耗的时间，远大于写内容本身。

能把这部分外包给AI，我干嘛要自己扛。

你要是也被Word格式折磨过，可以试试。关注公众号「软件测试大叔」，发消息：docx，获取安装方式。

不焦虑，有方向，一起进化。

点击在看，与更多测试人一起进化