SuperAPI AI 工具集

create-acceptance-test

测试与质量

查看项目

更新于 10-15 19:51

技能介绍

用途:根据用户请求中的票据键与描述,生成验证特定验收标准的验收测试,适用于 Playwright E2E 测试套件。

主要能力与流程:解析票据键和描述(如 PROJ-456 bulk export);检查 e2e/poms/ 下是否已有被测页面的 POM,有则读取并补充本票据验收标准所需的新方法,没有则先用 create-pom 技能创建;检查测试数据并按需创建或更新;在 e2e/tests/acceptance/ 创建 spec 文件;运行测试验证通过:npx playwright test --project="chromium:acceptance" {TICKET}-{description}.spec.ts。

命名与结构:文件名为 {TICKET}-{short-description}.spec.ts,票据键与跟踪器中完全一致,短描述用 kebab-case 且非完整标题,例如 PROJ-456-bulk-export.spec.ts。外层 test.describe 必须包含票据键以便追溯,如 test.describe('PROJ-456: Bulk Export', () => {。spec 从自定义 fixtures 导入 test,而非 @playwright/test;所有交互通过 POM,不在 spec 中直接调用 page;每个测试独立创建数据并独立导航;测试数据通过 testData fixture 使用外部 JSON,不硬编码;beforeAll 使用带 storageState 的手动浏览器上下文做清理。POM 规则:复用现有 POM,新交互加到现有 POM 而非为同一页面建第二个 POM,仅当票据引入全新页面时才新建 POM,新方法需完整 JSDoc 含 Steps 与 @param。

生命周期与限制:验收测试按设计是临时的,票据完成后应提升为回归测试(功能永久、每次构建运行)、提升为冒烟测试(关键路径)或删除(已被覆盖或功能回滚),可使用 promote-acceptance-test 技能。每个 sprint/发布后审查 tests/acceptance/,票据已 Done/Closed 的 spec 应提升或删除,不应无限期保留。文件清单包括 POM、测试数据与 spec 文件,并需满足文件名含票据前缀、describe 含票据键、POM 方法有 JSDoc、测试通过等检查项。完整模板见 references/acceptance-spec-template.md。