Hermes Kanban：您的 AI Agents 任務控制中心

Hermes Kanban 完整教學：協作模型、Agent 間的上下文共享，以及如何在 20 分鐘內建立一個 4 人 AI 軟體團隊（PM、後端、前端、測試）

AI Agent 理應像團隊一樣協作。

你描述目標，它們分工合作，每個 Agent 接手前一個 Agent 完成的工作。

理想很豐滿，現實卻相反。Agent 每次都是從頭開始。一個 Agent 不知道其他 Agent 建立了什麼、哪些檔案被修改過、API 長什麼樣子。每一次交接都是冷啟動，工作品質在從一個 Agent 傳遞給下一個 Agent 時就會下降。

Hermes Kanban 解決了這個問題。每個任務都能在當機或重啟後存活。每次簡報都精準傳遞下一個 Agent 需要的資訊。每次失敗都會被記錄下來，讓重試時知道哪裡出了問題。

這就是你的任務控制中心：

Kanban 儀表板

最棒的是，整個團隊可以從你的手機上運行。你可以透過 Telegram 建立和管理任務，Agent 會在你離開辦公桌時接手處理。

看看這個：

在這篇文章中，我們將從零開始建立這個完整的設定：協作模型、簡報機制，以及一個在你自己的硬體上運行的 4 人軟體團隊，整個過程大約需要 20 分鐘。

為了展示這個功能，我建立了一個可運作的 Google Docs 克隆版，包含 AI 功能、可投入生產的後端，正是由這個 Agent 團隊所打造。

Google Docs 克隆版示範

那麼，廢話不多說，我們直接開始吧。

為什麼一個 Agent 不夠用

舉例來說，你想要新增密碼重設功能。這項工作會分散到三個領域：

• 後端開發者：建立 REST API
• 前端開發者：讀取該 API 並在其上建立 UI
• 測試人員：端到端驗證整個功能

1 個 vs 3 個 Agent

你可以讓一個 Agent 完成這三項工作，但上下文視窗會很快被填滿，Agent 會忘記三步之前做過什麼。你花在管理它上面的時間比它幫你節省的時間還多。

將工作分配給各自負責一個領域的 Agent 會產生另一個問題：前端開發者要如何知道後端開發者建立了什麼？這個共享上下文的問題，正是 Hermes Kanban 要解決的。

核心概念：任務看板，但 Agent 坐在欄位後面

一個任務有標題、描述、負責人和狀態。有人接手它，將它在看板上移動，然後關閉它。看板是唯一的真相來源。

Hermes Kanban 保留了這個模型，並在每個欄位後面放上 Agent 而不是人類。

Hermes Kanban 看板

每個任務都是一行記錄，能在當機或重啟後存活。當 Agent 完成任務時，它會寫下一份摘要：修改了哪些檔案、建立了什麼、下一個 Agent 需要知道什麼。下一個 Agent 在開始工作前會先讀取這份摘要。

這份摘要就是整個系統的關鍵。它將一群 Agent 從陌生人變成一個團隊。

詞彙說明

Kanban 看板上有 6 個不同的欄位：

• Triage（分類）： 粗略的想法會放在這裡，適合在你還沒有完整規格時，例如「我想要 auth 速率限制」。
• Todo（待辦）： 任務已建立，但正在等待依賴項完成。在父任務完成之前，它不會移動。
• Ready（就緒）： 依賴項已滿足，等待 Agent 接手。
• In Progress（進行中）： Agent 正在積極執行中。
• Blocked（受阻）： Agent 遇到障礙並標記給人類處理。在你解除阻礙之前，不會有任何動作。
• Done（完成）： 已完成，並保留完整的執行歷史、摘要和中繼資料。

協調者：一個管理其他 Agent 的 Agent

將協調者 Agent 想像成專案經理，它會讀取高層級的目標，檢查有哪些 Agent 存在，將目標分解為相互關聯的任務，然後退居幕後。它從不寫程式碼或執行測試。它負責協調。

協調者 Agent

唯一重要的規則是：在建立任務之前，先檢查有哪些設定檔存在。系統會自動跳過任何受指派者與實際設定檔不符的任務，所以第零步永遠是 kanban_list。

以下是一個典型的專案經理操作，將「建立密碼重設流程」的請求分解為一個相互關聯的管線：

1kanban_show()
2
3be = kanban_create(title="密碼重設後端", assignee="backend-developer",
4    body="忘記/重設密碼流程 + 會話失效")
5
6fe = kanban_create(title="密碼重設 UI", assignee="frontend-developer",
7    parents=[be], body="使用後端 API 的 Next.js 重設流程")
8
9qa = kanban_create(title="E2E 密碼重設測試", assignee="tester",
10    parents=[fe], body="驗證所有驗收標準")
11
12kanban_complete(summary="已建立後端 → 前端 → QA 依賴管線")

