# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Akshay 🚀 (@akshay_pachaar) · 平台：X (Twitter) · 日期：2026-06-06

> 原始來源：https://x.com/akshay_pachaar/status/2062526843564233040

## 中文摘要

# Hermes Kanban：你的 Agent 任務控制中心

這是一份關於 Hermes Kanban 的完整指南：涵蓋協調模型、Agent 間的 context 共享，以及如何在約 20 分鐘內建立一個包含 4 名 Agent 的軟體開發團隊（專案經理、後端開發者、前端開發者、測試人員）。

---

AI Agent 本應像一個團隊那樣運作。

你描述目標，它們負責分工，每個人都能承接上一個人的工作進度。

這是理想的藍圖。但實際情況卻恰恰相反：Agent 每次開始工作時都像是一張白紙。一個 Agent 不知道其他人做了什麼、哪些檔案被修改過，也不清楚 API 的樣子。每一次交接都像是從零開始，工作品質在從一個 Agent 轉移到下一個時就會迅速下降。

Hermes Kanban 解決了這個問題。每一項任務都能在崩潰或重啟後存續；每一次簡報都精確傳遞了下一個 Agent 所需的資訊；每一次失敗都會被記錄，確保重試時知道哪裡出了問題。

這就是你的任務控制中心看起來的樣子：

最棒的部分是，整個團隊都在你的手機上運作。你可以透過 Telegram 建立並指揮任務，即使你不在電腦前，Agent 也會自動接手工作。

看看這個：

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584450-iaHJ90UUjbcAAak6Zjpg.jpg)

在這篇文章中，我們將從零開始建立這套完整系統：包含協調模型、簡報機制，以及在約 20 分鐘內於你自己的硬體上運行一個 4 人的軟體開發團隊。

為了演示，我建立了一個可運作的 Google Docs 複製版，包含 AI 功能與生產級後端，且完全由這組 Agent 團隊所打造。

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

# 為什麼單一 Agent 不夠用？

假設你想新增一個「重設密碼」功能。這項工作會跨越三個領域：

- 一位負責建立 REST API 的後端開發者
- 一位負責讀取該 API 並建立 UI 的前端開發者
- 一位負責進行端到端驗證的測試人員

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584277-iaHJ95xfkb0AAO2Jmjpg.jpg)

你可以透過單一 Agent 來執行這三項工作，但 context window 會被填滿，導致 Agent 忘記它三步之前做了什麼。你花在管理它的時間，反而比它節省的時間還多。

將工作拆分給各司其職的 Agent 會產生另一個問題：前端開發者如何知道後端開發者做了什麼？這種「共享 context」的問題正是 Hermes Kanban 所解決的。

# 核心概念：一個任務看板，但 Agent 坐在欄位後方

一個任務包含標題、描述、負責人和狀態。有人接手任務、在看板上移動它，最後將其關閉。看板是唯一的真理來源（Single source of truth）。

Hermes Kanban 保留了這個模型，並將人類換成了坐在每個欄位後方的 Agent。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584619-diaHJ97bJAa0AAJ4zjpg.jpg)

每一項任務都是一行在崩潰或重啟後依然存在的資料。當 Agent 完成工作時，它會寫下一份摘要：修改了哪些檔案、建立了什麼內容，以及下一個 Agent 需要知道什麼。下一個 Agent 在開始工作前會先閱讀這份摘要。

這份摘要就是洞察力的核心。它將一群 Agent 轉變為一個團隊，而不是互不相識的陌生人。

# 詞彙表

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

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584802-diaHJ9LsvaIAAXglGjpg.jpg)

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

# Orchestrator：管理其餘 Agent 的 Agent

將 Orchestrator Agent 想像成專案經理，它閱讀高層級目標、檢查現有的 Agent、將目標拆解為相互連結的任務，然後退居幕後。它從不編寫程式碼或執行測試，它只負責協調。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584685-ediaHJ9gGdboAAUThjpg.jpg)

最重要的一條規則：在建立任務前，先檢查有哪些設定檔（Profile）存在。系統會自動跳過任何指派對象不符合真實設定檔的任務，所以第一步永遠是 `kanban_list`。

這是一個典型的專案經理操作，將「建立重設密碼流程」的需求拆解為相互連結的管線：

