Agent Team

SKILL.md

# agent-team - 多 Agent 团队管理系统

管理和调用具有不同"灵魂"的子 Agent 团队，每个 Agent 拥有独特的身份定义和专用模型。

## 使用方法

### 基础命令
```bash
agent-team list                      # 列出所有 Agent
agent-team show <name>              # 查看 Agent 详情
agent-team spawn <name> [task]      # 启动 Agent 执行任务
agent-team chat <name>              # 与 Agent 交互对话
```

### 示例
```bash
# 查看团队所有成员
agent-team list

# 查看 Coder 的详细信息
agent-team show coder

# 让 Coder 帮你写代码
agent-team spawn coder "写一个快速排序算法"

# 与 Writer 对话讨论写作
agent-team chat writer
```

## 内置 Agent 团队

| Agent | 角色 | 主模型 | 专长 |
|:---:|:---|:---|:---|
| 🧑‍💻 **coder** | 代码专家 | qwen3-coder-next | 编程、重构、测试 |
| ✍️ **writer** | 写作专家 | qwen3.5-plus | 文档、博客、创意写作 |
| 📊 **analyst** | 数据专家 | qwen3.5-plus | 数据分析、可视化 |
| 🔍 **researcher** | 调研专家 | gemini-3.1-pro | 文献调研、竞品分析 |
| 👀 **reviewer** | 审查专家 | qwen3-max | 代码审查、质量把关 |

## 创建新 Agent

### 1. 创建目录
```bash
mkdir -p ~/.openclaw/workspace/agents/<agent-name>
```

### 2. 定义 SOUL.md
```markdown
# SOUL.md - <Agent Name>

## 身份
你是...

## 性格特质
- ...

## 专业领域
- ...

## 沟通风格
- ...
```

### 3. 创建 config.json
```json
{
  "name": "AgentName",
  "role": "角色描述",
  "emoji": "🤖",
  "model": {
    "primary": "dashscope/qwen3.5-plus",
    "fallback": "google/gemini-3-flash-preview"
  },
  "capabilities": ["能力 1", "能力 2"]
}
```

## 模型配置说明

每个 Agent 可以配置不同的模型：

- **dashscope/qwen3-coder-next**: 编码专用
- **dashscope/qwen3.5-plus**: 通用中文优化
- **dashscope/qwen3-max**: 最强推理
- **google/gemini-3.1-pro**: 深度研究
- **google/gemini-3-flash-preview**: 快速响应

## 工作模式

### 1. 任务模式 (spawn)
```bash
agent-team spawn coder "优化这个函数"
```
- 创建独立子代理会话
- 执行指定任务
- 完成后返回结果

### 2. 对话模式 (chat)
```bash
agent-team chat analyst
```
- 进入交互式对话
- 保持角色一致性
- 适合复杂协作

## 高级用法

### 并行多 Agent
```bash
# 同时启动多个 Agent
agent-team spawn coder "写代码" &
agent-team spawn writer "写文档" &
agent-team spawn reviewer "审查代码" &
wait
```

### 链式调用
```bash
# Coder 写代码 → Reviewer 审查 → Writer 写文档
agent-team spawn coder "实现功能"
agent-team spawn reviewer "审查代码"
agent-team spawn writer "编写文档"
```

## 文件结构

```
~/.openclaw/workspace/
├── agents/
│   ├── coder/
│   │   ├── SOUL.md       # 身份定义
│   │   └── config.json   # 模型配置
│   ├── writer/
│   └── ...
└── skills/
    └── agent-team/
        ├── agent-team.py  # 管理脚本
        └── SKILL.md       # 本文档
```

## 故障排除

1. **Agent 未找到**: 检查 `~/.openclaw/workspace/agents/` 目录
2. **模型不可用**: 确认模型配置正确且 API Key 有效
3. **会话无法创建**: 检查 OpenClaw 网关状态

## 相关技能

- `sessions_spawn`: OpenClaw 原生子代理创建
- `self-improving`: 自我进化记忆系统