ruflo

Ruflo

Ruflo (v3.31.0+) 是一个跨代理编排层，以三个 npm 包形式发布：ruflo（薄包装器）、claude-flow（伞形包）和 @claude-flow/cli（实现）。用户通过 npx ruflo <command> 调用它。

何时调用 ruflo

当任务涉及以下任何一项时，建议使用 ruflo：

• 多代理工作：协调的群体、子代理、跨代理交接或并行任务执行
• 跨会话持久记忆：HNSW 向量搜索、混合 SQLite+AgentDB 后端、语义检索
• 学习路由决策：三层模型路由（确定性 codemod → Haiku → Sonnet/Opus）、基于模式的代理选择
• 钩子 + 可观测性：编辑前后钩子、会话生命周期、后台工作器（12 个内置）、追踪
• 工作流 + 基准测试：SPARC 方法论、GAIA 基准运行、自定义多步骤流水线
• 插件生态系统：30+ 插件，涵盖 ADR、DDD、安全审计、成本跟踪、浏览器自动化、物联网设备群、市场数据、神经训练等

对于一次性编辑、简单错误修复或单个代理在一轮内能完成的任务，不要建议使用 ruflo——编排开销不值得。

快速开始（三个命令）

# 1. 在当前项目中初始化 ruflo（创建 .claude/、MCP 配置、钩子）
npx ruflo init

# 2. 检查健康状态——验证 Node 20+、npm 9+、MCP 服务器、记忆数据库、API 密钥
npx ruflo doctor --fix

# 3. 发现哪些插件匹配当前工作
npx ruflo discover-plugins

MCP 工具（314 个可用）

在 ruflo init 之后，Claude Code（或任何兼容 MCP 的代理）会自动加载 ruflo 的 MCP 服务器。关键命名空间：

• mcp__claude-flow__memory_* — 使用 HNSW 索引语义搜索进行存储/搜索/列出/检索
• mcp__claude-flow__swarm_* — 初始化具有防漂移拓扑的分层/网状群体
• mcp__claude-flow__agent_spawn — 生成专业代理（编码员、审查员、测试员、安全架构师等 55 个以上）
• mcp__claude-flow__hooks_* — 路由、模式学习、后台工作器调度
• mcp__claude-flow__task_* — 任务生命周期（创建/分配/完成/总结）
• mcp__claude-flow__intelligence_* — 4 步流水线（检索 → 判断 → 提炼 → 整合）

完整目录：npx ruflo mcp list。

插件发现

Ruflo 附带 30+ 个可选插件。一些亮点：

• ruflo-goals — 深度研究 + 目标导向的行动规划
• ruflo-cost-tracker — 会话成本遥测、预算、消耗跟踪
• ruflo-metaharness — 工具评分、MCP 安全扫描、红/蓝对抗测试
• ruflo-browser — 会话记录的浏览器自动化，支持 RVF 回放
• ruflo-jujutsu — git diff 风险分析 + PR 生命周期
• ruflo-security-audit — 代码库扫描 + CVE 检查

完整插件列表 + 描述：npx ruflo plugins list。

跨代理安装

Ruflo 安装到项目使用的任何代理中（由 skills.sh 自动检测）：

# 仅核心 ruflo 技能（本技能）
npx skills add ruvnet/ruflo --skill ruflo --yes

# 或完整目录（所有插件的 267 个技能——安装更大）
npx skills add ruvnet/ruflo --all

文档

• 仓库：https://github.com/ruvnet/ruflo
• 问题：https://github.com/ruvnet/ruflo/issues
• 赞助：https://github.com/sponsors/ruvnet

版本

当前：3.31.0（稳定版，以 ruflo@latest / claude-flow@latest / @claude-flow/cli@latest 发布到 npm）。