```python
kanban_show()

be = kanban_create(title="Password reset backend", assignee="backend-developer",
    body="Forgot/reset password flow + session invalidation")

fe = kanban_create(title="Password reset UI", assignee="frontend-developer",
    parents=[be], body="Next.js reset flow using backend API")

qa = kanban_create(title="E2E password reset test", assignee="tester",
    parents=[fe], body="Validate all acceptance criteria")

kanban_complete(summary="Created backend → frontend → QA dependency pipeline")
```

在此之後，看板會處理任務推進，而簡報會處理 context 傳遞。當這三項任務都完成時，專案經理會醒來，閱讀摘要並判斷工作是否完成。如果測試人員回傳 `"verdict": "FAIL"`，它會建立修復任務，循環繼續。

但實際上，你不需要操心任何細節。你只需要透過 Telegram 指派任務，Orchestrator 就會接手後續工作。

# 你會頻繁使用的三種模式

1. 管線（Pipeline）：

每個任務都依賴前一個任務。只有第一個任務會以「就緒」狀態開始，其他任務都在等待輪到自己。

```plaintext
BACKEND=$(hermes kanban create "Implement auth API" \
    --assignee backend-developer \
    --body "POST /register, POST /login, POST /refresh, POST /logout." \
    --json | jq -r .id)

FRONTEND=$(hermes kanban create "Build auth UI" \
    --assignee frontend-developer \
    --parent $BACKEND \
    --body "Read backend handoff for API shape. Login, register, profile pages." \
    --json | jq -r .id)

hermes kanban create "Test auth flow end to end" \
    --assignee tester \
    --parent $FRONTEND \
    --body "Cover happy path, wrong password, expired token, session persistence."
```

> 你不需要手動執行這些指令。你只需在 Telegram 上向專案經理描述專案，它就會為你建立這些任務。底層運作邏輯就如同上述指令。

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

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584934-diaHJBE9ZbsAAWgI1jpg.jpg)

2. 人類參與迴圈（Human in the loop）：

並非所有阻塞都是失敗。有時 Agent 會發現真正的問題並停下來詢問。

```plaintext
kanban_block(reason="review-required: password strength check missing, "
           "reset tokens aren't single-use (can be replayed within 30 min)")
```

你可以在儀表板上看到阻塞狀態。你驗證問題、修復它，然後解除任務阻塞：

```plaintext
hermes kanban unblock $IMPL
```

> 你也不需要在終端機執行這個指令，只需在 Kanban 看板上留言或在 Telegram 上傳送訊息，系統就會解除阻塞。

系統會在下一個週期重新啟動 Agent。第二次執行會呼叫 `kanban_show()` 並精確看到第一次嘗試為何被阻塞。它確切知道要修復什麼；它不是從零開始。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584516-ediaHJCu4aoAAjRwTjpg.jpg)

3. 分類說明（Triage specifier）：

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

```plaintext
# 丟出一個粗略的想法
hermes kanban create "auth needs rate limiting" --triage --assignee backend-developer

# 在調度員接手前完善它
hermes kanban specify $TASK_ID
```

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

# 設定流程：約 20 分鐘建立四個設定檔

四個 Agent，一個共享看板，專案經理可透過 Telegram 聯繫。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584337-diaHJEQB3acAA4piJjpg.jpg)

## 第 1 步：建立設定檔。

```bash
hermes profile create project-manager --clone
hermes profile create backend-developer --clone
hermes profile create frontend-developer --clone
hermes profile create tester --clone
```

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

## 第 2 步：賦予每個 Agent 個性

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

```markdown
# Soul

你是一個軟體開發團隊的專案經理。你的工作是接收使用者的應用程式構想，將其拆解為明確的任務，指派給正確的團隊成員，並在 Kanban 看板上追蹤進度。你不需要親自編寫程式碼，你負責管理工作。
```

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

```markdown
# Soul

你是一個軟體團隊的後端開發者。你使用 InsForge 建立並管理整個後端 — 資料庫、驗證、儲存、邊緣函式（edge functions）與部署。
```

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

```markdown
# Soul

你是一個軟體團隊的前端開發者。你負責建立 UI — 元件、頁面與使用者流程 — 並使用後端開發者設定好的 API 與 SDK 方法將它們與後端連接。
```

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

```markdown
# Soul

你是一個軟體團隊的測試人員。你對已完成的功能進行端到端測試，驗證是否符合驗收標準，並將 Bug 清晰地回報到 Kanban 看板上，以便進行修復。
```

