generate-e2e-test

generate-e2e-test 技能是一项全面的工程自动化工具，旨在连接用户定义的工作流程与稳健的测试覆盖率。它作为一个智能助手，接收高阶功能描述或用户故事，并将其转换为生产就绪的 Playwright 测试代码。通过利用 Playwright MCP 工具，代理程序会在浏览器中逐步执行工作流程，实时捕捉状态、选择器和交互序列，然后完成测试实现。

此技能适用于需要维持高测试速度且不想手动编写样板代码的软件工程师与 QA 专业人员。它在自动化回归测试套件、将手动测试流程转换为持久的自动化资产，以及确保测试模式在身份验证、仪表板管理和复杂客户端功能等不同项目领域中的一致性方面特别有效。

• 使用 Playwright 浏览器工具以交互方式执行工作流程，实现精确的状态捕捉与元素识别。

• 自动提取稳定的选择器，优先采用基于无障碍访问 (Accessibility) 的策略 (如 role, aria-label) 而非脆弱的 CSS。

• 审查 TESTING.md 与 e2e-utils 中的项目特定测试规范、夹具 (fixtures) 和公用函数，确保生成的代码遵循既定架构。

• 在最终提交前，通过在环境中执行生成的测试来验证其正确性，并调试选择器、时间问题或断言失败。

• 根据功能区域（如 admin, auth, workouts）将测试规约放置在适当的子目录中，以支持结构化的测试组织。

• 始终从导航至目标网址并利用 browser_snapshot 映射应用程序状态开始。

• 优先使用 tests/e2e/utils/test-helpers.ts 中的助手方法，以维持与现有项目模式的一致性。

• 使用稳健的等待策略 (如 waitForElementWithRetry) 而非静态延迟，以防止测试不稳定 (flakiness)。

• 处理复杂表单时，使用 browser_fill_form 以提高效率，并始终通过断言或吐司通知检查来验证结果。

• 尽早追踪会话状态与验证要求；若存在身份验证助手，请将其整合至测试初始化阶段。