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

需求追溯矩陣範本(RTM, Requirements Traceability Matrix Template)

需求追溯矩陣範本(Requirements Traceability Matrix, RTM) 參照標準:ISO/IEC/IEEE 29148:2018(需求追溯)/ ISO/IEC/IEEE 29119-3:2021 文件用途:串起「需求 → 設計 → 實作 → 測試」,確認每條需求都被實作與驗證,且每段程式都有需求依據 適用階段:需求核准(G1)起持續維護,於設計核准(G2)與上線核准(G3)時檢查 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.7、2.4 節 📋 章節目錄 文件資訊 追溯矩陣 自動追溯設定 缺口與處理 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 RTM-{專案代碼}-{序號} 對應需求文件 {PRD/FRD/SRD 文件編號與版本} 最後更新 {YYYY-MM-DD}(由 CI 自動產生時填寫建置編號) 負責人 {BA/QA Lead} 📖 使用說明 前向追溯:每條需求都有設計、實作、測試 → 防止遺漏 反向追溯:每段程式與測試都對應到需求 → 防止鍍金與範圍蔓延 建議以「測試程式碼中的需求編號標註」自動產生,人工維護的 Excel 很快就會過時 💡 範例 項目 內容 文件編號 RTM-HRMS-001 對應需求文件 FRD-HRMS-001 v1.3、SRD-HRMS-001 v1.1 最後更新 2026-10-05(CI build #482) 負責人 QA Lead 黃小玲 2. 追溯矩陣 📝 範本 需求編號 需求摘要 來源 優先序 設計(SDD 章節/API) 實作(模組/類別) 測試案例 測試結果 狀態 {FR-xxx} {摘要} {BRD/CR 編號} {Must/Should/Could} {SDD x.y/METHOD /path} {模組/類別} {TC-xxx} {Pass/Fail/未執行} {✅/⏳/❌} 📖 使用說明 非功能需求(NFR)通常由效能或安全測試驗證,「測試案例」欄填寫測試報告編號 需求異動(CR)時,同步更新受影響的列並記錄 CR 編號 狀態判定:設計、實作、測試三欄都有值且測試 Pass 才是 ✅ 💡 範例 需求編號 需求摘要 來源 優先序 設計 實作 測試案例 測試結果 狀態 FR-LV-001 員工提交請假申請 BRD 3.1 Must SDD 5.2/POST /api/v1/leaves leave-service/LeaveService TC-LV-001-01~04 Pass ✅ FR-LV-002 特休額度不足時拒絕申請 BRD 3.1 Must SDD 5.2/422 Problem Details LeaveQuotaPolicy TC-LV-002-01~02 Pass ✅ FR-LV-005 主管代理人設定 CR-2026-011 Should SDD 5.4 DelegateService TC-LV-005-01 未執行 ⏳ NFR-PERF-001 請假查詢 p95 < 500 ms(200 TPS) SRD 4.1 Must SDD 8.1 快取 LeaveQueryService PT-RPT-2026-03(k6) Fail(620 ms) ❌ 3. 自動追溯設定 📝 範本 // 在自動化測試上標註需求編號(JUnit 5 以上) @Tag("{需求編號}") @DisplayName("{測試案例編號} {情境描述}") @Test void {測試方法名稱}() { /* ... */ } # 前向追溯缺口:需求清單中有、但測試程式碼中找不到的需求編號 grep -ohE "^\| (FR|NFR)-[A-Z]+-[0-9]{3}" docs/requirements/rtm.md | tr -d '| ' | sort -u > req.txt grep -rohE "@Tag\(\"(FR|NFR)-[A-Z]+-[0-9]{3}\"\)" src/test | grep -oE "(FR|NFR)-[A-Z]+-[0-9]{3}" | sort -u > tested.txt comm -23 req.txt tested.txt # 有輸出 → 有需求沒有自動化測試 comm -13 req.txt tested.txt # 有輸出 → 有測試沒有對應需求(反向追溯缺口) 📖 使用說明 正規表示式需配合專案的需求編號格式調整 由效能或安全測試驗證的 NFR 不會有 @Tag,應在比對前從 req.txt 排除,或改以測試報告編號人工確認 建議在 CI 中執行,前向缺口數量做為 G2/G3 閘門的檢查項目 💡 範例 @Tag("FR-LV-002") @DisplayName("TC-LV-002-01 特休剩餘 2 天時申請 3 天,回傳 422") @Test void shouldRejectWhenAnnualLeaveQuotaInsufficient() { /* ... */ } 4. 缺口與處理 📝 範本 缺口類型 需求/測試編號 原因 處理方式 負責人 期限 {前向/反向} {編號} {原因} {補測試/補需求/刪除程式} {姓名} {日期} 📖 使用說明 反向缺口(有程式沒需求)可能是鍍金,也可能是需求文件漏寫,需由 PO 判斷 缺口未處理完畢不得通過 G3 上線閘門(風險 L1 專案) 💡 範例 缺口類型 需求/測試編號 原因 處理方式 負責人 期限 前向 FR-LV-005 測試環境尚未建立代理人資料 補測試資料後執行 TC-LV-005-01 QA 陳 2026-10-08 反向 @Tag("FR-LV-099") 開發自行新增「批次匯出」功能,無需求 PO 決定移除功能 Tech Lead 王 2026-10-09 5. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的 RTM 是否正確。 ...

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

PRD(產品需求文件)範本

PRD(產品需求文件|Product Requirement Document)範本 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、3.3、3.4 節 參照標準:ISO/IEC/IEEE 29148:2018、ISO 9241-210:2019、IIBA BABOK v3 適用對象:產品經理、UI/UX 設計師、業務分析師、開發團隊 文件性質:產品需求定義與功能規劃文件 📑 章節目錄 文件資訊 產品概述 使用者輪廓(User Persona) 核心功能清單(Feature List) 流程圖(Process Flow) 介面原型(Wireframe) 非功能性需求(Non-Functional Requirements) 依賴與限制 里程碑與時程 風險與緩解措施 術語定義 附件與參考 審查與驗證 範例:電子商務平台 PRD 摘要 📋 使用說明 PRD 是將商業目標轉譯為具體功能需求的關鍵文件,定義「產品要做什麼」。它是 UI/UX 設計師與工程團隊開發的主要依據,橋接業務需求(BRD)與技術實作(SDD/TSD)之間的落差。 何時使用本範本 新產品或新功能的需求定義階段 產品重大改版前的需求整理 跨部門協作時的需求溝通基準文件 填寫原則 以使用者為中心:所有功能描述應從使用者角度出發 量化可驗證:驗收條件必須可量化、可測試 優先序明確:使用 MoSCoW 或數字排序標明優先級 迭代更新:隨需求演進持續更新文件版本 📄 範本正文 [產品/功能名稱] 產品需求文件(PRD) 1. 文件資訊 項目 內容 文件編號 PRD-[專案代碼]-[序號] 版本 v0.1 建立日期 YYYY-MM-DD 最後更新 YYYY-MM-DD 撰寫者 [產品經理姓名] 審核者 [審核者姓名 / 角色] 核准者 [核准者姓名 / 角色] 狀態 草稿 / 審查中 / 已核准 / 已凍結 版本歷程 版本 日期 修改人 修改內容摘要 v0.1 YYYY-MM-DD [姓名] 初版建立 審核紀錄 審核者 角色 審核日期 結果 備註 通過 / 有條件通過 / 退回 2. 產品概述 2.1 產品願景 簡述本產品/功能的願景,說明為何需要此產品,以及期望達成的長期目標。 ...

May 19, 2026 · 5 min · 900 words · Eric Cheng

BRD 業務需求文件範本(Business Requirements Document Template)

BRD 業務需求文件範本(Business Requirements Document) 參照標準:IIBA BABOK Guide v3 / ISO/IEC/IEEE 29148:2018 文件用途:記錄業務層級需求,作為專案啟動與範圍確認的基礎依據 適用階段:專案啟始階段(Initiation Phase) 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 2.4(G1 需求核准)、3.3 節 📋 章節目錄 文件資訊 業務目的與範圍 業務背景與現況分析 利害關係人分析 業務需求 限制條件與假設 解決方案選項評估 驗收標準 風險評估 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 BRD-{專案代碼}-{序號} 文件名稱 {系統/專案名稱} 業務需求文件 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 核定 建立日期 {YYYY-MM-DD} 最後更新 {YYYY-MM-DD} 撰寫者 {姓名/角色} 審核者 {姓名/角色} 核定者 {姓名/角色} 版本歷程 版本 日期 修改人 修改內容摘要 v0.1 {YYYY-MM-DD} {姓名} 初稿建立 v1.0 {YYYY-MM-DD} {姓名} 正式發布 📖 使用說明 文件編號:採用組織標準編碼規則,確保唯一性與可追溯性 狀態管理:遵循 Draft → Under Review → Approved 的生命週期 版本歷程:每次修改必須記錄,符合 ISO/IEC/IEEE 29148 的組態管理要求 文件核定後進入基線管理(Baseline),後續修改需走變更控制流程 💡 範例 項目 內容 文件編號 BRD-ERP-001 文件名稱 人力資源管理系統 業務需求文件 版本 v1.2 狀態 核定 建立日期 2026-03-01 最後更新 2026-04-15 撰寫者 王小明 / 業務分析師 審核者 李主管 / 人資部經理 核定者 張總監 / IT 總監 2. 業務目的與範圍 📝 範本 2.1 業務目的(Business Purpose) {描述為什麼需要這個專案/系統,要解決什麼業務問題} ...

May 18, 2026 · 5 min · 1029 words · Eric Cheng

FRD 功能需求文件範本(Functional Requirements Document Template)

FRD 功能需求文件範本(Functional Requirements Document) 參照標準:ISO/IEC/IEEE 29148:2018(取代 IEEE 830-1998) 文件用途:將業務需求轉化為系統可實作的功能性與非功能性需求規格 適用階段:需求分析階段(Requirements Analysis Phase) 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、3.3、3.6、3.7 節 📋 章節目錄 文件資訊 導言 整體描述 系統功能需求 外部介面需求 非功能性需求 資料需求 其他需求 需求追溯矩陣 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 FRD-{專案代碼}-{序號} 文件名稱 {系統名稱} 功能需求文件 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 核定 / 基線 建立日期 {YYYY-MM-DD} 最後更新 {YYYY-MM-DD} 撰寫者 {姓名/角色} 審核者 {姓名/角色} 核定者 {姓名/角色} 對應 BRD {BRD 文件編號} 版本歷程 版本 日期 修改人 修改內容摘要 v0.1 {YYYY-MM-DD} {姓名} 初稿建立 📖 使用說明 FRD 承接 BRD(業務需求文件),將業務需求細化為系統功能規格 對應 BRD 欄位用於建立文件間的追溯關係 狀態增加「基線」代表已納入組態管理,後續變更需走 Change Request 流程 💡 範例 項目 內容 文件編號 FRD-HRM-001 文件名稱 人力資源管理系統 功能需求文件 版本 v2.1 狀態 基線 對應 BRD BRD-ERP-001 v1.2 2. 導言 📝 範本 2.1 目的(Purpose) 本文件定義 {系統名稱} 的功能性與非功能性需求規格,作為系統設計、開發與驗收測試的依據。 ...

May 18, 2026 · 6 min · 1128 words · Eric Cheng

使用案例文件範本(Use Case Document Template)

使用案例文件範本(Use Case Document Template) 適用標準:ISO/IEC/IEEE 29148:2018、UML 2.5.1(Unified Modeling Language) 適用階段:需求分析階段(Requirements Phase) 負責角色:系統分析師(SA)、業務分析師(BA) 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、3.7 節 📑 章節目錄 文件資訊 系統範圍與參與者 使用案例圖(Use Case Diagram) 使用案例清單 使用案例規格(逐案詳述) 業務規則 非功能性需求對應 追溯矩陣 審查與驗證 📝 範本 1. 文件資訊 項目 內容 文件名稱 [系統名稱] 使用案例文件 文件編號 [專案代碼]-UCD-[版本號] 版本 v[X.Y] 建立日期 [YYYY-MM-DD] 最後更新 [YYYY-MM-DD] 撰寫者 [BA/SA 姓名] 審核者 [技術主管 / 業務主管] 版本歷程 版本 日期 修改人 修改內容 v1.0 [YYYY-MM-DD] [姓名] 初版發布 2. 系統範圍與參與者 2.1 系統邊界 項目 說明 系統名稱 [系統全名] 系統目的 [一句話描述系統核心價值] 系統範圍 [包含/不包含的功能範疇] 2.2 參與者(Actors)清單 參與者 ID 名稱 類型 說明 相關角色/系統 ACT-001 [名稱] [人/系統/時間] [簡述] [實際角色] ACT-002 [名稱] [人/系統/時間] [簡述] [實際角色] 3. 使用案例圖(Use Case Diagram) graph LR subgraph "System Boundary: [系統名稱]" UC1([UC-001: 使用案例名稱]) UC2([UC-002: 使用案例名稱]) UC3([UC-003: 使用案例名稱]) end Actor1[/Actor 1\] --> UC1 Actor1 --> UC2 Actor2[/Actor 2\] --> UC2 Actor2 --> UC3 UC2 -.->|include| UC1 UC3 -.->|extend| UC2 4. 使用案例清單 UC ID 使用案例名稱 主要參與者 優先級 複雜度 狀態 UC-001 [名稱] [Actor] [High/Medium/Low] [High/Medium/Low] [Draft/Review/Approved] UC-002 [名稱] [Actor] [High/Medium/Low] [High/Medium/Low] [Draft/Review/Approved] 5. 使用案例規格(逐案詳述) UC-[NNN]: [使用案例名稱] 項目 內容 Use Case ID UC-[NNN] 名稱 [使用案例名稱] 簡述 [一句話描述目的] 主要參與者 [Primary Actor] 次要參與者 [Secondary Actors,若無填 N/A] 觸發條件 [什麼事件啟動此使用案例] 前置條件 [執行前必須滿足的條件] 後置條件(成功) [成功完成後系統/資料狀態] 後置條件(失敗) [失敗時系統/資料狀態] 優先級 [High / Medium / Low] 頻率 [每日 N 次 / 每週 N 次] 主要流程(Main Flow): ...

May 18, 2026 · 4 min · 671 words · Eric Cheng

安全需求清單範本(Security Requirements Checklist Template)

安全需求清單範本(Security Requirements Checklist) 參照標準:OWASP ASVS 5.0.0(Application Security Verification Standard)/ ISO/IEC 27001:2022 Annex A 文件用途:定義系統應滿足的安全需求,確保設計與開發階段納入安全考量 適用階段:需求分析階段(Requirements Phase)— Security by Design 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、5.4、9.1 節 📋 章節目錄 文件資訊 安全需求概述 認證需求 授權與存取控制 資料保護需求 輸入驗證與輸出編碼 Session 管理 日誌與監控需求 通訊安全 組態安全 合規性需求 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 SR-{專案代碼}-{序號} 文件名稱 {系統名稱} 安全需求清單 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 核定 建立日期 {YYYY-MM-DD} 撰寫者 {姓名/角色} 資安審核者 {資安人員姓名} ASVS 版本/等級 ASVS 5.0.0 / Level 1 / Level 2 / Level 3 📖 使用說明 依據 OWASP ASVS 5.0.0,安全需求分為三個驗證等級: Level 1:所有應用程式的最低標準,大部分可用自動化工具驗證 Level 2:處理個資、金流等敏感資料的應用程式(大多數企業系統) Level 3:最高安全等級(金流核心、身分驗證中心、關鍵基礎設施) 等級依專案風險分級選用(手冊 2.5、5.4):風險 L1 高 → ASVS L2(關鍵元件 L3);風險 L2 中 → ASVS L2;風險 L3 低 → ASVS L1 本清單在需求階段制定,貫穿整個 SDLC(設計需遵循、開發需實作、測試需驗證) ⚠️ ASVS 5.0 的章節與需求編號已與 4.0.3 不同(例如 4.0.3 的 V2 身分驗證在 5.0 為 V6)。引用時必須寫出版本,格式為 v5.0.0-{章}.{節}.{條},例如 v5.0.0-6.2.1 💡 範例 項目 內容 文件編號 SR-HRM-001 系統名稱 人力資源管理系統 ASVS 版本/等級 ASVS 5.0.0 / Level 2(處理員工個資與薪資資料) 2. 安全需求概述 📝 範本 2.1 系統安全分類 項目 評估 資料敏感度 一般 / 敏感 / 高度敏感 系統曝露面 內部 / 外部 / 混合 使用者類型 內部員工 / 外部客戶 / 合作夥伴 法規要求 {適用法規} 專案風險等級(手冊 2.5) L1 高 / L2 中 / L3 低 安全等級 ASVS 5.0.0 Level {1/2/3} 2.2 安全需求追溯矩陣 安全需求 ID 需求描述 ASVS 5.0 參照 對應 FRD 對應威脅(威脅模型) 驗證方式 優先級 SEC-{xxx} {描述} {章}.{節}.{條} FR-{xxx} T-{xx} {自動化測試/SAST/DAST/人工} 高/中/低 📖 使用說明 安全分類決定應套用的 ASVS Level 追溯矩陣確保每個安全需求可連結到 FRD 需求、威脅模型與 ASVS 條文,並寫出如何驗證 優先級考量:法規強制 > 高風險 > 一般防護 💡 範例 2.1 系統安全分類 項目 評估 資料敏感度 高度敏感(身分證字號、薪資、銀行帳號) 系統曝露面 混合(內部網路 + VPN 遠端存取) 使用者類型 內部員工(全體) + HR 管理人員 法規要求 個人資料保護法、勞動基準法 專案風險等級(手冊 2.5) L1 高(處理個資與薪資) 安全等級 ASVS 5.0.0 Level 2 2.2 安全需求追溯矩陣(節錄) 安全需求 ID 需求描述 ASVS 5.0 參照 對應 FRD 對應威脅 驗證方式 優先級 SEC-AUTHZ-002 員工僅能查詢自己的薪資資料 8.2.2 FR-021 T-03 整合測試:以 A 員工 Token 查 B 員工薪資 → 403 高 SEC-AUTH-005 密碼以 Argon2id 雜湊儲存 11.4.2 FR-001 T-07 程式碼審查 + 檢查資料庫雜湊格式 {argon2} 高 3. 認證需求(Authentication) 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-AUTH-001 {認證需求描述} 6.{x}.{x} L{N} 必須/建議 ☐ SEC-AUTH-002 {認證需求描述} 6.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V6(Authentication);密碼雜湊對應 V11.4;聯合身分(SSO)對應 V6.8 與 V10(OAuth/OIDC) Level 1:基本密碼安全;Level 2:多因子認證(MFA)或等效組合;Level 3:密碼學認證機制 認證需求需涵蓋:密碼策略、防暴力破解、MFA、密碼重設、SSO ⚠️ ASVS 5.0 的密碼政策與傳統作法不同:不得要求大小寫/數字/特殊字元等組成規則(6.2.5),不得強制定期更換密碼(6.2.10),改以長度、常見密碼與外洩密碼比對來提升強度 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-AUTH-001 密碼長度至少 12 字元(ASVS 下限 8、強烈建議 15);允許至少 64 字元 6.2.1、6.2.9 L1/L2 必須 ☑ SEC-AUTH-002 不設密碼組成規則,不強制定期更換;註冊與變更密碼時比對常見密碼清單與外洩密碼 6.2.5、6.2.10、6.2.4、6.2.12 L1/L2 必須 ☐ SEC-AUTH-003 依文件定義的機制防禦帳密填充與暴力破解(每帳號連續失敗 5 次後延遲 15 分鐘,並對來源 IP 限流),不得造成惡意鎖定他人帳號 6.1.1、6.3.1 L1 必須 ☑ SEC-AUTH-004 全體使用者啟用 MFA(或等效的多重單因子組合) 6.3.3 L2 必須 ☑ SEC-AUTH-005 密碼以 Argon2id 雜湊儲存(m=19 MiB、t=2、p=1 以上) 11.4.2 L2 必須 ☑ SEC-AUTH-006 整合企業 IdP 實現 SSO,並驗證斷言(JWT/SAML)的數位簽章 6.8.2 L2 必須 ☑ SEC-AUTH-007 停用或移除預設帳號(admin、root、sa) 6.3.2 L1 必須 ☑ SEC-AUTH-008 密碼重設流程不得繞過已啟用的 MFA 6.4.3 L2 必須 ☐ 4. 授權與存取控制(Authorization) 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-AUTHZ-001 {授權需求描述} 8.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V8(Authorization) 遵循最小權限原則(Principle of Least Privilege) 需求涵蓋:功能層級(Function-level)、資料層級(Data-specific,防 IDOR/BOLA)、欄位層級(Field-level)授權 授權規則必須先寫成文件(8.1.1),測試才有判定依據 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-AUTHZ-001 授權文件定義各角色(Admin/Manager/Employee)可使用的功能與可存取的資料範圍 8.1.1 L1 必須 ☑ SEC-AUTHZ-002 使用者僅能存取自己的薪資/假勤資料(資料層級授權,防 IDOR) 8.2.2 L1 必須 ☑ SEC-AUTHZ-003 每個 API 端點於伺服器端檢查功能權限,拒絕未授權請求回傳 403 8.2.1 L1 必須 ☑ SEC-AUTHZ-004 主管只能讀取部屬薪資的「總額」欄位,不能讀取銀行帳號欄位 8.2.3 L2 必須 ☐ SEC-AUTHZ-005 授權失敗事件需記錄於安全日誌 16.3.2 L2 必須 ☐ 5. 資料保護需求(Data Protection) 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-DATA-001 {資料保護需求描述} 14.{x}.{x} / 11.{x}.{x} L{N} 必須/建議 ☐ 敏感資料識別 資料欄位 敏感等級 加密方式 遮罩方式 保留期限 {欄位} 高/中/低 {加密} {遮罩} {期限} 📖 使用說明 對應 OWASP ASVS 5.0 V14(Data Protection) 與 V11(Cryptography) 敏感資料需先識別並分級(14.1.1),再為每個等級定義保護要求(14.1.2);完整的資料分級對照表可使用《資料分級對照表範本》 保護措施包含:傳輸加密、靜態加密(經認證的加密模式,例如 AES-GCM)、資料遮罩、存取控制、保留/銷毀策略 💡 範例 敏感資料識別 資料欄位 敏感等級 加密方式 遮罩方式 保留期限 身分證字號 高 AES-256-GCM(靜態,金鑰存放於 KMS) A1234****9 離職後 5 年 銀行帳號 高 AES-256-GCM(靜態,金鑰存放於 KMS) --1234 離職後 5 年 薪資金額 高 資料庫 TDE + 欄位權限控制 不遮罩(權限控制) 依勞動法規 手機號碼 中 無(權限控制) 09xx-xxx-789 離職後 2 年 Email 低 無 無 離職後 2 年 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-DATA-001 完成敏感資料盤點與分級,並定義各等級保護要求 14.1.1、14.1.2 L2 必須 SEC-DATA-002 加密只使用經核准的演算法與模式(例如 AES-GCM) 11.3.2 L1 必須 SEC-DATA-003 依資料保護等級控制日誌內容,禁止記錄密碼、Token、完整身分證字號 16.2.5 L2 必須 SEC-DATA-004 敏感資料不得出現在 URL 或查詢字串 14.2.1 L1 必須 SEC-DATA-005 含敏感資料的回應設定 Cache-Control: no-store 14.3.2 L2 必須 6. 輸入驗證與輸出編碼 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-INPUT-001 {輸入驗證需求} 1.{x}.{x} / 2.{x}.{x} / 5.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V1(Encoding and Sanitization)、V2(Validation and Business Logic)、V5(File Handling) 防禦 OWASP Top 10:2025 的 A05 Injection(SQL Injection、XSS、Command Injection) 原則:永不信任使用者輸入,驗證必須在伺服器端(受信任的服務層)執行 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-INPUT-001 所有輸入於伺服器端以允許清單(白名單)驗證 2.2.1、2.2.2 L1 必須 SEC-INPUT-002 資料庫查詢使用參數化查詢或 ORM,禁止字串拼接 1.2.4 L1 必須 SEC-INPUT-003 HTML 輸出依上下文編碼(Context-Aware Encoding)防止 XSS 1.2.1 L1 必須 SEC-INPUT-004 檔案上傳檢查副檔名與內容是否相符,並限制檔案大小 5.2.2、5.2.1 L1 必須 SEC-INPUT-005 文件定義每個上傳功能允許的檔案類型與大小上限(含解壓縮後大小) 5.1.1 L2 必須 7. Session 管理 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-SESS-001 {Session 管理需求} 7.{x}.{x} / 3.3.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V7(Session Management);Cookie 屬性對應 V3.3(Cookie Setup) Session 管理攸關身分劫持風險 需求涵蓋:Token 產生方式、閒置與絕對逾時、登出後失效、Cookie 安全屬性 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-SESS-001 Session Token 以 CSPRNG 產生且至少 128 bits 熵 7.2.3 L1 必須 SEC-SESS-002 Cookie 設定 Secure 並使用 __Host- 前綴;Session Cookie 設定 HttpOnly;SameSite 依用途設定 3.3.1、3.3.3、3.3.4、3.3.2 L1/L2 必須 SEC-SESS-003 閒置 30 分鐘、絕對 8 小時後需重新認證,並寫入設計文件 7.1.1、7.3.1、7.3.2 L2 必須 SEC-SESS-004 登入(含重新認證)後產生新的 Session Token,並使舊 Token 失效 7.2.4 L1 必須 SEC-SESS-005 使用者可檢視並終止其他裝置的 Session 7.5.2 L2 建議 SEC-SESS-006 帳號停用(如員工離職)時終止其所有 Session 7.4.2 L1 必須 8. 日誌與監控需求 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-LOG-001 {日誌監控需求} 16.{x}.{x} L{N} 必須/建議 ☐ 稽核事件定義 事件類型 記錄內容 保留期限 {事件} {需記錄的欄位} {期限} 📖 使用說明 對應 OWASP ASVS 5.0 V16(Security Logging and Error Handling) 日誌是事後追查與即時偵測的基礎;對應 OWASP Top 10:2025 A09(安全日誌與告警失效)——只記錄不告警,等於沒有偵測能力 重點:記什麼、不記什麼(禁止記錄密碼/Token)、保存多久、如何防竄改、時間是否含時區 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-LOG-001 記錄所有認證操作(成功與失敗) 16.3.1 L2 必須 SEC-LOG-002 記錄所有授權失敗事件 16.3.2 L2 必須 SEC-LOG-003 每筆日誌含時間(UTC 或含時區)、來源、使用者、事件 16.2.1、16.2.2 L2 必須 SEC-LOG-004 日誌防止未授權存取與竄改,並傳送至獨立的日誌系統 16.4.2、16.4.3 L2 必須 SEC-LOG-005 日誌元件對寫入資料編碼,防止日誌注入 16.4.1 L2 必須 SEC-LOG-006 同一帳號 10 分鐘內認證失敗 ≥ 20 次觸發告警並通知值班 16.4.3 L2 必須 稽核事件定義 事件類型 記錄內容 保留期限 登入成功 時間、帳號、IP、User-Agent、認證方式(密碼/MFA) 180 天 登入失敗 時間、帳號、IP、失敗原因(不含輸入的密碼) 180 天 權限變更 時間、操作者、變更內容 365 天 個資存取 時間、帳號、存取的個資類型(不含個資內容) 365 天 資料匯出 時間、帳號、匯出範圍、筆數 365 天 9. 通訊安全 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-COMM-001 {通訊安全需求} 12.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V12(Secure Communication);HSTS 標頭對應 V3.4 保護傳輸中資料不被竊聽或竄改 涵蓋:TLS 版本、憑證管理、HSTS、內部服務間通訊加密 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-COMM-001 只啟用 TLS 1.2 與 TLS 1.3,並優先使用 TLS 1.3;停用 SSL 3.0、TLS 1.0/1.1 12.1.1 L1 必須 SEC-COMM-002 啟用 HSTS(max-age ≥ 1 年) 3.4.1 L1 必須 SEC-COMM-003 對外服務使用公開受信任 CA 簽發的憑證 12.2.2 L1 必須 SEC-COMM-004 內部服務間(含資料庫、監控系統)通訊皆使用 TLS 12.3.1、12.3.3 L2 必須 SEC-COMM-005 使用 mTLS 時,先驗證用戶端憑證可信,才以憑證身分做認證或授權 12.1.3 L2 建議 10. 組態安全 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-CFG-001 {組態安全需求} 13.{x}.{x} / 3.4.{x} / 15.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V13(Configuration);HTTP 安全標頭對應 V3.4;第三方元件與 SBOM 對應 V15.1/V15.2 安全組態確保系統不因錯誤設定而暴露弱點(OWASP Top 10:2025 A02 Security Misconfiguration) 涵蓋:預設帳號、除錯模式、HTTP 安全標頭、依賴管理、機密管理 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-CFG-001 正式環境停用所有元件的除錯模式;錯誤只回傳一般性訊息 13.4.2、16.5.1 L2 必須 SEC-CFG-002 服務間認證不得使用預設帳密 13.2.3 L2 必須 SEC-CFG-003 設定 CSP(含 frame-ancestors)與 X-Content-Type-Options: nosniff 3.4.3、3.4.6、3.4.4 L2 必須 SEC-CFG-004 文件定義第三方元件弱點的修補時限,且所有元件皆在時限內 15.1.1、15.2.1 L1 必須 SEC-CFG-005 維護 SBOM(每次建置自動產生) 15.1.2 L2 必須 SEC-CFG-006 後端機密(DB 連線字串、API Key)存放於 Secret Manager/Key Vault 13.3.1 L2 必須 11. 合規性需求 📝 範本 法規/標準 適用條款 系統需求對應 實作狀態 {法規名稱} {條款} {系統需滿足的具體需求} ☐ 📖 使用說明 列出系統需遵循的法規、產業標準、企業政策 每條法規要求需轉化為可驗證的技術需求 常見法規:個人資料保護法、資通安全管理法(2025-12-01 施行修正條文)、GDPR、PCI DSS、ISO/IEC 27001:2022 法規版本與施行日期以全國法規資料庫為準,並由法遵單位確認(例:個人資料保護法 2025-11-11 修正條文的施行日期由行政院另定) 💡 範例 法規/標準 適用條款 系統需求對應 實作狀態 個人資料保護法 第 27 條(非公務機關安全維護措施;2025-11-11 修正條文刪除本條、改由新增條文規範,施行後需更新引用) 個資加密儲存、存取控制、稽核日誌 ☑ 個人資料保護法 第 3 條、第 10 條、第 11 條(當事人權利) 提供個資查詢、更正、停止處理及刪除功能 ☑ ISO/IEC 27001:2022 A.8.3(資訊存取限制) RBAC 與資料層級授權 ☑ ISO/IEC 27001:2022 A.8.24(密碼學之使用) TLS 1.2+、AES-256-GCM 加密 ☑ 公司資安政策 密碼政策 v4.0(依 ASVS 5.0 修訂) 最少 12 字元、比對外洩密碼、不強制定期更換 ☐ 12. 附錄 📝 範本 12.1 安全需求完成度統計 類別 總需求數 已實作 未實作 完成率 認證(AUTH) {N} {N} {N} {%} 授權(AUTHZ) {N} {N} {N} {%} 資料保護(DATA) {N} {N} {N} {%} 輸入驗證(INPUT) {N} {N} {N} {%} Session(SESS) {N} {N} {N} {%} 日誌監控(LOG) {N} {N} {N} {%} 通訊安全(COMM) {N} {N} {N} {%} 組態安全(CFG) {N} {N} {N} {%} 合計 {N} {N} {N} {%} 12.2 OWASP ASVS 5.0 對照表 ASVS 5.0 章節 主題 ASVS 4.0.3 對應章節 本文件對應章節 V1 Encoding and Sanitization V5 第 6 章 V2 Validation and Business Logic V5、V11 第 6 章 V3 Web Frontend Security V14、V3(Cookie) 第 7、9、10 章 V4 API and Web Service V13 第 6 章 V5 File Handling V12 第 6 章 V6 Authentication V2 第 3 章 V7 Session Management V3 第 7 章 V8 Authorization V4 第 4 章 V9 Self-contained Tokens V3.5 第 7 章 V10 OAuth and OIDC (新增) 第 3 章 V11 Cryptography V6 第 3、5 章 V12 Secure Communication V9 第 9 章 V13 Configuration V14 第 10 章 V14 Data Protection V8 第 5 章 V15 Secure Coding and Architecture V1、V10、V14.2 第 10 章 V16 Security Logging and Error Handling V7 第 8 章 V17 WebRTC (新增) 不適用時標示 N/A 📖 使用說明 完成度統計用於追蹤安全需求落實進度 所有「必須」等級的需求需在上線前 100% 實作;無法實作者需提出風險接受單(見《風險接受單範本》) ASVS 對照表協助資安審核人員快速定位驗證範圍,也協助把舊版(4.0.3)文件轉換到 5.0 「ASVS 4.0.3 對應章節」為主題層級的對應,個別需求請以 ASVS 5.0 原文逐條確認 💡 範例 12.1 安全需求完成度統計 類別 總需求數 已實作 未實作 完成率 認證(AUTH) 8 6 2 75% 授權(AUTHZ) 5 3 2 60% 資料保護(DATA) 5 5 0 100% 輸入驗證(INPUT) 5 5 0 100% Session(SESS) 6 5 1 83% 日誌監控(LOG) 6 4 2 67% 通訊安全(COMM) 5 5 0 100% 組態安全(CFG) 6 5 1 83% 合計 46 38 8 83% 13. 審查與驗證 自動檢查 檢查項目 方法 ASVS 編號存在且為 5.0 以 OWASP ASVS GitHub 的 5.0/en 章節檔比對每個 {章}.{節}.{條} 是否存在(gh api repos/OWASP/ASVS/contents/5.0/en) 每條需求都有驗證方式 追溯矩陣「驗證方式」欄不得為空 輸入驗證、注入、日誌敏感資訊 SAST(Semgrep p/owasp-top-ten)、Secrets 掃描(gitleaks) TLS、HSTS、安全標頭 testssl.sh、ZAP baseline 掃描 授權需求 每條授權需求至少一個「權限不足」與「存取他人資料」的整合測試 人工審查問題 ASVS 等級是否依專案風險等級選用?有沒有因為「做不完」而降級? 每條需求的 ASVS 參照,內容真的與需求描述一致嗎?(抽查 5 條對照原文) 密碼政策是否仍要求組成規則或定期更換(違反 ASVS 5.0 6.2.5、6.2.10)? 威脅模型中的每個高風險威脅,都能在本清單找到對應的需求嗎? 法規條款引用的是現行條文嗎?施行日期是否確認? AI 常見錯誤 沿用 ASVS 4.0.3 的章節與編號(例如把身分驗證寫成 V2.x),或捏造不存在的需求編號。 產生「90 天強制更換密碼」「必須包含大小寫與特殊字元」等已不符 ASVS 5.0 的密碼政策。 只列出需求,沒有寫驗證方式,導致測試階段無從驗證。 引用 OWASP Top 10:2021 的分類名稱(例如把注入寫成 A03)。 📌 範本使用注意事項 ...

May 18, 2026 · 8 min · 1519 words · Eric Cheng

系統需求規格書範本(System Requirements Document Template)

系統需求規格書範本(System Requirements Document, SRD) 參照標準:ISO/IEC/IEEE 29148:2018(Systems and Software Engineering — Requirements Engineering) 文件用途:定義系統層級的完整需求(功能、效能、安全、介面),作為設計與驗證的基準 適用階段:需求分析階段(Requirements Phase)— System-Level Requirements 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、3.3、5.4 節 📋 章節目錄 文件資訊 系統概述 系統功能需求 系統介面需求 效能需求 安全需求摘要 可靠性與可用性 限制條件 需求追溯矩陣 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 SRD-{專案代碼}-{版本} 文件名稱 {系統名稱} 系統需求規格書 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 基線化 建立日期 {YYYY-MM-DD} 撰寫者 {系統分析師} 審核者 {Tech Lead / 架構師} 核准者 {PM / 產品負責人} 基線版本 {基線化日期,變更需走 CR 流程} 📖 使用說明 SRD 位於需求文件階層的中間層: BRD(商業需求)→ SRD(系統需求) → FRD(功能需求) SRD 將商業需求轉化為系統可實作的技術需求 「基線化」後的變更需經正式變更控制流程(Change Request) 依 ISO/IEC/IEEE 29148:2018 Section 6.2(System Requirements Specification) 💡 範例 項目 內容 文件編號 SRD-HRM-v1.0 系統名稱 人力資源管理系統(HRMS) 版本 v1.0 基線版本 2026-04-01(Sprint 10 結束) 2. 系統概述 📝 範本 2.1 系統目的 {描述系統存在的理由與欲解決的核心問題} ...

May 18, 2026 · 5 min · 1033 words · Eric Cheng

需求異動申請表範本(Change Request Template)

需求異動申請表範本(Change Request Template) 適用標準:ISO/IEC/IEEE 15288:2023(系統生命週期)、ITIL 4 Change Enablement、CMMI V3.0 適用階段:需求分析階段 / 全生命週期(Requirements Phase / Cross-Phase) 負責角色:業務分析師(BA)、專案經理(PM)、變更管理委員會(CCB) 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.5 節 📑 章節目錄 變更申請資訊 變更描述 影響分析 變更方案 審核與決議 實施追蹤 變更驗收 審查與驗證 📝 範本 1. 變更申請資訊 項目 內容 變更編號 CR-[YYYY]-[NNN] 申請日期 [YYYY-MM-DD] 申請人 [姓名 / 部門] 專案名稱 [專案名稱] 變更類型 [需求變更 / 設計變更 / 範圍變更 / 缺陷修正] 優先級 [Critical / High / Medium / Low] 緊急程度 [緊急 / 一般] 目前狀態 [Draft / Submitted / Under Review / Approved / Rejected / Implementing / Completed / Cancelled] 2. 變更描述 2.1 變更摘要 項目 內容 變更標題 [一句話描述變更內容] 變更原因 [為什麼需要這個變更] 業務背景 [觸發變更的業務情境或事件] 2.2 現行需求(As-Is) 需求編號 需求描述 文件來源 [REQ-NNN] [目前的需求描述] [BRD/FRD §N.N] 2.3 變更後需求(To-Be) 需求編號 變更後描述 變更差異摘要 [REQ-NNN] [修改後的需求描述] [新增/修改/刪除了什麼] 2.4 相關附件 附件名稱 說明 [附件1] [UI 原型 / 流程圖 / 規格書片段] 3. 影響分析 3.1 影響範圍評估 影響面向 受影響項目 影響程度 說明 功能模組 [受影響的模組清單] [High/Medium/Low] 資料庫 [Schema / Table 異動] [High/Medium/Low] API 介面 [受影響的 API] [High/Medium/Low] UI 畫面 [受影響的頁面] [High/Medium/Low] 外部系統 [受影響的介接系統] [High/Medium/Low] 文件 [需更新的文件] [High/Medium/Low] 測試案例 [需新增/修改的測試] [High/Medium/Low] 3.2 時程影響 項目 原定日期 變更後日期 延遲天數 [里程碑1] [YYYY-MM-DD] [YYYY-MM-DD] [N] days 上線日期 [YYYY-MM-DD] [YYYY-MM-DD] [N] days 3.3 成本影響 成本項目 追加工時(人天) 追加費用 說明 開發 [N] 人天 [金額] 測試 [N] 人天 [金額] 設計 [N] 人天 [金額] 其他 [N] 人天 [金額] 合計 [N] 人天 [金額] 3.4 風險評估 風險 ID 風險描述 發生機率 影響程度 緩解措施 R-1 [風險描述] [High/Med/Low] [High/Med/Low] [措施] 4. 變更方案 4.1 建議方案 項目 內容 方案說明 [概述如何實施此變更] 實施步驟 1. [步驟1]2. [步驟2]3. [步驟3] 需要資源 [人力/環境/工具] 預計工期 [N] 個工作天 測試範圍 [需要回歸測試的範圍] 4.2 替代方案(如有) 方案 說明 工時 優點 缺點 方案 A [說明] [N] 天 [優點] [缺點] 方案 B [說明] [N] 天 [優點] [缺點] 5. 審核與決議 5.1 審核記錄 審核者 角色 審核日期 決議 意見 [姓名] PM [YYYY-MM-DD] [Approve/Reject/Defer] [意見] [姓名] Tech Lead [YYYY-MM-DD] [Approve/Reject/Defer] [意見] [姓名] Business Owner [YYYY-MM-DD] [Approve/Reject/Defer] [意見] 5.2 CCB 決議 項目 內容 會議日期 [YYYY-MM-DD] 最終決議 [Approved / Rejected / Deferred / Need More Info] 核准條件 [附帶條件,如有] 預計實施版本 [Release / Sprint] 6. 實施追蹤 6.1 實施任務 任務 ID 任務描述 負責人 預計完成 實際完成 狀態 T-1 [修改設計文件] [姓名] [日期] [日期] [Done/In Progress/TODO] T-2 [修改程式碼] [姓名] [日期] [日期] [Done/In Progress/TODO] T-3 [更新測試案例] [姓名] [日期] [日期] [Done/In Progress/TODO] T-4 [執行回歸測試] [姓名] [日期] [日期] [Done/In Progress/TODO] 6.2 文件更新追蹤 文件名稱 更新內容 更新人 更新日期 狀態 [BRD / FRD / SAD] [章節 N.N] [姓名] [日期] [Done/Pending] 7. 變更驗收 項目 內容 驗收日期 [YYYY-MM-DD] 驗收人 [申請人 / Business Owner] 驗收結果 [Pass / Fail / Conditional Pass] 備註 [驗收意見] 8. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的文件是否正確;對應《軟體開發標準程序教學手冊》v2.0 各章的「審查與驗證」。 ...

May 18, 2026 · 4 min · 642 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