自动测试用例生成
- Skill 标识
doc-based-testcase-generator- 所属分类
- 软件测试 / 测试方法
拿到需求或接口文档,按统一测试设计策略产出可评审的用例初稿。正向、异常、边界和状态场景一起梳理,还能对齐团队模板,告别每次从空白表格开始。
本文目录
- Skill 概览
- 适合谁、用在什么场景
- 需要准备什么、能得到什么
- 核心能力与使用边界
- 实战教程与使用说明
- 一、为什么需要这样一个 Skill?
- 二、这个 Skill 是什么?
- 三、适用场景与输入输出
- 3.1 适用场景
- 3.2 输入
- 3.3 输出
- 四、核心能力一:通用测试用例设计策略
- 五、核心能力二:专用标准(接口 / 功能 / 性能 / 自动化)
- 5.1 接口测试(api-testcases-standard.md)
- 5.2 功能测试(functional-testcases-standard.md)
- 5.3 性能测试(performance-testcases-standard.md)
- 5.4 自动化测试用例(automation-testcases-standard.md)
- 六、如何使用:操作步骤
- 步骤 1:准备文档内容
- 步骤 2:发起请求
- 步骤 3:查看与保存
- 七、输出与保存的约定
- 八、Skill 的目录结构与可扩展性
- 九、小结:给测试工程师的几点建议
- 十、实操过程视频&生成的登录用例文档
Skill 概览
适合谁、用在什么场景
以文档为主要输入、需要统一用例设计方法和模板的测试工程师。
需要准备什么、能得到什么
- 输入材料:可复制的 PRD、需求说明或接口文档文本,可补充团队 Word、Excel 模板。
- 交付产物:按模块、接口或场景组织的 Markdown 用例文档,按要求保存到指定目录。
核心能力与使用边界
- 核心能力:通用测试方法叠加功能、接口、性能及自动化候选规范,支持参考 assets 模板。
- 使用边界:默认不是直接生成 Excel 文件;截图宜先提取文本,输出用例仍需核对业务规则。
实战教程与使用说明
一、为什么需要这样一个 Skill?
测试工程师的日常里,有一类工作既高频又耗时:拿到需求文档或接口文档之后,把其中的业务规则、接口约束、边界条件拆解成一条条可执行的测试用例。痛点往往包括:
文档长、模块多:人工逐段提炼容易漏掉边界和异常场景。
用例设计方法不统一:不同人习惯不同,有的偏正向、有的缺反向和边界,质量参差。
接口 / 功能 / 性能写法不一:接口要关注参数和错误码,功能要关注流程和状态,性能要关注负载和指标,混在一起容易顾此失彼。
想按公司模板输出:希望生成结果能直接对接到现有的 Word/Excel 用例模板,减少二次整理。
本 Skill 的目标就是:你提供一份需求或接口文档(文本),AI 在固定「测试设计策略 + 专用标准」下,输出一整套结构化测试用例文档;你可以直接复制使用,或要求保存到指定目录,也可以让输出对齐自己在 assets 里放的 Word/Excel 模板。
二、这个 Skill 是什么?
名称:doc-based-testcase-generator(基于文档的测试用例生成器)
本质:一个可在 Cursor 等环境中加载的 Claude Skill。它由一份主说明(SKILL.md)和若干参考文档(references/)组成,规定了:
何时触发:当你说「根据这份文档生成测试用例」「根据 PRD/接口文档写测试用例」等时,会按本 Skill 的规则工作。
用什么方法设计用例:默认采用一套通用测试用例设计策略(正向、反向、边界值、等价类、状态与流程、场景法等),保证覆盖维度统一。
不同类型如何细化:通过
references/下的专用标准文档,对接口测试、功能测试、性能测试、自动化候选用例分别约定「要覆盖什么、怎么写」。输出格式从哪来:不写死表格列名;若你提到「参考某某 Word/Excel 模板」,则从
assets/目录读取对应模板,按模板结构组织输出。
也就是说:你负责提供文档和需求,Skill 负责「用什么策略 + 按什么标准」生成用例,并支持对齐你的模板。
三、适用场景与输入输出
3.1 适用场景
拿到 PRD、需求说明、用户故事 后,需要快速出一版功能测试用例。
拿到 接口文档(OpenAPI、Markdown、表格等) 后,需要系统化设计接口测试用例(参数、错误码、鉴权、幂等等)。
需求或设计中有 性能指标、SLA、压测要求 时,需要补充性能测试用例(场景、负载、通过标准)。
希望在一批用例中标出适合做自动化的,方便后续做自动化选型与排期。
希望生成结果按公司现有 Word/Excel 用例模板的列和结构输出,便于直接导入用例库。
3.2 输入
主输入:需求文档 / PRD / 接口文档的可复制文本。直接粘贴到对话中即可;若是截图,Skill 会建议你将图中文字转为文本再使用。
可选补充:
口头说明侧重点,如「重点做接口测试」「要包含性能用例」「标出自动化候选」;
或「参考 assets 里的某某模板」。
3.3 输出
形式:一份结构化测试用例文档(Markdown,含表格或分级列表),直接出现在对话中。
内容:按模块/接口/场景分节,每条用例包含:用例编号、标题、模块/接口、用例类型、优先级、前置条件、测试步骤、预期结果,以及可选的数据要求/备注。
落盘:默认不自动保存;若你说「保存到 xxx 目录」或「存到 testcases 文件夹」,会写入指定路径,无需额外脚本。
四、核心能力一:通用测试用例设计策略
Skill 规定:在生成任何测试用例之前,必须先按一套通用测试设计策略思考与覆盖。这样保证即使用户没有细说「要正向还是反向」,输出也会系统化。下面是策略概要,方便你对照自己平时的设计习惯。
策略 | 含义 | 典型做法 |
正向测试用例 | 合法前置条件 + 正常路径,验证符合需求/接口约定 | 每个核心功能/接口至少 1 条 happy path;前置、输入、步骤、预期与文档一致。 |
反向 / 异常测试用例 | 非法输入、错误操作、异常状态,验证系统正确拒绝且无副作用 | 每个可校验点至少一类无效情况(格式错误、越权、重复提交等);接口对应错误码,功能对应校验提示。 |
边界值用例设计 | 在范围、长度、数量的边界附近设计用例 | 提取文档中所有有范围/长度/数量限制的字段;设计边界内、边界值、超界、空值、0/负值/极大值等。 |
等价类划分 | 将输入域划类,每类取代表值,减少冗余 | 有效等价类取 1~2 个代表;无效等价类按违规类型各取代表;可与边界值结合。 |
状态与流程 | 针对状态机、多步骤流程设计合法与非法迁移 | 列出状态与允许迁移;设计正向路径、中断/回退、非法状态操作;有角色时覆盖越权。 |
场景法 / 用户场景 | 以用户故事串联多模块,做端到端用例 | 归纳 2~3 个典型场景;每场景下主流程 + 分支;可与正向/反向/边界结合。 |
优先级与类型标记 | 便于执行与排期 | 核心路径与关键校验标 P0;边界与次要异常标 P1/P2;并标用例类型(正向/反向/边界/异常/性能/自动化候选)。 |
输出时,会通过用例类型、标题或说明体现上述策略的运用,方便你评审和补充。
五、核心能力二:专用标准(接口 / 功能 / 性能 / 自动化)
通用策略解决「用什么方法想用例」;专用标准解决「某类测试要覆盖哪些维度、怎么写清楚」。Skill 通过 references/ 下的四个文档来约定,你在对话里提到对应类型时,会叠加这些要求。
5.1 接口测试(api-testcases-standard.md)
必须覆盖:
请求与参数:正常请求、必填缺失、类型/格式错误、边界值、可选参数不传/传空/传有效值;
响应与错误码:成功响应结构、文档中每个错误码至少 1 条用例、非法请求不返回 200;
鉴权与权限:未带鉴权、鉴权无效/过期、越权访问;
幂等与并发(若文档有):重复提交、超并发/限流。
表述要求:每条用例写清接口路径+方法、请求关键取值、预期 HTTP 状态码与响应/错误码;数据依赖在前置或数据要求中说明。
5.2 功能测试(functional-testcases-standard.md)
必须覆盖:
业务流程与用户场景:主流程、分支与异常流程、端到端场景;
状态与角色:合法/非法状态迁移、本角色允许操作与越权;
界面与交互(若适用):必填与校验、多步骤与回退;
数据与依赖:前置条件写清数据状态,跨模块时说明需校验的关联数据。
表述要求:用例标题可概括「谁在什么条件下做什么、预期什么」;步骤可执行、可验证;预期与需求/PRD 一致且可验收。
5.3 性能测试(performance-testcases-standard.md)
必须覆盖:
指标与基线:响应时间、吞吐量/QPS、资源与容量(若文档有);
场景类型:基准、稳态负载、峰值/尖峰、长时间稳定性;
瓶颈与退化:阶梯加压、降级与限流(若文档有)。
表述要求:场景名称能看出「场景类型 + 目标指标」;写清负载定义(并发、QPS、时长)、环境与数据量级、通过标准(如 P99 RT、成功率);可选观察要点(CPU、内存、错误日志等)。
5.4 自动化测试用例(automation-testcases-standard.md)
适合自动化:稳定可重复、高执行频率、断言明确、接口或可脚本化、依赖可构造。
不适合或低优先:强主观/探索性、一次性/低频、环境或数据难以自动化、变更频繁。
输出:在用例类型或备注中标注「自动化候选」或「建议自动化」;可选补充建议实现方式、断言要点、数据与环境要求。
以上四份文档都不规定具体表格列名或排版,只规定覆盖维度和表述要求;列名与排版由你指定的 assets 模板或团队约定决定。
六、如何使用:操作步骤
步骤 1:准备文档内容
将需求文档、PRD 或接口文档中需要覆盖测试的部分复制成纯文本。若是 Word/PDF/截图,请把关键内容粘贴到对话中(截图会建议转为文字)。
步骤 2:发起请求
在对话中说清意图并粘贴内容,例如:
「请根据下面这份需求文档,帮我生成测试用例。」
然后另起一段粘贴文档正文。
可选地加一句:
「重点做接口测试」→ 会叠加接口标准。
「要包含性能测试」→ 会叠加性能标准。
「标出适合自动化的用例」→ 会叠加自动化标准并做标记。
「按我们公司的 Excel 模板来」/「参考 assets 里的 xxx 模板」→ 会按
assets中对应模板组织列与结构。
步骤 3:查看与保存
测试用例文档会直接输出在对话中,你可复制到 Word/Excel/语雀等使用。
若需要落盘,说一句即可,例如:
「把这份测试用例保存到当前项目的
testcases/文件夹。」「保存为
docs/测试用例_用户中心需求_20250305.md。」无需写脚本;若只给目录未给文件名,会使用默认命名:
测试用例_<模块或文档简称>_<日期>.md。
七、输出与保存的约定
默认:仅输出在对话中,不自动写文件。
保存:只有在你明确要求保存或给出路径时,才会将刚才输出的内容写入指定路径;若目录不存在会先创建。
不依赖脚本:保存完全通过对话中的「保存到 xxx」+ 写入工具完成,无需额外脚本。
八、Skill 的目录结构与可扩展性
doc-based-testcase-generator/
├── SKILL.md # 主说明:触发条件、通用策略、工作流、保存约定
├── references/ # 各测试类型的「输出要求与设计标准」
│ ├── api-testcases-standard.md
│ ├── performance-testcases-standard.md
│ ├── functional-testcases-standard.md
│ └── automation-testcases-standard.md
├── assets/ # 你放置 Word/Excel 用例模板的目录
│ └── README.md # 说明模板放置方式
└── docs/ # 本文档等说明材料
references/:可自行增改。例如增加「安全测试用例标准」「兼容性测试标准」等,并在
SKILL.md中说明何时引用。assets/:放入你实际使用的 .docx、.xlsx 模板;对话中提及「参考某某模板」时,会从此目录查找并按要求组织输出。
格式:Skill 不写死表格列名,列名与排版以 references 的表述要求 + assets 模板为准,便于适配不同团队规范。
九、小结:给测试工程师的几点建议
把文档整理成可粘贴的文本:这是当前版本下效果最好的方式;截图可转为文字后再用。
说清侧重点:需要接口/性能/自动化标记时,在请求里提一句,会自动加载对应标准。
用好模板:把公司或项目常用的 Word/Excel 用例模板放到
assets/,生成时说明「参考某某模板」,可减少二次整理。生成后做一次人工评审:AI 按策略和标准覆盖,但业务细节、环境差异仍需你确认;可重点看边界与异常是否贴合实际、优先级是否合理。
需要落盘时说一句即可:无需脚本,直接「保存到 xxx」就能写入指定路径。
十、实操过程视频&生成的登录用例文档
实操过程录屏展示:
实操登录测试用例并保存到本地的用例excel:
扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。