前面文章了解描述(Description)、驗收條件(AC)後,我們可以知道寫一則User Stroy 就像在寫故事,你需要讓讀者一頁一頁地被吸引,跟隨你的情節走到最後;在這篇中,我們將繼續揭開撰寫好User Stroy的密技,讓它既清晰明確,又易於維護。如果你曾經寫過一份需求文檔,那你可能知道這感覺——就像在爬一座無盡的山,今天我會幫你找到捷徑,讓整件事情變得不再那麼辛苦!
我們知道,系統畫面經常更新,按鈕的設計、位置、顏色每天都有可能變,所以,不要藥讓你的 AC 被畫面「綁架」,不要描述那些具體的位置或界面元件,否則每次 UI 調整,你的 AC 也得跟著變動。
- 錯誤(X):使用者可以點按右上的 [新增] 按鈕,開啟 {新增職務} 的畫面。
這樣寫,下一次設計師把按鈕挪到左邊,你就得重寫 AC,這樣是不是太麻煩了?
- 正確(O):使用者可以執行 [新增] 按鈕,進行新增職務的操作。
這樣寫,不論按鈕跑到哪裡,AC 都穩如泰山!
想像一下,你正在寫一個故事,最好遵循一個清晰的時間順序和情節發展——我們叫這個「快樂路徑」。先講清楚最常見、最流暢的流程,再來講不那麼順利的情況。如果你先描述出最糟的結果,那讀者可能會覺得自己一開始就進入了地獄!
- 錯誤(X):若查不到資料,顯示「查無資料」;若查到資料,則在 1 秒內返回查詢結果。
這就像是你打開一本小說,第一段就告訴你主角死了——誰還想往下看?
- 正確(O):若查到資料,則在 1 秒內返回查詢結果;若查不到資料,顯示「查無資料」。
先讓讀者走過平坦的路,然後再告訴他們可能會有的荊棘,這才是一個順暢的體驗。
在寫 AC 時,讓主詞+動詞的句型成為你的好朋友。當你的語句簡潔明了,讀者可以輕鬆理解你要表達的內容。如果語句太過複雜,他們可能會開始懷疑自己是不是需要讀一份「文言文」訓練指南。
- 錯誤(X):我可以將表單送出。
這雖然不是致命的錯誤,但也太過於繞口,不夠直白。
- 正確(O):我可以送出表單。
簡單明瞭,毫無多餘,這才是高效的 AC 描述!
看完這個系列文章,希望你對撰寫 User Story 有了全新的認識,其實,寫一則 User Story 不用堆砌複雜的詞句,而是要讓每個人都能輕鬆讀懂、順利跟上情節,這樣不僅開發團隊開心,使用者的需求也能真正被滿足。
希望讓大家透過這些小技巧,讓寫需求文件不用再像爬山那樣艱辛,而是走上一條又簡單又明瞭的捷徑!