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。