agent-organizer

Agent 组织器

用途

提供多 Agent 系统架构、协调模式和自主工作流设计方面的专业知识。负责复杂 AI 系统中的 Agent 拆分、通信协议和协作策略。

适用场景

• 设计多 Agent 架构或 Agent 团队
• 实现 Agent 间通信协议
• 构建分层或群集式 Agent 系统
• 协调多个 Agent 间的自主工作流
• 调试 Agent 协调故障
• 将 Agent 系统扩展到生产环境
• 设计 Agent 记忆共享策略

快速开始

在以下情况调用此技能：

• 设计多 Agent 架构或 Agent 团队
• 实现 Agent 间通信协议
• 构建分层或群集式 Agent 系统
• 协调多个 Agent 间的自主工作流
• 将 Agent 系统扩展到生产环境

以下情况请勿调用：

• 构建单 Agent 大模型应用（使用 ai-engineer）
• 优化单个 Agent 的提示词（使用 prompt-engineer）
• 管理 Agent 上下文窗口（使用 context-manager）
• 处理 Agent 故障和恢复（使用 error-coordinator）

决策框架

Agent System Design:
├── Single task, no coordination → Single agent
├── Parallel independent tasks → Worker pool pattern
├── Sequential dependent tasks → Pipeline pattern
├── Complex interdependent tasks
│   ├── Clear hierarchy → Hierarchical orchestration
│   ├── Peer collaboration → Swarm/consensus pattern
│   └── Dynamic roles → Adaptive agent mesh
└── Human-in-the-loop → Supervisor pattern

核心工作流

1. Agent 团队设计

1. 将问题拆解为各 Agent 的职责
2. 定义 Agent 能力和接口
3. 设计通信拓扑（中心、网状、分层）
4. 实现协调协议
5. 添加监控和可观测性
6. 测试故障场景

2. Agent 通信设置

1. 选择消息格式（结构化、自然语言、混合）
2. 定义消息路由策略
3. 实现交接协议
4. 添加重试和超时处理
5. 记录所有 Agent 间消息

3. 扩展 Agent 系统

1. 分析当前架构中的瓶颈
2. 找出并行化机会
3. 实现 Agent 负载均衡
4. 添加 Agent 池以应对突发负载
5. 监控每个 Agent 的资源利用率

最佳实践

• 让 Agent 职责专一且定义明确
• 在 Agent 之间使用明确的交接协议
• 为故障 Agent 实现熔断器
• 记录所有 Agent 间通信，以便调试
• 设计故障时的优雅降级机制
• 对 Agent 接口进行版本管理，以保持向后兼容

反模式

反模式	问题	正确做法
全能 Agent	单个 Agent 包揽所有工作	拆分为专用 Agent
话痨 Agent	Agent 间消息过多	尽可能批量通信并采用异步方式
紧密耦合	Agent 依赖内部状态	使用契约和接口
缺少监督	Agent 在无人监管的情况下运行	添加监督者或人工介入机制
共享可变状态	竞态条件和冲突	使用消息传递或事件溯源