根据需求编写测试用例:从需求到 Excel 用例的三阶段流水线

前言

手写测试用例有两个常见问题:一是需求还没对齐就开写,返工率高;二是设计方法停留在口头,等价类、边界值、状态迁移混在一起用,覆盖度说不清楚。这个 Skill 把流程固定成「需求理解确认 → 用例设计 → 生成 Excel」三段,每一步都有明确的输出物。

这是什么

「根据需求编写测试用例」是一个社区贡献的通用 SKILL.md Skill,坐标 @user_d8828b8e/test-case-writer,版本 1.2.0,分类 dev-programming,发布者 user_d8828b8e,来源标记为 community。定位是:输入一段需求描述,先输出一份 Word 辅助阅读文档,再产出一份可直接使用的 Excel 测试用例表。它不负责执行测试,只负责把用例设计好、排好、导出好。

核心功能

内置 7 种黑盒设计方法:场景法、等价类、边界值、因果图、正交试验、错误推测、状态迁移。每种方法都带有设计策略和适用说明,避免把方法当标签贴上去。

执行分三步。

第一步,需求提取。从口头描述、文档附件、截图等来源提取七类测试要素:功能点、输入域、约束、边界值、流程、状态、权限,逐项标注「用户说的 / 推断的」,确认后再继续。这一步解决的是需求没对齐就开写的问题。

第二步,Word 辅助阅读文档。生成一份七章递进式文档,把提取出的要素和待确认项摆在纸面上,供人阅读和批注。

第三步,用例生成。用例先去重,再按 正常 → 边界 → 异常 → 组合 排序,最终输出 9 列、蓝色表头、交替行色的专业 Excel 表格。

底层脚本内置 Windows UTF-8 编码兼容与脚本调用规范,规避中文环境下执行失败。

安装与启用

官方页面:https://api.skillhub.cn/user_d8828b8e/test-case-writer ,SkillHub 页面:https://www.skillhub.cn/skills/user_d8828b8e/test-case-writer 。Skill 标签显示 requires_api_key=false,不需要 API Key。

通用 SKILL.md 格式的 Skill 按宿主工具的 Skill 目录放置即可。以 Claude Code 为例,把 SKILL.md 放进项目或用户的 skills 目录后,用自然语言触发:

测试用例

Cursor、Codex CLI 等其他宿主工具的 Skill 目录位置和加载方式不同,需按各自文档配置,这里不逐一展开。

典型用法

输入需求,例如口头描述一段登录功能:

用户说:手机号加验证码登录,验证码 6 位数字,5 分钟内有效,同一手机号 1 小时内最多发送 5 次

Skill 会先列出七类测试要素,把「5 分钟内有效」「最多发送 5 次」这类约束逐项标注为用户说的还是推断的,输出 Word 文档待确认;确认后按 正常 / 边界 / 异常 / 组合 展开用例,例如验证码有效期边界(4 分 59 秒、5 分钟、5 分 01 秒)、发送次数边界(第 5 次、第 6 次),最终生成 Excel 表格。

触发词覆盖:测试用例、测试计划、用例编写、测试设计、功能测试、测试方案、测试分析、测试覆盖、用例评审、冒烟测试、回归用例。触发词写在需求前面即可,例如「用例评审:帮我检查这份登录需求的用例覆盖」。

适用场景与注意

适合中小型功能模块的用例设计与评审辅助,尤其是需求来自口头描述或截图、文字材料不完整的场景。它的价值在于把需求确认和用例导出流程标准化,减少人工整理时间。

注意几点:一是它不执行测试,也不做自动化,产出的是 Excel 表格,回归执行仍需接入测试框架;二是需求过于模糊时,推断出的测试要素仍需人工确认,不要把推断项当作已确认需求;三是 Excel 列结构固定为 9 列,如果团队有自定义模板,导出后需要二次调整。

结尾

这个 Skill 的价值在于流程固定:先对齐需求,再设计方法,最后导出 Excel。对于用例编写这类重复性高、又容易在需求阶段返工的活,它能把步骤和输出物约束清楚。官方地址:https://api.skillhub.cn/user_d8828b8e/test-case-writer 。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