Bdd Assistant

---
name: bdd
source: ../../../../skills/bdd-assistant/SKILL.md
source_version: 1.0.0
translation_version: 1.1.0
last_synced: 2026-08-17
status: current
description: |
  [UDS] 行為驅動開發（BDD）的參考資料：Gherkin 的 Given-When-Then 格式與 Three Amigos 結構。
  Use when: 撰寫或審查 .feature 場景、選定通用語言、針對行為進行探索式對話。
  Not for: 執行 BDD 生命週期或 RED/GREEN 自動化——該部分已移至採用層（XSPEC-095）；把 .feature 檔轉成 E2E 骨架——請用 /e2e。
  Keywords: BDD, Gherkin, Given When Then, feature file, scenario, Three Amigos, 行為驅動開發, 場景, 特性檔, 通用語言.
allowed-tools: Read, Write, Grep, Glob
scope: partial
argument-hint: "[feature or spec | 功能或規格]"
---

# BDD 助手

> **語言**: [English](../../../../skills/bdd-assistant/SKILL.md) | 繁體中文

> ⚠️ **狀態：參考用（非可執行流程）** — BDD 生命週期協調（4 階段循環、Gherkin scaffolding、RED/GREEN 執行）已於 2026-04-28 移至 **adoption layer（XSPEC-095）**。此處保留 Gherkin 格式定義、Three Amigos 結構、BDD 循環圖供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。

引導行為驅動開發（BDD）流程，使用 Given-When-Then 格式。

## BDD 循環

DISCOVERY ──► FORMULATION ──► AUTOMATION ──► LIVING DOCS

## 工作流程

### 1. DISCOVERY - 探索行為
與利害關係人討論、識別範例和邊界案例、理解「為什麼」。

### 2. FORMULATION - 制定場景
使用通用語言撰寫 Gherkin 場景，確保具體且明確。

### 3. AUTOMATION - 自動化測試
實作步驟定義，撰寫最小化程式碼以通過測試，在自動化中遵循 TDD。

### 4. LIVING DOCUMENTATION - 活文件維護
保持場景為最新狀態，作為共享文件使用，與利害關係人定期審查。

## Gherkin 格式

```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
```

## 三劍客會議

| 角色 | 關注點 | Role | Focus |
|------|--------|------|-------|
| **業務** | 什麼和為什麼 | Business | What & Why |
| **開發** | 如何實現 | Development | How |
| **測試** | 假設情況 | Testing | What if |

## 使用方式

- `/bdd` - 啟動互動式 BDD 會話
- `/bdd "user can reset password"` - 針對特定功能進行 BDD
- `/bdd login-feature.feature` - 使用現有的 feature 檔案

## 下一步引導

`/bdd` 完成後，AI 助手應建議：

> **BDD 場景已定義。建議下一步：**
> - 執行 `/tdd` 實作步驟定義
> - 執行 `/checkin` 品質關卡（若功能完成）
> - 與利害關係人審查場景確保業務正確性

## 參考

- [BDD 工作流程指南](./bdd-workflow.md) — 要把探索、制定、自動化當一個循環跑時讀它。
- [Gherkin 快速參考指南](./gherkin-guide.md) — 要寫 Given／When／Then 而需要確切語法時讀它。
- 詳細指南：[guide.md](./guide.md)
- 核心規範：[behavior-driven-development.md](../../../../core/behavior-driven-development.md)