官方技能 · 產品

附驗收標準的使用者故事

把功能拆成使用者故事,每則附上 Given/When/Then 驗收標準、邊界情況、範圍外說明和 INVEST 檢查。

可在 Claude、ChatGPT 和程式設計代理中使用。使用 Team 和 Business 方案時,我們改進官方技能後,你 Pod 裡的這個技能會自動更新。

適用情境

你要提供的內容

你會得到的內容

一組使用者故事,每則附上 Given/When/Then 情境、邊界情況、範圍外說明、INVEST 檢查和待釐清問題。

運作方式

  1. 列出角色和他們的目標 每個角色寫出他想用這個功能完成什麼。一則故事只有一個角色;「使用者和管理員」的故事是 2 則故事。
  2. 每則故事都寫成「身為/我想要/以便」 Dan North 說明這個範本會迫使撰寫者寫出價值。「以便」要寫使用者在意的成果,而不是把功能再說一次。如果誠實的「以便」只能寫「因為我們說要做」,就把這則故事標為建議縮減範圍。
  3. 依使用者看得到的切片拆分 依工作流程的步驟、業務規則的不同情況、資料類型來拆,或先做順利路徑、之後再做例外。絕不依技術層拆分(「後端故事」、「前端故事」):每則故事都必須交付使用者可以實際試用的東西。
  4. 用 Given/When/Then 寫驗收標準 假設(Given)= 起始狀態。當(When)= 唯一的動作。那麼(Then)= 可以觀察到的結果。額外的條件用「而且」(And)接上。每則故事寫 2 到 5 個情境(本技能的預設):順利路徑、至少 1 個失敗路徑,以及任何規則的邊界。
  5. 列出邊界情況 每則故事都對照檢查:空資料、超長輸入、重複、沒有權限、連線中斷、同一個動作做兩次,以及既有資料會怎樣。每個邊界情況要嘛變成一個情境,要嘛列為範圍外。
  6. 寫範圍外說明 寫出這則故事刻意不做的事,免得審閱者期待它。
  7. 跑 INVEST 檢查 Bill Wake 的 INVEST:Independent(獨立)、Negotiable(可協商)、Valuable(有價值)、Estimable(可估算)、Small(夠小)、Testable(可測試)。每個字母標上通過或不通過。Small 不通過就再拆。Testable 不通過,代表驗收標準太模糊。Independent 不通過,就註明相依的項目。

分享給你的團隊

把它加入 AI Skill Pod,團隊每個人(外包人員也包括在內)都能從自己的 AI 使用同一個版本。 看看和團隊分享 AI 技能的最佳做法

加入我團隊的 Pod

更新紀錄

參考來源

  1. INVEST in Good Stories, and SMART Tasks (XP123) (2026-11-04 查閱)
  2. Given When Then (Martin Fowler) (2026-11-04 查閱)
  3. Introducing BDD (Dan North) (2026-11-04 查閱)
  4. Essential XP: Card, Conversation, Confirmation (Ron Jeffries) (2026-11-04 查閱)