寫程式之前,怎樣用 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。由快速上手開始。