# Kanban HTTP API — 跨机器任务协作

看板数据库使用 `~/.hermes/kanban.db`（Hermes CLI 同一份）。

## 访问方式

| 方式 | 命令 / URL | 状态 |
|------|-----------|------|
| Hermes CLI | `hermes kanban list` | ✅ 可用（任意机器） |
| 独立 API | `scripts/kanban_api.py` → `:9580` | ❌ 需启动 |
| Hermes Dashboard | `hermes dashboard` → Kanban 插件 | ✅ 246 上可用 |

> **注**：看板**暂未**合入 AgentsMeeting Flask Dashboard（:5803）。该文档是过时设计意图，待 Phase 3 开发时实现合并。

## REST API

### 列出任务

```bash
# 全部
curl http://192.168.1.246:5803/api/kanban

# 按状态筛选
curl "http://192.168.1.246:5803/api/kanban?status=ready"

# 按指派者筛选
curl "http://192.168.1.246:5803/api/kanban?assignee=mohe"
```

返回 JSON 数组，每项含 id / title / body / status / assignee / created_at。

### 查看单个任务（含评论）

```bash
curl http://192.168.1.246:5803/api/kanban/t_3adcf4a6
```

返回 JSON，含 comments 数组。

## 创建 / 更新 / 评论

（走 kanban handler 流程，暂不开放 HTTP 写操作）

## 沟通流程

1. 创建任务 → Dashboard 事件 → XMPP DM 通知目标 agent
2. agent 在 kanban-handler session 里处理
3. 有疑问 → 评论卡片 → 触发新一轮通知
4. 完成 → 更新 status=done → 可选汇报

**不需要在群里说话。** 评论代替讨论，通知代替 @。