User Story 與驗收條件範本(User Story & Acceptance Criteria Template)

User Story 與驗收條件範本(User Story & Acceptance Criteria) 參照標準:INVEST 原則 / Gherkin(Cucumber)/ ISO/IEC/IEEE 29148:2018 需求品質特性 文件用途:以使用者觀點描述需求,並以可自動化的 Gherkin 驗收條件定義「完成」 適用階段:需求分析與 Sprint 規劃(Backlog Refinement) 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、2.4(DoR)節 📋 章節目錄 Story 基本資訊 Story 描述與 INVEST 檢查 驗收條件(Gherkin) 非功能與安全考量 審查與驗證 1. Story 基本資訊 📝 範本 項目 內容 Story 編號 {專案代碼}-{序號} 對應需求 {FR/PRD 功能編號} 優先序 {Must/Should/Could/Won’t} 估點 {Story Points,超過 8 點需拆分} 相依項目 {API、資料表、其他 Story} UI 設計 {Figma 連結/線框圖} 📖 使用說明 「相依項目」與「UI 設計」是 DoR(就緒定義)的檢查項目,缺少時不得排入 Sprint 估點超過團隊約定上限(例:8 點)時必須拆分 💡 範例 項目 內容 Story 編號 HRMS-412 對應需求 FR-LV-002 優先序 Must 估點 5 相依項目 GET /api/v1/leave-quotas(HRMS-398,已完成) UI 設計 Figma「請假申請 v3」 2. Story 描述與 INVEST 檢查 📝 範本 身為 {角色}, 我想要 {功能}, 以便 {商業價值}。 原則 檢查問題 結果 Independent 獨立 能否單獨交付? {✅/❌ 說明} Negotiable 可協商 描述需求而非規定實作? {✅/❌} Valuable 有價值 使用者或業務能感受到價值? {✅/❌} Estimable 可估算 團隊能估出大小? {✅/❌} Small 夠小 一個 Sprint 內可完成? {✅/❌} Testable 可測試 有明確驗收條件? {✅/❌} 📖 使用說明 「以便」寫的是業務價值,不是技術手段(❌「以便呼叫 API」) INVEST 任一項 ❌ 時,於 Refinement 會議中修改或拆分 💡 範例 身為 員工, 我想要 在申請特休時看到剩餘天數,並在額度不足時被擋下, 以便 不必等主管退件才知道申請無效。 原則 檢查問題 結果 Independent 能否單獨交付? ✅ 額度 API 已完成 Negotiable 描述需求而非實作? ✅ Valuable 有業務價值? ✅ 減少主管退件(每月約 40 件) Estimable 可估算? ✅ 5 點 Small 一個 Sprint 內? ✅ Testable 有驗收條件? ✅ 見第 3 節 3. 驗收條件(Gherkin) 📝 範本 # language: zh-TW 功能: {功能名稱}({需求編號}) 場景: {正常情境} 假設 {前置條件} 當 {使用者動作} 那麼 {可觀察的結果} 場景: {例外情境} 假設 {前置條件} 當 {使用者動作} 那麼 {錯誤處理結果} 📖 使用說明 至少 1 個正常情境與 1 個例外情境;邊界值(剛好等於上限)另列場景 「那麼」必須可觀察、可自動判定:寫出畫面訊息、HTTP 狀態碼或資料變化,不寫「系統正常運作」 中文關鍵字需在第一行宣告 # language: zh-TW;也可使用英文關鍵字 Feature/Scenario/Given/When/Then 每個 .feature 檔都必須有 功能:(Feature:)行,否則 Cucumber 無法解析 💡 範例 # language: zh-TW 功能: 特休額度檢查(FR-LV-002) 場景: 額度足夠時可送出申請 假設 員工 "E20260001" 的特休剩餘 5 天 當 員工申請 3 天特休 那麼 申請狀態為 "pending" 而且 畫面顯示 "申請已送出,剩餘特休 2 天(核准後扣除)" 場景: 額度不足時拒絕申請 假設 員工 "E20260001" 的特休剩餘 2 天 當 員工申請 3 天特休 那麼 API 回應狀態碼 422 而且 畫面顯示 "特休剩餘 2 天,不足申請天數 3 天" 場景: 申請天數剛好等於剩餘額度 假設 員工 "E20260001" 的特休剩餘 3 天 當 員工申請 3 天特休 那麼 申請狀態為 "pending" 4. 非功能與安全考量 📝 範本 類別 要求 驗證方式 權限 {誰可以執行、可以存取誰的資料} {整合測試} 效能 {量化目標} {k6/APM} 稽核 {需記錄的事件} {日誌檢查} 個資 {涉及的欄位與分級} {資料分級對照表} 📖 使用說明 每個 Story 都要想一次「誰不應該能做這件事」,並寫成測試 涉及個資時引用《資料分級對照表範本》的分級 💡 範例 類別 要求 驗證方式 權限 員工只能查詢與申請自己的假;主管可查部屬 整合測試:以 A 員工 Token 查 B 員工額度 → 403 效能 額度查詢 p95 < 300 ms k6 負載測試 稽核 申請送出記錄員工編號、天數、結果 日誌檢查 個資 請假事由屬「機密」,日誌禁止記錄 日誌 grep 測試 5. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的 User Story 是否正確。 ...

