joelhooks/swarm-tools

解决的问题

Swarm 解决了在使用 AI 代理处理大型复杂任务时出现的「上下文死亡」和协调开销问题。它防止代理在编辑文件时相互冲突，并确保进度、任务追踪和学习到的模式在不同会话间得以保留。

工作原理

Swarm 使用协调器将大型任务分解为更小的、可并行处理的子任务。随后，它利用多个核心系统来管理工作流：

• Hive： 一个基于 Git 的任务追踪器，将任务存储在 .hive/ 目录中，确保进度在会话重启后依然存在，并可在不同环境中同步。
• Hivemind： 使用 Ollama 嵌入的语义记忆系统，用于存储和检索以往任务中的学习成果和模式。
• Swarm Mail： 一种基于 Actor 模型的协调系统，负责代理间消息传递，并实现文件预留（锁）机制，防止多个代理同时编辑同一文件。
• 事件溯源： 所有状态变更均通过 libSQL（嵌入式 SQLite）记录在仅追加的事件日志中，确保每一步操作都有持久化记录。

适用人群

使用 OpenCode 或 Claude Code 等 AI 编码助手的开发者，需要从单次提示任务扩展到需要持久化和协调的复杂多代理工作流。

核心亮点

• 并行执行： 启动多个工作代理，同时处理子任务。
• 持久化记忆： 使用语义记忆系统记录成功模式并识别反模式。
• Poirot 风格协调： 实现文件锁定，避免代理间产生合并冲突。
• 本地优先架构： 完全本地运行，无需外部服务器，使用 Bun、libSQL 和 Ollama。