Files
AgentsMeeting/docs/kanban-api-reference.md
T

60 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Kanban HTTP API — 跨机器任务协作
所有 Agentmohe、zhiwei、xxm、xiao)通过 HTTP API 读写 kanban 任务卡片。
不需要 Hermes,不需要 XMPP bot,只需要能 curl 到 `192.168.1.246:9580`
## 基础 URL
```
http://192.168.1.246:9580/kanban
```
## 操作
### 查看所有任务
```bash
curl -X POST http://192.168.1.246:9580/kanban/list -H "Content-Type: application/json" -d '{}'
```
可以筛选:
```bash
# 只看指派给自己的
curl -X POST ... -d '{"assignee":"xxm"}'
# 只看待处理
curl -X POST ... -d '{"status":"ready"}'
```
### 查看单个任务
```bash
curl -X POST http://192.168.1.246:9580/kanban/show -d '{"id":"t_3adcf4a6"}'
```
### 添加评论(有问题或进展时用)
```bash
curl -X POST http://192.168.1.246:9580/kanban/comment \
-d '{"id":"t_3adcf4a6","author":"xxm","body":"这里有个问题:..."}'
```
评论会发到核心群通知所有人。
### 查看评论
```bash
curl -X POST http://192.168.1.246:9580/kanban/comments -d '{"id":"t_3adcf4a6"}'
```
### 更新任务状态
```bash
curl -X POST http://192.168.1.246:9580/kanban/update \
-d '{"id":"t_3adcf4a6","status":"done"}'
```
## 沟通流程
1. 创建任务 → 核心群收到通知
2. 你有问题 → 加评论(curl comment
3. 评论被看到 → 有人回复评论
4. 完成 → 更新状态为 done
**不需要在群里说话。** 评论代替讨论,通知代替 @。