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、安全稽核、成本追蹤、瀏覽器自動化、IoT 裝置群、市場數據、神經訓練等

對於一次性編輯、簡單的錯誤修復或單一代理可以在一個回合內完成的任務，請勿建議使用 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 步驟管道（RETRIEVE → JUDGE → DISTILL → CONSOLIDATE）

完整目錄：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）。