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

缺陷報告範本(Bug Report Template)

缺陷報告範本(Bug Report) 參照標準:ISO/IEC/IEEE 29119-3:2021(Incident Report) 文件用途:讓開發者不必再詢問就能重現、定位與修復缺陷,並讓 PO 判斷優先序 適用階段:測試驗證與維運階段 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 6.4 節 📋 章節目錄 基本資訊與分級 重現資訊 證據與影響 修復與驗證 審查與驗證 1. 基本資訊與分級 📝 範本 項目 內容 缺陷編號 {BUG-專案-序號} 標題 [{模組}] {現象}({在什麼情況下}) 嚴重度(Severity) {P1 Critical/P2 High/P3 Medium/P4 Low}(QA 判定:影響多大) 優先序(Priority) {Highest/High/Medium/Low}(PO 判定:多快要修) 環境/版本 {SIT/UAT/PRD},{版本或 commit SHA} 對應需求/測試案例 {FR-xxx}/{TC-xxx} 是否為安全問題 {是:改走弱點管理流程/否} 📖 使用說明 標題要能單獨看懂:寫出模組、現象、條件;避免「系統錯誤」 嚴重度與優先序不同:報表標題錯字嚴重度低,但明天要交主管機關時優先序最高 安全問題不要寫在公開的缺陷系統中,改依弱點管理流程處理 💡 範例 項目 內容 缺陷編號 BUG-HRMS-0731 標題 [請假] 申請 0.5 天特休時,剩餘額度剛好 0.5 天仍被拒絕 嚴重度(Severity) P3 Medium(有替代方案:改請 4 小時事假) 優先序(Priority) High(月底結算前需修正) 環境/版本 UAT,v2.4.0-rc.2(commit a41f9c2) 對應需求/測試案例 FR-LV-002/TC-LV-002-03 是否為安全問題 否 2. 重現資訊 📝 範本 ### 前置條件 - {帳號、資料狀態} ### 重現步驟 1. {步驟} 2. {步驟} ### 預期結果 {依據需求或驗收條件,寫出應有的結果} ### 實際結果 {實際看到的結果,含錯誤訊息原文} ### 重現頻率 {每次/偶發(N 次中 M 次)} 📖 使用說明 步驟要具體到「另一個人照做就能重現」 預期結果要引用需求或驗收條件,不是「應該要正常」 錯誤訊息貼原文,不要轉述 💡 範例 ### 前置條件 - 帳號 E20260001,特休剩餘 0.5 天 ### 重現步驟 1. 登入 UAT,進入「請假申請」 2. 假別選「特休」,日期 2026-10-15 上午(0.5 天) 3. 按「送出」 ### 預期結果 申請成功,狀態為 pending(驗收條件「申請天數剛好等於剩餘額度」) ### 實際結果 HTTP 422,畫面顯示「特休剩餘 0.5 天,不足申請天數 0.5 天」 ### 重現頻率 每次 3. 證據與影響 📝 範本 項目 內容 traceId {從錯誤回應或日誌取得} 日誌/截圖 {連結;須遮罩個資} 影響範圍 {功能、使用者數、資料是否受損} 替代方案 {有/無:說明} 📖 使用說明 提供 traceId 讓開發者直接在日誌與追蹤系統找到該請求 截圖與日誌中的個資必須遮罩(依資料分級對照表) 💡 範例 項目 內容 traceId 4bf92f3577b34da6a3ce929d0e0e4736 日誌/截圖 UAT 日誌連結(員工姓名已遮罩) 影響範圍 剩餘額度為小數的員工(約 12%)無法用完最後半天 替代方案 有:改請 4 小時事假後由 HR 人工調整 4. 修復與驗證 📝 範本 項目 內容 根本原因 {開發者填寫} 修復 PR {連結} 新增的回歸測試 {測試名稱} 驗證者/日期 {QA 姓名,日期} 📖 使用說明 每個缺陷修復都必須附對應的自動化回歸測試,避免再犯 由提出者或 QA 驗證後才能關閉 💡 範例 項目 內容 根本原因 額度比較使用 double,0.5 的運算結果為 0.49999… 修復 PR #1287(改用 BigDecimal) 新增的回歸測試 LeaveQuotaPolicyTest#shouldAllowWhenRequestEqualsRemainingHalfDay 驗證者/日期 QA 陳,2026-10-09 5. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的缺陷報告是否正確。 ...

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

階段閘門審查紀錄範本(Stage Gate Review Template)

階段閘門審查紀錄範本(Stage Gate Review) 參照標準:ISO/IEC/IEEE 12207:2026 / ISO/IEC/IEEE 15288:2023(決策管理流程) 文件用途:記錄每道閘門(G1 需求核准、G2 設計核准、G3 上線核准、G4 結案)的檢查結果、證據與決策 適用階段:每個階段結束時 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 2.4 節 📋 章節目錄 審查基本資訊 進入條件檢查 決策 審查與驗證 1. 審查基本資訊 📝 範本 項目 內容 專案 {名稱/代號}(風險等級:{L1/L2/L3},裁剪紀錄:{編號}) 閘門 {G1 需求核准/G2 設計核准/G3 上線核准/G4 結案} 審查日期 {YYYY-MM-DD} 核准者 {依閘門:產品負責人/架構師+資安/CAB/PM+維運主管} 出席者 {姓名與角色} 📖 使用說明 核准者依閘門而定(手冊 2.4 表格);風險 L3 專案依裁剪紀錄可合併閘門 審查前 2 個工作日將證據連結提供給核准者 💡 範例 項目 內容 專案 HRMS 請假模組 v2(風險等級:L1,裁剪紀錄:TR-HRMS-2026-02) 閘門 G3 上線核准 審查日期 2026-10-03 核准者 CAB 主席 林志明、產品負責人 王 HR 主管 出席者 PM 陳大文、QA Lead 黃小玲、DevOps 林、資安 李小華 2. 進入條件檢查 📝 範本 # 進入條件 結果 證據(連結) 1 {條件} {✅/❌/N/A(依裁剪紀錄)} {CI 紀錄、報告、簽核單} 各閘門標準條件(依手冊 2.4,可依裁剪紀錄調整): ...

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