xiaowei-system/scripts/kanban-user-guide.md

小唯 Kanban 看板调度手册

2026-09-01 · v0.21.0

---

快速使用

1. 创建任务

# 路由到对应 profile
python3 ~/.hermes/scripts/kanban-route.py "调研 AI Agent 记忆系统" --assignee research
python3 ~/.hermes/scripts/kanban-route.py "写一个 hermes 插件" --assignee opencode
python3 ~/.hermes/scripts/kanban-route.py "测试 DSH 模型" --assignee dsh

# 或直接指定
hermes kanban create --assignee research --tenant xiaowei "任务描述"

2. 查看状态

hermes kanban list                    # 所有任务
hermes kanban stats                   # 统计信息
hermes kanban show <task_id>         # 任务详情
hermes kanban diagnostics            # 故障诊断

3. Swarm 并行执行

hermes kanban swarm "完成这个功能" \
  --worker research:调研,skill=project-research \
  --worker opencode:编码,skill=opencode \
  --verifier default \
  --synthesizer default

4. 后台调度器

# 启动 daemon（持续调度）
hermes kanban daemon --interval 60 --max 5

# 单次 dispatch
hermes kanban dispatch --max 10

---

Profile 路由表

任务类型	关键词	→ Profile	Model
代码执行	代码/实现/写/改/bug/API/插件/安装/部署	opencode	claude-fable-5（需 API key）
研究分析	调研/分析/竞品/报告/选型/方案/设计	research	agnes-2.0-flash
DSH 研究	DSH/dsh/模型测试/本地模型/llama	dsh	deepseek-v4-flash
通用任务	默认	research	agnes-2.0-flash

---

文件位置

文件	用途
~/.hermes/scripts/kanban-route.py	任务路由脚本
~/.hermes/scripts/kanban-hub.py	看板中枢脚本
~/.hermes/scripts/kanban-verification-report.md	验证报告
~/.hermes/profiles/{opencode,research,dsh,orchestrator}/config.yaml	Worker profile 配置
~/.hermes/kanban/kanban.db	看板 SQLite 数据库

---

验证记录

• ✅ research profile：55s 完成竞品分析报告（8 个框架）
• ⚠️ opencode profile：API key 失效，需修复
• ✅ 看板调度器：spawn → heartbeat → complete 全链路
• ✅ 故障诊断：失败任务自动 blocked + diagnostic

---

创建：小唯 A06
更新：2026-09-01