如何在寫程式之前用 AI 程式設計代理做計劃

Coppice

寫程式之前,先讓代理給出一份短計劃:做法、步驟,以及怎麼驗證這次改動。讓它先提問,真有選擇時再比較方案。可以用 CLI 的計劃模式,也可以在倉庫裡放一份計劃檔案,或者用 Coppice 這樣的看板。看板上,計劃是單獨的一步,你批准之後才寫程式,之後再對照計劃審查。

為什麼先做計劃

代理直接寫程式時,理解錯了只能在 diff 裡看出來。到那時,它已經把不對的東西做出來了,你得花時間去讀、解釋你本來的意思,再等下一次嘗試。一份計劃把同樣的誤解收成幾行字,一分鐘就能讀完。

拿到計劃很容易:你開口要,任何代理都會寫。難的是讓它有用。需求含糊,代理不問就猜,計劃只列步驟、不寫背後的決定,一旦開始寫程式,也沒有人再對照計劃檢查。

一份好計劃裡有什麼

  • 用你自己的話寫出結果和約束。「Settings 裡加一個深色模式開關,跟應用其餘部分用同一套主題設定。」
  • 要答案,不要猜測。 代理在做計劃之前,先問它需要知道的事。
  • 寫出做法,以及為什麼這樣選。 真有選擇時,比如版面或資料模型,代理列出選項並推薦一個。
  • 幾個步驟,包括能表明改動有效的測試。
  • 它不會改什麼。

如果一兩分鐘讀不完,這個任務大概太大了。把它拆開。

做法一:CLI 裡的計劃模式

Claude Code 有計劃模式:代理讀程式碼、提出計劃,但不改檔案。用其他代理時,你要求一份計劃,並告訴它在你批准之前不要改任何東西。

這是上手最快的做法。限制是計劃只留在對話裡。工作階段一結束,計劃就沒了,最終的 diff 也不容易再對照它檢查。

做法二:倉庫裡放一份計劃檔案

讓代理把計劃寫進一個 Markdown 檔案,比如 docs/plans/dark-mode.md。你自己改這個檔案,再用「Implement docs/plans/dark-mode.md」開始實作。同一個代理可以做,換一個也可以。

計劃能留下來,跨過工作階段,也跨過不同的代理,你還可以像審程式碼一樣審它。檔案仍由你管理,什麼時候算批准由你決定,diff 和計劃的對照也要你自己做。

做法三:用 Coppice,把計劃做成你批准的一步

Coppice 是一個桌面應用程式,把程式設計代理放在一塊工作看板上。每張工單都從一份計劃開始。PM 代理可以先問你最多三個問題,再寫計劃。介面改動還會給出幾種設計方案,供你比較和選擇。這次規劃不會改你的程式碼。你一批准,計劃就保存在工單上,代理按它來做,你再對照計劃審查 diff。

  1. 安裝 Coppice,並加入你的專案。
  2. 寫一張工單,寫明結果和約束,然後讓代理開始做。
  3. 如果 PM 代理提問,就回答。
  4. 讀計劃。如果是介面改動,打開設計方案並選一個。然後批准計劃,或要求修改。
  5. 程式碼準備好之後,對照已批准的計劃審查 diff。

如果工單是要在 Settings 裡加一個深色模式開關,計劃會寫明做法和三個步驟,其中包括一項設定測試:

一張處於 Plan Review 的工單,標題是 Add a dark mode toggle to Settings。計劃要在 Settings 那一列做一個開關,並列出三步:加上 Settings 開關、沿用現有的 theme hook、再加上一項設定測試。
寫任何程式之前,計劃會寫明做法和步驟。

同一張工單還會附上三種版面供比較。PM 代理推薦其中一種。你改選另一種,計劃會跟著更新:

深色模式開關的三種版面:A 是 Settings 列裡的開關,標著 Recommended;B 是 Light、Dark 和 System 按鈕,旁邊有即時預覽;C 是主題預覽卡片。
代理動手做之前,先比較這幾種版面。

核心概念說明了工單經過的每一步。

該選哪一種

  • 一次工作階段裡的小任務: 計劃模式。
  • 跨工作階段或跨代理的較大任務: 一份計劃檔案。
  • 任務很多,而且寫任何程式之前,計劃都是你要批准的一步: 用 Coppice。從快速上手開始。