测试用例生成器(test-cases)
从 PRD 或需求文档自动生成结构化测试用例,覆盖功能、边界、异常与状态流转场景。
该技能仅要求读取用户提供的PRD文件并向 tests/ 目录写入Markdown,权限最小、无外部副作用、无依赖或网络调用,数据流向透明;扣分点:缺少对覆盖已有文件、敏感信息进入测试用例等情形的确认与回滚说明,来源归属依赖未验证的发布者。
工作流步骤自洽、模板和检查清单完整,指令层面可复现;但纯提示词技能无自身测试、对异常输入(空PRD、格式错误的文件路径)的失败反馈仅依赖 AskUserQuestion,错误处理薄弱,故不超过10分。
触发条件描述清晰(测试用例生成、QA规划等),输出格式明确且含中文摘要要求,对中文用户基本友好、无海外服务依赖;扣分点:未声明不适用边界(如非功能性/性能测试场景仅略微提及),缺少自动化触发精度证据。
文档分层良好(SKILL.md + references),含示例和质量清单;扣分点:SKILL.md frontmatter 声明 MIT 而仓库整体为 AGPL-3.0,许可不一致;无版本号、变更日志或明确的维护责任说明。
核心目标(需求到结构化测试用例)合理且有模板支撑,边际价值明确;但纯静态审阅无法验证输出可直接可用,且对复杂PRD的覆盖质量缺少代表性证据,故不超过7分。
仅有作者自述的指令与参考文档;CI测试针对的是 codeagent-wrapper 与 harness 技能,与本技能关键路径无关,无第三方执行证据覆盖此技能,故仅为有限可审计材料。
- 注意 SKILL.md 声明 MIT 而仓库为 AGPL-3.0,使用前请确认实际许可约束。
- 技能会直接写入 tests/ 目录,若已有同名文件可能被覆盖,请先备份。
- 生成测试用例的质量依赖输入PRD质量,建议人工复核覆盖矩阵。
- 发布者身份未经验证,依赖其后续维护存在不确定性。
这个 Skill 能做什么,适合哪些场景?
test-cases 是 stellarlinkco/myclaude 仓库中的一个独立技能,用于将产品需求文档(PRD)或口述需求转化为结构化的 Markdown 测试用例文档。它遵循"测试该测的内容"的务实理念,要求每条需求至少有一条测试用例覆盖,并维护需求与用例之间的可追溯映射。输出按功能测试(TC-F)、边界测试(TC-E)、异常处理测试(TC-ERR)、状态流转测试(TC-ST)四类组织,附覆盖矩阵。该技能是仓库 11 个技能之一,通过交互式安装器随整个集合一起安装。
读取 PRD 文件或用户口述的需求;需求不清晰时通过 AskUserQuestion 向用户确认核心流程、验收标准、边界场景与状态流转;随后提取功能、边界、异常和状态流转四类测试场景,为每个场景标注前置条件、测试步骤、预期结果与后置条件;生成带唯一编号(TC-F/TC-E/TC-ERR/TC-ST)、优先级和需求追溯链接的测试用例;校验每条需求是否至少有一条用例覆盖并生成覆盖矩阵;最终用 Write 工具将文档写入 tests/<name>-test-cases.md,并用中文输出用例总数与覆盖分布摘要。
- QA 工程师拿到产品经理的 PRD 文档,需要在动手测试前生成一份覆盖功能、边界和异常场景的完整测试用例文档
- 测试负责人希望确认每条需求都有对应测试用例,通过覆盖矩阵发现遗漏的测试盲区
- 开发者在实现有状态功能(如订单流程、会话管理)后,需要系统地梳理所有合法状态流转的测试场景
- 团队成员在需求描述模糊时,借助技能内置的澄清问题(核心流程、验收标准、边界条件)补齐需求再生成用例
- 需要将测试文档以统一的 Markdown 模板归档到 tests/ 目录、便于版本管理和小团队协作的场合
这个 Skill 有哪些优点和局限?
- 强制需求到用例的可追溯映射,覆盖矩阵能直观暴露测试盲区
- 四类场景(功能、边界、异常、状态流转)分类清晰,编号规范统一
- 输出为纯 Markdown,无脚本依赖,易于评审、归档和版本管理
- 内置需求澄清环节,在输入模糊时主动向用户提问而不是臆测
- 工作流含自检清单,生成前会校验覆盖完整性
- 只产出静态的测试用例文档,不执行任何实际测试或自动化脚本
- 质量完全依赖输入需求的质量,PRD 本身含糊时产出也会含糊
- 正文引用了 references/testing-principles.md,但源材料未提供其内容,无法核实深度
- SKILL.md 中标注 MIT 许可证,而仓库整体为 AGPL-3.0,许可证归属存在不一致,商用前需向维护方确认
- 仓库未提供针对该技能的独立测试套件或用户反馈证据
如何安装这个 Skill?
安装整个技能集合:在终端运行 npx github:stellarlinkco/myclaude 进入交互式安装器,或先用 npx github:stellarlinkco/myclaude --list 查看可安装项(其中包含 test-cases 技能)。默认安装目录为 ~/.claude,可用 --install-dir 指定其他目录,--force 强制覆盖。源文档未说明是否支持单独安装 test-cases 这一个技能。
如何使用这个 Skill?
在 Claude Code 中直接用自然语言触发,例如:"为 docs/auth-prd.md 中的用户认证功能生成测试用例"。技能会读取该 PRD,提取需求,生成测试用例并写入 tests/auth-test-cases.md。也可以在需求不完整时直接口述需求,技能会先向你提问澄清。任何提到"生成测试用例"、"创建测试场景"或"规划 QA"的请求都会触发此技能。