具體實例規範 (Specification by Example, 簡寫為 SBE) 是一種協作式的方法，旨在透過「具體範例」而不是抽象的文字描述來定義軟體需求。

這套方法能確保業務人員、測試人員與開發人員對「系統該做什麼」達成完全一致的共識。

1. 核心定義與簡寫 #

• 全稱： Specification by Example
• 簡寫： SBE
• 核心理念： 透過討論真實的、具體的使用場景（Examples），來澄清需求並消除歧義。

2. SBE 的運作流程 #

SBE 通常包含以下幾個關鍵步驟，形成一個循環：

1. 從業務目標中衍生需求： 確保每個功能都是為了達成某個業務價值。
2. 協作制定規範： 透過「三方協作」（Three Amigos：開發、測試、業務）共同討論範例。
3. 舉例說明： 針對複雜邏輯舉出具體數值或情境。
4. 精煉規範： 將討論出的範例整理成結構化的文件。
5. 自動化驗證： 將這些規範轉化為自動化測試腳本。
6. 頻繁驗證： 每次更動程式時都執行這些測試。
7. 演進成活文件 (Living Documentation)： 這些規範會隨系統更新，成為最準確的技術文件。

3. SBE 與 BDD 的關係 #

SBE 經常與 行為驅動開發 (Behavior-Driven Development, BDD) 聯繫在一起。你可以將 SBE 視為一種「行為準則」或「方法論」，而 BDD 則是實踐這套準則的具體技術框架（例如使用 Given/When/Then 的語法）。

4. 具體範例對比 #

• 傳統需求描述： 「系統應該根據使用者的購買金額給予適當的折扣。」（語意模糊：多少錢算適當？）
• SBE 描述： | 購買金額 (TWD) | 會員等級 | 折扣比例 | 最終價格 | | :--- | :--- | :--- | :--- | | 500 | 一般 | 0% | 500 | | 1200 | 一般 | 5% | 1140 | | 1200 | VIP | 10% | 1080 |

為什麼這對您的專案很重要？ #

根據您提供的圖片規範，所有的 Specifications (規格) 必須使用繁體中文。採用 SBE 可以幫助您在撰寫繁體中文文件時，透過表格與實例減少語言表達上的誤解。

您是否希望我針對某個特定的功能模組，示範如何撰寫一份符合 SBE 格式的繁體中文需求文件？