# agent-coordinate

**Repository Path**: anolis/agent-coordinate

## Basic Information

- **Project Name**: agent-coordinate
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-08
- **Last Updated**: 2026-04-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Coordinate

OpenClaw 多 Agent 团队协作插件

## 功能特性

- **项目管理** - 创建项目、拆分任务、追踪进度
- **任务调度** - 任务全生命周期管理（创建→分配→执行→完成）
- **Agent 通信** - 支持询问、通知、广播三种通信模式
- **自动汇报** - 任务完成后自动向上级汇报
- **数据看板** - 提供 HTTP API 供外部系统查询
- **完整日志** - 记录所有通信和任务操作

## 快速开始

### 1. 安装

将插件复制到 OpenClaw 扩展目录：

```bash
cp -r agent-coordinate ~/.openclaw/extensions/
```

### 2. 配置 Agent

编辑 `config/agents.json`：

```json
{
  "agents": {
    "tech-dev": {
      "name": "技术开发",
      "role": "研发",
      "sessionLabel": "tech-dev-session"
    },
    "product-manager": {
      "name": "产品运营", 
      "role": "产品",
      "sessionLabel": "product-manager-session"
    },
    "manager": {
      "name": "项目经理",
      "role": "管理",
      "sessionLabel": "manager-session"
    }
  }
}
```

### 3. 重启 Gateway

```bash
openclaw gateway restart
```

## 使用示例

### 创建项目并分配任务

```typescript
// 1. 创建项目
project_manage(action="create", title="Wget 1.21.4 发布", requester="chairman")

// 2. 拆分任务
project_manage(
  action="plan",
  projectId="project_xxx",
  tasks=[
    { title: "源码编译构建", assignee: "tech-dev" },
    { title: "发布文档准备", assignee: "product-manager" }
  ]
)

// 3. 通知 Agent 开始工作
agent_message(action="notify", to="tech-dev", message="新任务：源码编译构建")
```

### 任务状态流转

```typescript
// Agent 接收任务
task_manage(action="receive", taskId="task_xxx")

// Agent 开始执行
task_manage(action="start", taskId="task_xxx")

// Agent 更新进度
task_manage(action="update", taskId="task_xxx", progress=50)

// Agent 完成任务（自动汇报给经理）
task_manage(action="complete", taskId="task_xxx", result="构建成功")
```

### Agent 间通信

```typescript
// 询问模式（阻塞等待响应）
agent_message(action="send", to="tech-dev", message="编译需要多久？")

// 通知模式（异步）
agent_message(action="notify", to="product-manager", message="文档已更新")

// 广播模式
agent_message(action="broadcast", members=["tech-dev", "product-manager"], message="项目进度会议")
```

## HTTP API

数据看板可通过以下接口获取数据：

```bash
# 获取任务列表和统计
curl http://localhost:18789/api/tasks

# 获取项目列表和进度
curl http://localhost:18789/api/projects
```

## 工具参考

### task_manage

| 操作 | 说明 |
|-----|------|
| `create` | 创建任务 |
| `assign` | 分配任务 |
| `receive` | 接收任务 |
| `start` | 开始任务 |
| `update` | 更新进度 |
| `complete` | 完成任务（自动汇报） |
| `list` | 任务列表 |
| `stats` | 任务统计 |
| `delete` | 删除任务 |

### project_manage

| 操作 | 说明 |
|-----|------|
| `create` | 创建项目 |
| `plan` | 拆分任务 |
| `status` | 项目状态 |
| `update` | 更新项目 |
| `complete` | 完成项目 |
| `list` | 项目列表 |
| `delete` | 删除项目 |

### agent_message

| 操作 | 说明 |
|-----|------|
| `send` | 发送消息（询问） |
| `notify` | 发送通知 |
| `broadcast` | 广播消息 |

## 日志查看

```bash
# 查看通信日志
tail -f ~/.openclaw/logs/agent-communication.log

# 查看任务数据
cat ~/.openclaw/extensions/agent-coordinate/data/tasks.json

# 查看项目数据
cat ~/.openclaw/extensions/agent-coordinate/data/projects.json
```

## 文件结构

```
agent-coordinate/
├── index.ts              # 插件入口
├── openclaw.plugin.json  # 插件配置
├── DESIGN.md             # 设计文档
├── README.md             # 本文件
├── config/
│   └── agents.json       # Agent 配置
├── data/
│   ├── tasks.json        # 任务数据
│   └── projects.json     # 项目数据
└── src/
    ├── types.ts          # 类型定义
    ├── core/             # 核心组件
    ├── store/            # 数据存储
    └── tools/            # 工具实现
```

## 设计文档

详细架构设计和流程说明请参考 [DESIGN.md](./DESIGN.md)

## 许可证

MIT