SuperAPI AI 工具集

playwright-documentation-tdd

测试与质量

查看项目

更新于 10-22 01:53

技能介绍

用途

该技能用于将测试用例整理为结构化的场景文档,适用于用户希望获得正式测试用例规格而非轻量笔记的场景。它是 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。资料未提供具体的安装命令、收费方式、支持平台或运行环境要求。