| name | bdd |
| scope | partial |
| description | [UDS] Guide through Behavior-Driven Development workflow |
| allowed-tools | Read, Write, Grep, Glob |
| argument-hint | [feature or spec | 功能或規格] |
| status | reference |
BDD Assistant | BDD 助手
⚠️ Status: Reference(參考用,非可執行流程) — BDD 生命週期協調(4 階段循環、Gherkin scaffolding、RED/GREEN 執行)已於 2026-04-28 移至 adoption layer(XSPEC-095)。此處保留 Gherkin 格式定義、Three Amigos 結構、BDD 循環圖供參考。
Lifecycle orchestration has moved to the adoption layer (XSPEC-095); this document is reference-only. For enforced execution, use your adoption layer's toolchain.
Guide through the Behavior-Driven Development (BDD) workflow using Given-When-Then format.
引導行為驅動開發(BDD)流程,使用 Given-When-Then 格式。
BDD Cycle | BDD 循環
DISCOVERY ──► FORMULATION ──► AUTOMATION ──► LIVING DOCS
^ │
└────────────────────────────────────────────┘
Workflow | 工作流程
📖 以下為流程的參考結構,非可執行步驟;自動化/強制執行請用 adoption layer 工具鏈(XSPEC-095)。
The steps below are a reference structure, not an executable workflow.
1. DISCOVERY - Explore Behavior | 探索行為
Discuss with stakeholders, identify examples and edge cases, understand the "why".
2. FORMULATION - Write Scenarios | 制定場景
Write Gherkin scenarios using ubiquitous language, make them concrete and specific.
3. AUTOMATION - Implement Tests | 自動化測試
Implement step definitions, write minimal code to pass, follow TDD within automation.
4. LIVING DOCUMENTATION - Maintain | 活文件維護
Keep scenarios current, use as shared documentation, review with stakeholders.
Gherkin Format | Gherkin 格式
Feature: User Login
As a registered user
I want to log in to my account
So that I can access my dashboard
Scenario: Successful login
Given I am on the login page
When I enter valid credentials
Then I should see my dashboard
Three Amigos | 三劍客會議
| Role | Focus | 角色 | 關注點 |
|---|
| Business | What & Why | 業務 | 什麼和為什麼 |
| Development | How | 開發 | 如何實現 |
| Testing | What if | 測試 | 假設情況 |
Usage | 使用方式
/bdd - Start interactive BDD session | 啟動互動式 BDD 會話
/bdd "user can reset password" - BDD for specific feature | 針對特定功能
/bdd login-feature.feature - Work with existing feature file | 處理現有功能檔案
Next Steps Guidance | 下一步引導
After /bdd completes, the AI assistant should suggest:
BDD 場景已定義。建議下一步 / BDD scenarios defined. Suggested next steps:
- 執行
/tdd 實作步驟定義 ⭐ Recommended / 推薦 — Implement step definitions
- 執行
/checkin 品質關卡(若功能完成)— Quality gates (if feature complete)
- 與利害關係人審查場景確保業務正確性 — Review scenarios with stakeholders
Reference | 參考
AI Agent Behavior | AI 代理行為
完整的 AI 行為定義請參閱對應的命令文件:/bdd
For complete AI agent behavior definition, see the corresponding command file: /bdd