feat: update spec content

Author: 薛華慶, james.hsueh

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gsi-protocol-installer"
-version = "1.1.2"
+version = "1.1.3"
 description = "Installer for GSI-Protocol workflow commands (Claude Code & Codex)"
 authors = [
     {name = "James Hsueh", email = "[email protected]"}

scripts/templates/sdd-spec.md

@@ -10,7 +10,7 @@ description: 階段 1 - 從使用者需求生成 Gherkin 行為規格（PM 角
 
 ## 使用者需求
 
-__PROMPT__
+**PROMPT**
 
 ## 您的職責約束
 
@@ -19,49 +19,14 @@ __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. **檢查需求衝突**：
    - 檢視 `features/` 目錄中所有現有的 feature 檔案
    - 分析新需求是否與現有功能規格存在衝突或矛盾
    - 如果發現衝突，**立即停止並向使用者確認**：
-     * 列出衝突的功能和具體衝突點
-     * 詢問使用者如何處理（修改現有功能、調整新需求、或確認覆蓋）
+     - 列出衝突的功能和具體衝突點
+     - 詢問使用者如何處理（修改現有功能、調整新需求、或確認覆蓋）
    - 只有在無衝突或使用者確認後才繼續下一步
 
 2. **分析需求**，考慮：
@@ -85,88 +50,76 @@ Feature: <清楚簡潔的功能名稱>
   <功能業務價值的簡短描述>
 
   Scenario: <正常流程情境名稱>
-    Given <業務前置條件，從用戶角度描述>
-    And <補充前置條件>
-    When <用戶執行的業務動作>
-    And <額外的業務動作（如需要）>
-    Then <預期的業務結果，描述行為而非驗證>
-    And <補充的業務結果>
+    Given <前置條件 1>
+    And <前置條件 2>
+    When <使用者動作或事件>
+    And <額外動作（如需要）>
+    Then <預期結果 1>
+    And <預期結果 2>
 
   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 會員進行結帳
-    And 購物車金額達到優惠門檻
-    When 會員完成訂單
-    Then 系統應該自動套用 VIP 專屬折扣
-    And 訂單摘要應該顯示折扣優惠
-
-  Scenario: 一般會員無優惠資格
-    Given 一位一般會員進行結帳
-    And 購物車金額達到優惠門檻
-    When 會員完成訂單
-    Then 系統應該以原價結帳
-    And 訂單摘要不顯示折扣資訊
-
-  Scenario: VIP 會員小額購物未達門檻
-    Given 一位 VIP 會員進行結帳
-    And 購物車金額未達優惠門檻
-    When 會員完成訂單
-    Then 系統應該以原價結帳
-    And 提示會員還需消費多少才能享有優惠
-
-  Scenario: 拒絕異常的訂單金額
-    Given 會員嘗試建立訂單
-    When 購物車金額為負數或零
-    Then 系統應該拒絕訂單
-    And 提示會員購物車金額無效
+  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 系統應該拒絕並回應錯誤 "無效的購買金額"
 ```
 
 ## 品質檢查清單
 
 完成前，確保您的規格具有：
+
 - [ ] 已檢查與現有功能的衝突（如有衝突已向使用者確認）
-- [ ] 清楚的功能描述，強調業務價值
+- [ ] 清楚的功能描述
 - [ ] 至少一個正常流程情境
 - [ ] 至少一個邊界情況情境
 - [ ] 至少一個錯誤處理情境
 - [ ] 沒有技術實作細節（沒有資料庫、沒有程式碼、沒有架構）
 - [ ] 所有情境遵循 Given-When-Then 格式
 - [ ] 每個情境都是原子性且可測試的
-- [ ] **使用行為描述而非實作細節**：
-  - [ ] 避免具體的計算數值和測試斷言
-  - [ ] 從用戶或業務角度描述期望行為
-  - [ ] 描述「應該發生什麼」而非「如何驗證」
-  - [ ] 使用業務語言而非技術術語
 
 ## 下一步
 
 完成此階段後：
+
 - 儲存 `.feature` 檔案
-- 您可以使用以下指令進入階段 2：`__CMD_PREFIX__sdd-arch features/<feature_name>.feature`
+- 您可以使用以下指令進入階段 2：`/sdd-arch features/<feature_name>.feature`
 - 或返回給使用者審查
 
 現在根據使用者的需求建立 Gherkin 規格。