自动测试用例生成

Skill 标识
doc-based-testcase-generator

拿到需求或接口文档,按统一测试设计策略产出可评审的用例初稿。正向、异常、边界和状态场景一起梳理,还能对齐团队模板,告别每次从空白表格开始。

扫码添加辅导员,发送 Skill 名称领取源码
本文目录
  1. Skill 概览
  2. 适合谁、用在什么场景
  3. 需要准备什么、能得到什么
  4. 核心能力与使用边界
  5. 实战教程与使用说明
  6. 一、为什么需要这样一个 Skill?
  7. 二、这个 Skill 是什么?
  8. 三、适用场景与输入输出
  9. 3.1 适用场景
  10. 3.2 输入
  11. 3.3 输出
  12. 四、核心能力一:通用测试用例设计策略
  13. 五、核心能力二:专用标准(接口 / 功能 / 性能 / 自动化)
  14. 5.1 接口测试(api-testcases-standard.md)
  15. 5.2 功能测试(functional-testcases-standard.md)
  16. 5.3 性能测试(performance-testcases-standard.md)
  17. 5.4 自动化测试用例(automation-testcases-standard.md)
  18. 六、如何使用:操作步骤
  19. 步骤 1:准备文档内容
  20. 步骤 2:发起请求
  21. 步骤 3:查看与保存
  22. 七、输出与保存的约定
  23. 八、Skill 的目录结构与可扩展性
  24. 九、小结:给测试工程师的几点建议
  25. 十、实操过程视频&生成的登录用例文档

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/)组成,规定了:

  1. 何时触发:当你说「根据这份文档生成测试用例」「根据 PRD/接口文档写测试用例」等时,会按本 Skill 的规则工作。

  2. 用什么方法设计用例:默认采用一套通用测试用例设计策略(正向、反向、边界值、等价类、状态与流程、场景法等),保证覆盖维度统一。

  3. 不同类型如何细化:通过 references/ 下的专用标准文档,对接口测试、功能测试、性能测试、自动化候选用例分别约定「要覆盖什么、怎么写」。

  4. 输出格式从哪来:不写死表格列名;若你提到「参考某某 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 的目录结构与可扩展性

plain
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 模板为准,便于适配不同团队规范。


九、小结:给测试工程师的几点建议

  1. 把文档整理成可粘贴的文本:这是当前版本下效果最好的方式;截图可转为文字后再用。

  2. 说清侧重点:需要接口/性能/自动化标记时,在请求里提一句,会自动加载对应标准。

  3. 用好模板:把公司或项目常用的 Word/Excel 用例模板放到 assets/,生成时说明「参考某某模板」,可减少二次整理。

  4. 生成后做一次人工评审:AI 按策略和标准覆盖,但业务细节、环境差异仍需你确认;可重点看边界与异常是否贴合实际、优先级是否合理。

  5. 需要落盘时说一句即可:无需脚本,直接「保存到 xxx」就能写入指定路径。

十、实操过程视频&生成的登录用例文档

实操过程录屏展示:

实操登录测试用例并保存到本地的用例excel:

开始使用 doc-based-testcase-generator

扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。

同类 Skills