AsiaOstrich E2E Assistant | E2E 助手
[!WARNING] Experimental Feature / 實驗性功能
This feature is under active development and may change significantly in v4.0. 此功能正在積極開發中，可能在 v4.0 中有重大變更。
Generate E2E test skeletons from BDD .feature scenarios, with framework detection and coverage gap analysis.
從 BDD .feature 場景生成 E2E 測試骨架，支援框架偵測與覆蓋差距分析。
Workflow | 工作流程
/derive bdd → .feature 場景
↓
/e2e → 分析 AC 適用性 → 偵測框架 → 參考既有模式 → 生成骨架
↓
手動執行驗證
Modes | 模式
1. Generation Mode (Default) | 生成模式（預設）
Analyze BDD scenarios, classify AC suitability, detect framework, and generate E2E test skeletons.
分析 BDD 場景、分類 AC 適用性、偵測框架、生成 E2E 測試骨架。
2. Analysis Mode (--analyze) | 分析模式
Scan coverage gaps between BDD features and existing E2E tests.
掃描 BDD feature 與既有 E2E 測試之間的覆蓋差距。
AC Classification | AC 分類
| Category | Condition | Example |
|---|---|---|
e2e-suitable |
Multi-step user flow or UI interaction | Login → Action → Verify |
integration-suitable |
Cross-component without UI | API call → DB write |
unit-suitable |
Pure logic or computation | Sort, validate, format |
Supported Frameworks | 支援框架
| Ecosystem | Framework | Auto-detected | Detection signal |
|---|---|---|---|
| JavaScript | Playwright | ✅ | @playwright/test in package.json |
| JavaScript | Cypress | ✅ | cypress dep + config file |
| JavaScript | Vitest | ✅ | vitest dep + e2e directory |
| JavaScript | WebdriverIO | ❌ Manual | listed in SUPPORTED_FRAMEWORKS |
| Python | pytest-playwright | ✅ | pytest-playwright in requirements |
| Python | Selenium + pytest | ✅ | selenium in requirements |
| Python | Robot Framework | ✅ | robotframework in requirements |
| Python | Behave | ✅ | behave in requirements |
| Go | chromedp | ✅ | chromedp in go.mod |
| Go | rod | ✅ | rod in go.mod |
| Java | Selenium WebDriver | ✅ | selenium-java in pom.xml / build.gradle |
| Java | Playwright for Java | ✅ | playwright in pom.xml / build.gradle |
| Java | Gauge | ✅ | gauge-java in pom.xml / build.gradle |
| Ruby | Capybara | ✅ | capybara in Gemfile |
| Ruby | Watir | ✅ | watir in Gemfile |
| C# | Playwright for .NET | ❌ Manual | not yet auto-detected |
| C# | Selenium WebDriver | ❌ Manual | not yet auto-detected |
Usage | 使用方式
/e2e <feature-file> - Generate E2E skeleton from BDD scenarios
/e2e <spec-file> - Delegate to /derive e2e for SDD specs
/e2e --analyze - Scan all features for E2E coverage gaps
/e2e --analyze <feature-file> - Analyze specific feature's AC suitability
Next Steps Guidance | 下一步引導
After /e2e completes, the AI assistant should suggest:
E2E 骨架已生成。建議下一步 / E2E skeleton generated. Suggested next steps:
- 執行
/tdd填入[TODO]標記的測試實作 ⭐ Recommended / 推薦 — Implement test logic- 執行
/checkin品質關卡（若功能完成）— Quality gates (if feature complete)- 執行
/e2e --analyze檢查整體 E2E 覆蓋狀況 — Check overall E2E coverage
Reference | 參考
- Spec: SPEC-E2E-001
- Core standard: testing-standards.md
- Utilities:
cli/src/utils/e2e-analyzer.js,cli/src/utils/e2e-detector.js
AI Agent Behavior | AI 代理行為
完整的 AI 行為定義請參閱對應的命令文件：
/e2eFor complete AI agent behavior definition, see the corresponding command file:
/e2e