RondoFlow

技能简介

RondoFlow 是一个本地优先的开源平台，通过可视化拖拽画布编排 Claude Code 多 Agent 协作工作流。用户在同一界面内定义 Agent 团队、附加 Skill、配置安全策略，然后一键运行并实时观察团队协作过程。所有 Agent 以 Claude Code CLI 子进程形式运行在本地，可真实读写文件、执行命令、调用 MCP 工具——而非仅模拟对话。

核心能力

• 可视化多 Agent 画布：基于 React Flow 构建的拖拽式画布，可自由放置 Agent、Skill、MCP 连接和安全策略节点，连线组成工作流
• 真实 Claude Code 进程：Agent 对应真实的 Claude Code CLI 子进程，具备完整的代码编辑、工具执行和流式输出能力
• AI 导演机制：运行时有 Director（评估每步是否继续/重试）、Planner（启动前调优团队配置）和 Advisor（事后复盘结果）三类特殊 Agent
• 多模型混编：支持在同一工作流中混合使用 Claude Code（本地 CLI）、OpenAI 和 Perplexity Agent
• 本地优先隐私：所有数据在本地处理，仅外发用户配置的模型 API 调用，公司代码不出本地机器
• 三层安全模型：为危险操作（如文件写入、终端命令）配置分级审批策略，防止 Agent 误操作
• Docker 一键部署：docker compose up 即可启动完整环境（含 PostgreSQL、Next.js 前端、Fastify 后端和文档站点）

安装配置

1. 环境要求：Node 22+、Docker Desktop、Claude Code CLI
2. 克隆仓库：git clone https://github.com/rondoflow/rondoflow.git
3. 一键启动：cp .env.example .env && docker compose up（自动启动5个容器）
4. 本地开发模式：npm run setup && npm run dev，需手动启动 PostgreSQL
5. 配置 Agent：在 .env 中填入 OPENAI_API_KEY 等模型凭证

使用步骤

1. 打开画布：浏览器访问 http://localhost:3000，进入可视化编辑器
2. 拖入 Agent 节点：从左侧面板拖入 Director、Planner、Claude Code Agent 等节点到画布
3. 连接节点与配置策略：用连线定义 Agent 间调用关系，双击节点配置 Agent 类型、模型和工具权限
4. 定义安全规则：为危险操作（终端命令、文件写入）配置 Always Allow / Ask / Block 三级策略
5. 运行并观察：点击 Run，右侧面板实时显示每个 Agent 的思考过程和工具调用日志
6. 复盘优化：运行结束后，Advisor Agent 生成复盘报告，可根据建议调整工作流配置

适用场景

• 复杂代码生成任务：需要多个专门化 Agent（如前端、后端、测试）协作完成的中大型功能模块
• 代码审查流程：多个 Agent 从不同角度（安全性、性能、可维护性）并行审查同一 Pull Request
• 自动化测试生成：Planner 生成测试计划，多个 Agent 并行编写单元测试、集成测试和 E2E 测试
• 文档自动生成：从代码库结构和接口定义出发，多 Agent 协作生成 API 文档和架构说明

适用人群

• 使用 Claude Code 的专业开发者，希望编排多 Agent 协作完成复杂任务
• AI 工程团队，构建和测试多 Agent 系统架构
• 研究者，需要可视化观察和调试 Agent 决策过程的从业者

工作原理

RondoFlow 后端为 Fastify + Socket.IO 服务，Claude Code CLI 以子进程形式运行在服务器上。前端 Next.js 通过 WebSocket 实时接收 Agent 输出并渲染到 React Flow 画布。Director Agent 在每步执行后评估当前状态，决定继续、重试或终止；Planner 在工作流启动前分析任务并生成最优 Agent 组合方案。整个架构设计强调本地执行，所有文件读写和命令执行均发生在用户机器上，隐私边界清晰。

GitHub 链接

https://github.com/rondoflow/rondoflow