feat: increase bdd principles in spec stage

Author: 薛華慶, james.hsueh

scripts/templates/sdd-spec.md

@@ -19,6 +19,41 @@ __PROMPT__
 - 思考：系統應該做什麼？有哪些邊界情況？如何處理錯誤？
 - 只使用 Gherkin 語法（Given-When-Then）。
 
+## 重要：行為描述 vs 實作細節
+
+**您的目標是撰寫「功能規格」，而非「測試步驟」。**
+
+### ❌ 避免：實作細節和測試步驟
+- 具體的計算數值（例如："價格應該是 800 美元"）
+- 資料庫欄位或技術術語
+- UI 元件細節（按鈕、表單）
+- 系統內部狀態
+
+### ✅ 推薦：業務行為和用戶價值
+- 業務規則和政策（例如："VIP 會員應該獲得折扣優惠"）
+- 用戶期望和體驗（例如："購物車應該反映優惠後的金額"）
+- 業務價值（例如："提高客戶忠誠度"）
+- 從用戶角度描述行為
+
+### 對比範例
+
+**❌ 實作細節（測試步驟）：**
+```gherkin
+Given 使用者的會員等級是 "VIP"
+When 使用者購買金額是 1000 美元
+Then 折扣金額應該是 200 美元
+And 最終價格應該是 800 美元
+```
+
+**✅ 行為描述（功能規格）：**
+```gherkin
+Given 一位 VIP 會員進行結帳
+And 購物車金額達到優惠門檻
+When 會員完成訂單
+Then 系統應該自動套用 VIP 專屬折扣
+And 訂單摘要應該顯示折扣優惠
+```
+
 ## 您的任務
 
 1. **檢查需求衝突**：
@@ -50,68 +85,82 @@ Feature: <清楚簡潔的功能名稱>
   <功能業務價值的簡短描述>
 
   Scenario: <正常流程情境名稱>
-    Given <前置條件 1>
-    And <前置條件 2>
-    When <使用者動作或事件>
-    And <額外動作（如需要）>
-    Then <預期結果 1>
-    And <預期結果 2>
+    Given <業務前置條件，從用戶角度描述>
+    And <補充前置條件>
+    When <用戶執行的業務動作>
+    And <額外的業務動作（如需要）>
+    Then <預期的業務結果，描述行為而非驗證>
+    And <補充的業務結果>
 
   Scenario: <邊界情況情境名稱>
-    Given <邊界情況設定>
-    When <邊界情況下的動作>
-    Then <預期行為>
+    Given <邊界情況的業務場景>
+    When <邊界情況下的用戶動作>
+    Then <系統應展現的業務行為>
 
   Scenario: <錯誤處理情境名稱>
-    Given <無效條件>
-    When <嘗試的動作>
-    Then <預期的錯誤回應>
+    Given <導致錯誤的業務情境>
+    When <觸發錯誤的用戶動作>
+    Then <系統應如何回應（從業務角度）>
 ```
 
+**撰寫技巧：**
+- Given：描述業務情境，而非系統狀態（例如：「VIP 會員進行結帳」而非「會員等級 = VIP」）
+- When：描述用戶行為，而非系統操作（例如：「完成訂單」而非「呼叫 checkout API」）
+- Then：描述業務期望，而非技術驗證（例如：「應該套用折扣」而非「折扣 = 200」）
+
 ## 範例輸出
 
 針對需求："VIP 使用者購買超過 $100 可享 20% 折扣"
 
 ```gherkin
-Feature: VIP 折扣系統
-  作為企業，我想要給予 VIP 客戶折扣優惠
+Feature: VIP 會員優惠計劃
+  作為企業，我想要給予 VIP 客戶購物折扣優惠
   以提高客戶忠誠度和重複購買率。
 
-  Scenario: 對 VIP 使用者套用折扣
-    Given 使用者是 VIP
-    When 使用者購買 1000 美元
-    Then 最終價格應該是 800 美元
-    And 套用的折扣應該是 200 美元
-
-  Scenario: 非 VIP 使用者無折扣
-    Given 使用者是 NORMAL
-    When 使用者購買 1000 美元
-    Then 最終價格應該是 1000 美元
-    And 套用的折扣應該是 0 美元
-
-  Scenario: 購買金額低於門檻無折扣
-    Given 使用者是 VIP
-    When 使用者購買 50 美元
-    Then 最終價格應該是 50 美元
-    And 套用的折扣應該是 0 美元
-
-  Scenario: 處理無效的購買金額
-    Given 使用者是 VIP
-    When 使用者購買 -100 美元
-    Then 系統應該拒絕並回應錯誤 "無效的購買金額"
+  Scenario: VIP 會員大額購物獲得優惠
+    Given 一位 VIP 會員進行結帳
+    And 購物車金額達到優惠門檻
+    When 會員完成訂單
+    Then 系統應該自動套用 VIP 專屬折扣
+    And 訂單摘要應該顯示折扣優惠
+
+  Scenario: 一般會員無優惠資格
+    Given 一位一般會員進行結帳
+    And 購物車金額達到優惠門檻
+    When 會員完成訂單
+    Then 系統應該以原價結帳
+    And 訂單摘要不顯示折扣資訊
+
+  Scenario: VIP 會員小額購物未達門檻
+    Given 一位 VIP 會員進行結帳
+    And 購物車金額未達優惠門檻
+    When 會員完成訂單
+    Then 系統應該以原價結帳
+    And 提示會員還需消費多少才能享有優惠
+
+  Scenario: 拒絕異常的訂單金額
+    Given 會員嘗試建立訂單
+    When 購物車金額為負數或零
+    Then 系統應該拒絕訂單
+    And 提示會員購物車金額無效
 ```
 
 ## 品質檢查清單
 
 完成前，確保您的規格具有：
 - [ ] 已檢查與現有功能的衝突（如有衝突已向使用者確認）
-- [ ] 清楚的功能描述
+- [ ] 清楚的功能描述，強調業務價值
 - [ ] 至少一個正常流程情境
 - [ ] 至少一個邊界情況情境
 - [ ] 至少一個錯誤處理情境
 - [ ] 沒有技術實作細節（沒有資料庫、沒有程式碼、沒有架構）
 - [ ] 所有情境遵循 Given-When-Then 格式
 - [ ] 每個情境都是原子性且可測試的
+- [ ] **使用行為描述而非實作細節**：
+  - [ ] 避免具體的計算數值和測試斷言
+  - [ ] 從用戶或業務角度描述期望行為
+  - [ ] 描述「應該發生什麼」而非「如何驗證」
+  - [ ] 使用業務語言而非技術術語
 
 ## 下一步