maestro-flow 0.3.7 → 0.3.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/learn-retro.md +303 -0
- package/.claude/commands/maestro-execute.md +3 -2
- package/.claude/commands/maestro-learn.md +74 -298
- package/.claude/commands/manage-learn.md +21 -15
- package/.claude/commands/manage-memory-capture.md +13 -15
- package/.claude/commands/manage-memory.md +1 -1
- package/.claude/commands/quality-retrospective.md +5 -5
- package/.claude/commands/spec-load.md +7 -2
- package/.claude/commands/wiki-digest.md +27 -2
- package/README.md +103 -220
- package/README.zh-CN.md +159 -181
- package/dashboard/dist/assets/{ArtifactsPage-A9yzYtpj.js → ArtifactsPage-BmPOu8sO.js} +1 -1
- package/dashboard/dist/assets/{ChatInput-PuCvZZ3y.js → ChatInput-CL8YDfOU.js} +1 -1
- package/dashboard/dist/assets/ChatPage-CT-ozBK2.js +8 -0
- package/dashboard/dist/assets/{CollabPage-I5k_mCbG.js → CollabPage-C0rWMden.js} +1 -1
- package/dashboard/dist/assets/{KanbanPage-PDDBv5-9.js → KanbanPage-C6WbAlwI.js} +1 -1
- package/dashboard/dist/assets/{MarkdownRenderer-CCXHaut3.js → MarkdownRenderer-BjZ43aSa.js} +1 -1
- package/dashboard/dist/assets/{McpPage-CiqXpCHg.js → McpPage-BPIXADQi.js} +1 -1
- package/dashboard/dist/assets/{RequirementBoardPage-CEOvppGn.js → RequirementBoardPage-B7yRL0s_.js} +1 -1
- package/dashboard/dist/assets/{RequirementPage-DpnbTEqY.js → RequirementPage-D8J_-b6O.js} +1 -1
- package/dashboard/dist/assets/{SpecsPage-CYqOfFkB.js → SpecsPage-6lO8v8_C.js} +1 -1
- package/dashboard/dist/assets/{SupervisorPage-B2sZwkq8.js → SupervisorPage-Ds5N378a.js} +1 -1
- package/dashboard/dist/assets/{TeamsPage-CkZdCAVZ.js → TeamsPage-DrkKr17T.js} +1 -1
- package/dashboard/dist/assets/{TreeBrowser-0VIMWclo.js → TreeBrowser-g_QUKemL.js} +1 -1
- package/dashboard/dist/assets/WorkflowPage-X8aNkDEr.js +6 -0
- package/dashboard/dist/assets/{arrow-left-6fktHyjN.js → arrow-left-CadP5YgU.js} +1 -1
- package/dashboard/dist/assets/{check-Cbxq2l1-.js → check-5xufDzS8.js} +1 -1
- package/dashboard/dist/assets/{chevron-right-Yts3bi8p.js → chevron-right-CYbpR4ev.js} +1 -1
- package/dashboard/dist/assets/{circle-4Ci4Xolf.js → circle-Bm-5Q-Yh.js} +1 -1
- package/dashboard/dist/assets/{circle-alert-B25g9BTL.js → circle-alert-BqcYuT7x.js} +1 -1
- package/dashboard/dist/assets/{circle-check-BA5_XqeV.js → circle-check-DEVzW_lm.js} +1 -1
- package/dashboard/dist/assets/{circle-check-big-DzO2BlL7.js → circle-check-big-yyzAFysU.js} +1 -1
- package/dashboard/dist/assets/{code-zxwuybO8.js → code-BBdC8Wmw.js} +1 -1
- package/dashboard/dist/assets/{columns-3-DV4oeCfU.js → columns-3-CQ9Trztr.js} +1 -1
- package/dashboard/dist/assets/{download-CXCyQw8M.js → download-DayuF-sn.js} +1 -1
- package/dashboard/dist/assets/{folder-Bvjj8Vn9.js → folder-CqXeSKeC.js} +1 -1
- package/dashboard/dist/assets/{git-branch-DL8p9kVC.js → git-branch-SqFf4Ru5.js} +1 -1
- package/dashboard/dist/assets/{index-BvScJmJM.js → index-Dru5HYy0.js} +1 -1
- package/dashboard/dist/assets/{index-11DuhKhc.js → index-nufWop4p.js} +18 -18
- package/dashboard/dist/assets/{list-Dj4i9N75.js → list-DBOD6IUt.js} +1 -1
- package/dashboard/dist/assets/{minus-DwlFabsT.js → minus-fQI1Syn2.js} +1 -1
- package/dashboard/dist/assets/{pen-line-D7UzECt6.js → pen-line-Bkbbngl5.js} +1 -1
- package/dashboard/dist/assets/{proxy-B9XRqHD9.js → proxy-teW12DdZ.js} +1 -1
- package/dashboard/dist/assets/{search-BQbBTIYl.js → search-Bq3ygFUW.js} +1 -1
- package/dashboard/dist/assets/{shallow-Clb1Lyd_.js → shallow-22ZN8sFt.js} +1 -1
- package/dashboard/dist/assets/{table-BqxCXid2.js → table-BEYtdWc4.js} +1 -1
- package/dashboard/dist/assets/{trash-2-6rN9B-EQ.js → trash-2-DMqGBgcF.js} +1 -1
- package/dashboard/dist/assets/{wrench-BScEJFqC.js → wrench-B84-zdLI.js} +1 -1
- package/dashboard/dist/assets/{zap-DxUhG-gk.js → zap-9DVkGVtt.js} +1 -1
- package/dashboard/dist/index.html +1 -1
- package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.d.ts +1 -1
- package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.js +5 -4
- package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.d.ts +1 -1
- package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.js +3 -4
- package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.test.js +4 -4
- package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.test.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/commander/commander-agent.js +4 -3
- package/dashboard/dist-server/dashboard/src/server/commander/commander-agent.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/commander/commander-agent.test.js +20 -7
- package/dashboard/dist-server/dashboard/src/server/commander/commander-agent.test.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/execution/wave-executor.d.ts +1 -1
- package/dashboard/dist-server/dashboard/src/server/execution/wave-executor.js +4 -4
- package/dashboard/dist-server/dashboard/src/server/execution/wave-executor.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/index.js +2 -1
- package/dashboard/dist-server/dashboard/src/server/index.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/routes/issues.js +14 -14
- package/dashboard/dist-server/dashboard/src/server/routes/issues.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/routes/linear.js +7 -5
- package/dashboard/dist-server/dashboard/src/server/routes/linear.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/state/state-manager.js +144 -23
- package/dashboard/dist-server/dashboard/src/server/state/state-manager.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/utils/issue-store.d.ts +6 -0
- package/dashboard/dist-server/dashboard/src/server/utils/issue-store.js +24 -2
- package/dashboard/dist-server/dashboard/src/server/utils/issue-store.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/ws/handlers/execution-handler.js +4 -7
- package/dashboard/dist-server/dashboard/src/server/ws/handlers/execution-handler.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/shared/constants.js +2 -1
- package/dashboard/dist-server/dashboard/src/shared/constants.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/shared/constants.test.js +5 -5
- package/dashboard/dist-server/dashboard/src/shared/constants.test.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/shared/issue-types.test.js +4 -4
- package/dashboard/dist-server/dashboard/src/shared/issue-types.test.js.map +1 -1
- package/dashboard/dist-server/src/commands/delegate.js +7 -1
- package/dashboard/dist-server/src/commands/delegate.js.map +1 -1
- package/dist/src/commands/delegate.d.ts.map +1 -1
- package/dist/src/commands/delegate.js +7 -1
- package/dist/src/commands/delegate.js.map +1 -1
- package/package.json +1 -1
- package/workflows/delegate-usage.md +39 -41
- package/workflows/execute.md +154 -34
- package/workflows/init.md +1 -1
- package/workflows/maestro-coordinate.codex.md +1 -1
- package/workflows/maestro-coordinate.md +1 -1
- package/workflows/maestro.md +2 -2
- package/workflows/memory.md +2 -1
- package/workflows/plan.md +9 -2
- package/workflows/retrospective.md +2 -2
- package/workflows/roadmap.md +1 -1
- package/.claude/commands/learn-retro-decision.md +0 -198
- package/.claude/commands/learn-retro-git.md +0 -160
- package/dashboard/dist/assets/ChatPage-v19GURYH.js +0 -8
- package/dashboard/dist/assets/WorkflowPage-Csm23wUS.js +0 -6
package/README.zh-CN.md
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
# Maestro-Flow
|
|
4
4
|
|
|
5
|
-
###
|
|
5
|
+
### 多智能体时代的编排层
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
**不仅是执行,更是编排。**
|
|
8
8
|
|
|
9
9
|
[](https://www.typescriptlang.org/)
|
|
10
10
|
[](https://nodejs.org/)
|
|
@@ -13,41 +13,20 @@
|
|
|
13
13
|
|
|
14
14
|
[English](README.md) | [简体中文](README.zh-CN.md)
|
|
15
15
|
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
*我不写代码 —— Claude Code 和 Codex 写。但告诉它们做什么、按什么顺序、带什么上下文、然后验证结果 —— 这才是耗时间的地方。Maestro-Flow 把这些编排自动化了。*
|
|
19
|
-
|
|
20
16
|
</div>
|
|
21
17
|
|
|
22
18
|
---
|
|
23
19
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
这个项目是 [Claude-Code-Workflow (CCW)](https://github.com/catlog22/Claude-Code-Workflow) 的**彻底重写**。CCW 是我之前的多 CLI 编排框架,它证明了通过结构化工作流协调 Claude、Codex、Gemini 等 AI 智能体是可行的 —— 但它越长越复杂。太多层级,太多抽象。
|
|
27
|
-
|
|
28
|
-
Maestro-Flow 保留了验证过的核心思路,用全新的理念重建:**更少仪式感,更快执行。** 规格驱动的阶段管线设计受 [GET SHIT DONE (GSD)](https://github.com/gsd-build/get-shit-done) 启发 —— 它的上下文工程方法和原子提交纪律确实优雅。Maestro-Flow 采纳了这些设计模式,同时补上 GSD 没有的东西:实时可视化看板、基于 Claude Agent SDK 的多智能体执行、以及自主运行的 Commander 让管线持续推进。
|
|
29
|
-
|
|
30
|
-
**相比 CCW 改了什么:**
|
|
31
|
-
- 砍掉了重型的 session/beat 编排层 —— 替换为轻量的 skill 路由
|
|
32
|
-
- 终端仪表盘升级为 Linear 风格的 Web 看板 UI
|
|
33
|
-
- 统一所有 CLI 工具调用到 `maestro cli` 单一接口
|
|
34
|
-
- 新增自主 Commander Agent(assess → decide → dispatch 循环)
|
|
35
|
-
- 构建了完整的 Issue 闭环系统(discover → analyze → plan → execute → close)
|
|
36
|
-
|
|
37
|
-
**保留了什么:**
|
|
38
|
-
- 多 CLI 编排(Claude、Codex、Gemini、Qwen、OpenCode)
|
|
39
|
-
- Markdown 定义的结构化工作流
|
|
40
|
-
- 斜杠命令作为用户界面
|
|
41
|
-
- Agent 定义作为聚焦的角色规格
|
|
20
|
+
Maestro-Flow 是一个面向 Claude Code、Codex、Gemini 等多智能体的工作流编排框架。它将软件工程中最耗时的部分——决定让哪些智能体做什么、按什么顺序、带什么上下文——自动化为一条结构化管线。你只需描述意图,Maestro-Flow 自动路由到最优命令链,驱动多个 AI 智能体并行执行,并通过实时看板、Issue 闭环和知识图谱形成完整的项目交付闭环。
|
|
42
21
|
|
|
43
22
|
---
|
|
44
23
|
|
|
45
24
|
## 它做什么
|
|
46
25
|
|
|
47
|
-
你描述你想要什么。Maestro-Flow
|
|
26
|
+
你描述你想要什么。Maestro-Flow 决定用哪些智能体、按什么顺序、带什么上下文,然后驱动它完成。
|
|
48
27
|
|
|
49
28
|
```bash
|
|
50
|
-
# 自然语言
|
|
29
|
+
# 自然语言 -- Maestro-Flow 路由到最优命令链
|
|
51
30
|
/maestro "实现基于 OAuth2 的用户认证,带 refresh token"
|
|
52
31
|
|
|
53
32
|
# 或者一步步来
|
|
@@ -74,160 +53,164 @@ graph LR
|
|
|
74
53
|
J -->|下一阶段| D
|
|
75
54
|
```
|
|
76
55
|
|
|
77
|
-
每个阶段有明确的状态跟踪。仪表盘展示正在发生什么、下一步该做什么。
|
|
78
|
-
|
|
79
56
|
### 快速通道
|
|
80
57
|
|
|
81
|
-
不是所有事情都需要走完整管线:
|
|
82
|
-
|
|
83
58
|
| 通道 | 流程 | 适用场景 |
|
|
84
59
|
|------|------|---------|
|
|
85
|
-
| `/maestro-quick` | analyze
|
|
86
|
-
| Scratch 模式 | `analyze -q`
|
|
60
|
+
| `/maestro-quick` | analyze > plan > execute | 快速修复、小功能 |
|
|
61
|
+
| Scratch 模式 | `analyze -q` > `plan --dir` > `execute --dir` | 不需要 roadmap,直接干 |
|
|
87
62
|
| `/maestro "..."` | AI 路由命令链 | 描述意图,让 Maestro-Flow 决定 |
|
|
88
63
|
|
|
89
64
|
---
|
|
90
65
|
|
|
91
|
-
##
|
|
92
|
-
|
|
93
|
-
实时项目控制面板,运行在 `http://127.0.0.1:3001`。React 19 + Tailwind CSS 4 构建,WebSocket 实时更新。
|
|
66
|
+
## 四大支柱
|
|
94
67
|
|
|
95
|
-
###
|
|
96
|
-
|
|
97
|
-
| 视图 | 快捷键 | 你看到什么 |
|
|
98
|
-
|------|--------|-----------|
|
|
99
|
-
| **Board** | `K` | 看板列 —— Backlog、In Progress、Review、Done。Phase 卡片和 Issue 卡片并排展示。 |
|
|
100
|
-
| **Timeline** | `T` | 甘特图风格的阶段时间线,带进度条 |
|
|
101
|
-
| **Table** | `L` | 所有阶段和 Issue 的可排序表格 |
|
|
102
|
-
| **Center** | `C` | 指挥中心 —— 活跃执行、Issue 队列、质量指标 |
|
|
68
|
+
### 1. 结构化管线
|
|
103
69
|
|
|
104
|
-
|
|
70
|
+
基于阶段的执行模型,每个阶段经历 analyze > plan > execute > verify > review > test > transition。仪表盘展示正在发生什么、下一步该做什么。
|
|
105
71
|
|
|
106
|
-
|
|
107
|
-
- **批量派发** — 多选 Issue,并行发送给智能体
|
|
108
|
-
- **看智能体工作** — 实时 CLI 输出流式面板
|
|
109
|
-
- **Issue 全生命周期** — 创建、分析、规划、执行、关闭 —— 全在看板上
|
|
110
|
-
- **Linear 同步** — 导入/导出 Issue 到 Linear,支持团队协作
|
|
72
|
+
51 个斜杠命令覆盖 6 大类别,驱动从项目初始化到质量复盘的每一个环节。
|
|
111
73
|
|
|
112
|
-
###
|
|
74
|
+
### 2. 自主驾驶
|
|
113
75
|
|
|
114
|
-
|
|
76
|
+
**Commander Agent** -- 后台运行的自主监督者:
|
|
115
77
|
|
|
116
78
|
```
|
|
117
|
-
评估(assess)
|
|
79
|
+
评估(assess) -> 决策(decide) -> 派发(dispatch) -> 等待 -> 评估 -> ...
|
|
118
80
|
```
|
|
119
81
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
Commander 开启后,Issue 从发现到解决全程无需人工干预。
|
|
82
|
+
读取项目状态(阶段、任务、Issue、智能体工位),判断什么需要处理,自动派发智能体。三档配置: `conservative`、`balanced`、`aggressive`。
|
|
123
83
|
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
## Issue 闭环
|
|
127
|
-
|
|
128
|
-
Issue 不只是工单 —— 它们是一条自修复管线:
|
|
84
|
+
**Issue 闭环** -- Issue 不只是工单,它们是一条自修复管线:
|
|
129
85
|
|
|
130
86
|
```mermaid
|
|
131
87
|
graph LR
|
|
132
|
-
A[发现] --> B[
|
|
133
|
-
B --> C[
|
|
134
|
-
C --> D[
|
|
135
|
-
D --> E[
|
|
136
|
-
E --> F[关闭]
|
|
88
|
+
A[发现] --> B[分析]
|
|
89
|
+
B --> C[规划]
|
|
90
|
+
C --> D[执行]
|
|
91
|
+
D --> E[关闭]
|
|
137
92
|
```
|
|
138
93
|
|
|
139
94
|
| 阶段 | 命令 | 做了什么 |
|
|
140
95
|
|------|------|---------|
|
|
141
|
-
| **发现** | `/manage-issue-discover` | 8
|
|
142
|
-
| **分析** | `/manage-issue-analyze` | CLI
|
|
143
|
-
| **规划** | `/manage-issue-plan` |
|
|
144
|
-
| **执行** | `/manage-issue-execute` |
|
|
145
|
-
| **关闭** | 自动 | 验证通过
|
|
96
|
+
| **发现** | `/manage-issue-discover` | 8 视角扫描: Bug、UX、技术债、安全、性能、测试缺口、代码质量、文档 |
|
|
97
|
+
| **分析** | `/manage-issue-analyze` | CLI 探索式根因分析 |
|
|
98
|
+
| **规划** | `/manage-issue-plan` | 生成解决方案步骤、目标文件、验证条件 |
|
|
99
|
+
| **执行** | `/manage-issue-execute` | Dashboard API 派发或 CLI 直接执行 |
|
|
100
|
+
| **关闭** | 自动 | 验证通过 -> resolved -> closed |
|
|
146
101
|
|
|
147
|
-
|
|
102
|
+
质量命令(`review`、`test`、`verify`)自动为发现的问题创建 Issue。Issue 修复的代码回流到阶段管线。闭环自动关闭。
|
|
148
103
|
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
104
|
+
### 3. 可视化控制面板
|
|
105
|
+
|
|
106
|
+
实时项目仪表盘,运行在 `http://127.0.0.1:3001`。React 19 + Tailwind CSS 4 构建,WebSocket 实时更新。
|
|
107
|
+
|
|
108
|
+
| 视图 | 快捷键 | 你看到什么 |
|
|
109
|
+
|------|--------|-----------|
|
|
110
|
+
| **Board** | `K` | 看板列 -- Backlog、In Progress、Review、Done |
|
|
111
|
+
| **Timeline** | `T` | 甘特图风格的阶段时间线,带进度条 |
|
|
112
|
+
| **Table** | `L` | 所有阶段和 Issue 的可排序表格 |
|
|
113
|
+
| **Center** | `C` | 指挥中心 -- 活跃执行、Issue 队列、质量指标 |
|
|
114
|
+
|
|
115
|
+
在 Issue 卡片上选个智能体,点播放。批量选择 Issue,并行派发。实时流式面板观察智能体工作。
|
|
116
|
+
|
|
117
|
+
### 4. 智能知识库
|
|
118
|
+
|
|
119
|
+
项目随时间积累智能,通过两个系统实现:
|
|
120
|
+
|
|
121
|
+
**Wiki 知识图谱** -- 结构化条目(specs、phases、decisions、lessons)通过语义链接关联。BM25 搜索、反向链接遍历、健康评分。`/wiki-connect` 发现隐藏连接;`/wiki-digest` 生成主题聚类摘要,带覆盖热力图和缺口分析。
|
|
122
|
+
|
|
123
|
+
**学习工具箱** -- 5 个命令将代码和历史转化为可复用知识:
|
|
166
124
|
|
|
167
|
-
|
|
125
|
+
| 命令 | 做了什么 |
|
|
126
|
+
|------|---------|
|
|
127
|
+
| `/learn-retro` | 统一复盘 -- Git 活动指标 + 架构决策评估,通过 `--lens git\|decision\|all` 切换 |
|
|
128
|
+
| `/learn-follow` | 引导式跟读,带强制提问 -- 提取模式、构建理解 |
|
|
129
|
+
| `/learn-decompose` | 4 维度并行模式提取,保存到 specs/wiki |
|
|
130
|
+
| `/learn-second-opinion` | 多视角分析: review、challenge、consult 三种模式 |
|
|
131
|
+
| `/learn-investigate` | 系统化问题调查,假设验证 + 3 次上报机制 |
|
|
132
|
+
|
|
133
|
+
所有学习命令共享 `lessons.jsonl` -- 通过 `/manage-learn` 统一查询的知识库。Specs、复盘和手动洞察全部汇入同一个池。
|
|
168
134
|
|
|
169
135
|
---
|
|
170
136
|
|
|
171
|
-
##
|
|
137
|
+
## 引擎盖下
|
|
138
|
+
|
|
139
|
+
### 多智能体引擎
|
|
172
140
|
|
|
173
|
-
Maestro-Flow
|
|
141
|
+
Maestro-Flow 协调多个 AI 智能体并行工作:
|
|
174
142
|
|
|
175
143
|
```
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
144
|
+
+--------------------------------+
|
|
145
|
+
| ExecutionScheduler |
|
|
146
|
+
| (波次并行执行引擎) |
|
|
147
|
+
+---------------+----------------+
|
|
148
|
+
|
|
|
149
|
+
+--------------+--------------+
|
|
150
|
+
| | |
|
|
151
|
+
+-----+-----+ +-----+------+ +----+------+
|
|
152
|
+
| Claude | | Codex | | Gemini |
|
|
153
|
+
| Agent SDK | | CLI | | CLI |
|
|
154
|
+
+-----------+ +------------+ +-----------+
|
|
187
155
|
```
|
|
188
156
|
|
|
189
|
-
- **波次执行**
|
|
190
|
-
- **Agent SDK**
|
|
191
|
-
- **CLI 适配器**
|
|
192
|
-
- **工作区隔离**
|
|
157
|
+
- **波次执行** -- 无依赖任务并行,有依赖任务等前置完成
|
|
158
|
+
- **Agent SDK** -- 原生 Claude Agent SDK 驱动 Claude Code 进程
|
|
159
|
+
- **CLI 适配器** -- Codex、Gemini、Qwen、OpenCode 通过 `maestro delegate` 调用
|
|
160
|
+
- **工作区隔离** -- 每个智能体获得独立执行上下文
|
|
193
161
|
|
|
194
|
-
|
|
162
|
+
### Hook 系统
|
|
195
163
|
|
|
196
|
-
|
|
164
|
+
9 个上下文感知 Hook,3 级安装:
|
|
197
165
|
|
|
198
|
-
|
|
166
|
+
| Hook | 用途 |
|
|
167
|
+
|------|------|
|
|
168
|
+
| `context-monitor` | 监控上下文用量,接近上限时注入警告 |
|
|
169
|
+
| `spec-injector` | 按智能体类型自动注入项目规范到子 Agent 提示词 |
|
|
170
|
+
| `delegate-monitor` | 跟踪异步 delegate 任务完成状态 |
|
|
171
|
+
| `team-monitor` | 团队协作消息感知 |
|
|
172
|
+
| `telemetry` | 执行遥测收集 |
|
|
173
|
+
| `session-context` | 会话启动时注入工作流状态 |
|
|
174
|
+
| `skill-context` | 调用工作流 Skill 时注入工作流状态 |
|
|
175
|
+
| `coordinator-tracker` | 跟踪协调器链进度 |
|
|
176
|
+
| `workflow-guard` | 保护关键文件、约束工作流行为 |
|
|
177
|
+
|
|
178
|
+
`spec-injector` 按类型路由项目规范 -- 执行 Agent 获取编码约定,规划 Agent 获取架构约束。4 级上下文预算(full > reduced > minimal > skip)自适应注入量。
|
|
199
179
|
|
|
200
180
|
```bash
|
|
201
|
-
#
|
|
202
|
-
|
|
181
|
+
maestro hooks install --level minimal # context-monitor + spec-injector
|
|
182
|
+
maestro hooks install --level standard # + delegate/team/telemetry + session/skill-context + coordinator-tracker
|
|
183
|
+
maestro hooks install --level full # + workflow-guard
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
### Overlay 系统
|
|
187
|
+
|
|
188
|
+
非侵入式地为 `.claude/commands/*.md` 打补丁 -- 增加步骤、阅读要求、质量门禁,无需编辑原始文件。Overlay 在 `maestro install` 升级后自动保留。
|
|
203
189
|
|
|
204
|
-
|
|
205
|
-
maestro
|
|
190
|
+
```bash
|
|
191
|
+
/maestro-overlay "在 maestro-execute 执行后增加 CLI 验证"
|
|
206
192
|
maestro overlay list # 交互式 TUI 管理
|
|
207
193
|
maestro overlay bundle -o team.json # 打包分享
|
|
208
|
-
maestro overlay import-bundle team.json # 解包 + 应用
|
|
209
194
|
```
|
|
210
195
|
|
|
211
|
-
每个 overlay 声明目标命令和补丁列表(section + mode + content)。Patcher 使用哈希 HTML 注释标记包裹注入内容,实现幂等应用和精准移除。
|
|
212
|
-
|
|
213
|
-
详见 **[Overlay 系统指南](guide/overlay-guide.md)**。
|
|
214
|
-
|
|
215
196
|
---
|
|
216
197
|
|
|
217
|
-
##
|
|
198
|
+
## 51 个命令,21 个 Agent
|
|
218
199
|
|
|
219
|
-
###
|
|
200
|
+
### 命令
|
|
220
201
|
|
|
221
|
-
| 类别 | 数量 | 用途 |
|
|
222
|
-
|
|
223
|
-
| `maestro-*` |
|
|
224
|
-
| `manage-*` |
|
|
225
|
-
| `quality-*` |
|
|
226
|
-
|
|
|
202
|
+
| 类别 | 数量 | 前缀 | 用途 |
|
|
203
|
+
|------|------|------|------|
|
|
204
|
+
| **核心工作流** | 20 | `maestro-*` | 全生命周期 -- init、brainstorm、roadmap、analyze、plan、execute、verify、coordinate、milestones、overlays、UI design |
|
|
205
|
+
| **管理** | 12 | `manage-*` | Issue 生命周期、代码库文档、知识捕获、记忆管理、harvest、status |
|
|
206
|
+
| **质量** | 9 | `quality-*` | review、test、debug、test-gen、integration-test、business-test、refactor、retrospective、sync |
|
|
207
|
+
| **学习** | 5 | `learn-*` | 统一复盘、跟读学习、模式拆解、系统探究、多视角分析 |
|
|
208
|
+
| **规范** | 3 | `spec-*` | setup、add、load |
|
|
209
|
+
| **知识图谱** | 2 | `wiki-*` | 连接发现、知识摘要 |
|
|
227
210
|
|
|
228
211
|
### Agent
|
|
229
212
|
|
|
230
|
-
`.claude/agents/` 下 21 个专业化 Agent 定义
|
|
213
|
+
`.claude/agents/` 下 21 个专业化 Agent 定义 -- 每个是聚焦的 Markdown 文件,Claude Code 按需加载。包括 `workflow-planner`、`workflow-executor`、`issue-discover-agent`、`workflow-debugger`、`workflow-verifier`、`team-worker` 等。
|
|
231
214
|
|
|
232
215
|
---
|
|
233
216
|
|
|
@@ -237,12 +220,10 @@ maestro overlay import-bundle team.json # 解包 + 应用
|
|
|
237
220
|
|
|
238
221
|
- Node.js >= 18
|
|
239
222
|
- [Claude Code](https://claude.com/code) CLI
|
|
240
|
-
-
|
|
223
|
+
- (可选) Codex CLI、Gemini CLI 用于多智能体工作流
|
|
241
224
|
|
|
242
225
|
### 安装
|
|
243
226
|
|
|
244
|
-
#### npm(推荐)
|
|
245
|
-
|
|
246
227
|
```bash
|
|
247
228
|
npm install -g maestro-flow
|
|
248
229
|
|
|
@@ -250,22 +231,6 @@ npm install -g maestro-flow
|
|
|
250
231
|
maestro install
|
|
251
232
|
```
|
|
252
233
|
|
|
253
|
-
#### 从源码编译
|
|
254
|
-
|
|
255
|
-
```bash
|
|
256
|
-
git clone https://github.com/catlog22/Maestro-Flow.git
|
|
257
|
-
cd Maestro-Flow
|
|
258
|
-
npm install && npm run build && npm install -g .
|
|
259
|
-
maestro install
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
#### 启动仪表盘
|
|
263
|
-
|
|
264
|
-
```bash
|
|
265
|
-
cd dashboard && npm install && npm run dev
|
|
266
|
-
# → http://127.0.0.1:3001
|
|
267
|
-
```
|
|
268
|
-
|
|
269
234
|
### 第一次运行
|
|
270
235
|
|
|
271
236
|
```bash
|
|
@@ -274,16 +239,32 @@ cd dashboard && npm install && npm run dev
|
|
|
274
239
|
/maestro-plan 1 # 规划第一阶段
|
|
275
240
|
/maestro-execute 1 # 多智能体执行
|
|
276
241
|
|
|
277
|
-
#
|
|
242
|
+
# 或者直接:
|
|
278
243
|
/maestro "搭建用户管理的 REST API"
|
|
279
244
|
```
|
|
280
245
|
|
|
246
|
+
### 仪表盘
|
|
247
|
+
|
|
248
|
+
```bash
|
|
249
|
+
maestro serve # -> http://127.0.0.1:3001
|
|
250
|
+
maestro view # 终端 TUI 替代方案
|
|
251
|
+
```
|
|
252
|
+
|
|
281
253
|
### MCP 服务器
|
|
282
254
|
|
|
283
|
-
|
|
255
|
+
```bash
|
|
256
|
+
# Claude Code -- 加载为开发 MCP 服务器
|
|
257
|
+
claude --dangerously-load-development-channels server:maestro --dangerously-skip-permissions
|
|
258
|
+
|
|
259
|
+
# stdio 传输 (Claude Desktop 和其他 MCP 客户端)
|
|
260
|
+
npm run mcp
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
### 工作流启动器
|
|
284
264
|
|
|
285
265
|
```bash
|
|
286
|
-
|
|
266
|
+
maestro launcher # 交互式工作流 + 设置选择器
|
|
267
|
+
maestro launcher list # 查看已注册的工作流
|
|
287
268
|
```
|
|
288
269
|
|
|
289
270
|
---
|
|
@@ -292,27 +273,25 @@ npm run mcp # stdio 传输
|
|
|
292
273
|
|
|
293
274
|
```
|
|
294
275
|
maestro/
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
├── templates/ # JSON 模板(task, plan, issue, ...)
|
|
315
|
-
└── extensions/ # 插件系统
|
|
276
|
+
+-- bin/ # CLI 入口
|
|
277
|
+
+-- src/ # 核心 CLI (Commander.js + MCP SDK)
|
|
278
|
+
| +-- commands/ # 11 个 CLI 命令 (serve, run, cli, ext, tool, ...)
|
|
279
|
+
| +-- mcp/ # MCP 服务器 (stdio 传输)
|
|
280
|
+
| +-- core/ # 工具注册、扩展加载器
|
|
281
|
+
+-- dashboard/ # 实时 Web 仪表盘
|
|
282
|
+
| +-- src/
|
|
283
|
+
| +-- client/ # React 19 + Zustand + Tailwind CSS 4
|
|
284
|
+
| +-- server/ # Hono API + WebSocket + SSE
|
|
285
|
+
| | +-- agents/ # AgentManager + 适配器
|
|
286
|
+
| | +-- commander/ # 自主 Commander Agent
|
|
287
|
+
| | +-- execution/ # ExecutionScheduler + WaveExecutor
|
|
288
|
+
| +-- shared/ # 共享类型
|
|
289
|
+
+-- .claude/
|
|
290
|
+
| +-- commands/ # 51 个斜杠命令 (.md)
|
|
291
|
+
| +-- agents/ # 21 个 Agent 定义 (.md)
|
|
292
|
+
+-- workflows/ # 47 个工作流实现 (.md)
|
|
293
|
+
+-- templates/ # JSON 模板 (task, plan, issue, ...)
|
|
294
|
+
+-- extensions/ # 插件系统
|
|
316
295
|
```
|
|
317
296
|
|
|
318
297
|
### 技术栈
|
|
@@ -320,7 +299,7 @@ maestro/
|
|
|
320
299
|
| 层级 | 技术 |
|
|
321
300
|
|------|------|
|
|
322
301
|
| CLI | Commander.js, TypeScript, ESM |
|
|
323
|
-
| MCP | @modelcontextprotocol/sdk
|
|
302
|
+
| MCP | @modelcontextprotocol/sdk (stdio) |
|
|
324
303
|
| 前端 | React 19, Zustand, Tailwind CSS 4, Framer Motion, Radix UI |
|
|
325
304
|
| 后端 | Hono, WebSocket, SSE |
|
|
326
305
|
| 智能体 | Claude Agent SDK, Codex CLI, Gemini CLI, OpenCode |
|
|
@@ -330,20 +309,19 @@ maestro/
|
|
|
330
309
|
|
|
331
310
|
## 文档
|
|
332
311
|
|
|
333
|
-
- **[命令使用指南](guide/command-usage-guide.md)**
|
|
334
|
-
- **[Delegate 异步执行指南](guide/delegate-async-guide.md)**
|
|
335
|
-
- **[Overlay 系统指南](guide/overlay-guide.md)**
|
|
336
|
-
- **[
|
|
312
|
+
- **[命令使用指南](guide/command-usage-guide.md)** -- 全部 51 个命令,含工作流图表、管线衔接、Issue 闭环、快速通道
|
|
313
|
+
- **[Delegate 异步执行指南](guide/delegate-async-guide.md)** -- 异步任务委派: CLI & MCP 用法、消息注入、链式调用、Broker 生命周期
|
|
314
|
+
- **[Overlay 系统指南](guide/overlay-guide.md)** -- 非侵入式命令扩展: overlay 格式、section 注入、bundle 打包/导入、交互式 TUI 管理
|
|
315
|
+
- **[Hook 系统指南](guide/hooks-guide.md)** -- Hook 系统架构、9 个 Hook、Spec 注入、上下文预算、配置
|
|
316
|
+
- **[Team Lite -- 使用指南](guide/team-lite-guide.md)** -- 2-8 人小团队日常协作: 加入、同步、队友活跃、冲突预飞检
|
|
317
|
+
- **[Team Lite -- 设计文档](guide/team-lite-design.md)** -- 架构、数据模型、人机协作与智能体管线的命名空间边界
|
|
337
318
|
|
|
338
319
|
---
|
|
339
320
|
|
|
340
321
|
## 致谢
|
|
341
322
|
|
|
342
|
-
Maestro-Flow
|
|
343
|
-
|
|
344
|
-
- **[GET SHIT DONE](https://github.com/gsd-build/get-shit-done)** by TACHES — 规格驱动开发模型、上下文工程理念、原子提交纪律,塑造了 Maestro-Flow 的管线设计。GSD 证明了结构化的 meta-prompting 才是大规模驱动 AI 智能体的正确方式。
|
|
345
|
-
|
|
346
|
-
- **[Claude-Code-Workflow](https://github.com/catlog22/Claude-Code-Workflow)** — Maestro-Flow 的前身。CCW 开创了多 CLI 编排(Gemini + Codex + Qwen + Claude)、skill 路由工作流、team agent 架构。Maestro-Flow 是 CCW 从零重建 —— 更快、更精简,加上可视化看板和自主 Commander。
|
|
323
|
+
- **[GET SHIT DONE](https://github.com/gsd-build/get-shit-done)** by TACHES -- 规格驱动开发模型和上下文工程理念,塑造了 Maestro-Flow 的管线设计。
|
|
324
|
+
- **[Claude-Code-Workflow](https://github.com/catlog22/Claude-Code-Workflow)** -- 前身项目,开创了多 CLI 编排和 skill 路由工作流。
|
|
347
325
|
|
|
348
326
|
## 贡献者
|
|
349
327
|
|
|
@@ -351,7 +329,7 @@ Maestro-Flow 站在两个项目的肩膀上:
|
|
|
351
329
|
<img src="https://github.com/catlog22.png" width="60px" alt="catlog22" style="border-radius:50%"/>
|
|
352
330
|
</a>
|
|
353
331
|
|
|
354
|
-
**[@catlog22](https://github.com/catlog22)**
|
|
332
|
+
**[@catlog22](https://github.com/catlog22)** -- 创建者 & 维护者
|
|
355
333
|
|
|
356
334
|
## 友情链接
|
|
357
335
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{d as Y,r as d,A as B,j as e,F as C,o as xe,W as j,p as pe,V as ue,X as fe,n as X,B as he}from"./index-
|
|
1
|
+
import{d as Y,r as d,A as B,j as e,F as C,o as xe,W as j,p as pe,V as ue,X as fe,n as X,B as he}from"./index-nufWop4p.js";import{C as me}from"./code-BBdC8Wmw.js";import{F as W,a as ge,T as ve}from"./TreeBrowser-g_QUKemL.js";import{S as Q}from"./search-Bq3ygFUW.js";import{u as Z}from"./shallow-22ZN8sFt.js";import{M as be}from"./MarkdownRenderer-BjZ43aSa.js";import{C as ee}from"./chevron-right-CYbpR4ev.js";import{D as te}from"./folder-CqXeSKeC.js";import{C as re}from"./circle-Bm-5Q-Yh.js";import{C as $}from"./circle-check-DEVzW_lm.js";import{A as ye}from"./index-Dru5HYy0.js";import{m as N}from"./proxy-teW12DdZ.js";/**
|
|
2
2
|
* @license lucide-react v0.577.0 - ISC
|
|
3
3
|
*
|
|
4
4
|
* This source code is licensed under the ISC license.
|