# multi-agent-collaboration

**Repository Path**: cgq/multi-agent-collaboration

## Basic Information

- **Project Name**: multi-agent-collaboration
- **Description**: 这是一个opencode 插件，实现一个简单的多智能体协作系统。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-22
- **Last Updated**: 2026-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# multi-agent-collaboration

轻量级多代理插件，专为 ollama 本地模型（Qwen 优化）设计。

## 特性

- **轻量代理架构**: 3 个专门化代理（Worker/Planner/Explorer）
- **Hashline 编辑**: 哈希锚定编辑，提高小模型编辑准确性
- **上下文优化**: 自动压缩和分块加载，适配有限上下文窗口
- **Skills 扩展**: 简单的技能模块系统
- **Qwen 优化**: 针对指令跟随特性优化的 Prompt

## 安装

```bash
# 克隆或下载到 OpenCode 插件目录
git clone https://gitee.com/cgq/multi-agent-collaboration.git
cd multi-agent-collaboration
npm install
npm run build

# 添加到 opencode.json
# "plugin": ["multi-agent-collaboration"]
```

## 快速开始

### 基本命令

| 命令 | 描述 |
|------|------|
| `/work` | 执行任务（简化版 ultrawork） |
| `/plan` | 创建计划 |
| `/refactor` | 代码重构 |

### 代理系统

| 代理 | 默认模型 | 职责 |
|------|---------|------|
| **Worker** | `ollama/qwen2.5-coder` | 主执行代理，完成任务 |
| **Planner** | `ollama/qwen2.5` | 规划代理，分解任务 |
| **Explorer** | `ollama/qwen2.5-coder:7b` | 快速探索，代码搜索 |

## 配置

在 `~/.config/opencode/multi-agent-collaboration.json` 中配置：

```jsonc
{
  "$schema": "./schema.json",
  "model": {
    "worker": "ollama/qwen2.5-coder",
    "planner": "ollama/qwen2.5",
    "explorer": "ollama/qwen2.5-coder:7b"
  },
  "context": {
    "maxTokens": 32000,
    "compressThreshold": 25000,
    "chunkSize": 500
  },
  "commands": {
    "work": { "maxSteps": 10 },
    "plan": { "maxTasks": 20 }
  },
  "hooks": {
    "hashline": true,
    "contextCompress": true
  }
}
```

## Hashline 编辑系统

原始输出:
```
1: function hello() {
2:   return "world";
3: }
```

Hashline 输出:
```
1#A3F2| function hello() {
2#B7C1|   return "world";
3#D9E4| }
```

编辑时验证哈希，防止小模型编辑错位。

## 代理详细说明

### Worker（主执行代理）

负责执行具体任务，编写代码。

**特点**:
- 完整的文件操作权限
- Bash 命令执行
- 自动任务追踪

**Prompt 优化**:
- 清晰的步骤指令
- 结构化输出格式
- 错误恢复机制

### Planner（规划代理）

负责任务分解和计划生成。

**特点**:
- 只读权限
- 结构化 todo 输出
- 任务优先级排序

### Explorer（探索代理）

快速代码搜索和探索。

**特点**:
- 轻量模型
- 仅 grep/glob/read 工具
- 快速响应

## Skills 系统

### 创建自定义 Skill

在 `.opencode/skills/my-skill/SKILL.md` 中定义：

```markdown
---
name: my-skill
description: 我的自定义技能
tools: [read, write, bash]
---

# 系统提示词

你是一个专门处理XXX任务的代理...

# 使用示例

当用户请求XXX时，你应该...
```

### 内置 Skills

- `git-helper`: Git 操作辅助
- `code-review`: 代码审查
- `test-gen`: 测试生成

## 开发

```bash
# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build
```

## 许可证

MIT