| name | test-case-generator |
| description | 根据 PRD 文档生成测试用例文档。当用户需要为新功能编写测试用例、生成测试计划、创建测试文档时使用此技能。触发词包括:测试用例、测试文档、生成测试、测试计划、QA 文档等。必须先查看 PRD 文档和现有代码才能生成。 |
测试用例生成技能
根据 PRD 文档和现有代码生成测试用例文档。
核心规则(必须遵守)
强制前置条件
在生成任何测试用例之前,必须满足以下两个条件:
-
必须获取 PRD 文档
- 用户必须提供 PRD 文档路径
- 必须完整读取并理解 PRD 文档内容
- 如果用户未提供 PRD 文档,立即询问并拒绝继续
-
必须查看现有代码
- 根据 PRD 内容智能推断相关代码位置
- 查看与功能相关的现有代码结构
- 了解当前代码架构和模式
禁止行为:
- 禁止在没有 PRD 文档的情况下生成测试用例
- 禁止在没有查看现有代码的情况下生成测试用例
- 禁止凭空臆测功能细节
工作流程
阶段一:获取 PRD 文档
询问用户 PRD 文档位置:
"请提供 PRD 文档的路径,例如:docs/prd/功能名称.md"
收到路径后:
- 读取完整的 PRD 文档
- 提取关键信息:功能列表、用户场景、验收标准、业务规则
- 向用户确认理解是否正确
阶段二:查看现有代码
根据 PRD 文档内容,智能推断需要查看的代码:
-
分析 PRD 涉及的模块
- 识别功能涉及的页面/组件
- 识别相关的 API 接口
- 识别涉及的数据模型
-
搜索相关代码
- 使用 Glob 查找相关文件
- 使用 Grep 搜索关键词
- 阅读核心文件了解现有实现模式
-
总结代码现状
- 向用户说明查看了哪些代码
- 说明当前代码与 PRD 需求的关系
- 确认是否需要查看其他代码
阶段三:确认输出位置
"PRD 文档和代码已分析完毕。请问测试用例文档要保存到哪里?请提供完整路径,例如:docs/test-cases/功能名称-测试用例.md"
阶段四:生成测试用例文档
按照 references/template.md 模板结构生成文档。
测试用例覆盖范围:
- 功能测试:验证 PRD 中每个功能点
- 边界测试:验证边界条件和异常情况
- UI/交互测试:验证用户操作流程
生成原则:
- 测试用例必须与 PRD 需求一一对应
- 结合现有代码结构设计测试路径
- 每个用例必须有明确的预期结果
- 优先级基于 PRD 中的功能优先级
错误处理
用户未提供 PRD
无法继续生成测试用例。
根据技能规则,必须先提供 PRD 文档才能生成测试用例。
请提供 PRD 文档路径,例如:docs/prd/xxx.md
如果还没有 PRD 文档,建议先使用 /prd-writer 创建。
PRD 文档不存在或无法读取
无法读取指定的 PRD 文档:[路径]
请确认:
1. 文件路径是否正确
2. 文件是否存在
请提供正确的 PRD 文档路径。
无法定位相关代码
根据 PRD 文档,我尝试查找以下相关代码但未找到:
- [搜索的内容]
请问:
1. 这是一个全新功能,还没有相关代码?
2. 相关代码在其他位置?请指定目录。
模板参考
详细测试用例模板见 references/template.md