maestro-flow

Name: maestro-flow
Author: catlog22

475stars60forks

How to install maestro-flow?

catlog22/maestro-flow

$git clone https://github.com/catlog22/maestro-flow

Installs into the current project.

Summary

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

Files · 1

View on GitHub

README.md

1	<div align="center">
2
3	# Maestro-Flow
4
5	### 意图驱动的多智能体工作流编排框架
6
7	说出你要做什么，Maestro 自动规划、调度、执行、验证。
8
9	<br/>
10
11	[![npm version](https://img.shields.io/npm/v/maestro-flow?color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/maestro-flow)
12	[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
13	[![Node.js](https://img.shields.io/badge/Node.js-≥18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
14	[![MCP](https://img.shields.io/badge/MCP-Protocol-8B5CF6)](https://modelcontextprotocol.io/)
15	[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
16
17	[简体中文](README.md)  \|  [English](README.en.md)
18
19	</div>
20
21	<br/>
22
23	> 大多数 AI 编程工具只能让一个 Agent 做一件事。
24	> Maestro-Flow 让多个 Agent 协同完成从头脑风暴到部署上线的全流程 — 自适应决策引擎根据实际结果动态调整策略，知识图谱将每次执行的经验自动积累到下一次。
25
26	<br/>
27
28	## 核心能力
29
30	自适应编排 — Ralph v2 引擎读取项目状态，将自然语言意图分类到 40+ 种命令链，在关键节点根据实际执行结果动态决策：继续、回退、还是插入修复循环。不写 YAML，不配置管线。
31
32	跨后端调度 — 同一工作流中混用 Claude、Codex、Gemini、Qwen、OpenCode，四种编排模式按需组合：Delegate（异步委派）、Team（角色协作）、Wave（依赖并行）、Swarm（蚁群探索）。
33
34	知识自增强 — Agent 执行中发现的模式、陷阱、决策，自动持久化为 Spec 和 Knowhow。Hook 系统将相关知识注入后续 Agent 的提示词 — 项目越用越聪明。
35
36	长周期自校正 — Odyssey 系列命令运行数小时级的自主循环，每个检查点自适应调整策略，直到满足验收标准。
37
38	---
39
40	## 安装
41
42	```bash
43	npm install -g maestro-flow
44	maestro install # 交互式选择安装组件
45	```
46
47	需要 Node.js ≥ 18 和 [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)。多 Agent 工作流可选装 Codex CLI、agy CLI。
48
49	---
50
51	## 快速上手
52
53	### Ralph v2 — 自适应生命周期引擎
54
55	主入口。说出目标，Ralph 自动判断开发阶段、构建命令链、在 decision 节点动态调整：
56
57	```bash
58	/maestro-ralph-v2 "实现 OAuth2 认证，支持 refresh token"
59
60	# Ralph 自动构建链：analyze → plan → execute → verify → review → test
61	# 遇到失败 → 自动插入 debug → fix → retry 循环
62	# 遇到新项目 → 自动前置 brainstorm → blueprint
63	```
64
65	```bash
66	/maestro-ralph-v2 status # 查看当前会话进度
67	/maestro-ralph-v2 continue # 从 decision 暂停点恢复
68	/maestro-ralph-v2 -y "..." # 全自动，无需确认
69	```
70
71	### 核心管线
72
73	```
74	意图输入 → Ralph 分类（40+ 链类型）
75	│
76	▼
77	brainstorm → blueprint(opt) → analyze → plan → execute → verify
78	◆ decision
79	review ── ◆ ── test ── ◆ ── milestone
80	◆ → 下一里程碑
81	```
82
83	三种质量模式控制管线深度：
84
85	\| 模式 \| 管线 \| 适用场景 \|
86	\|------\|------\|---------\|
87	\| `full` \| verify → business-test → review → test-gen → test \| 生产环境、安全关键 \|
88	\| `standard` \| verify → review → test \| 默认平衡 \|
89	\| `quick` \| verify → CLI-review \| 原型、热修 \|
90
91	### 其他入口
92
93	```bash
94	/maestro "添加用户资料页" # 意图路由，自动选链
95	/maestro-quick "修复重定向 bug" # 最短链路：plan → execute → verify
96	```
97
98	### Odyssey — 长周期自主循环
99
100	适合大型调试、深度重构、UI 优化等需要持续迭代的场景：
101
102	\| 命令 \| 循环模式 \|
103	\|------\|---------\|
104	\| `/odyssey-debug` \| 考古分析 → 诊断 → 修复 → 确认 → 泛化 → 知识沉淀 \|
105	\| `/odyssey-planex` \| 需求解析 → 计划 → 执行 → 严格验证 → 修复循环 \|
106	\| `/odyssey-improve` \| 多维审计 → 深度诊断 → 定向修复 → 验证 → 泛化 \|
107	\| `/odyssey-review-test-fix` \| 多维审查 → 定向修复 → 测试 → 泛化 → 知识沉淀 \|
108	\| `/odyssey-ui` \| 视觉巡检 → 多维审计 → 发散探索 → 修复 → 验证 \|
109
110	每个 Odyssey 命令持续运行直到验收标准达成，中间自适应调整策略，发现的知识自动持久化。
111
112	---
113
114	## 文档
115
116	### 入门
117
118	\| \| 指南 \| 说明 \|
119	\|---\|------\|------\|
120	\| 01 \| [快速开始](guide/quick-start-guide.md) \| 安装、第一个工作流、核心概念 \|
121	\| 02 \| [安装指南](guide/install-guide.md) \| 组件选择、工作空间配置 \|
122	\| 03 \| [Ralph 引擎](guide/maestro-ralph-guide.md) \| 自适应决策、quality 模式、session 管理 \|
123	\| 04 \| [命令大全](guide/command-usage-guide.md) \| 64 个命令的用法、流程图、管线衔接 \|
124
125	### 日常使用
126
127	\| 指南 \| 说明 \|
128	\|------\|------\|
129	\| [CLI 命令参考](guide/cli-commands-guide.md) \| 35+ 终端命令速查 \|
130	\| [知识管理](guide/knowledge-management-guide.md) \| 知识图谱、Spec、Knowhow、Wiki 全景 \|
131	\| [Spec 系统](guide/spec-system-guide.md) \| 项目规则的编写、加载与自动注入 \|
132	\| [质量管线](guide/quality-pipeline-guide.md) \| verify → review → test 三级管线 \|
133	\| [Hook 机制](guide/hooks-guide.md) \| 17 个 Hook 的触发时机与上下文预算控制 \|
134
135	<details>
136	<summary><b>进阶 & 设计文档</b>（点击展开）</summary>
137	<br/>
138
139	\| 指南 \| 说明 \|
140	\|------\|------\|
141	\| [工作流结构](guide/workflow-structure-guide.md) \| 四层命令拓扑、六条规范路径 \|
142	\| [多 Agent 协调](guide/maestro-coordinator-guide.md) \| Delegate / Team / Wave / Swarm 详解 \|
143	\| [Delegate 异步执行](guide/delegate-async-

People who liked this also viewed

6 picks

Type

Scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!MCP ServersJul 2026930k71k
excel-mcp-serverA Model Context Protocol server for Excel file manipulationMCP ServersApr 2026572k4.0k
Excel-MCP-Server-MasterExcel MCP Server - Manipulate Excel files without Microsoft Excel. Model Context Protocol for XLSX, XLSM with Claude AI integrationMCP ServersJun 2025570k33
agent-deviceCLI to control iOS and Android devices for AI agentsMCP ServersJul 2026517k3.6k
n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you MCP ServersJul 2026495k22k
ha-mcpThe Unofficial and Awesome Home Assistant MCP ServerMCP ServersJul 2026351k4.1k

maestro-flow

475stars60forks

View on GitHub

How to install maestro-flow?

catlog22/maestro-flow

$git clone https://github.com/catlog22/maestro-flow

Installs into the current project.

Summary

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

Files · 1

View on GitHub

README.md

1	<div align="center">
2
3	# Maestro-Flow
4
5	### 意图驱动的多智能体工作流编排框架
6
7	说出你要做什么，Maestro 自动规划、调度、执行、验证。
8
9	<br/>
10
11	[![npm version](https://img.shields.io/npm/v/maestro-flow?color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/maestro-flow)
12	[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
13	[![Node.js](https://img.shields.io/badge/Node.js-≥18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
14	[![MCP](https://img.shields.io/badge/MCP-Protocol-8B5CF6)](https://modelcontextprotocol.io/)
15	[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
16
17	[简体中文](README.md)  \|  [English](README.en.md)
18
19	</div>
20
21	<br/>
22
23	> 大多数 AI 编程工具只能让一个 Agent 做一件事。
24	> Maestro-Flow 让多个 Agent 协同完成从头脑风暴到部署上线的全流程 — 自适应决策引擎根据实际结果动态调整策略，知识图谱将每次执行的经验自动积累到下一次。
25
26	<br/>
27
28	## 核心能力
29
30	自适应编排 — Ralph v2 引擎读取项目状态，将自然语言意图分类到 40+ 种命令链，在关键节点根据实际执行结果动态决策：继续、回退、还是插入修复循环。不写 YAML，不配置管线。
31
32	跨后端调度 — 同一工作流中混用 Claude、Codex、Gemini、Qwen、OpenCode，四种编排模式按需组合：Delegate（异步委派）、Team（角色协作）、Wave（依赖并行）、Swarm（蚁群探索）。
33
34	知识自增强 — Agent 执行中发现的模式、陷阱、决策，自动持久化为 Spec 和 Knowhow。Hook 系统将相关知识注入后续 Agent 的提示词 — 项目越用越聪明。
35
36	长周期自校正 — Odyssey 系列命令运行数小时级的自主循环，每个检查点自适应调整策略，直到满足验收标准。
37
38	---
39
40	## 安装
41
42	```bash
43	npm install -g maestro-flow
44	maestro install # 交互式选择安装组件
45	```
46
47	需要 Node.js ≥ 18 和 [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)。多 Agent 工作流可选装 Codex CLI、agy CLI。
48
49	---
50
51	## 快速上手
52
53	### Ralph v2 — 自适应生命周期引擎
54
55	主入口。说出目标，Ralph 自动判断开发阶段、构建命令链、在 decision 节点动态调整：
56
57	```bash
58	/maestro-ralph-v2 "实现 OAuth2 认证，支持 refresh token"
59
60	# Ralph 自动构建链：analyze → plan → execute → verify → review → test
61	# 遇到失败 → 自动插入 debug → fix → retry 循环
62	# 遇到新项目 → 自动前置 brainstorm → blueprint
63	```
64
65	```bash
66	/maestro-ralph-v2 status # 查看当前会话进度
67	/maestro-ralph-v2 continue # 从 decision 暂停点恢复
68	/maestro-ralph-v2 -y "..." # 全自动，无需确认
69	```
70
71	### 核心管线
72
73	```
74	意图输入 → Ralph 分类（40+ 链类型）
75	│
76	▼
77	brainstorm → blueprint(opt) → analyze → plan → execute → verify
78	◆ decision
79	review ── ◆ ── test ── ◆ ── milestone
80	◆ → 下一里程碑
81	```
82
83	三种质量模式控制管线深度：
84
85	\| 模式 \| 管线 \| 适用场景 \|
86	\|------\|------\|---------\|
87	\| `full` \| verify → business-test → review → test-gen → test \| 生产环境、安全关键 \|
88	\| `standard` \| verify → review → test \| 默认平衡 \|
89	\| `quick` \| verify → CLI-review \| 原型、热修 \|
90
91	### 其他入口
92
93	```bash
94	/maestro "添加用户资料页" # 意图路由，自动选链
95	/maestro-quick "修复重定向 bug" # 最短链路：plan → execute → verify
96	```
97
98	### Odyssey — 长周期自主循环
99
100	适合大型调试、深度重构、UI 优化等需要持续迭代的场景：
101
102	\| 命令 \| 循环模式 \|
103	\|------\|---------\|
104	\| `/odyssey-debug` \| 考古分析 → 诊断 → 修复 → 确认 → 泛化 → 知识沉淀 \|
105	\| `/odyssey-planex` \| 需求解析 → 计划 → 执行 → 严格验证 → 修复循环 \|
106	\| `/odyssey-improve` \| 多维审计 → 深度诊断 → 定向修复 → 验证 → 泛化 \|
107	\| `/odyssey-review-test-fix` \| 多维审查 → 定向修复 → 测试 → 泛化 → 知识沉淀 \|
108	\| `/odyssey-ui` \| 视觉巡检 → 多维审计 → 发散探索 → 修复 → 验证 \|
109
110	每个 Odyssey 命令持续运行直到验收标准达成，中间自适应调整策略，发现的知识自动持久化。
111
112	---
113
114	## 文档
115
116	### 入门
117
118	\| \| 指南 \| 说明 \|
119	\|---\|------\|------\|
120	\| 01 \| [快速开始](guide/quick-start-guide.md) \| 安装、第一个工作流、核心概念 \|
121	\| 02 \| [安装指南](guide/install-guide.md) \| 组件选择、工作空间配置 \|
122	\| 03 \| [Ralph 引擎](guide/maestro-ralph-guide.md) \| 自适应决策、quality 模式、session 管理 \|
123	\| 04 \| [命令大全](guide/command-usage-guide.md) \| 64 个命令的用法、流程图、管线衔接 \|
124
125	### 日常使用
126
127	\| 指南 \| 说明 \|
128	\|------\|------\|
129	\| [CLI 命令参考](guide/cli-commands-guide.md) \| 35+ 终端命令速查 \|
130	\| [知识管理](guide/knowledge-management-guide.md) \| 知识图谱、Spec、Knowhow、Wiki 全景 \|
131	\| [Spec 系统](guide/spec-system-guide.md) \| 项目规则的编写、加载与自动注入 \|
132	\| [质量管线](guide/quality-pipeline-guide.md) \| verify → review → test 三级管线 \|
133	\| [Hook 机制](guide/hooks-guide.md) \| 17 个 Hook 的触发时机与上下文预算控制 \|
134
135	<details>
136	<summary><b>进阶 & 设计文档</b>（点击展开）</summary>
137	<br/>
138
139	\| 指南 \| 说明 \|
140	\|------\|------\|
141	\| [工作流结构](guide/workflow-structure-guide.md) \| 四层命令拓扑、六条规范路径 \|
142	\| [多 Agent 协调](guide/maestro-coordinator-guide.md) \| Delegate / Team / Wave / Swarm 详解 \|
143	\| [Delegate 异步执行](guide/delegate-async-

People who liked this also viewed

6 picks

Type