Skills Atlas · ruvnet / ruflo

Repo Deep-Dive · ruvnet / ruflo

Skills Atlas — Repo 使用說明書把 100+ 代理編進
Claude Code 的編排層。
跨機器、自學習、零信任。

Ruflo 把單機的 Claude Code 升級成跨機器、跨信任邊界的多代理編排平台 — 100+ 專家代理、SONA 自學習神經模式、HNSW 向量記憶、聯邦通訊與 AIDefence 安全層全部整合。它是 Cognitum.One 的 Rust 引擎在 Claude Code 上的開源開發者體驗，從 plugin marketplace 一鍵安裝，到 mTLS 跨機器協同，全在 MIT 授權下開放。

代理規模

100+ Agents

涵蓋 coding、testing、security、docs、architecture 全棧分工。

向量檢索

150–12,500×

HNSW-indexed AgentDB 子毫秒級記憶查詢，較線性掃描的加速倍率。

外掛模組

32 + 21

32 個原生 Claude Code plugins 加 21 個 npm 套件，跨測試／文件／DevOps／安全。

授權

MIT

RuvNet 維護，底層為 Cognitum.One 的 Rust AI 引擎。

01 / 編者手記 FROM THE EDITOR · APRIL 2026

把 Claude Code 推進編排平台的 RuvNet 答卷。

編者手記 EDITOR'S NOTE

Ruflo 不是另一組 prompt 集，它是 Claude Code 的編排層 — 把 100+ 代理、向量記憶、聯邦通訊、AIDefence 安全層當作完整堆疊發布。如果說 Anthropic 的 Skills 是 SDK，Ruflo 就是它上面的 Kubernetes。

不再是單機 Claude Code。

Ruflo 把代理協同推到跨機器、跨信任邊界。同一份 swarm 描述可以跑在筆電、雲端、客戶 VPC，靠 mTLS 與零信任協議互通。對需要把開發外包但又不能讓對方碰到完整原始碼的團隊，這是少見的可工程化路徑。

記憶從「上下文視窗」變成「向量資料庫」。

內建 AgentDB + HNSW 索引，把跨任務的軌跡、決策、修正全部結構化儲存；SONA 神經模式持續從這些軌跡學習，下次遇到相似情境直接以 ReasoningBank 重放。記憶不再是每次重啟就消失的便條紙。

多模型路由 + AIDefence，企業級先決條件。

Claude / GPT / Gemini / Cohere / Ollama 通通可路由，依任務難度與成本切換。AIDefence 同時做輸入驗證、CVE 修補、路徑遍歷防護，把 LLM 上線真正缺的合規與供應鏈安全補齊。

02 / 核心能力 SWARM · MEMORY · FEDERATION · SECURITY · ROUTING

編排平台的五根支柱

100+ 代理、向量記憶、聯邦通訊、AI 安全、多模型路由 — Ruflo 把這五件事做成可以整合進 Claude Code 的單一堆疊。

5 Capabilities
Swarm · Memory · Federation
Production-grade

01^/05

ruvnet / ruflo › 100+ Specialized Agents

100+ 代理 +三種 Swarm 拓樸

Hierarchical · Mesh · Adaptive，附共識機制

專家代理橫跨 coding、testing、security、documentation、architecture，可以用階層式（總指揮 → 中階 → 工兵）、網狀（全員可達）、或適應式（依任務動態切換）三種拓樸組合。內建共識機制讓 swarm 在分歧時可投票或裁決，而不是各跑各的。另附 12 個常駐 Background Workers，自動觸發稽核、最佳化、測試。

✓ 三種拓樸可切換 100+ 代理 12 背景工人共識機制

Topologies 3 Agents 100+ Workers 12

AgentDB · HNSW Vector Memory

向量記憶子毫秒檢索

對線性掃描 150–12,500× 加速

HNSW-indexed AgentDB 提供持續性向量記憶，把每次任務的軌跡與決策存成可重放紀錄。配合 ruflo-rag-memory 與 ruflo-knowledge-graph 模組，可建跨專案的私有知識圖譜，下次接案時直接命中相關脈絡。

HNSW 索引持久化知識圖譜

Index HNSW Latency Sub-ms

Agent Federation · mTLS Zero-Trust

跨機器、跨信任邊界協同

