官方技能 · 產品
附驗收標準的使用者故事
把功能拆成使用者故事,每則附上 Given/When/Then 驗收標準、邊界情況、範圍外說明和 INVEST 檢查。
可在 Claude、ChatGPT 和程式設計代理中使用。使用 Team 和 Business 方案時,我們改進官方技能後,你 Pod 裡的這個技能會自動更新。
適用情境
- PRD 或功能已經定案,需要拆成票券放進待辦清單
- 已經有票券,但沒有人說得出怎樣才算完成
你要提供的內容
- 功能說明或 PRD 段落
- 涉及的使用者角色
- 已知的規則和限制(選填)
你會得到的內容
一組使用者故事,每則附上 Given/When/Then 情境、邊界情況、範圍外說明、INVEST 檢查和待釐清問題。
運作方式
- 列出角色和他們的目標 每個角色寫出他想用這個功能完成什麼。一則故事只有一個角色;「使用者和管理員」的故事是 2 則故事。
- 每則故事都寫成「身為/我想要/以便」 Dan North 說明這個範本會迫使撰寫者寫出價值。「以便」要寫使用者在意的成果,而不是把功能再說一次。如果誠實的「以便」只能寫「因為我們說要做」,就把這則故事標為建議縮減範圍。
- 依使用者看得到的切片拆分 依工作流程的步驟、業務規則的不同情況、資料類型來拆,或先做順利路徑、之後再做例外。絕不依技術層拆分(「後端故事」、「前端故事」):每則故事都必須交付使用者可以實際試用的東西。
- 用 Given/When/Then 寫驗收標準 假設(Given)= 起始狀態。當(When)= 唯一的動作。那麼(Then)= 可以觀察到的結果。額外的條件用「而且」(And)接上。每則故事寫 2 到 5 個情境(本技能的預設):順利路徑、至少 1 個失敗路徑,以及任何規則的邊界。
- 列出邊界情況 每則故事都對照檢查:空資料、超長輸入、重複、沒有權限、連線中斷、同一個動作做兩次,以及既有資料會怎樣。每個邊界情況要嘛變成一個情境,要嘛列為範圍外。
- 寫範圍外說明 寫出這則故事刻意不做的事,免得審閱者期待它。
- 跑 INVEST 檢查 Bill Wake 的 INVEST:Independent(獨立)、Negotiable(可協商)、Valuable(有價值)、Estimable(可估算)、Small(夠小)、Testable(可測試)。每個字母標上通過或不通過。Small 不通過就再拆。Testable 不通過,代表驗收標準太模糊。Independent 不通過,就註明相依的項目。
分享給你的團隊
把它加入 AI Skill Pod,團隊每個人(外包人員也包括在內)都能從自己的 AI 使用同一個版本。 看看和團隊分享 AI 技能的最佳做法
更新紀錄
- v1.0.1 · · Example: Story 3 now has a failure scenario, a removed user who tries to sign in again is refused.
- v1.0.0 · · First release.
參考來源
- INVEST in Good Stories, and SMART Tasks (XP123) (2026-11-04 查閱)
- Given When Then (Martin Fowler) (2026-11-04 查閱)
- Introducing BDD (Dan North) (2026-11-04 查閱)
- Essential XP: Card, Conversation, Confirmation (Ron Jeffries) (2026-11-04 查閱)