用途:这是一个面向 Playwright E2E 测试套件的技能,用来生成由工单驱动的临时交接测试(handover test),验证某张工单的验收标准。
工作流程:从用户请求中解析工单编号与描述(如 PROJ-456 bulk export);检查 e2e/poms/ 下是否已有被测页面的 POM,有则读取并补充该工单验收标准所需的新方法,没有则先用 create-pom 技能创建;检查测试数据是否需要新建或更新;在 e2e/tests/handover/ 下创建 spec 文件;运行验证:npx playwright test --project="chromium:handover" {TICKET}-{description}.spec.ts。
命名与结构:文件名为 {TICKET}-{short-description}.spec.ts,工单号原样保留,短描述用 kebab-case;外层 test.describe 需包含工单编号以便追溯;测试从自定义 fixtures 导入 test,而非 @playwright/test;交互全部经 POM,测试之间相互独立,不硬编码数据而使用 testData fixture。
POM 规则:复用被测页面既有 POM,新交互只向既有 POM 添加方法,不为同一页面建第二个 POM;只有工单引入全新页面时才新建 POM;新增方法需带完整 JSDoc(含 Steps 与 @param)。
生命周期与限制:交接测试是临时性的,工单完成后应提升为回归或冒烟测试,或删除,可用 promote-handover-test 技能处理;每次 sprint/release 后审查 tests/handover/,工单已 Done/Closed 的 spec 应提升或删除,不应长期保留。完整模板见 references/handover-spec-template.md。