October 6, 2026 · 2 min · 410 words · Eric Cheng

BDD行為驅動開發使用教學手冊

BDD 行為驅動開發使用教學手冊 📘 手冊說明 本手冊專為系統分析師(SA)、業務分析師(BA)、開發人員與測試人員設計,旨在協助團隊成員: 理解 BDD 的核心概念與價值 掌握 Gherkin 語法與規格撰寫 學會將業務需求轉換為可執行的行為規格 建立 BDD 協作開發流程 實踐 BDD 自動化測試 適用對象: 新進系統分析師 想導入 BDD 的開發團隊 需要強化需求溝通的專案經理 負責驗收測試的 QA 人員 使用方式: 循序閱讀各章節,建立完整概念 參考實務案例,模擬實際場景 使用附錄的模板與檢查清單 在專案中逐步導入與實踐 📑 目錄 第一章 認識 BDD:行為驅動開發的核心理念 1.1 什麼是 BDD 1.2 BDD 與 TDD、ATDD 的差異 1.3 為什麼要導入 BDD 1.4 BDD 的價值與應用場景 1.5 BDD 在軟體開發生命週期(SDLC)中的位置 第二章 BDD 的三大支柱 2.1 Discovery(需求探索) 2.2 Formulation(範例定義) 2.3 Automation(自動化驗證) 第三章 BDD 的核心語法:Gherkin 3.1 Gherkin 語法結構與規則 3.2 Feature、Scenario、Scenario Outline 進階應用 3.3 範例:從需求敘述轉為 Gherkin 規格 3.4 常見錯誤與最佳實務 第四章 BDD 與系統分析的整合應用 4.1 如何將業務需求轉化為可執行行為 4.2 與利害關係人共創範例(Example Mapping) 4.3 User Story 與 BDD 的結合方式 4.4 Acceptance Criteria(驗收準則)的撰寫指引 4.5 從 BDD 到 Use Case 的對應關係 第五章 BDD 開發流程與角色分工 5.1 BDD 工作流(Workflow)全貌 5.2 三方會談(Three Amigos:BA/SA、Dev、QA) 5.3 SA 在 BDD 流程中的責任與產出 5.4 實務文件產出範例 5.5 維護與版本控管實務 第六章 BDD 自動化測試實作 6.1 常見 BDD 工具比較 6.2 環境安裝與專案結構 6.3 Feature 與 Step Definitions 的關聯 6.4 CI/CD 整合實務 6.5 測試報告與追蹤機制 第七章 BDD 實戰案例 7.1 案例一:Web 登入驗證流程 7.2 案例二:銀行轉帳業務流程 7.3 案例三:批次系統業務規則驗證 7.4 案例四:API 行為測試 7.5 案例回顧與行為重構 第八章 導入策略與組織落地 8.1 組織 BDD 成熟度評估 8.2 BDD 導入計畫範本 8.3 克服導入 BDD 的常見障礙 8.4 建立 BDD 協作文化 8.5 成功導入的關鍵因素 第九章 高階應用與延伸 9.1 AI 輔助 BDD 實踐 9.2 BDD 與 Specification by Example (SBE) 整合 9.3 微服務架構下的 BDD 挑戰 9.4 BDD 的未來趨勢 第十章 附錄 10.1 Gherkin 語法速查表 10.2 BDD 文件模板 10.3 常見 BDD 工具與插件 10.4 推薦學習資源 10.5 BDD 完整檢查清單 第一章 認識 BDD:行為驅動開發的核心理念 1.1 什麼是 BDD BDD (Behavior-Driven Development,行為驅動開發) 是一種軟體開發方法論,強調: ...

