用語音輸入更快寫出清楚的錯誤回報
工作時發現軟體出錯，光是把問題說清楚，就像多了一項任務。切換到問題追蹤工具後，你開始回想剛才的操作，最後卻只寫下「匯出功能壞了」。接手調查的人還得追問：匯出什麼？發生了什麼事？怎麼重現？
語音輸入可以作為起點：趁細節還清楚，先說出問題經過，再把文字整理成有結構的回報。經過用說的，需要精確的資訊則用輸入或複製補上。這套做法不只適合開發與測試人員，也適合在 Mac 上工作的客服或一般使用者。
1. 切換工作前，先說清楚一個問題
先簡短說明你原本想完成什麼，包括操作前的狀態、採取的動作，以及實際看到的結果。一份回報聚焦一個問題，避免把不同狀況混在一起。
以虛構的任務管理應用程式為例，口述草稿可以是：
我開啟已完成任務的畫面，把清單匯出成 CSV。畫面上只有四筆已完成任務，但下載的檔案也包含未完成的任務。我預期匯出內容會和篩選後的畫面一致。在同一個畫面再試一次，結果還是一樣。
這是報告的素材，還不是定稿。先保留操作順序，不必一邊說話，一邊顧慮每個欄位的格式。
2. 把敘述整理成可重現的步驟
編輯草稿時，將「那個按鈕」等模糊說法換成介面上的實際名稱，並補上重現問題前需要準備的條件。
上面的虛構案例可以整理成：
- 標題： 從已完成任務畫面匯出的 CSV 包含未完成任務。
- 前置條件： 測試專案中有四筆已完成任務與兩筆未完成任務。
- 重現步驟： 開啟專案，篩選已完成任務，匯出 CSV，再開啟下載的檔案。
- 預期結果： CSV 只包含篩選畫面上的四筆已完成任務。
- 實際結果： CSV 包含全部六筆任務，包括兩筆未完成任務。
- 重現情況： 使用同一個測試專案操作兩次，皆出現相同結果。
- 影響： 分享匯出清單前，必須手動刪除不需要的資料列。
另外，複製並補上受影響應用程式與作業系統的版本；若與瀏覽器有關，也附上瀏覽器版本。只寫實際測試的環境，不要憑印象填寫。
3. 背景用說的，精確字串用複製的
語音適合解釋操作經過，以及問題為何影響工作。錯誤代碼、檔案路徑、網址與版本號碼，則適合從來源直接複製。少一個字元，都可能讓調查走錯方向。
口述完成後，再用鍵盤整理編號步驟、貼上簡短的錯誤訊息。若有助於說明問題，可另外附上螢幕截圖或相關的紀錄片段。語音輸入產生的是文字草稿，不代表它已驗證問題或自動附上佐證。
也要區分觀察與推測。「檔案包含六筆任務」是觀察；「快取錯誤導致匯出時忽略篩選條件」則是原因假設，除非你已經查證。尚未確認的解釋，請標示為可能原因。
4. 準備可以重複使用的回報範本
把以下問題存進筆記或問題追蹤工具，每次用語音簡短回答：
- 用一句話說明，問題是什麼？
- 使用什麼環境，從什麼狀態開始？
- 依序做了哪些操作？
- 預期結果與實際結果分別是什麼？
- 測試幾次，發生幾次？
- 影響哪項工作，有沒有替代做法？
- 應該附上哪些佐證？
只發生過一次，就照實寫。如果還沒測試替代做法，就標示未確認。清楚交代證據的範圍，比把猜測寫得很肯定更有用。
5. 用第一次看到問題的角度檢查
送出前，檢查標題、步驟順序、介面名稱、數字與預期結果。本文提到的附件，也要確認確實已附上。刪除重複說明，但保留重現問題所需的前置條件。
想延伸運用這套寫作方式，可以閱讀用語音輸入更快撰寫文件，以及把草稿整理成流暢文章。
TypeFree提供簡單的方式，將說話內容轉成可編輯的文字，幫助你更快寫作。下次回報錯誤時，先趁記憶清楚說出操作經過，再補齊精確資訊，讓接手的人能依據清楚的內容展開調查。