Ruflo 是一个“仓库操作型”技能，用于对 ruvnet/ruflo 仓库和 Ruflo CLI 进行有源码依据、需审批的操作。它的核心原则是：先离线检查、先展示将要发生的变更、获得明确批准后再执行，并且只在必要时读取或写入与 Ruflo 相关的路径。
用途 该技能适用于以下场景：在不调用上游程序的情况下确认当前安装了什么；检查一个固定提交的 Ruflo 源码检出；预览初始化会生成哪些路径与组件；为 swarm 或 hive 运行记录拓扑与共识策略；注册 MCP 时避免覆盖现有条目；只读查看内存/状态；以及仅清理 Ruflo 自有产物。资料还说明，其他职责应分别路由到 paperclip（规划与工件）、agent-manager（本地 tmux 进程/会话）、zeroshot（图式 provider-CLI 运行与验证）、ooo（歧义消减与不可变规格循环）、harness2（递归 agent-harness 优化）。
主要能力
- 离线预检：在仓库根目录运行 python3 .agent-skills/ruflo/scripts/preflight.py --json，或在已安装技能根目录运行 python3 "$SKILLS_ROOT/ruflo/scripts/preflight.py" --json，--help 可列出选项。该脚本只发现工具并检查显式提供的检出目录，不会调用上游可执行文件。
- 源码审计：使用 --repo PATH --expect-commit a00b2855e5b8204aec61133d5fbc53060e1726b5，确认 Git 根、提交与公开标记后再使用参考中的命令。
- 只读发现：可用 ruflo --help、ruflo --version 或等价包元数据了解情况，但不能据此推断运行时已就绪，预检期间不要运行 npx ruflo 或 claude-flow init。
- 初始化预览与审批：init 前必须展示确切目标路径与生成组件；init 可能创建 .claude/ 目录、.claude/settings.json 钩子与权限、.mcp.json、helpers、skills、commands、agents、运行时配置、statusline 数据、.swarm/memory.db 和 CLAUDE.md，未经明确批准不得覆盖现有配置。
- 拓扑与共识规划：swarm 支持 hierarchical、mesh、ring、star、hybrid、hierarchical-mesh、pheromone-adaptive；hive-mind 还提供 adaptive 与 consensus 选项，包括 byzantine、raft、gossip、crdt、quorum。启动代理、开启服务器、开放端口、使用凭据或远程 provider 前必须审批。
- MCP 注册：作为独立审批环节，先检查现有 .mcp.json、父级与全局 Claude 注册以及遗留 claude-flow 键，未经批准不得覆盖或创建重复注册。
- 内存与状态查看：用 memory peek 做只读存储解析；memory init、store/delete/import/export、cleanup 及任何写入 .swarm/memory.db、.claude-flow/data、协调或会话状态的命令都视为变更操作，需审批。
- 清理：先预览，只删除 Ruflo 产物路径与 .claude/helpers，保留无关 .claude 内容、内存数据库、工作树与用户设置；--force、回滚、删除、发布、安装、下载、遥测或远程调用等操作必须审批。
使用方式 先运行离线门禁预检，再进行源码审计或只读发现；在初始化、MCP 注册、拓扑运行、内存写入和清理前，逐项展示目标并请求批准。行为不明确时阅读定版源码引用，并区分“观察到的事实”与“未经验证的说法”；不要基于静态证据声称已获得实时 swarm 结果。
适用场景 适合需要审慎操作 Ruflo 仓库与 CLI 的开发者、维护者和审计场景，尤其是初始化前评估、MCP 注册冲突排查、状态只读检查和安全清理。
限制 该技能助手仅离线运行，不执行 Ruflo、Claude Code、npm、npx、服务器、钩子或网络调用。不得隐式安装依赖；package.json 的 postinstall 被视为会修改可达 agentdb 树的变更型安装钩子。向量内存、共识、吞吐与学习相关说法，除非有另行批准的运行时捕获证明，否则只能标注为配置值或估计值。收费、价格与平台支持信息暂未提供。