前言¶
手写测试用例有两个常见问题:一是需求还没对齐就开写,返工率高;二是设计方法停留在口头,等价类、边界值、状态迁移混在一起用,覆盖度说不清楚。这个 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 。