AgentsMeeting/docs/kanban-api-reference.md

Kanban HTTP API — 跨机器任务协作

所有 Agent（mohe、zhiwei、xxm、xiao）通过 HTTP API 读写 kanban 任务卡片。 不需要 Hermes，不需要 XMPP bot，只需要能 curl 到 192.168.1.246:9580。

基础 URL

http://192.168.1.246:9580/kanban

操作

查看所有任务

curl -X POST http://192.168.1.246:9580/kanban/list -H "Content-Type: application/json" -d '{}'

可以筛选：

# 只看指派给自己的
curl -X POST ... -d '{"assignee":"xxm"}'

# 只看待处理
curl -X POST ... -d '{"status":"ready"}'

查看单个任务

curl -X POST http://192.168.1.246:9580/kanban/show -d '{"id":"t_3adcf4a6"}'

添加评论（有问题或进展时用）

curl -X POST http://192.168.1.246:9580/kanban/comment \
  -d '{"id":"t_3adcf4a6","author":"xxm","body":"这里有个问题：..."}'

评论会发到核心群通知所有人。

查看评论

curl -X POST http://192.168.1.246:9580/kanban/comments -d '{"id":"t_3adcf4a6"}'

更新任务状态

curl -X POST http://192.168.1.246:9580/kanban/update \
  -d '{"id":"t_3adcf4a6","status":"done"}'

沟通流程

1. 创建任务 → 核心群收到通知
2. 你有问题 → 加评论（curl comment）
3. 评论被看到 → 有人回复评论
4. 完成 → 更新状态为 done

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