DoR/DoD 範本(Definition of Ready & Definition of Done Template)

DoR/DoD 範本(Definition of Ready & Definition of Done) 參照標準:Scrum Guide 2020(Definition of Done)/ 業界 Definition of Ready 慣例 文件用途:定義工作項目「可以排入 Sprint」與「可以標示完成」的條件,每一條都要能指出證據 適用階段:專案啟動時制定,每季回顧時檢討 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 2.4 節 📋 章節目錄 Definition of Ready Definition of Done 自動化對應 審查與驗證 1. Definition of Ready 📝 範本 ## Definition of Ready(Story 可以排入 Sprint 的條件) - [ ] {條件 1} 證據:{在哪裡可以確認} - [ ] {條件 2} 證據:{…} 📖 使用說明 DoR 防止「需求不清就開工」;未符合 DoR 的 Story 不得排入 Sprint 每一條都寫出證據所在,避免「感覺已經準備好」 💡 範例 ## Definition of Ready - [ ] 符合 INVEST 原則 證據:Story 頁面的 INVEST 檢查表 - [ ] 至少 1 個正常與 1 個例外的 Gherkin 驗收條件 證據:Story 頁面的驗收條件 - [ ] 相依的 API/資料表已存在或排入同一 Sprint 證據:相依 Story 狀態 - [ ] UI 需求附 Figma 連結 證據:Story 欄位 - [ ] 估點 ≤ 8 點 證據:Story Points 欄位 - [ ] 涉及個資的欄位已在資料分級表中 證據:資料分級對照表版本 2. Definition of Done 📝 範本 ## Definition of Done(Story 可以標示完成的條件) - [ ] {條件 1} 證據:{CI 紀錄/PR 連結/簽核} 📖 使用說明 DoD 適用於所有 Story;團隊不得對個別 Story 降低標準 能自動化的條件交給 CI 與分支保護,不靠人記得 💡 範例 ## Definition of Done - [ ] 程式碼已合併至 main,PR 至少 1 位 Reviewer 核准(L1 專案 2 位) 證據:PR 連結 - [ ] CI 全數通過:建置、單元/整合測試、SAST、SCA、Secrets 掃描 證據:CI 執行紀錄 - [ ] 新增程式碼行覆蓋率 ≥ 80%、分支覆蓋率 ≥ 70% 證據:SonarQube 品質閘門 - [ ] 每條驗收條件都有自動化測試或手動測試紀錄 證據:RTM - [ ] API 異動已更新 OpenAPI;設計異動已更新 SDD 或新增 ADR 證據:PR 中的檔案變更 - [ ] 已部署到測試環境並由 PO 驗收 證據:PO 於 Story 留言確認 - [ ] PR 說明已填寫 AI 參與範圍(如有使用 AI) 證據:PR 說明 3. 自動化對應 📝 範本 DoD 條件 自動化方式 未自動化時的人工確認者 {條件} {分支保護必要檢查/CI Job/品質閘門} {角色} 📖 使用說明 目標是讓 DoD 中大部分條件由工具強制,人工只確認需要判斷的部分 💡 範例 DoD 條件 自動化方式 未自動化時的人工確認者 PR 核准 分支保護:Require approvals(1/2 位)、最後一次推送需重新核准 — CI 通過 分支保護:Require status checks(build、security-scan) — 覆蓋率 SonarQube 品質閘門 + sonar.qualitygate.wait=true — 驗收條件有測試 RTM 前向追溯腳本 QA PO 驗收 — PO 4. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的 DoR/DoD 是否正確。 ...

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

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