Hermes Kanban 使用教程
Hermes Kanban 是一个多 Agent 任务协作系统。你创建任务 → dispatcher 派发给对应 Worker → Worker 自动执行 → 结果回到你的飞书对话。
一、核心理念
传统工作流：你给指令 → 我一个一个做 → 做完再下一个
Kanban 工作流：你给任务 → 我拆成子任务 → 多个 AI 并行干 → 干完自动汇总回来
一句话：把一个大活拆成小活，分给不同的 AI 同时干，干完自动拼回来。
二、基本概念
2.1 任务（Task）
一个任务就是一个工作单元。每个任务有：
| 字段 | 说明 | 示例 |
|---|---|---|
| 标题 | 干什么 | "写一篇 Kanban 教程" |
| 分配者 | 哪个 AI 来做 | writer |
| 状态 | 当前在哪个阶段 | running |
| 工作区 | 文件放哪里 | scratch（临时目录） |
2.2 任务状态流转
创建(triage/ready) → 派发(running) → 执行中 → 完成(done)
↘ 阻塞(blocked) → 解封 → 重新执行
↘ 超时(timed_out) → 自动重试
↘ 崩溃(crashed) → 自动重试（连续失败3次则阻塞）
状态说明：
- triage：刚创建，还没人细化需求
- ready：需求明确，等待派发
- running：Worker 正在执行
- done：完成
- blocked：卡住了，需要人工介入（比如要密码、要决策）
2.3 Worker 身份（Profile）
每个 Worker 是一个特定角色的 AI，有自己的技能和记忆：
| Profile | 擅长 | 典型任务 |
|---|---|---|
| researcher | 查资料、收集信息 | "研究竞品定价" |
| analyst | 分析、对比、排序 | "基于两份研究报告出结论" |
| writer | 写作、翻译 | "写一篇 SEO 文章" |
| reviewer | 审校、找问题 | "审查这篇文章有没有事实错误" |
| pm | 需求拆解、规格说明 | "把这个想法拆成可执行的任务" |
| coder | 写代码 | "修复某个 bug" |
| publisher | 发布、上线 | "把文章发到百家号" |
| video-worker | 视频制作 | "做一条短视频" |
2.4 工作区（Workspace）
每个任务有自己的工作空间：
- scratch：临时目录，任务完成后自动清理。适用于研究、写作等不需要持久化的任务
- dir：固定目录，任务完成后保留。适用于部署、运维等需要持久化的任务
- worktree：Git 工作树，适用于代码开发
三、三种使用方式
方式一：飞书对话（推荐）
直接对飞书里的 Hermes 说：
"帮我研究一下灵活用工行业最新的政策变化，整理成一份报告"
Hermes 会自动创建 Kanban 任务，指派给 researcher，完成后报告回到对话。
这是你主要用的方式。 不需要打开任何网页，不需要记住任何命令。
方式二：Web UI
两个面板：
- 任务看板：https://claw.suiqu.com/kanban
创建任务、查看进度、手动干预。卡住的任务在这里解封。 - 像素办公室：https://kanban.jiuhui.net
可视化查看哪些 Worker 正在工作。鹤妹和 Worker 们会在像素办公室里走来走去。左侧有"昨日小记"（每天 22:00 自动生成）。
方式三：CLI 命令
适合排查问题：
# 查看所有任务 hermes kanban list # 查看某个任务详情 hermes kanban show t_xxxxxxxx # 手动完成任务 hermes kanban complete t_xxxxxxxx --summary "已完成" # 解封被阻塞的任务 hermes kanban unblock t_xxxxxxxx
四、任务协作模式
4.1 简单任务（一步到位）
一个任务，一个 Worker，干完就结束。
你: "查一下灵活用工最新政策" → 系统创建任务 → researcher 执行 → 报告回到对话
4.2 流水线（串行）
前一步的输出是后一步的输入。用 parents 建立依赖：
pm（拆需求）→ writer（写文章）→ reviewer（审校）→ publisher（发布）
每个阶段完成后，下一个阶段自动启动。
4.3 扇出扇入（并行）
多个 Worker 同时干，然后汇总：
researcher-A（查政策） ↘
analyst（汇总）→ writer（写报告）
researcher-B（查竞品） ↗
A 和 B 同时开始，都完成后 analyst 自动启动。
五、实际操作指南
5.1 创建任务
通过飞书： 直接描述你想做什么，Hermes 会自行判断是否需要拆成 Kanban 任务。
通过 Web UI： claw.suiqu.com/kanban → 点击"新建任务" → 填写标题和描述 → 选择分配者 → 创建。
5.2 查看进度
飞书： 任务完成后 Hermes 会主动汇报。"进行中"的任务可以在 Web UI 或像素办公室看到。
像素办公室： 打开 kanban.jiuhui.net
- 办公桌区域有角色在动 = 正在干活
- 休息区 = 待命中
- Bug 区 = 出问题了（需要你关注）
- 右侧访客列表 = 所有活跃 Worker
5.3 处理阻塞
任务卡住时，Worker 会告诉你卡在哪里。常见原因：
- 需要登录凭证（某个网站改密码了）
- 需要你做决策（"用方案 A 还是方案 B？"）
- 连续失败 3 次（系统自动挂起防止死循环）
解封方式： Web UI 上找到 blocked 的任务，点进去回复你的决策，然后点"解封"。
5.4 重试失败的任务
某个 Worker 崩溃或超时：
- 系统自动重试（最多连续 3 次）
- 3 次都失败则自动阻塞，不会无限重试烧 token
- 你可以在 Web UI 上手动 reclaim（回收）或 reassign（换人）
六、实际案例
案例 1：GEO 资讯日报
每天 9:00 cron 触发 → researcher: 从 AI HOT 搜 GEO 相关内容 → writer: 写成文章 → publisher: 发布到 jiuhui.net 和百家号
这条流水线每天早上自动跑，不需要人工干预。
案例 2：写一篇教程（当前任务）
user 创建任务: "写一篇 Kanban 教程" → dispatcher 派发给 writer（就是我） → writer 写完后 mark done → 教程回到你的对话
案例 3：竞品分析
你: "分析三家灵活用工平台的优劣势"
→ orchestrator 拆成 4 个子任务:
T1 researcher: 研究平台A
T2 researcher: 研究平台B
T3 researcher: 研究平台C
T4 analyst: 汇总 T1+T2+T3 出对比报告
→ T1/T2/T3 并行跑 → 都完成后 T4 自动启动
→ 报告回到对话
七、常见问题
Q: Worker 卡住了怎么办？
A: 去 claw.suiqu.com/kanban 找到 blocked 的任务，看它说了什么，回复你的决定。
Q: 任务派给错误的 Worker 了？
A: Web UI 上 reassign（重新分配）给正确的 profile。
Q: 不想等 Worker 慢慢跑，能催吗？
A: 不能催。Worker 是自动的，速度取决于任务复杂度。复杂的研究任务可能几分钟，简单的写作任务通常很快。
Q: 怎么知道 Worker 在干嘛？
A: 三个方法：
- 像素办公室 kanban.jiuhui.net — 看角色在哪个区域
- Web UI claw.suiqu.com/kanban — 看任务详情
- Worker 会定期发心跳（heartbeat）报告进度
Q: 任务完成后文件在哪里？
A: scratch 工作区的文件在任务完成后会被清理。如果产出是报告/文章，内容会直接在飞书对话里给你。如果需要保留文件，任务会用 dir 工作区指定固定路径。
八、进阶：自己配 Cron 自动任务
定时自动跑的任务：
# 每天早上 9 点发 GEO 日报 hermes cron create \ --name "GEO日报" \ --schedule "0 9 * * *" \ --model deepseek-v4-pro \ --prompt "搜索今天的 GEO 行业新闻，写成一篇资讯文章，发布到 jiuhui.net"
创建后自动运行，不需要每天手动触发。
九、一句话总结
你有活 → 飞书告诉我 → 我拆成小活分给不同的 AI 干 → 干完回来找你。
你不用管中间谁在干、怎么干、干到哪了——那是 Kanban 和我的事。