之後，看板會處理任務提升，而簡報則負責傳遞上下文。當三個任務都完成時，專案經理會醒來，讀取摘要，並判斷工作是否完成。如果測試人員回傳 "verdict": "FAIL"，它會建立修復任務，循環繼續。

但實際上，你不需要關心這些。你只需要從 Telegram 委派一個任務，協調者就會接手處理。

你會經常使用的三種模式

1. 管線模式： 每個任務都依賴於前一個任務。只有第一個任務會從「就緒」狀態開始。其他任務都必須等待輪到它們。

1BACKEND=$(hermes kanban create "實作 Auth API" \
2    --assignee backend-developer \
3    --body "POST /register, POST /login, POST /refresh, POST /logout." \
4    --json | jq -r .id)
5
6FRONTEND=$(hermes kanban create "建立 Auth UI" \
7    --assignee frontend-developer \
8    --parent $BACKEND \
9    --body "讀取後端交接資訊以了解 API 形狀。登入、註冊、個人資料頁面。" \
10    --json | jq -r .id)
11
12hermes kanban create "端到端測試 Auth 流程" \
13    --assignee tester \
14    --parent $FRONTEND \
15    --body "涵蓋快樂路徑、錯誤密碼、過期 Token、會話持久性。"

你不需要手動執行這個。你只需在 Telegram 上向專案經理描述你的專案，它就會為你建立這些任務。在底層，它的運作方式就像上面那樣。

當後端 Agent 呼叫 kanban_complete() 時，前端任務會移動到「就緒」狀態，並附帶後端的工作成果。

2. 人類介入模式： 並非所有阻礙都是失敗。有時 Agent 會發現一個真正的問題，並停下來詢問。

1kanban_block(reason="review-required: 缺少密碼強度檢查，"
2           "重設 Token 不是一次性使用（可在 30 分鐘內重播）")

你會在儀表板上看到這個阻礙。你驗證問題、修復它，然後解除任務的阻礙：

1hermes kanban unblock $IMPL

你也不需要直接在終端機執行這個，只需在 Kanban 看板上留言或在 Telegram 上發送訊息，系統就會解除阻礙。

系統會在下一個循環重新啟動 Agent。第二次執行時，Agent 會呼叫 kanban_show()，並確切看到第一次嘗試為何受阻。它清楚地知道要修復什麼，而不是從頭開始。

3. 分類規格化模式。

當你只有一個粗略的想法，而不是完整的規格時，將它放到看板上，讓系統在任何 Agent 接手之前先將其完善。

1# 放入一個粗略的想法
2hermes kanban create "auth 需要速率限制" --triage --assignee backend-developer
3
4# 在調度器接手之前將其完善
5hermes kanban specify $TASK_ID

specify 指令會將三個字的標題重寫為一個完整的任務，包含目標、方法和驗收標準。接手這個任務的 Agent 會得到一份真正的簡報。

設定：大約 20 分鐘建立四個設定檔

四個 Agent、一個共享看板、可在 Telegram 上聯繫的專案經理。

步驟 1：建立設定檔。

1hermes profile create project-manager --clone
2hermes profile create backend-developer --clone
3hermes profile create frontend-developer --clone
4hermes profile create tester --clone

--clone 會複製你的預設設定檔的配置作為起點。

步驟 2：為每個 Agent 賦予個性

1. 專案經理 位於 ~/.hermes/profiles/project-manager/SOUL.md：

1# 靈魂
2
3你是軟體開發團隊的專案經理。你的工作是接受使用者的應用程式想法，將其分解為清晰的任務，
4分配給合適的團隊成員，並在 Kanban 看板上追蹤進度。你自己不寫程式碼。你管理工作。

2. 後端開發者 位於 ~/.hermes/profiles/backend-developer/SOUL.md：

1# 靈魂
2
3你是軟體團隊的後端開發者。你使用 InsForge 建立和管理整個後端——資料庫、驗證、儲存、
4邊緣函式和部署。

3. 前端開發者 位於 ~/.hermes/profiles/frontend-developer/SOUL.md：

1# 靈魂
2
3你是軟體團隊的前端開發者。你建立 UI——元件、頁面和用戶流程——並使用後端開發者
4設定的 API 和 SDK 方法將它們連接到後端。

4. 測試人員 位於 ~/.hermes/profiles/tester/SOUL.md：

1# 靈魂
2
3你是軟體團隊的測試人員。你端到端測試已完成的功能，驗證驗收標準是否達成，
4並將錯誤清晰地回報到 Kanban 看板上，以便它們能被修復。

步驟 3：新增 Agent 技能

技能是逐步指南，是關於如何執行特定類型工作的具體指示。把它們想像成 Agent 的職業訓練。我們一個一個來列出：

