需要 Playwright smoke 端到端验证时…

在变更前后需要 Playwright 冒烟测试做端到端验证时，用来运行相关 smoke 套件、调试失败并确认最小修复稳定。

适用场景

解决思路

1. 为目标应用构建前置条件/准备构建产物。
2. 运行相关的 smoke 套件，或聚焦运行单个测试文件。
3. 如果失败，检查 trace/日志并隔离根因。
4. 应用最小修复并重跑，直到稳定。
5. 运行完整 smoke 套件：npm run smoketest
6. 运行指定 smoke 测试文件：npm run smoketest -- path/to/test.spec.ts
7. 当构建产物已就绪、需要更快迭代时运行：npm run smoketest-no-compile -- path/to/test.spec.ts
8. 优先使用确定性等待和断言，而不是脆弱的时间超时。
9. 对已经通过的修复进行重跑，以减少 flaky 假阳性。
10. 仅在被明确要求并记录文档时，才隔离测试。
11. 输出测试结果摘要。
12. 输出根因和修复。
13. 输出剩余 flake 风险（如有）。

适用边界 · 注意事项

• 不适用于替代完整回归测试、性能测试或安全测试；它只做端到端冒烟验证。
• 不适用于目标应用前置构建未完成、依赖未安装或测试环境不可用的场景。
• 不适用于未配置 Playwright 和对应 npm smoketest 脚本的项目。