E2E 助手
語言: English | 繁體中文
[!WARNING] 實驗性功能 / Experimental Feature
此功能正在積極開發中,可能在 v4.0 中有重大變更。 This feature is under active development and may change significantly in v4.0.
從 BDD .feature 場景生成 E2E 測試骨架,支援框架偵測與覆蓋差距分析。
工作流程
/derive bdd → .feature 場景
↓
/e2e → 分析 AC 適用性 → 偵測框架 → 參考既有模式 → 生成骨架
↓
手動執行驗證
模式
1. 生成模式(預設)
分析 BDD 場景、分類 AC 適用性、偵測框架、生成 E2E 測試骨架。
2. 分析模式(--analyze)
掃描 BDD feature 與既有 E2E 測試之間的覆蓋差距。
AC 分類
| 類別 | 條件 | 範例 |
|---|---|---|
e2e-suitable |
多步驟使用者流程或 UI 互動 | 登入 → 操作 → 驗證 |
integration-suitable |
跨元件但無 UI | API 呼叫 → DB 寫入 |
unit-suitable |
純邏輯或計算 | 排序、驗證、格式化 |
支援框架
| 框架 | 自動偵測 | 範本 |
|---|---|---|
| Playwright | ✅ | @playwright/test |
| Cypress | ✅ | cy.* 指令 |
| Vitest | ✅ | describe/it + async |
使用方式
/e2e <feature-file> - 從 BDD 場景生成 E2E 骨架
/e2e <spec-file> - 委派 /derive e2e 處理 SDD 規格
/e2e --analyze - 掃描所有 feature 的 E2E 覆蓋差距
/e2e --analyze <feature-file> - 分析特定 feature 的 AC 適用性
下一步引導
/e2e 完成後,AI 助手應建議:
E2E 骨架已生成。建議下一步:
- 執行
/tdd填入[TODO]標記的測試實作 ⭐ 推薦 — 實作測試邏輯- 執行
/checkin品質關卡(若功能完成)- 執行
/e2e --analyze檢查整體 E2E 覆蓋狀況
參考
- 規格:SPEC-E2E-001
- 核心規範:testing-standards.md
- 工具程式:
cli/src/utils/e2e-analyzer.js、cli/src/utils/e2e-detector.js
AI 代理行為
完整的 AI 行為定義請參閱對應的命令文件:
/e2e