用途
该技能用于将测试用例整理为结构化的场景文档,适用于用户希望获得正式测试用例规格而非轻量笔记的场景。它是 Playwright 专用的旧版别名,官方说明建议优先使用独立的 test-management-sync 技能来格式化已批准的测试用例。
主要能力
每个测试用例输出一份场景文档,包含以下字段:
- title
- description
- test_suite
- covered_requirement
- preconditions
- steps
- execution_type
- design_status
- test_engineer
- test_level
- jira
- test_script
步骤部分使用 Markdown 步骤表,列为 Step、Action、Expected result。
使用方式
可追溯性规则
- 使用仓库相对路径的自动化引用,例如
tests/e2e/auth/login.spec.ts#AUTH-US02-user-login。 - 保持需求引用明确且稳定。
- 如果自动化尚不存在,应如实说明,而不是编造脚本链接。
组织规则
- 当用户需要长期维护的测试文档树时,优先按功能或故事建立文件夹。
- 当文档需要长期维护时,每个文件只放一个场景。
- 按所描述的行为命名文件,而不是仅使用任意编号。
写作规则
- 前置条件应描述有意义的起始状态,而不是每个测试都隐含共享的样板内容。
- 步骤应反映有意义的用户或系统操作,而不是每一个底层点击。
- 预期结果应断言需求本身,而不是使用通用的成功措辞。
适用场景
适用于需要结构化测试用例规格、需要维护测试文档树、需要将测试用例与需求及自动化脚本建立可追溯关系的团队或个人。
限制
该技能为旧版 Playwright 专用别名,官方建议优先使用 test-management-sync。资料未提供具体的安装命令、收费方式、支持平台或运行环境要求。