Maestro Flow

Maestro-Flow

意图驱动的多智能体工作流编排框架

说出你要做什么，Maestro 自动规划、调度、执行、验证。

简体中文  |  English
大多数 AI 编程工具只能让一个 Agent 做一件事。
Maestro-Flow 让多个 Agent 协同完成从头脑风暴到部署上线的全流程 — 自适应决策引擎根据实际结果动态调整策略，知识图谱将每次执行的经验自动积累到下一次。

核心能力

自适应编排 — Ralph v2 引擎读取项目状态，将自然语言意图分类到 40+ 种命令链，在关键节点根据实际执行结果动态决策：继续、回退、还是插入修复循环。不写 YAML，不配置管线。

跨后端调度 — 同一工作流中混用 Claude、Codex、Gemini、Qwen、OpenCode、Grok，四种编排模式按需组合：Delegate（异步委派）、Team（角色协作）、Wave（依赖并行）、Swarm（蚁群探索）。

知识自增强 — Agent 执行中发现的模式、陷阱、决策，自动持久化为 Spec 和 Knowhow。Hook 系统将相关知识注入后续 Agent 的提示词 — 项目越用越聪明。

长周期自校正 — Odyssey 系列命令运行数小时级的自主循环，每个检查点自适应调整策略，直到满足验收标准。

安装

需要 Node.js ≥ 22.19 和至少一个宿主 CLI：Claude Code（默认）和/或 Grok Build。多 Agent 工作流还可选装 Codex CLI、agy CLI。

Grok 一等适配：先装官方 maestro-flow@0.5.82，再在仓库根跑 .\install.ps1 / ./install.sh（可用 --path）。项目指令落到 .grok/rules/maestro.md；旧 .grok/AGENTS.md 里的 Maestro 段会在重装时剥离。官方版本不一致会失败，不会自动降级。补丁已叠、只缺项目资产时，再跑一次同一脚本即可。项目级 MCP / hooks 需在该目录信任 Grok 文件夹（交互确认或 /hooks-trust）；用户级 maestro-tools 不依赖信任。详见仓库根 INSTALL.md。产品安装细节见 安装指南。

装完命令只教 v3：maestro session open → maestro run next → maestro run complete --advance → maestro session complete。

快速上手

Ralph — 闭环策略层

主入口。说出目标，Ralph 自动判断开发阶段、构建命令链、在 decision 节点动态调整：

核心管线

三种质量模式控制管线深度：

其他入口

Odyssey — 长周期自主循环

适合大型调试、深度重构、UI 优化等需要持续迭代的场景：

统一入口 /maestro-odyssey  --mode ，七种模式：

Odyssey 持续运行直到验收标准达成，中间自适应调整策略，发现的知识自动持久化。

受治理的精确搜索

已知字符串、路径或标识符只需定位源码出现位置时，可使用独立的 literal 路由：

--exact 直接使用内置 @vscode/ripgrep，输出相对 filePath、行/列和预览，
不参与默认搜索排序或融合。默认只搜索当前 repository；linked code 必须同时指定
--include-linked-code 且具有 codebase read share。.gitignore、.maestroignore、
敏感目录及 timeout/result/byte 上限始终生效。

排名搜索默认走低延迟 BM25；只有显式 --semantic 才启用 embedding 重排。
--diagnostics 提供有界、request-scoped 的机器可读诊断（--json 时嵌入响应，
否则写入 stderr）。自适应候选预算、compiled postings、文件增量索引和结构化 chunks
仍是默认关闭的受控实验能力，不改变默认搜索契约。

文档

入门

日常使用

进阶…