在上篇文章中,我介绍了 prd-to-xmind-testcases 这个技能,它能自动将 PRD 文档转换为飞书思维导图格式的测试用例,帮助测试同学快速输出结构化的测试计划。
文章发出后,收到了不少读者的反馈。其中被问到最多的问题是:接口文档能生成测试用例吗?
说实话,prd-to-xmind-testcases 虽然好用,但它的定位很明确,只处理 PRD 类型的需求文档。对于那些手握 Swagger 文档、接口说明书的测试同学来说,这个技能确实帮不上忙。
既然大家有这个需求,那就做一个支持更多场景的版本吧,于是,universal-testcase-generator 诞生了。
在测试工作中,我们接触的文档类型五花八门:
-
产品经理给的是PRD 文档(Word、PDF、Markdown) -
后端开发给的是接口文档(Swagger、OpenAPI、Postman Collection) -
UI 设计师给的是设计稿截图(PNG、JPG) -
有时候还要从在线文档(Notion、Confluence)里扒需求
而现有的工具往往只支持其中一种。结果就是:文档类型变了,工具就得换。
更麻烦的是,每个团队的测试用例规范都不一样。有的要求 8 列,有的要求 12 列;有的叫「前置条件」,有的叫「前置操作」。生成的用例往往需要手动调整格式,费时费力。
能不能有一个工具,既能处理各种文档,又能按团队规范输出?
这就是universal-testcase-generator要解决的问题。
Universal Testcase Generator是全能测试用例生成器 ,能够一站式测试用例生成与导出解决方案。
universal-testcase-generator能根据用户提供的需求文档(PRD)、接口文档、设计截图或需求说明,自动生成结构化、可落地的测试用例。支持多种输出格式,可直接导入飞书思维导图或XMind工具。
一、全格式输入:各类型文档都支持

二、全类型覆盖:自动识别文档类型
技能会根据输入文档的类型,自动选择对应的测试设计策略:

三、全模板适配:统一输出规范
这是最核心的功能,也是大家最需要的。
每个团队的测试用例规范都不一样。你们的模板可能是这样的:

别的团队可能是那样的:

无论你的模板长什么样,这个技能都能适配。
使用方法:三步搞定
第一步:准备你的团队模板(Excel 格式,第一行是列名)
第二步:放到指定目录


第三步:正常使用,自动适配
输入:根据这个 Swagger 文档生成接口测试用例
就这么简单。技能会自动读取模板,按你定义的列顺序和字段名称输出用例。

智能字段映射,告别格式调整
担心字段名对不上?内置智能映射:

无论你输入的是 PRD、接口文档还是设计图,最终输出的测试用例都严格符合你的团队规范。
四、全格式输出:满足不同场景
自定义模板解决了格式规范的问题,但不同场景需要不同的输出形式:

详细内容见后文"多种输出格式"章节。
一、实战演示:Swagger 接口文档 → 你的团队模板
让我们看一个真实场景。
你收到后端同学发来的Swagger_Api.json,内容包含用户登录和商品列表两个接口。同时,你的团队有一个标准的测试用例模板(8列格式)。
操作步骤
根据这个 Swagger 文档生成接口测试用例,测试用例以/assets/templates/测试用例模板.xlsx下模板格式输出[上传 swagger.json]
生成结果
技能自动读取assets/templates/测试用例模板.xlsx,按照模板格式输出:

完全符合你的模板格式,不需要手动调整。
效率对比:
![]() ![]() ![]() |
二、实战演示:Word 接口文档 → 你的团队模板
很多团队的接口文档是 Word 格式的。比如这样:

操作步骤
根据这个接口文档生成测试用例,测试用例以/assets/templates/测试用例模板.xlsx下模板格式输出
生成结果
技能智能解析 Word 文档,自动适配你的模板格式输出:

同样完全符合你的模板格式。
三、实战演示:PRD 文档 → 你的团队模板
产品同学发来一个 PRD 文档,描述用户登录功能的需求。
操作步骤
根据这个需求文档生成测试用例,测试用例以/assets/templates/测试用例模板.xlsx下模板格式输出[上传 PRD.docx]
生成结果
技能识别这是 PRD 文档,生成功能测试用例,同样按照你的模板格式输出:

