Claude Code 五種問法：講清目標、範圍同驗收

好 prompt 令假設少啲，唔保證結果一定啱

你叫 Claude「執靚個模組」，佢可能改命名，亦可能重寫架構。要減少來回，先講你想改善乜、邊啲行為要保留，同點樣驗收。

以下五種問法可以按需要組合。改一句字毋須全部做；涉及多個模組、業務規則或者難以復原嘅操作，先需要較清楚嘅步驟。

1. 先查專案，再提出方案

目標：[具體結果]。

先讀相關入口、現有實作同測試。提出最小可行方案，列出預計改動檔案、取捨、假設同未確認資料。

只有真係存在值得比較嘅選擇，先提供替代方案。暫時唔寫程式，等方案確認後再做。

唔使硬湊三個方案。最重要係計劃基於實際檔案，唔係先想像一套架構，再搵地方放入去。

2. 範圍寫到可以用差異核對

任務：[填寫]。

可修改：[原始碼及相關測試路徑]。
必須保留：[公開介面、資料格式或行為]。
唔包括：[升級依賴、部署或其他工作]。

如果需要超出範圍，先列出原因同最小影響，唔好自行擴大。完成後列出實際改動檔案。

記得預留相關測試範圍，唔好一邊要求可靠修正，一邊禁止任何測試改動。完成後用 git diff 核對；發現越界，先分清係邊個嘅改動，唔好直接還原檔案而蓋走其他工作。

3. 用失敗測試確認規格

預期行為：[填寫]。
重現步驟或輸入：[填寫]。

先加一個能重現問題嘅測試，執行並確認係因為預期行為未做到而失敗，唔係語法、匯入或環境錯誤。

確認測試符合需求後，再做最小修正，重跑相關測試。唔好修改預期答案去迎合現有實作。

有明確邏輯嘅工作好適合呢種問法。版面細改可以用視覺檢查同鍵盤操作驗收；但 UI 互動、表單規則同重要流程仍然值得測試，唔應一概排除。

4. 畀例子，同時畀一般規則

以下用文字清理示例，避免將一個特定業務或稅率當成普遍規則：

寫一個整理標籤清單嘅函數。

規則：去除每項頭尾空白；移除空字串；相同文字只保留第一次；保留原先次序；英文大小寫視為不同。

例子一：輸入 [" 工作 ", "", "生活", "工作"]，輸出 ["工作", "生活"]。
例子二：輸入 []，輸出 []。
例子三：輸入 ["AI", "ai"]，兩項都保留。

若輸入唔係字串陣列，先說明錯誤處理方案。唔好硬寫例子內容做答案。

例子補足規則，唔取代規則。真實資料要先去識別化；你亦可以提供虛構但結構相同嘅資料，唔需要將客戶發票或私人記錄原樣貼入去。

5. 有後果嘅步驟，先解釋再執行

請先完成可審閱嘅草稿或差異，列出改動、驗證結果、仍有風險嘅地方，以及下一步會影響邊個外部系統。

今次只準備同驗證，唔提交、推送、部署或發訊息。完成後將結果留低畀我決定。

如果一開始已經明確授權某個可逆小改動，就唔需要每一步停低再問。流程應該配合範圍同風險，唔係用同一個確認儀式套落所有任務。

點揀最合適嘅組合

查 bug：先提供重現同證據，再要求驗證假設。重構：先界定要保留嘅行為，再加特徵測試。新功能：先確認目標同一般規則，落手後用實際驗收結果收尾。

唔需要喺 PR 寫用過邊個「神奇問法」證明質素。審閱者真正需要嘅，係問題、差異、測試同未確認範圍。Prompt 只係幫你更清楚咁交代呢幾樣資料。