核心概念

Coppice 是一塊用來做程式工作的看板。你寫工單,代理在各自的分支上工作,每個改動在落地前都要經你審查。你啟動工單之後,代理可以沿工作流程自動繼續。你審查並接受最終的 diff。你不決定,甚麼都不會合併。

工單如何流轉

  1. Backlog(待辦)。你建立一個工單,或批准一個代理建議的工單。
  2. Plan Review(計劃審查)。按 Run agent,你的 PM 代理就會寫計劃。閱讀後,批准它或留下評論。如果工單有不清楚的地方,PM 代理可能會先問你最多 3 個簡短的問題。卡片上會顯示 “Waiting for your answers”(等待你的回答)。在工單裏回答後按 Send answers,PM 代理就會寫計劃。規劃永遠不會改動工單的程式碼。開啟 Skip planning(跳過規劃)後,工單會從 Backlog 直接進入 Ready。涉及流程、架構或資料模型時,計劃裏可能附一張小圖,但文字版計劃始終都在。
  3. Ready(就緒)。你批准的計劃會成為工單描述的一部分,放在 Approved plan 一節。Technical Lead(技術負責人)代理會對照程式碼檢查它,只在需要時修改這一節,然後決定由誰來做。被指派代理的執行會自動開始;想自己啟動的話,在 Settings 裏設定 auto_start_runs = false。如果沒有 Technical Lead,或者沒有合適的人選,工單會留在 Ready,保持未指派,並附上一條評論。
  4. In Progress、In Review、In QA(進行中、審查中、測試中)。代理在工單自己的分支上構建、審查和測試改動。你的主檢出目錄不會被動到。
  5. Wait for Human Review(等待人工審查)。你開啟 diff,以評論的形式給出意見,滿意後選擇 Accept(接受)。如果之後代理又加了提交,工單會回到 In Review,然後再回到你這裏。
  6. Done(完成)。接受不等於合併。準備好後選擇 Merge…,你接受的內容就是合併的內容,一字不差。如果檔案衝突,Coppice 不會動 main,而是把工單送回 In Progress,由同一個代理解決衝突。合併前你需要再接受一次。

卡住的工單會進入 Blocked(受阻),並附上一條說明原因的評論。

代理

Coppice 執行你已經在用的代理 CLI,例如 Claude Code、Codex、Cursor、OpenCode、Kilo Code、GitHub Copilot、Qwen Code、Kimi Code 和 Grok。每個代理都有一個角色,比如 PM、Technical Lead 或 Backend Engineer,並執行在一個 CLI 上。參見供應商。

每個代理都可以用不同的模型,即使在同一個 CLI 上也一樣。你的 PM 可以用 Claude Opus,Backend Engineer 則用 Claude Sonnet。

聊天

開啟 Chat(聊天),按一個代理,就可以聊你的程式碼、一個想法或某個工單。每個代理都能看到你所有的倉庫、看板、工單和 Knowledge(知識庫)。它可以起草工單或建議一條 Knowledge 筆記,但在你批准之前甚麼都不會儲存。選擇 New chat 可以另開一個聊天。

所有 CLI 都能聊天。Coppice 還沒有確認 Claude Code、Codex 或 Kilo Code 能保持只讀,所以它們的聊天會顯示一條提示橫幅。代理仍然可以在你的電腦上執行命令。

一切都在卡片上

評論、計劃和代理的執行記錄都儲存在工單上。代理之間只經工單評論溝通,所以發生過的事,你都能在那裏看到。代理可以開啟你附加到描述或評論中的檔案。

Knowledge(知識庫)

代理可以為後續工單儲存關於你專案的筆記。預設情況下,保留哪些由你批准。