使用 TodoWrite 進行規劃

你將學到什麼

複雜的任務需要計劃。當你要求 Claude Code「為我的應用程式添加認證」時，它不會直接開始編輯隨機檔案。它會先建立計劃。

完成後，你將了解：

• 為什麼執行前的規劃很重要
• TodoWrite 如何建立結構化任務清單
• 規劃-執行-驗證模式
• 如何有效使用規劃模式

問題是什麼

沒有規劃，AI 代理會陷入常見的陷阱：

1. 隧道視野 — 從想到的第一個檔案開始，忽略大局
2. 不完整的解決方案 — 修復了一部分但忘記了相關的更改
3. 浪費精力 — 走錯路，然後回溯

規劃通過強制「先思考再行動」階段來解決這些問題。

如何運作

規劃-執行-驗證模式

最有效的複雜任務模式：

階段 1：規劃
  └── 分析請求
  └── 拆分為獨立的任務
  └── 識別依賴關係
  └── 建立 TodoWrite 清單

階段 2：執行
  └── 按順序處理任務
  └── 將每個標記為 in_progress → completed
  └── 如有意外情況則調整計劃

階段 3：驗證
  └── 審查所有更改
  └── 執行測試
  └── 確認沒有遺漏

規劃模式

Claude Code 的 --plan 標誌強制採用規劃優先的方法：

claude --plan

在規劃模式中：

• AI 必須在執行前提出計劃
• 每個工具呼叫需要使用者批准
• 使用者可以在執行開始前修改計劃

關鍵洞見

規劃不只是組織工作 — 它是讓 AI 的推理可見。

當 Claude Code 建立 TodoWrite 清單時，它本質上是在展示它的思考。你可以審查計劃、及早發現誤解，並在任何程式碼更改發生之前重新導向。

這就是為什麼有經驗的使用者通常以「首先，建立一個計劃」開始複雜任務 — 這不是在微觀管理 AI，而是在對齊。在規劃階段抓住錯誤假設比在修改了 20 個檔案之後要好得多。

實作範例

試試這個規劃優先的開發提示模式：

我需要為我們的應用程式添加通知系統。

在寫任何程式碼之前：
1. 探索現有程式碼庫以了解架構
2. 使用 TodoWrite 建立包含所有必要任務的詳細計劃
3. 在繼續之前提出計劃供我審查

重點領域：
- 需要的資料庫架構更改
- 要建立的 API 端點
- 要構建的前端元件
- 要撰寫的測試

前後對比

沒有規劃	有 TodoWrite 規劃
直接跳到寫程式	探索 → 規劃 → 執行 → 驗證
遺漏相關更改	依賴關係提前識別
沒有進度可見性	任務清單顯示狀態
難以審查方法	計劃在執行前可審查
經常回溯	開始前方向已設定

下一堂課

在第 4 堂課中，我們將探索子代理與上下文隔離 — Claude Code 如何產生具有乾淨訊息陣列的子代理來處理複雜子任務，而不會污染父級上下文。