| name | x4-e2e-test-run |
| description | Run change-scoped X4 Playwright E2E tests and validate implementation coverage against `e2e_test_tasks.md`. Trigger with /x4:e2e-test-run <change-name>. |
X4 E2E Test Run
目的
运行指定 change 的 E2E 测试,并在运行前后确认 e2e_test_tasks.md 与实际 Playwright 用例仍保持对应。
输入
openspec/changes/<change-name>/e2e_tests.md
openspec/changes/<change-name>/e2e_test_tasks.md
openspec/changes/<change-name>/fixtures.md(如存在)
tests/e2e/<change-name>/**/*.spec.ts
执行步骤
- 先运行任务-测试映射校验:
python3 .trae/skills/x4-e2e-test-impl/scripts/validate_e2e_case_refs.py <change-name> --json
- 如果映射校验失败:
- 缺少用例或子任务注释:交回
x4-e2e-test-impl。
e2e_tests.md 顶层任务本身不合理:交回 x4-e2e-test-doc。
e2e_test_tasks.md 细化不合理:交回 x4-e2e-test-doc-details。
- 运行 change-scoped Playwright:
npm exec playwright test -- tests/e2e/<change-name>
- 如果测试失败,读取失败输出并分类:
- 测试实现问题:交回
x4-e2e-test-impl。
- 高层测试方案与真实需求冲突:交回
x4-e2e-test-doc。
- 子任务、fixture、knowledge 与真实需求冲突:交回
x4-e2e-test-doc-details。
- 产品缺陷:记录失败现象、复现路径、关联任务编号,交给缺陷修复流程。
- 对已执行且可判定的 E2E case 应用结果:
python3 .trae/skills/x4-e2e-test-run/scripts/apply_e2e_test_results.py <change-name> \
--successes "1.1,1.2" \
--failures "1.3" \
--fail-steps "1.3.2" \
--json
- 测试通过或结果应用后,再运行一次映射校验,防止调试过程中破坏任务对应关系。
约束
- 本 skill 不修改产品代码。
- 本 skill 不修改旧
test_tasks.md。
- checklist 状态只能通过
apply_e2e_test_results.py 修改,不手动打勾。
- 不把失败测试标记为完成;失败 case 使用
[✗],失败点之前的同级子任务使用 [✓],失败点之后保持 [ ]。
- 如果需要更新文档或实现,只说明交回哪个 skill,并列出具体原因。
输出
- 映射校验命令与结果。
- Playwright 命令与结果。
e2e_test_tasks.md 结果应用命令与结果。
- 失败分类和下一步交接目标,或通过摘要。