SwarmSDK, SwarmCLI 与 SwarmMemory

这是一个用于将多个 AI Agent 编排为协作团队，并具备持久化记忆的 Ruby 框架。

SwarmSDK 是对 Claude Swarm 的彻底重构，提供了更好的开发者体验，并针对通用 Agent 系统进行了优化。

✨ 核心特性

• 🚀 解耦 Claude Code：不再依赖 Claude Code。
• ⚡ 单进程架构：所有 Agent 使用 RubyLLM 在同一个 Ruby 进程中运行，无需管理多个进程。
• 🎯 更高效：直接使用方法调用，而非 MCP 进程间通信。
• 🔧 功能更丰富：支持节点工作流 (Node workflows)、钩子系统 (hooks system)、草稿/记忆工具等。
• 🎮 更佳的控制力：细粒度的权限控制、成本追踪、结构化日志。
• 💻 交互式 REPL：基于 TTY 工具包构建，提供极佳的命令行体验。
• 🌐 多 LLM 提供商支持：支持 RubyLLM 所支持的所有 LLM 提供商（Claude、OpenAI、Gemini 等）。
• 🧠 SwarmMemory：具备语义搜索和 FAISS 索引的持久化 Agent 知识存储。
• 🔌 插件系统：可扩展的架构，方便进行自定义集成。

---

🚀 快速开始

安装

gem install swarm_cli     # 包含 swarm_sdk
swarm --help              # 探索现代化的 CLI

你的第一个 Swarm

创建一个简单的 Swarm 配置文件 my_swarm.yml：

version: 2
agents:
  lead:
    model: claude-3-5-sonnet-20241022
    role: "Lead developer coordinating development efforts"
    tools:
      - Read
      - Write
      - Edit
      - Bash
    delegates_to:
      - frontend
      - backend

  frontend:
    model: claude-3-5-sonnet-20241022
    role: "Frontend specialist handling UI and user experience"
    tools: [Read, Write, Edit]

  backend:
    model: claude-3-5-sonnet-20241022
    role: "Backend developer managing APIs and data layer"
    tools: [Read, Write, Edit, Bash]

运行它：

# 交互式 REPL 模式
swarm run my_swarm.yml

# 或者使用特定提示词
swarm run my_swarm.yml -p "Build a simple TODO app with React and Node.js"

---

📚 文档

完整文档请查阅 docs/v2 目录。

入门指南

• SwarmSDK 入门 ⭐ 学习基础知识：安装、核心概念、创建你的第一个 Swarm（YAML 与 Ruby DSL）

• SwarmCLI 入门 ⭐ 命令行界面：交互式 REPL 和自动化模式

综合教程

• SwarmSDK 完整教程 涵盖所有功能的深度指南：
  • 第 1 部分：基础（Agent、模型、工具）
  • 第 2 部分：工具与权限（全部 11 种工具，路径/命令权限）
  • 第 3 部分：Agent 协作（委托模式）
  • 第 4 部分：钩子系统（全部 12 个事件，6 种动作）
  • 第 5 部分：节点工作流（多阶段管道、转换器）
  • 第 6 部分：高级配置（MCP、提供商、上下文管理）
  • 第 7 部分：生产环境特性（日志记录、成本追踪、错误处理）
  • 第 8 部分：最佳实践（架构、测试、优化）

参考文档

• 架构流程图 - 完整的系统架构
• 执行流程图 - 运行时执行历程（21 个详细步骤）
• CLI 参考 - 完整的命令行参考
• Ruby DSL 参考 - 完整的编程 API
• YAML 配置参考 - 完整的 YAML 结构

集成指南

• SwarmMemory 指南 - 带有语义搜索的 Agent 持久化知识库
• 插件系统指南 - 为 SwarmSDK 构建扩展
• 记忆适配器开发 - 自定义存储后端
• Rails 集成指南 - 与 Ruby on Rails 集成

---

💡 核心概念

SwarmSDK

一个用于编排多个 AI Agent 团队协作的 Ruby 框架。每个 Agent 都具备：

• 角色 (Role)：专业领域（后端开发者、代码审查员等）。
• 工具 (Tools)：功能能力（读取文件、写入文件、运行 Bash 命令等）。
• 委托 (Delegation)：将子任务委托给其他 Agent 的能力。
• 钩子 (Hooks)：在执行关键点运行的自定义逻辑。

SwarmCLI

（内容待补充）