InsForge

InsForge（開源，Apache 2.0） 作為使用技能和 CLI 的 Agent 的後端上下文工程層。我們的後端開發者 Agent 設定檔使用這個技能，為專案提供一個立即可用的後端服務。

首先，新增 InsForge 技能來源：

1hermes skills tap add InsForge/insforge-skills

然後安裝後端技能：

1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force

同樣地，我們安裝其他技能，如 insforge-cli（基礎設施指令）、insforge-debug（故障診斷）和 insforge-integrations（第三方驗證提供者）。

以下是後端開發者 Agent 如何使用該技能在 InsForge 上建立我們的專案後端。

首先，後端開發者 Agent 在 InsForge 中建立一個名為「Google Docs 克隆版」的專案。

儀表板會顯示專案統計資料，例如使用者數量、資料庫中的資料表、儲存空間，以及已部署的與驗證、文件處理等相關的邊緣函式及其 JavaScript/TypeScript 程式碼清單。

所以，如果你正在建立一個 AI 後端工程師，一定要看看 InsForge →

（別忘了給個星星 🌟）

來自技能中心的更多技能

Hermes 還維護一個技能中心，包含 687 個技能，涵蓋 18 個類別：87 個內建技能、79 個可選技能、16 個來自 Anthropic（前端設計、PDF、PPTX、DOCX、MCP 建構器等），以及 505 個來自 LobeHub。

對於前端開發者，安裝 frontend-design。對於測試人員，安裝 webapp-testing。兩者都包含在技能中心中。

步驟 4：初始化看板並啟動閘道。

hermes kanban init 會建立 ~/.hermes/kanban.db，這是一個 SQLite 資料庫，用於保存每個任務、上下文和執行歷史。

然後，在專案經理設定檔下設定聊天閘道。從 Telegram 上的 @BotFather 獲取機器人 Token，並從 @userinfobot 獲取你的使用者 ID，然後：

1hermes kanban init
2hermes -p project-manager gateway setup
3hermes -p project-manager gateway start

連線會 24/7 全天候運行，保持系統活躍，並使專案經理可在 Telegram 上聯繫。

步驟 5：發送你的第一個專案。

向專案經理發送你想要建立的內容。它會將目標分解為任務，建立帶有依賴連結的任務，然後系統會按順序執行它們。

儀表板

執行 hermes dashboard 並開啟 http://127.0.0.1:9119。你會看到每個狀態對應一個欄位，並透過 WebSocket 獲得即時更新，無需重新整理。

0:20

Hermes Kanban 儀表板

有兩個控制項值得了解。Lanes by profile（按設定檔分組） 會將「進行中」欄位按受指派者進行子分組，讓你一目瞭然哪個 Agent 負責什麼。Nudge dispatcher（推動調度器） 會立即執行一次調度，而不是等待 60 秒，這在你剛解除任務阻礙時特別有用。

點擊任何卡片以開啟其抽屜，查看完整的執行歷史、每次嘗試的結果和中繼資料，以及可編輯的欄位，如標題、受指派者、優先級和依賴項。

需要注意的事項

在處理重要工作之前，有三種失敗模式值得了解。

1. 資料庫超載。 2 到 4 個 Agent 並行運作時，你永遠不會遇到這個問題。但當 10 個以上的 Agent 以高頻率寫入時，速度會變慢。使用 hermes kanban dispatch --max 4 來限制。

2. 暫存工作區被刪除。 儲存到暫存工作區的檔案在任務標記為完成的那一刻就會消失，因為暫存區的設計就是會被清除。對於編碼任務，請使用工作樹（worktree），或者將專案資料夾路徑放在任務描述中，以便 Agent 知道要儲存在哪裡。

3. 本地模型飽和。 針對本地模型（Ollama、本地 GPU），系統可能會同時啟動多個 Agent 並壓垮 GPU，這會減慢生成速度並觸發自動停止。對於本地設定，請使用 hermes kanban dispatch --max 2。對於基於 API 的模型，如 Claude 或 GPT-4o，這很少是問題。

完整藍圖

每個部分都有一個職責：

• SOUL.md 是 Agent 的固定身份：它是誰以及它如何思考。
• 技能 是針對特定類型工作的逐步指示。
• 記憶 是 Agent 跨工作階段對你的環境的了解。
• Kanban 是協作層：共享狀態、上下文傳遞，以及隨時可介入的人類。

四個設定檔、四個 SOUL.md 檔案、一次閘道啟動。向 Telegram 上的專案經理描述你想要建立的內容，然後觀看看板被填滿。

如果你更喜歡透過影片學習，完整的 Hermes Kanban 教學將在幾天內於 YouTube 和 X 上發布。

感謝你的閱讀。