用途：使用 agentic-flow 的协调系统编排多智能体集群，支持 mesh、hierarchical、adaptive 拓扑，具备自动任务分发、负载均衡与容错能力，适合需要并行执行和智能协调的规模化任务。
前提条件：agentic-flow v1.5.11+、Node.js 18+，了解分布式系统会有帮助。
快速开始：初始化集群 npx agentic-flow hooks swarm-init --topology mesh --max-agents 5；生成智能体 npx agentic-flow hooks agent-spawn --type coder（tester、reviewer 同理）；编排任务 npx agentic-flow hooks task-orchestrate --task "Build REST API with tests" --mode parallel。
主要能力：三种拓扑模式——mesh 为对等节点、分布式决策、广播通信；hierarchical 为集中协调、queen 加 workers；adaptive 根据任务复杂度自动切换拓扑。任务编排支持并行执行、带依赖的顺序流水线（design→implement→test→review）以及由集群自动决定策略的 autoOrchestrate。集群内存可跨智能体共享状态，如存储与读取 api-schema。高级功能包括动态负载均衡（依据 cpu、memory、task-queue 指标）、容错（重试最多 3 次、指数退避、失败任务重新分配）和性能监控（吞吐量、延迟、成功率、智能体利用率）。还可与 hooks 集成，进行任务前协调、任务后同步和会话恢复。
最佳实践：从 2-3 个智能体开始逐步扩展；通过集群内存共享上下文；监控指标发现瓶颈；启用 hooks 自动协调；设置超时防止任务挂起。
限制与排障：智能体不协调时检查内存访问并启用 hooks；性能不佳时检查拓扑（改用 adaptive）并启用负载均衡。更多文档见 docs/swarm/orchestration.md、docs/swarm/topologies.md、docs/hooks/coordination.md。