用語音輸入,更快寫出清楚的驗收條件
「讓使用者可以儲存草稿」看起來很簡單,直到有人問:標題留白怎麼辦?儲存後會直接公開嗎?你或許能立刻口頭解釋,任務的說明欄卻還是一片空白。
語音輸入可以把這段說明變成初稿。先說明一個情境,再整理成驗收條件,也就是工作通過驗收時應能觀察到的結果。基本概念可參考Atlassian 的驗收條件說明(英文)。以下提供一套從口述到文字的實際做法。
1. 先打開任務與相關資料
在 Mac 上,把任務說明與相關設計稿或已確認的筆記並排顯示。一次只處理一個小範圍的行為,不要從整個功能開始。若這次要描述手動儲存草稿,排程發布、公開文章和自動儲存就先另外討論,除非已確定包含在範圍內。
先寫一句目標,例如:「編輯者可以儲存未完成的文章,之後回來繼續編輯。」這能讓口述內容聚焦在使用者要完成的事情。
2. 用五個問題引導口述
想像你正在向同事展示操作流程,每說完一項就稍微停頓。
- 誰: 使用這項功能的是哪種使用者或角色?
- 前提: 操作前已具備哪些條件?
- 操作: 使用者做了什麼?
- 結果: 操作後應該能看到或確認什麼?
- 例外: 在一個相關的失敗情境中,應該如何處理?
遇到團隊還沒決定的內容,先說「待確認」。整理文字時就能移到獨立區塊,避免把一個想法誤寫成確定的需求。
3. 把初稿拆成可檢查的敘述
以下是虛構功能的口述範例,並非 TypeFree 的功能說明。
編輯者開著一篇還沒公開的文章,已經有標題和內文。儲存草稿後會看到成功提示,重新開啟時標題和內文都還在。文章不會因此公開。標題空白時,要提示補上標題,而且不能儲存。自動儲存還沒決定。
完成語音輸入後,可整理成供團隊審閱的條件草案:
- 編輯者儲存標題非空白的未公開文章,儲存成功後會看到確認提示。
- 重新開啟已儲存的草稿時,會還原該次儲存的標題與內文。
- 儲存草稿不會讓文章對外公開。
- 標題空白時嘗試儲存,會顯示要求填寫標題的訊息,且不儲存變更。
「是否加入自動儲存?」留在待確認事項,不要混入已同意的條件。這些規則只是虛構功能的提案;實際行為仍需由你的團隊決定。
4. 先核對意思,再修飾文字
特別檢查「不會」「只有」「空白」「未公開」等字詞。少一個否定詞,就可能把需求意思顛倒。按鈕名稱若需要精確一致,請直接從設計稿複製,不要只依賴語音辨識。
接著換成審閱者的角度:我要做什麼操作,又要看到什麼,才能判斷通過?如果寫了「快速儲存」,就確認團隊需要的時間與測量條件,不要為了讓文字看起來精確而自行編出數值。
若口述過程談到資料儲存方式或內部命名,把這些內容移到技術討論筆記。先分清楚使用者看得見的結果,以及內部如何實作。
5. 帶著待確認事項一起討論
分享時註明這是草案,並保留尚未決定的問題。在把清單視為確定範圍之前,請開發與審閱人員一起確認情境。語音輸入能記下你的說明,卻不代表大家已經同意,也不代表功能已通過測試。
其他相關寫作任務,可參考用語音輸入撰寫專案概要與更清楚地撰寫錯誤回報。
TypeFree是把語音轉成可編輯文字、加快寫作速度的簡單方式。先選一個功能情境,說出預期行為,檢查文字後再放進任務說明。