e2e-assistant

name	e2e-assistant
source	../../../../skills/e2e-assistant/SKILL.md
source_version	1.0.0
translation_version	1.0.0
last_synced	"2026-04-10T00:00:00.000Z"
status	current
description	[UDS] 從 BDD 場景生成 E2E 測試骨架，支援框架偵測與覆蓋差距分析

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