bdd

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 | 參考

• Detailed guide: guide.md
• Core standard: behavior-driven-development.md

AI Agent Behavior | AI 代理行為

完整的 AI 行為定義請參閱對應的命令文件：/bdd

For complete AI agent behavior definition, see the corresponding command file: /bdd