Swarm Orchestration 是一个面向多智能体协作的编排技能，依托 agentic-flow 的协调系统工作。它允许用户创建由多个智能体组成的群体（swarm），并以不同拓扑结构协同执行任务。
用途 该技能用于在单一智能体能力不足以完成复杂工作时，通过多智能体并行与协调来扩展处理能力。它支持自动任务分发、负载均衡和容错，适用于需要分工协作的任务场景。
主要能力
- 拓扑模式：支持三种拓扑。Mesh（点对点）为平等节点、分布式决策、广播通信；Hierarchical（女王-工作者）为集中协调、专用工作者，由 architect 担任 queen，backend-dev、frontend-dev、db-designer 等担任 workers；Adaptive（动态）会根据任务自动切换拓扑，可按 task-complexity 进行优化。
- 任务编排：支持并行执行（列出多个 agent 与任务，设置 parallel 模式与超时）、流水线执行（按 design→implement→test→review 的阶段顺序，用 after 声明依赖）、自适应执行（由 swarm 自行决定执行策略，可传入 maxTime、maxAgents、quality 等约束）。
- 内存协调：通过共享内存存储与读取状态，例如存储 api-schema 供各智能体读取。
- 高级功能：负载均衡（strategy: dynamic，metrics 可含 cpu、memory、task-queue）、容错（重试 maxAttempts、指数退避 backoff，fallback 为重新分配任务）、性能监控（getMetrics 返回 throughput、latency、success_rate、agent_utilization）。
- 钩子集成：提供 pre-task 协调、post-task 同步与 session-restore 会话恢复。
使用方式 先决条件为 agentic-flow v1.5.11+ 与 Node.js 18+，了解分布式系统会有帮助。快速开始包括：初始化 swarm（swarm-init，指定 topology 与 max-agents）、派生智能体（agent-spawn，可指定 coder、tester、reviewer 等类型）、编排任务（task-orchestrate，传入 task 与 mode）。也可通过代码调用 swarm.init、swarm.execute、swarm.pipeline、swarm.autoOrchestrate、swarm.memory、swarm.enableLoadBalancing、swarm.setResiliency、swarm.getMetrics 等方法。
适用场景 适合需要多个智能体协同完成的任务，例如构建带测试的 REST API、并行实现 API 端点与 UI 组件并编写测试套件、按阶段推进的设计-实现-测试-审查流程，以及构建生产级 API 并设置时间与质量约束的场景。
限制与注意事项 文档未提供价格、收费、平台支持与效果数据。需注意 agentic-flow 版本要求与 Node.js 版本要求。最佳实践建议从小规模开始（2-3 个智能体）再扩展，通过共享内存传递上下文，监控性能指标，启用钩子实现自动协调，并设置超时防止任务挂起。常见问题排查：智能体不协调时检查内存访问并启用钩子；性能不佳时检查拓扑（可改用 adaptive）并启用负载均衡。
更多文档 Swarm 指南：docs/swarm/orchestration.md；拓扑模式：docs/swarm/topologies.md；钩子集成：docs/hooks/coordination.md。