同一個 swarm 可同時跨筆電、雲端、客戶 VPC

ruflo-federation 模組以 mTLS 為底層，定義「能讀什麼資料、能呼叫哪些工具、能寫到哪裡」三層權限。對需要把開發外包但又怕讓對方碰到全部原始碼的團隊，這是少見的可工程化路徑。

mTLS 零信任跨 VPC

Protocol mTLS Trust Zero-Trust

SONA + ReasoningBank · Self-Learning

SONA 神經模式 +軌跡學習

代理會自我優化、可動態 replanning

SONA 持續從 ReasoningBank 軌跡中學習；當執行偏離預期，adaptive replanning 會即時改寫剩餘步驟而不是整單失敗。對長任務（如全棧重構、資料遷移）特別有用，避免一錯到底。

軌跡重放動態 replanning SONA

Learner SONA Buffer ReasoningBank

AIDefence + Multi-Provider Routing

合規、CVE 修補、多模型路由

Claude / GPT / Gemini / Cohere / Ollama 通通可路由

AIDefence 同時做輸入驗證、CVE 修補、路徑遍歷防護；多模型路由則依任務難度與成本切換 Claude、GPT、Gemini、Cohere、Ollama。讓你可以一邊上線一邊保留模型供應鏈彈性，不被單一供應商綁死。

AIDefence 多模型 CVE 修補

Models 5+ Defense Built-in

03 / 安裝與設定 PLUGIN · CLI · MCP · NPM ECOSYSTEM

從 plugin marketplace五分鐘到全 CLI

三種安裝路徑：Claude Code plugin（最輕）、CLI wizard（最完整）、MCP server（純 LLM 編排）。再加 32 個原生 plugin 與 21 個 npm 套件按需擴充。

4 Channels
Plugin · CLI · MCP · npm
Lite → Full

01^/04

/plugin marketplace add ruvnet/ruflo

Lite 模式：Claude Code plugin 一鍵裝

marketplace add → install ruflo-core → install ruflo-swarm

在 Claude Code 內鍵入 /plugin marketplace add ruvnet/ruflo，再 /plugin install ruflo-core@ruflo 與 /plugin install ruflo-swarm@ruflo。不需要 npm，不需要 Rust toolchain — 只裝核心編排與 swarm，最適合用 Claude Code 為主的工程師快速驗證。

✓ 推薦起手式 Plugin 安裝無需 npm ~5 分鐘

Mode Lite Steps 3 Commands Surface Claude Code

npx ruflo@latest init wizard

Full CLI：init wizard 引導全棧

npx ruflo@latest init wizard · 或 npm install -g ruflo@latest

完整 CLI 模式可使用 swarm 編排、autopilot、聯邦、AgentDB 持久化所有功能。init wizard 會問你拓樸、模型路由、儲存後端，再產出 ruflo.config 與 .env 模板。

完整功能 init wizard npm 全域

Mode Full Channel npm / npx

claude mcp add ruflo -- npx ruflo@latest mcp start

MCP 模式：把 Ruflo 變成外部能力

讓任何支援 MCP 的 LLM 客戶端都能呼叫

claude mcp add ruflo -- npx ruflo@latest mcp start 把 Ruflo 註冊成 MCP server。Cursor、Cline、Antigravity 等支援 MCP 的客戶端都能直接呼叫 swarm 編排與 AgentDB 記憶，不必綁定 Claude Code。

MCP server 客戶端通用外部觸發

Protocol MCP Clients Any MCP

32 Native Plugins + 21 npm Packages

按需擴充：從testgen 到 jujutsu

記憶 / 知識圖譜 / 觀測 / 成本追蹤 / 安全稽核任選

32 個原生 plugin 與 21 個 npm 套件可組合：核心是 ruflo-core/swarm/autopilot/workflows/federation；記憶層是 ruflo-agentdb / rag-memory / ruvector / knowledge-graph / intelligence；測試與品質含 ruflo-testgen / browser / jujutsu / docs；維運面是 ruflo-migrations / observability / cost-tracker / security-audit。

32 plugins 21 npm 套件模組化擴充

Plugins 32 npm 21

04 / 實戰應用 FLO.RUV.IO · GOAL.RUV.IO · GOAP · FEDERATION

RuvNet 自家先驗證的五個場景