November 7, 2025 · 87 min · 18385 words · Eric Cheng

BDD行為驅動開發使用教學手冊

BDD 行為驅動開發使用教學手冊 📘 手冊說明 本手冊專為系統分析師(SA)、業務分析師(BA)、開發人員與測試人員設計,旨在協助團隊成員: 理解 BDD 的核心概念與價值 掌握 Gherkin 語法與規格撰寫 學會將業務需求轉換為可執行的行為規格 建立 BDD 協作開發流程 實踐 BDD 自動化測試 適用對象: 新進系統分析師 想導入 BDD 的開發團隊 需要強化需求溝通的專案經理 負責驗收測試的 QA 人員 使用方式: 循序閱讀各章節,建立完整概念 參考實務案例,模擬實際場景 使用附錄的模板與檢查清單 在專案中逐步導入與實踐 📑 目錄 第一章 認識 BDD:行為驅動開發的核心理念 1.1 什麼是 BDD 1.2 BDD 與 TDD、ATDD 的差異 1.3 為什麼要導入 BDD 1.4 BDD 的價值與應用場景 1.5 BDD 在軟體開發生命週期(SDLC)中的位置 第二章 BDD 的三大支柱 2.1 Discovery(需求探索) 2.2 Formulation(範例定義) 2.3 Automation(自動化驗證) 第三章 BDD 的核心語法:Gherkin 3.1 Gherkin 語法結構與規則 3.2 Feature、Scenario、Scenario Outline 進階應用 3.3 範例:從需求敘述轉為 Gherkin 規格 3.4 常見錯誤與最佳實務 第四章 BDD 與系統分析的整合應用 4.1 如何將業務需求轉化為可執行行為 4.2 與利害關係人共創範例(Example Mapping) 4.3 User Story 與 BDD 的結合方式 4.4 Acceptance Criteria(驗收準則)的撰寫指引 4.5 從 BDD 到 Use Case 的對應關係 第五章 BDD 開發流程與角色分工 5.1 BDD 工作流(Workflow)全貌 5.2 三方會談(Three Amigos:BA/SA、Dev、QA) 5.3 SA 在 BDD 流程中的責任與產出 5.4 實務文件產出範例 5.5 維護與版本控管實務 第六章 BDD 自動化測試實作 6.1 常見 BDD 工具比較 6.2 環境安裝與專案結構 6.3 Feature 與 Step Definitions 的關聯 6.4 CI/CD 整合實務 6.5 測試報告與追蹤機制 第七章 BDD 實戰案例 7.1 案例一:Web 登入驗證流程 7.2 案例二:銀行轉帳業務流程 7.3 案例三:批次系統業務規則驗證 7.4 案例四:API 行為測試 7.5 案例回顧與行為重構 第八章 導入策略與組織落地 8.1 組織 BDD 成熟度評估 8.2 BDD 導入計畫範本 8.3 克服導入 BDD 的常見障礙 8.4 建立 BDD 協作文化 8.5 成功導入的關鍵因素 第九章 高階應用與延伸 9.1 AI 輔助 BDD 實踐 9.2 BDD 與 Specification by Example (SBE) 整合 9.3 微服務架構下的 BDD 挑戰 9.4 BDD 的未來趨勢 第十章 附錄 10.1 Gherkin 語法速查表 10.2 BDD 文件模板 10.3 常見 BDD 工具與插件 10.4 推薦學習資源 10.5 BDD 完整檢查清單 第一章 認識 BDD:行為驅動開發的核心理念 1.1 什麼是 BDD BDD (Behavior-Driven Development,行為驅動開發) 是一種軟體開發方法論,強調: ...

November 7, 2025 · 88 min · 18620 words · Eric Cheng