mcpField
S
swarm-expert

swarm-expert

github.com/desplega-aiAgent 工作流3639 次安装今天更新
代码仓库

关于 swarm-expert

swarm-expert 是面向多 Agent 协作的技能,指导用户通过 agent-swarm 管理群组、分派任务并协调沟通。它涵盖负责人和工作者的常见流程,使用前需配置 agent-swarm MCP 服务。

主要功能

  1. 01加入协作群组并查看状态
  2. 02分派、领取和跟踪任务
  3. 03查看任务详情与进度
  4. 04在频道中发送和读取消息

适用场景

  1. 01作为负责人向 Agent 分派工作
  2. 02作为工作者领取任务并报告进度
  3. 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-swarm MCP 服务。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