flo.ruv.io 與 goal.ruv.io 是 Ruflo 在 production 上的兩個前線實驗；再加大規模重構、跨機器外包、合規上線三個典型企業情境。

5 Scenarios
Web · GOAP · Refactor · Federation · Compliance
Production

01^/05

flo.ruv.io · 多模型聊天 + 持久記憶

把 Ruflo 變成日常 AI 入口

六個前沿模型 · MCP 平行工具呼叫 · AgentDB 記憶

flo.ruv.io 是 RuvNet 自家把 Ruflo 跑成消費者 UI 的範例：同一個對話可平行調用多個 MCP 工具、跨 session 由 AgentDB 持久記憶。對企業團隊而言，這是直接可 fork 的 Internal AI Portal 雛型 — 顧問、PM、設計師都能用同一張記憶表持續協作。

✓ 官方範例六個模型平行 MCP 記憶持久

Surface Web Models 6 Memory AgentDB

goal.ruv.io · GOAP 規劃 UI

A* 狀態空間搜尋的代理規劃

Goal-Oriented Action Planning · 即時代理 dashboard

把長任務變成遊戲 AI 用的 GOAP 圖：定義目標、可執行動作、前置條件，A* 自動找最短路徑並指派給代理。goal.ruv.io/agents 提供即時 telemetry 與工作分配視覺化，讓 PM 第一次能像看 production dashboard 一樣監控 AI swarm。

GOAP A* 搜尋即時 telemetry

Planner GOAP / A* UI Live Dashboard

大規模重構 · Adaptive Topology

monorepo 重構的數十代理協同

Adaptive 拓樸 + ReasoningBank 軌跡學習

把一個跨 1,000 檔案的重構切片給 swarm，每個代理拿到一塊；當任一代理偏離（型別錯、測試壞），adaptive replanning 會即時改寫剩餘步驟，不必整單失敗重來。ruflo-testgen 與 ruflo-jujutsu 同步守住測試覆蓋與 commit 歷史。

Monorepo 動態 replanning Jujutsu 整合

Topology Adaptive Scale 1,000+ files

外包與夥伴協作 · Federation

把開發外包，但不交出原始碼

mTLS 跨 VPC · 三層權限隔離

外包工作室或客戶的 swarm 可透過 ruflo-federation 接入你內部的 swarm，但只能看到你授權的 repo 子集、只能呼叫白名單工具、產出寫到 isolated branch。對需要把部分模組外包但合規不允許全代碼交付的團隊（金融、醫療、政府），這是少見的可工程化路徑。

VPC 跨界三層隔離白名單工具

Trust Zero-Trust Boundary Cross-VPC

合規上線 · AIDefence + 觀測

把 AI swarm 接進SOC2 / HIPAA 流程

AIDefence + Observability + Cost-Tracker

AIDefence 處理輸入驗證、CVE 修補、路徑遍歷防護；ruflo-observability 把 swarm 的呼叫鏈推到既有 OpenTelemetry / Datadog；ruflo-cost-tracker 把每個任務的模型成本攤到專案。對需要交合規報告的部門，這三個 plugin 把「AI 上線缺的那塊」直接補齊。

AIDefence OpenTelemetry 成本歸戶

Compliance Audit-Ready Telemetry OTel

想把 Ruflo 接進你的工程組織？

Ruflo 已經開源。
接上合規與多機器這一段，
是 Tenten 在做的事。

Tenten 是 AI-First 設計與技術顧問公司。從 Ruflo 的 swarm 編排、AgentDB 記憶層、聯邦通訊，到 OpenTelemetry / SIEM / SOC2 的合規對齊 — 我們把這份倉庫裡每一個 plugin，部署成你正式可上線、可審計、可外包協作的工程基底。

預約 30 分鐘諮詢 → Tenten Awesome List

Tenten 如何協助你導入 Ruflo

Swarm 架構規劃

依工作流選拓樸（Hier / Mesh / Adaptive），定義代理分工與 MCP 工具集。

AgentDB 記憶層

把企業既有文件、Wiki、CRM 資料導入向量記憶，讓 swarm 直接命中脈絡。

Federation 跨組織協作

把合作夥伴 swarm 接進你的 VPC，配 mTLS 與三層權限做合規外包。