无论输入什么类型的文档,输出格式永远一致。
总结一下自定义模板功能的核心价值:
1. 格式统一
无论输入的是:
-
PRD 文档 → 功能测试用例 -
Swagger 接口文档 → 接口测试用例 -
Word 接口文档 → 接口测试用例 -
设计截图 → UI 测试用例
输出格式永远符合你的团队模板。
2. 零调整成本
传统流程:

使用技能:

3. 团队协作友好
-
新人加入?模板已经在那里,生成的用例天然符合规范 -
多人协作?统一的输出格式,无需反复沟通 -
审查用例?熟悉的格式,一眼就能看懂
4. 灵活适配
团队规范变了?换个模板文件就行:

多种输出格式,满足不同场景
自定义模板解决了格式规范的问题,但实际工作中,测试用例的使用场景各不相同:
- 导入测试管理系统→ 需要 Excel/表格格式
- 团队评审展示→ 需要思维导图格式
- 个人整理归档→ 需要 Markdown 文档
技能支持以下三种输出格式:
1. Excel 表格格式
适用场景:
-
导入测试管理系统(Jira、禅道、TestLink) -
团队协作编辑 -
用例评审和修改
使用方式:
根据这个 Swagger 文档生成接口测试用例,测试用例以/assets/templates/测试用例模板.xlsx下模板格式输出
输出效果:

特点:
-
完全符合团队模板格式 -
可直接导入 Excel 或测试管理系统 -
支持多人协作编辑
2. 飞书思维导图格式
适用场景:
-
用例评审会议展示 -
快速浏览用例结构 -
导入飞书思维笔记
使用方式:
根据这个接口文档生成测试用例,输出飞书思维导图格式
输出效果:

导入方法:
-
复制生成的 Markdown 内容 -
打开飞书思维笔记 -
直接粘贴,自动转为思维导图
特点:
-
层级结构清晰,便于展示 -
支持飞书思维笔记直接导入 -
适合评审会议演示
3. XMind 格式
适用场景:
-
用 XMind 工具编辑和管理 -
导出为图片/PDF 分享 -
更复杂的思维导图编辑
使用方式:
根据这个 PRD 文档生成测试用例,输出 XMind 格式
输出效果:

特点:
-
标准 XMind 文件格式 -
支持 XMind 工具打开编辑 -
可导出为图片、PDF 等格式
格式对比:选择合适的输出方式

实际工作流建议:
- 生成阶段→ 输出 Excel 表格格式,导入测试管理系统
- 评审阶段→ 输出飞书思维导图格式,用于会议展示
- 归档阶段→ 保持 Excel 格式,作为正式文档保存
与旧版本的对比

总结:universal-testcase-generator是prd-to-xmind-testcases的全面升级版,核心优势是,自定义模板适配:任何文档都能按团队规范输出,多格式输出:表格、思维导图、XMind 一键切换。

2. 我们把这个skill导入workbuddy即可。

点击skill名称,可以看到skill的详细说明

接着我们来配置测试用例模板。
第一步:配置团队模板(推荐)


不配置也能用,会使用内置的标准格式。
第二步:开始使用,输入以下提示词即可使用
PRD生成测试用例(自动按模板格式输出)根据这个PRD生成测试用例,测试用例以/assets/templates/测试用例模板.xlsx下模板格式输出# 接口文档生成测试用例(自动按模板格式输出)根据这个Swagger文档生成接口测试用例,测试用例以/assets/templates/测试用例模板.xlsx下模板格式输出# 设计图生成测试用例(自动按模板格式输出)根据这个设计图生成UI测试用例,测试用例以/assets/templates/测试用例模板.xlsx下模板格式输出# 指定其他输出格式根据这个接口文档生成测试用例,输出飞书思维导图格式
实际工作流建议
场景一:测试用例编写

场景二:用例评审

场景三:多格式需求

开发这个技能的初衷很简单:让测试同学从重复劳动中解放出来,把精力放在真正需要思考的地方。
自动化生成测试用例并不能完全替代人工设计,但它可以:
- 节省时间:用例编写时间从 30 分钟缩短到 30 秒
- 提高质量:内置测试设计方法论,降低遗漏风险
- 统一规范:自定义模板输出,无需手动调整格式
- 多场景适配:无论什么文档类型,都能生成用例
- 团队协作友好:统一的输出格式,降低沟通成本
最重要的是:无论你输入什么文档,最终输出的测试用例都严格符合你的团队规范。这才是真正的"拿来就能用"。

