看到 ruvnet/ruflo，新手最容易踩的坑是把 Claude Code 插件路径和全量 CLI 初始化当成一回事。README 里已经把两条路径拆开：插件路径更轻，CLI 路径才会把 MCP、hooks、记忆和代理协作完整接进本地项目。

这个 skill 教程适合想给 Claude Code 或 Codex 加一层 agent harness 的读者。它的价值在于把多代理、记忆、RAG、后台循环和插件体系放到同一套工具层里；限制也很明确，轻量插件不会注册 Ruflo MCP，不能期待 memory_store、swarm_init 这类工具同时可用。

先选轻量插件，还是全量初始化

只想在 Claude Code 里试几个 slash command，可以先走插件路径。它适合低风险试用，因为 README 说明这条线不会往工作区写入 .claude/、.claude-flow/、CLAUDE.md 等文件，也不会安装 hooks。

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo

如果目标是完整 Ruflo loop，就不要停在插件路径。全量 CLI 才会带来代理、命令、skills、MCP server、hooks 和 daemon，适合长期放进自己的工程流。

全量路径先放到测试仓库里跑

macOS、Linux、WSL 或 Git-Bash 可以用一行安装脚本；原生 Windows PowerShell 或 cmd 更稳的是用 npx ruflo@latest init wizard。README 特别提醒，curl ... | bash 需要 POSIX shell，Windows 新手不要在这个点上误判成 Ruflo 安装失败。

curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

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

第一次试跑看三个信号

全量初始化后，先看工作区有没有出现 .claude/、.claude-flow/、CLAUDE.md、settings 或 helpers。再把 MCP 接入 Claude Code：

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

第一次不要直接让它接管复杂重构。让 Claude Code 做一个小任务，比如解释当前仓库结构、补一个测试或列出待办，再观察是否出现代理路由、记忆或后台协作的痕迹。这样能把 Ruflo 自身问题、项目权限问题和模型回答质量分开看。

这些情况先别急着全量接入

如果你只是想体验一个命令，插件路径更省心；如果团队仓库对自动写入配置很敏感，先在临时仓库验证；如果必须使用 swarms、MCP 工具、长期记忆和 hooks，再走 CLI 全量安装。ruvnet/ruflo 很强，但它不是一个无痕小插件，选错入口会让新手排查方向一开始就偏掉。