## 第 3 步：新增 Agent skill

Skill 是逐步指南，針對如何執行特定工作提供具體指令。將它們視為你 Agent 的職業訓練。讓我們逐一列出：

InsForge

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584652-ediaHJHIzb0AAtC13jpg.jpg)

InsForge（開源，Apache 2.0）作為使用 Skill 與 CLI 的 Agent 的後端 context 工程層。我們的後端開發者 Agent 設定檔使用此 skill，以便為專案準備好可用的後端服務。

首先，新增 InsForge skills tap：

```bash
hermes skills tap add InsForge/insforge-skills
```

然後安裝後端 skills：

```bash
hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force
```

我們以同樣方式安裝其他工具，如 `insforge-cli`（基礎設施指令）、`insforge-debug`（故障診斷）與 `insforge-integrations`（第三方驗證提供者）。

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

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

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

所以，如果你正在打造 AI 後端工程師，請務必查看 InsForge →

（別忘了給個 star 🌟）

更多來自 Skills Hub 的 skills

Hermes 也維護了一個 Skills Hub，包含 18 個類別中的 687 個 skills：87 個內建、79 個選配、16 個來自 Anthropic（前端設計、pdf、pptx、docx、mcp-builder 等），以及 505 個來自 LobeHub。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584436-ediaHJLkragAASHPEjpg.jpg)

對於前端開發者，安裝 `frontend-design`。對於測試人員，安裝 `webapp-testing`。兩者皆可在 Hub 中取得。

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

`hermes kanban init` 會建立 `~/.hermes/kanban.db`，這是一個 SQLite 資料庫，用來保存每個任務、context 與執行歷史。

接著在專案經理設定檔下設定聊天閘道。從 Telegram 的 @BotFather 取得機器人 token，並從 @userinfobot 取得你的使用者 ID，然後執行：

```bash
hermes kanban init
hermes -p project-manager gateway setup
hermes -p project-manager gateway start
```

連線會 24/7 運作，保持系統活躍，並讓專案經理可透過 Telegram 聯繫。

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

傳送訊息給專案經理，告訴它你想建立什麼。它會將目標拆解為任務，建立並加上依賴連結，系統就會按順序執行它們。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584111-diaHJMZV2asAAAt51jpg.jpg)

# 儀表板

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

有兩個控制項值得了解。「Lanes by profile」會按負責人將「執行中」欄位進行子分組，讓你一眼就能看出哪個 Agent 負責什麼。「Nudge dispatcher」會立即執行一次排程，而不是等待 60 秒，這在你剛解除任務阻塞時很有幫助。

點擊任何卡片即可開啟其抽屜，查看完整的執行歷史、每次嘗試的結果與 metadata，並可編輯標題、負責人、優先級與依賴項目。

# 注意事項

在進行嚴肅的工作負載前，有三種故障模式值得了解。

1. 資料庫過載。若同時有 2 到 4 個 Agent 並行，你永遠不會遇到這個問題。但若有 10 個以上的 Agent 高頻率寫入，速度就會變慢。請使用 `hermes kanban dispatch --max 4` 進行限制。

2. 暫存 workspace 刪除。儲存到暫存 workspace 的檔案在任務標記為完成時就會消失，因為暫存空間的設計就是會被清除。請在程式撰寫任務中使用 `worktree`，或將專案資料夾路徑放在任務描述中，以便 Agent 知道儲存位置。

3. 本地模型飽和。針對本地模型（Ollama, 本地 GPU）時，系統可能會同時啟動多個 Agent 並使 GPU 不勝負荷，這會減慢生成速度並觸發自動停止。對於本地設定，請使用 `hermes kanban dispatch --max 2`。對於 Claude 或 GPT-4o 等 API 模型，這通常不是問題。

# 全貌

每個組件都有一個職責：

- `SOUL.md` 是 Agent 的固定身分：它是誰以及它如何思考。
- Skills 是針對特定工作類型的逐步指令。
- 記憶（Memory）是 Agent 在不同工作階段間對你環境的了解。
- Kanban 是協調層：共享狀態、context 傳遞，以及隨時可介入的人類。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780786584124-diaHJNCOxbQAApsEvjpg.jpg)

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

---

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

感謝閱讀。

## 標籤

Agent, 教學資源, 自動化, Hermes Agent, Hermes Kanban