atdd-assistant

name	atdd-assistant
source	../../../../skills/atdd-assistant/SKILL.md
source_version	1.0.0
translation_version	1.0.0
last_synced	"2026-02-10T00:00:00.000Z"
status	current
description	[UDS] 引導驗收測試驅動開發（ATDD）流程，用於定義和驗證使用者故事

ATDD 助手

語言: English | 繁體中文

⚠️ 狀態：參考用（非可執行流程） — 5 階段 ATDD 生命週期協調（WORKSHOP→DISTILLATION→DEVELOPMENT→DEMO→DONE、INVEST 驗證、AC→Gherkin 轉換、RED/GREEN 執行、PO sign-off gates）已於 2026-04-28 移至 adoption layer（XSPEC-095）。此處保留 INVEST 準則、ATDD 循環圖、Gherkin AC 格式、Three Amigos 結構供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。

引導驗收測試驅動開發（ATDD）流程，用於定義和驗證使用者故事。

ATDD 循環

WORKSHOP ──► DISTILLATION ──► DEVELOPMENT ──► DEMO ──► DONE

工作流程

1. WORKSHOP - 定義驗收條件

PO 提出使用者故事，團隊提出澄清問題，共同定義驗收條件。

2. DISTILLATION - 轉換為測試

將驗收條件轉換為可執行的測試格式，消除歧義，取得 PO 簽核。

3. DEVELOPMENT - 實作

執行驗收測試（初始應失敗），使用 BDD/TDD 進行實作，迭代直到全部通過。

4. DEMO - 向利害關係人展示

展示通過的驗收測試，示範可運作的功能，取得正式驗收。

5. DONE - 完成

PO 已驗收，程式碼已合併，故事已關閉。

INVEST 準則

準則	說明	Criterion	Description
Independent	可獨立開發	Independent	Can be developed separately
Negotiable	可協商細節	Negotiable	Details can be discussed
Valuable	提供商業價值	Valuable	Delivers business value
Estimable	可估算工作量	Estimable	Can estimate effort
Small	一個 Sprint 可完成	Small	Fits in one sprint
Testable	有明確驗收條件	Testable	Has clear acceptance criteria

使用者故事格式

As a [role],
I want [feature],
So that [benefit].

### Acceptance Criteria
- Given [context], when [action], then [result]

使用方式

• /atdd - 啟動互動式 ATDD 會話
• /atdd "user can reset password" - 針對特定功能進行 ATDD
• /atdd US-123 - 針對現有使用者故事進行 ATDD

下一步引導

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

驗收測試已定義。建議下一步：

• 執行 /sdd 建立規格文件
• 執行 /bdd 將 AC 轉為 Gherkin 場景
• 執行 /tdd 直接實作驗收測試

參考

• 詳細指南：guide.md
• 核心規範：acceptance-test-driven-development.md