Claude Code 任務怎麼下：功能開發任務說明提示詞（先探索再計劃、指定參考文件、給出能運行的驗收檢查）
在 Claude Code 裏讓它做一個跨多個文件的功能或改動，擔心它一上來就寫、寫偏了又反覆返工時用：一份按官方最佳實踐組織的任務說明——範圍、參考的現有寫法、不許動的地方、可運行的驗收檢查——並要求它先只讀探索、出計劃等你確認。
我要在這個倉庫裏完成一項改動。請先探索和計劃，得到我的確認後再實現。 ## 要做什麼 [功能或改動描述] ## 為什麼做、給誰用 [背景與使用者] ## 範圍 - 需要改動的位置（我已知的）：[相關文件或目錄] - 可以參考的現有寫法：請先閱讀 [參考實現的文件]，新代碼沿用它的結構、命名和錯誤處理方式。 - 不在這次範圍內、不要改動的部分：[不要改動的部分] - 依賴：只使用倉庫裏已經在用的庫；確實需要新增依賴時先問我。 ## 驗收檢查（完成的標準） - 行為：[驗收用例]（請寫成輸入與期望結果，例如「未登入訪問返回 401」） - 可運行的檢查：[測試與檢查命令] - 全部檢查通過才算完成。檢查失敗時修復根本原因，不要通過跳過測試、放寬斷言或吞掉錯誤來讓它通過。 ## 工作步驟 1. 探索（只讀，不修改任何文件）：閱讀上面提到的文件和與之相關的調用方，弄清現有的數據流和約定。把你的發現和不確定的地方簡要告訴我。 2. 計劃：列出要新增和修改的文件、每個文件改什麼、實現順序、需要補哪些測試、有哪些風險。然後停下來等我確認。有兩種可行方案時並列給出並說明取捨。 3. 實現：按確認後的計劃做。先寫或更新測試，再寫實現；每完成一個可獨立驗證的部分就運行相關檢查。 4. 驗證與彙報：運行全部驗收檢查，把實際運行的命令和輸出結果貼出來作為證據；說明改了哪些文件、有沒有偏離計劃、還有哪些已知的遺留問題。 5. 我確認後再提交，提交資訊說明做了什麼以及原因。 如果在實現中發現計劃有問題，停下來告訴我，不要自行擴大改動範圍。
高亮處換成你自己的內容：[功能或改動描述]、[背景與使用者]、[相關文件或目錄]、[參考實現的文件]、[不要改動的部分]、[驗收用例]、[測試與檢查命令]
已被複製 0 次
使用說明
這份任務說明對應的官方建議（據 Claude Code 官方文檔「Best practices」，資料核對於 2026-10-10）：
- 給 Claude 一個能自己運行的檢查：測試、構建、lint，或與設計稿比對的截圖。沒有檢查時它只能憑「看起來做完了」來判斷，驗證就落在你身上；並建議讓它展示證據（測試輸出、運行的命令及結果），而不是隻說「已完成」。
- 先探索、再計劃、再編碼：把調研和計劃與實現分開，避免解決錯問題。官方同時提醒，改動很小、一句話就能說清 diff 的任務可以跳過計劃直接做。
- 在提示詞裏給具體上下文：限定範圍、指向能回答問題的來源、指出倉庫裏可參考的現有模式、描述症狀和「修好」的標準。
- 針對根本原因而不是症狀。
怎麼填變量：[參考實現的文件] 是省返工最有效的一項，例如「src/widgets/HotList.tsx 是一個寫得比較規範的組件」。[驗收用例] 寫 2–5 條具體的輸入與期望結果；[測試與檢查命令] 寫倉庫裏實際使用的命令，如 pnpm test、pnpm typecheck。也可以在 Claude Code 裏用 @ 引用文件，讓它直接讀取。
配合 Plan 模式：官方推薦在探索和計劃階段使用 plan mode（只讀、不改文件），確認計劃後再切回正常模式實現。切換方式和快捷鍵見本站「Claude Code Plan 模式怎麼用」教學。
常見問題與調整：
- 同一個問題糾正了兩次還不對 → 官方建議此時清空上下文重新開始，把剛學到的教訓寫進新的任務說明，通常比在長對話裏繼續糾正效果好。
- 探索階段讀了太多文件 → 把範圍收窄，或說明「調查部分請用子代理完成，只把結論帶回來」。
- 需求本身還沒想清楚 → 先讓它採訪你：「我想做……，請就實現方式、邊界情況和取捨向我提問，問完後寫成 SPEC.md。」再新開會話按規格實現。
示例輸出
示例，僅供參考（任務：給導出接口加上按日期範圍篩選；計劃階段的輸出節選）
探索發現：導出邏輯在 src/export/service.ts，現有的篩選參數經 parseFilters() 統一校驗；列表接口已支持 from / to，可以複用同一個校驗函數。不確定：時區按用戶設定還是按 UTC，目前列表接口用的是 UTC。
計劃：
src/export/schema.ts：增加可選的from、to字段，複用dateRangeSchema。src/export/service.ts：把日期條件加入查詢；結束日期按當天 23:59:59 處理。src/export/service.test.ts：新增 4 個用例——只有開始日期、只有結束日期、範圍為空、開始晚於結束返回 400。
風險：大範圍導出可能超時，本次不處理，建議另開任務。請確認時區口徑後我再開始實現。
同款作品
用這條提示詞做出來的作品；原作者會因此獲得積分
還沒有同款，來做第一個。
0 條評論
還沒有評論，來搶沙發～