Kanban 教程

本教程用四個場景幫助你理解 Hermes Kanban。開始之前，建議先讀 Kanban 多代理協作板，知道 task、run、assignee 和 dispatcher 分別是什麼。

準備工作

先啟動看板和 Dashboard：

hermes kanban init
hermes dashboard

然後在瀏覽器中打開 Dashboard，進入 Kanban 頁面。默認 board 使用 ~/.hermes/kanban.db。如果你後續創建多個 board，每個 board 都會有自己的數據庫。

注意：本教程裡的 bash 代碼塊是你手動運行的命令；worker 的工具調用只是為了說明模型在後臺如何驅動任務板，並不需要你手動輸入。

假設你要讓 Hermes 修一個 bug。最簡單的方式是創建任務，讓一個 worker 處理：

hermes kanban create "修復日報編輯器聯網校驗 loading 狀態"
hermes kanban list

worker 認領任務後，會持續 heartbeat。你可以在 Dashboard 裡看到它是否還活著、當前狀態是什麼、是否寫了 comment。

這個場景的重點是：即使 worker 退出，任務也還在。你可以重新調度，而不是從聊天記錄裡找上下文。

如果你有一批相似任務，例如更新 20 篇文檔、檢查 30 個鏈接、給多個頁面補測試，就可以把它們都寫進 board。

hermes kanban create "翻譯 Nous Portal 文檔"
hermes kanban create "翻譯 Bitwarden Secrets 文檔"
hermes kanban create "審計 Web Search 文檔"

然後讓多個 worker 並行認領。這樣做的好處是，每個任務都有獨立狀態，不會在一個長對話裡混成一團。

更復雜的任務可以拆成流水線。例如：

Kanban 的 link、block 和 unblock 可以表達這些依賴關係。一個任務阻塞時，worker 應該寫清楚原因；依賴解除後，再由 orchestrator 或人工 unblock。

長任務最怕“看起來還在跑，其實已經卡死”。Kanban 通過 heartbeat、claim TTL、stale 檢測和 retry fingerprint 來降低這個風險。

你可以把它想象成外賣系統：騎手接單後需要不斷更新位置。如果很久沒有位置更新，平臺就知道這單可能出問題了，需要重新派單或人工介入。

Kanban 的核心價值不是多一個列表，而是讓 Agent 協作變得可觀察、可恢復、可審計。先從單任務開始，確認 Dashboard、CLI 和 worker 狀態都能看懂，再逐步嘗試多 worker 和 swarm。