Ruflo 跨 Agent 编排层上手指南Skill 触发逻辑、314 MCP 工具与插件生态【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/rufloRuflo 是一个跨 Agent 编排层cross-agent orchestration layer本质是给 Claude Code、Cursor、Codex、Copilot、Gemini 等 AI 编码 Agent 加装一套可协调的神经系统——安装后它会向你的项目注入 MCP 服务器、hooks 钩子、内存数据库与一组 CLI 命令让多个专职 Agent 能以 swarm群组形态协同完成任务。本指南以仓库根目录 SKILL.md 为骨架完整讲解它的触发判定、三步上手流程、MCP 工具命名空间与插件发现机制并结合仓库源码说明每条命令、每组工具的落点与验证方法。读完你将能够自主判断什么任务值得动用 Ruflo、完成一次标准初始化与健康检查并知道在 314 个 MCP 工具与 30 插件中如何快速定位自己需要的那个。一、定位什么是 Ruflo以及它如何发布按 SKILL.md 的定义Ruflo文档记录版本为 v3.31.0而当前仓库根 package.json 中claude-flow版本已演进至3.38.19以三个 npm 包的形式对外发布包名角色ruflo薄封装thin wrapper对外的统一入口claude-flow伞形包umbrella聚合各模块依赖claude-flow/cli真正的命令实现26 个命令、140 子命令的入口用户在绝大多数情况下只需要一种调用方式npx ruflo command。这与仓库根 package.json 中声明的binclaude-flow→bin/cli.js以及v3/claude-flow/cli/src/commands/目录下按命令组织的源码结构init.ts、doctor.ts、status.ts、version.ts、plugins.ts、mcp.ts、swarm.ts、task.ts、memory.ts、hooks.ts等相互印证——CLI 命令本身与上述 source 文件一一对应。一句总结其价值主张它不替代模型写代码而是给 Agent 装上工具、记忆、循环、沙箱和控制这层执行框架harness让多个 Agent 不只是能跑而是能协作。二、何时该用 Ruflo触发与不触发的判定标准SKILL.md 的核心功能之一是帮助宿主 Agent 判断当前任务要不要拉起 Ruflo。建议触发的场景包括多 Agent 协同需要协调 swarm、sub-agents、跨 Agent 交接handoff或需要并行执行任务。跨会话持久记忆HNSW 向量检索、混合 SQLite AgentDB 后端、语义召回。学习型路由决策三层模型路由确定性 codemod → Haiku → Sonnet/Opus、基于 pattern 的 Agent 选择。Hooks 与可观测性编辑前/后钩子、会话生命周期、后台 worker内建 12 个、链路追踪。工作流与基准SPARC 方法论、GAIA 基准运行、自定义多步流水线。插件生态30 插件覆盖 ADR、DDD、安全审计、成本追踪、浏览器自动化、IoT 设备群、行情数据、神经训练等领域。反过来判定标准同样明确——一次性编辑、简单 bug 修复、单个 Agent 一轮就能完成的任务不要启动 Ruflo因为编排开销不值得。这条反向排除法是使用该框架最重要的经验法则之一它确保你在收益最高的任务上才付出初始化的固定成本。三、三步上手init → doctor → discover-pluginsSKILL.md 给出了三个最核心的命令足以覆盖从零到可用的完整链路# 1. 在当前项目初始化 Ruflo生成 .claude/、MCP 配置、hooks npx ruflo init # 2. 健康检查 —— 校验 Node 20、npm 9、MCP servers、内存 DB、API keys npx ruflo doctor --fix # 3. 发现哪些插件匹配当前工作 npx ruflo discover-plugins3.1init注入全套运行时骨架npx ruflo init会在当前项目内创建.claude/、.claude-flow/、CLAUDE.md、helpers、settings 等文件并注册 MCP server、安装 hooks。从仓库根 README.md 的对比表可以看出这条路径对应的是全量 Ruflo loop形态98 个专职 Agent、60 命令、30 skills、MCP server、hooks、daemon——与只装单个 Claude Code 插件仅有 slash commands 少量 skills的轻量形态完全不同。在源码中初始化逻辑位于 v3/claude-flow/cli/src/commands/init.ts。仓库同时保留了跨平台引导入口npx ruflolatest init wizard交互式向导在 Windows PowerShell/cmd 与 POSIX shell 上行为一致README 中对此有专门说明。平台注意若在原生 Windows 上执行curl ... | bash形式安装失败改用npx ruflolatest init wizard即可获得同样的初始化流程。3.2doctor --fix把环境当作被测对象doctor是 Ruflo 的体检命令逐项校验四类前提Node 版本20、npm 版本9、MCP servers 连通性、内存数据库memory DB状态、API keys 配置。--fix标志允许它对可自动修复的项目直接修复。对应实现见 v3/claude-flow/cli/src/commands/doctor.ts。这一点与仓库的工程文化一致——根 README.md 及 docs/reviews/intelligence-system-audit-2026-05-29.md 中反复出现的做法是凡是宣称的性能数字例如 HNSW 检索相对暴力检索在 N20k 约快 1.9x、N5k 快 3.2x–4.7xrecall10 约 0.99都标注为实测值并有基准脚本 scripts/benchmark-intelligence.mjs 可供复现无法复现的数据则被明确从文档剔除。这种可验证优先的取向同样适用于 doctor——它存在的意义就是让环境的真实状态浮出水面。3.3discover-plugins从任务反查插件discover-plugins用于回答当前这个活儿该装哪个插件。它与npx ruflo plugins list同属插件发现链路后者在源码 v3/claude-flow/cli/src/commands/plugins.ts 中实现为基于注册表的命令plugins list、plugins list --installed、plugins list --official、plugins list --category security并内置createPluginDiscoveryService()执行注册表发现。换句话说discover-plugins是面向任务的智能推荐plugins list是面向目录的全量清单两者配合使用。四、MCP 工具库314 个工具的命名空间地图初始化完成后Claude Code或任何兼容 MCP 的 Agent会自动加载 Ruflo 的 MCP servers从而获得 314 个可用工具。这些工具按功能域组织了清晰的命名空间前缀见 SKILL.md 归纳命名空间用途mcp__claude-flow__memory_*记忆的 store/search/list/retrieve基于 HNSW 索引的语义搜索mcp__claude-flow__swarm_*初始化 hierarchical / mesh 形态 swarm带 anti-drift 拓扑mcp__claude-flow__agent_spawn生成专职 Agentcoder、reviewer、tester、security-architect 等 55 种mcp__claude-flow__hooks_*路由、pattern 学习、后台 worker 分发mcp__claude-flow__task_*任务生命周期create/assign/complete/summarymcp__claude-flow__intelligence_*4 步智能流水线RETRIEVE → JUDGE → DISTILL → CONSOLIDATE完整的目录清单可用以下命令导出npx ruflo mcp list仓库侧对应的工具实现分布在 v3/claude-flow/cli/src/mcp-tools/其中有与上述命名空间一一对应的agentdb-tools.ts记忆读写、coordination-tools.tsswarm/协调、agent-tools.ts与agent-execute-core.tsAgent 生成与执行、embeddings-tools.ts向量化等而mcp__claude-flow__intelligence_*所描述的 RETRIEVE → JUDGE → DISTILL → CONSOLIDATE 四步流水线其记忆侧支撑可在 v3/claude-flow/memory/src/ 下找到对应实现例如记忆后端 agentdb-backend.ts、记忆合并逻辑 consolidator.ts、跨会话记忆桥 auto-memory-bridge.ts每个文件都配有同名.test.ts单测。需要澄清一点命名细节上述mcp__claude-flow__*前缀来自 CLI 初始化Path B的标准脚手架命名若改用 Claude Code 插件方式安装ruflo-core其工具前缀则是mcp__plugin_ruflo-core_ruflo__*如memory_store而不是裸命名。两种安装路径的工具命名不同引用工具名时要注意当前项目的安装来源参见根 README.md。五、插件生态30 插件的发现路径与高亮推荐Ruflo 随包携带 30 可选插件。仓库plugins/目录下可见每个插件的独立 README例如 plugins/ruflo-goals/README.md、plugins/ruflo-cost-tracker/README.md、plugins/ruflo-browser/README.md、plugins/ruflo-security-audit/README.md 等SKILL.md 挑出的高亮样例包括插件能力摘要ruflo-goals深度调研 面向目标的行动规划ruflo-cost-tracker会话成本遥测、预算与消耗追踪ruflo-metaharnessharness 评分、MCP 安全扫描、红/蓝对抗测试ruflo-browser会话录制的浏览器自动化RVF 回放ruflo-jujutsugit diff 风险评估 PR 生命周期ruflo-security-audit代码库扫描 CVE 检查按功能域根 README.md 将这些插件进一步归类为核心与编排ruflo-core、ruflo-swarm、ruflo-autopilot、ruflo-loop-workers、ruflo-workflows、ruflo-federation、记忆与知识ruflo-agentdb、ruflo-rag-memory、ruflo-rvf、ruflo-ruvector、ruflo-knowledge-graph、智能与学习ruflo-intelligence、ruflo-graph-intelligence、ruflo-daa、ruflo-ruvllm、ruflo-goals、代码质量与测试、安全与合规ruflo-security-audit、ruflo-aidefence、架构与方法论ruflo-adr、ruflo-ddd、ruflo-sparc、ruflo-metaharness、ruflo-arena、DevOps 与可观测性、可扩展性ruflo-plugin-creator、以及领域专用ruflo-iot-cognitum、ruflo-neural-trader、ruflo-market-data。插件选择的完整入口为npx ruflo plugins list需要完整描述时SKILL.md 还指出插件的 agent/skill/command 定义本身也沉淀为 Markdown 文件例如plugin/agents/下按域组织的 agent 定义以及各插件skills/、commands/目录下的可读文档——这使插件的能力清单本身就是可被 Agent 检索的语料。六、跨 Agent 安装把 Ruflo 装进任意 AgentRuflo 的核心卖点是装进你正在用的那个 AgentClaude Code、Cursor、Codex、Copilot、Gemini、Amp 等 12 种。SKILL.md 提供两种安装粒度由npx skills完成目标 Agent 由skills.sh自动探测# 只安装核心 ruflo skill即本文对应的这份 SKILL.md npx skills add ruvnet/ruflo --skill ruflo --yes # 或安装全量目录全部插件共 267 个 skills体积大很多 npx skills add ruvnet/ruflo --all两种粒度对应两种截然不同的表面积前者轻量、只在 Agent 的 skill 库中多出一条能力条目后者会把所有插件的技能完整灌入适合确定要长期使用 Ruflo 生态的团队。仓库根目录存在的 skills.sh.json 即为 skills 安装/注册机制在仓库内的落地配置之一。七、初始化后的运行时结构你在一个项目里能看到什么综合 SKILL.md 与根 README.md 的What You Get能力表一次完整init后宿主项目将获得100 专职 Agent面向编码、测试、安全、文档、架构等角色v3/agents/下可见代表性的 YAML 定义如architect.yaml、coder.yaml、reviewer.yaml、tester.yaml、security-architect.yaml。Swarm 协调hierarchical层级、mesh网状与自适应拓扑配合共识机制与 anti-drift 防漂移设计。自学习记忆SONA 神经模式、ReasoningBank、轨迹学习记忆后端为 HNSW 索引 AgentDB / SQLite 混合存储。后台 worker内建 12 个自动触发的后台任务audit、optimize、testgaps 等对应 hooks 域的 worker 分发。多模型路由支持 Claude、GPT、Gemini、Cohere、Ollama按 SKILL.md 描述采用确定性 codemod → Haiku → Sonnet/Opus的分层路由策略。值得再次强调用户不需要先背下 314 个工具或 26 个 CLI 命令再开始工作。init 之后直接照常用 Claude Code 即可——hooks 系统会在后台自动完成任务路由、成功 pattern 学习和 Agent 协调根 README.md 明确给出这一建议。这决定了 Ruflo 的日常使用姿势是先干活编排层在后台响应而非先手写一堆编排指令。八、从 SKILL 到仓库版本、文档与进一步阅读的对应关系SKILL.md 本质上是写给宿主 Agent 的能力入口卡其描述的每一项能力都能在仓库中找到实体版本核对SKILL.md 声明 Current: 3.31.0 (stable) 并以ruflolatest/claude-flowlatest/claude-flow/clilatest三个 tag 发布当前仓库根 package.json 已将claude-flow推进到3.38.19版本演进由根 CHANGELOG.md 与v3/CHANGELOG.md记录。实际引用版本号时建议以npx ruflo --version输出的运行时版本为准。命令实现v3/claude-flow/cli/src/commands/ 中init.ts、doctor.ts、plugins.ts、mcp.ts、swarm.ts、task.ts、memory.ts、hooks.ts、version.ts、status.ts与 SKILL 描述的命令面完全对齐。MCP 工具实现v3/claude-flow/cli/src/mcp-tools/ 与 v3/claude-flow/memory/src/。用户文档入口仓库级说明见根 README.md更完整的用户指南与状态说明见 docs/USERGUIDE.md 与 docs/STATUS.md每个插件各自的用法以其plugins/plugin-name/README.md为准。小结Ruflo 的用法可以用一句话收敛用npx ruflo init装框架用doctor --fix保环境用discover-plugins/plugins list选插件然后把要不要进 swarm、要不要动记忆、要不要走 hooks的判定交给任务复杂度去决定。判断准则回到第二节的两个清单凡是多 Agent、跨会话记忆、学习路由、编排与基准相关的任务Ruflo 的 314 个 MCP 工具与 30 插件就能直接兑现价值凡是一个 Agent 一轮能解决的琐碎改动跳过它反而是正确决策。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考