跳到主要內容
HERMES DOCUMENTATIONDOCS / CURRENT

Kanban 多代理協作板

Hermes Kanban 是一個持久化任務板，用來協調多個 Hermes profile 一起工作。每個任務都是 SQLite 數據庫裡的一行，每次交接都有記錄，每個 worker 都是獨立 OS 進程，有自己的身份、模型和運行環境。

如果說 /delegate 更像“臨時找一個同事幫忙”，Kanban 就更像“給團隊開一個項目看板”。任務不會因為當前進程退出就消失，worker 可以認領、心跳、阻塞、恢復和完成任務。

想按案例學習，可以先看 Kanban 教程。本頁更像速查說明。

兩個入口：模型用工具，人用 CLI​

Kanban 有兩個入口，底層都寫同一個數據庫。

  • Agent worker 使用 kanban_* 工具集，例如 kanban_show、kanban_list、kanban_complete、kanban_block、kanban_heartbeat、kanban_comment、kanban_create、kanban_link 和 kanban_unblock。模型直接調用工具，不需要 shell 到 hermes kanban。
  • 人和腳本使用 CLI、slash command 或 Dashboard，例如 hermes kanban ...、/kanban ... 和 Dashboard 裡的 Kanban 頁面。

這點很重要：worker 不靠瀏覽器界面工作，也不靠模擬人類輸入命令。它們通過專用工具讀寫任務板。

初始化與查看​

最小流程如下：

hermes kanban init
hermes kanban list
hermes dashboard

默認看板數據庫通常在 ~/.hermes/kanban.db。如果你創建多個 board，每個 board 會有自己的數據庫路徑，避免不同項目互相干擾。

Dashboard 是觀察系統最直觀的地方。你可以看任務狀態、worker 活躍情況、任務關係和運行日誌；腳本和 cron 則更適合用 CLI 自動創建任務。

任務狀態怎麼流轉？​

一個典型任務會經歷下面的過程：

  1. 你或 orchestrator 創建任務。
  2. dispatcher 找到可用 worker。
  3. worker 認領任務，並持續發送 heartbeat。
  4. worker 遇到問題時可以 block，並寫明阻塞原因。
  5. 其他 worker 或你本人可以 comment、unblock 或接手。
  6. 任務完成後，worker 調用 complete，並寫入結果。

這套流程的價值在於“可恢復”。即使某個 worker 崩掉，任務和歷史仍然在數據庫裡，下一輪調度可以繼續處理。

Swarm 與多 worker​

v0.15.x 之後，Kanban 已經不只是列表，而是多代理平臺。hermes kanban swarm 可以創建 root、並行 worker、verifier、synthesizer 等拓撲，讓多個 profile 按角色協作。

適合使用 swarm 的場景包括：

  • 大型代碼改造，需要多個 worker 分文件或分模塊推進；
  • 研究任務，需要搜索、整理、驗證和成稿分工；
  • 迴歸測試，需要一個 worker 修改、另一個 worker 驗證；
  • 長任務需要 scheduled start、claim TTL 和失敗重試。

新手建議先從單 board、少量任務開始。理解任務狀態後，再引入 swarm。

什麼時候用 Kanban，什麼時候用普通會話？​

如果任務能在一次對話裡講清楚，並且不需要長期跟蹤，用普通會話即可。

如果任務具備下面任一特徵，就值得用 Kanban：

  • 需要多個 Agent 並行處理；
  • 任務會跨越很長時間；
  • 需要把工作拆成多個可追蹤子任務；
  • 需要 verifier 或 reviewer；
  • 需要任務級模型、任務級 worktree 或定時啟動。

記住一句話：會話適合即時協作，Kanban 適合持久協作。

參考鏈接​