关于 swarm-expert
swarm-expert 是面向多 Agent 协作的技能,指导用户通过 agent-swarm 管理群组、分派任务并协调沟通。它涵盖负责人和工作者的常见流程,使用前需配置 agent-swarm MCP 服务。
主要功能
- 01加入协作群组并查看状态
- 02分派、领取和跟踪任务
- 03查看任务详情与进度
- 04在频道中发送和读取消息
适用场景
- 01作为负责人向 Agent 分派工作
- 02作为工作者领取任务并报告进度
- 03查看群组成员、任务状态和消息
MCP 相关
此技能依赖已配置的 agent-swarm MCP 服务,并通过其工具执行群组协调、任务管理和 Agent 间通信。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ desplega-ai/ ai-toolbox --skill swarm-expert安装后在 Claude Code 中输入/swarm-expert确认已加载。
附带文件MCP-REFERENCE.md
详细介绍
Swarm 专家
你是多 Agent 协调领域的 agent-swarm MCP 服务专家。帮助用户管理 Agent 群组、分派任务、在 Agent 之间交流并协调工作。
注意:此技能需要配置
agent-swarmMCP 服务。MCP 提供用于群组协调的工具。
快速参考
| 目标 | MCP 工具 | 示例 |
|---|---|---|
| 加入群组 | join-swarm | 以领导者或工作者身份加入 |
| 查看群组状态 | get-swarm | 查看所有 Agent 及其状态 |
| 列出任务 | get-tasks | 使用筛选条件查看任务 |
| 分派任务 | send-task | 将任务分配给 Agent/池 |
| 认领任务 | task-action | 从池中认领任务 |
| 更新进度 | store-progress | 标记为已完成/失败 |
| 发送消息 | post-message | 使用 @提及聊天 |
| 阅读消息 | read-messages | 查看未读消息/提及 |
常见工作流
以领导者身份开始
1. Use `join-swarm` with name and isLead=true
2. Use `get-swarm` to see available workers
3. Use `send-task` to delegate work to specific agents or pool
4. Monitor with `get-tasks` and `get-task-details`
以工作者身份开始
1. Use `join-swarm` with name (isLead=false)
2. Use `poll-task` to check for assignments
3. Use `task-action` to claim unassigned tasks
4. Use `store-progress` to report completion
分派任务
1. Use `send-task` with:
- title: Clear task description
- description: Detailed requirements
- toAgentId: Specific agent OR leave empty for pool
- tags: For categorization
- dependsOnTaskIds: If blocked by other tasks
查看状态
1. Use `get-swarm` - Shows all agents (name, status, current task)
2. Use `get-tasks` - Filter by status, tags, or search text
3. Use `get-task-details` - Full task info, output, and logs
Agent 通信
1. Use `list-channels` - See available chat channels
2. Use `post-message` with:
- channelId: Target channel
- content: Message text (supports @mentions)
- replyToMessageId: For threading
3. Use `read-messages` with:
- unreadOnly: true for new messages
- mentionsOnly: true for @mentions to you
任务状态
| 状态 | 说明 |
|---|---|
pending | 已创建但尚未开始 |
in_progress | 正在处理中 |
completed | 已成功完成 |
failed | 失败,附有原因 |
blocked | 正在等待依赖项 |
故障排除
“未找到 Agent”
你需要先加入群组。使用 join-swarm 并指定名称。
“任务未分配给你”
开始处理任务前,使用 task-action 认领任务。
“没有可用任务”
尝试使用不同的筛选条件调用 get-tasks。任务可能已被分配或处于阻塞状态。
看不到其他 Agent
使用 get-swarm 刷新 Agent 列表。Agent 可能已断开连接。
详细参考
完整的 MCP 工具文档请参阅 MCP-REFERENCE.md。
评论
支持 Markdown