e2e

E2E 指令 (E2E Command)

此指令调用 E2E 运行者 (e2e-runner) 智能体，使用 Playwright 生成、维护和执行端到端测试。

此指令的功能

1. 生成测试旅程 - 为用户流程创建 Playwright 测试
2. 运行 E2E 测试 - 跨浏览器执行测试
3. 捕获工件 - 在失败时捕获截图、视频和追踪
4. 上传结果 - 生成 HTML 报告和 JUnit XML
5. 识别不稳定测试 - 隔离不稳定的测试 (Flaky Tests)

何时使用

在以下情况使用 /e2e：

• 测试关键用户旅程（登录、交易、支付）
• 验证多步骤流程是否端到端端正常工作
• 测试 UI 交互和导航
• 验证前端和后端之间的集成
• 准备生产部署时

工作原理

E2E 运行者智能体将：

1. 分析用户流程 并识别测试场景
2. 生成 Playwright 测试 使用页面对象模型 (Page Object Model) 模式
3. 运行测试 跨多个浏览器 (Chrome, Firefox, Safari)
4. 捕获失败 包含截图、视频和追踪
5. 生成报告 包含结果和工件
6. 识别不稳定测试 并推荐修复方案

使用示例

User: /e2e Test the market search and view flow
(用户：/e2e 测试市场搜索和查看流程)

Agent (e2e-runner):
# E2E Test Generation: Market Search and View Flow
(E2E 测试生成：市场搜索和查看流程)

## Test Scenario Identified (识别的测试场景)

**User Journey (用户旅程):** Market Search (市场搜索) → View Results (查看结果) → Click Market (点击市场) → View Details (查看详情)

**Test Coverage (测试覆盖):**
1. Navigate to markets page (导航到市场页面)
2. Perform semantic search (执行语义搜索)
3. Verify search results (验证搜索结果)
4. Click on first result (点击第一个结果)
5. Verify market details page loads (验证市场详情页加载)
6. Verify chart renders (验证图表渲染)

## Generated Test Code (生成的测试代码)

```typescript
// tests/e2e/markets/search-and-view.spec.ts
import { test, expect } from '@playwright/test'
import { MarketsPage } from '../../pages/MarketsPage'
import { MarketDetailsPage } from '../../pages/MarketDetailsPage'

test.describe('Market Search and View Flow', () => {
  test('user can search markets and view details', async ({ page }) => {
    // 1. Navigate to markets page
    const marketsPage = new MarketsPage(page)
    await marketsPage.goto()

    // Verify page loaded
    await expect(page).toHaveTitle(/Markets/)
    await expect(page.locator('h1')).toContainText('Markets')

    // 2. Perform semantic search
    await marketsPage.searchMarkets('election')

    // Wait for API response
    await page.waitForResponse(resp =>
      resp.url().includes('/api/markets/search') && resp.status() === 200
    )