maestro-flow 0.3.6 → 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.
Files changed (106) hide show
  1. package/.claude/commands/learn-retro.md +303 -0
  2. package/.claude/commands/maestro-execute.md +3 -2
  3. package/.claude/commands/maestro-learn.md +74 -298
  4. package/.claude/commands/manage-learn.md +21 -15
  5. package/.claude/commands/manage-memory-capture.md +13 -15
  6. package/.claude/commands/manage-memory.md +1 -1
  7. package/.claude/commands/quality-retrospective.md +5 -5
  8. package/.claude/commands/spec-load.md +7 -2
  9. package/.claude/commands/wiki-digest.md +27 -2
  10. package/README.md +103 -220
  11. package/README.zh-CN.md +159 -181
  12. package/dashboard/dist/assets/{ArtifactsPage-A9yzYtpj.js → ArtifactsPage-BmPOu8sO.js} +1 -1
  13. package/dashboard/dist/assets/{ChatInput-PuCvZZ3y.js → ChatInput-CL8YDfOU.js} +1 -1
  14. package/dashboard/dist/assets/ChatPage-CT-ozBK2.js +8 -0
  15. package/dashboard/dist/assets/{CollabPage-I5k_mCbG.js → CollabPage-C0rWMden.js} +1 -1
  16. package/dashboard/dist/assets/{KanbanPage-PDDBv5-9.js → KanbanPage-C6WbAlwI.js} +1 -1
  17. package/dashboard/dist/assets/{MarkdownRenderer-CCXHaut3.js → MarkdownRenderer-BjZ43aSa.js} +1 -1
  18. package/dashboard/dist/assets/{McpPage-CiqXpCHg.js → McpPage-BPIXADQi.js} +1 -1
  19. package/dashboard/dist/assets/{RequirementBoardPage-CEOvppGn.js → RequirementBoardPage-B7yRL0s_.js} +1 -1
  20. package/dashboard/dist/assets/{RequirementPage-DpnbTEqY.js → RequirementPage-D8J_-b6O.js} +1 -1
  21. package/dashboard/dist/assets/{SpecsPage-CYqOfFkB.js → SpecsPage-6lO8v8_C.js} +1 -1
  22. package/dashboard/dist/assets/{SupervisorPage-B2sZwkq8.js → SupervisorPage-Ds5N378a.js} +1 -1
  23. package/dashboard/dist/assets/{TeamsPage-CkZdCAVZ.js → TeamsPage-DrkKr17T.js} +1 -1
  24. package/dashboard/dist/assets/{TreeBrowser-0VIMWclo.js → TreeBrowser-g_QUKemL.js} +1 -1
  25. package/dashboard/dist/assets/WorkflowPage-X8aNkDEr.js +6 -0
  26. package/dashboard/dist/assets/{arrow-left-6fktHyjN.js → arrow-left-CadP5YgU.js} +1 -1
  27. package/dashboard/dist/assets/{check-Cbxq2l1-.js → check-5xufDzS8.js} +1 -1
  28. package/dashboard/dist/assets/{chevron-right-Yts3bi8p.js → chevron-right-CYbpR4ev.js} +1 -1
  29. package/dashboard/dist/assets/{circle-4Ci4Xolf.js → circle-Bm-5Q-Yh.js} +1 -1
  30. package/dashboard/dist/assets/{circle-alert-B25g9BTL.js → circle-alert-BqcYuT7x.js} +1 -1
  31. package/dashboard/dist/assets/{circle-check-BA5_XqeV.js → circle-check-DEVzW_lm.js} +1 -1
  32. package/dashboard/dist/assets/{circle-check-big-DzO2BlL7.js → circle-check-big-yyzAFysU.js} +1 -1
  33. package/dashboard/dist/assets/{code-zxwuybO8.js → code-BBdC8Wmw.js} +1 -1
  34. package/dashboard/dist/assets/{columns-3-DV4oeCfU.js → columns-3-CQ9Trztr.js} +1 -1
  35. package/dashboard/dist/assets/{download-CXCyQw8M.js → download-DayuF-sn.js} +1 -1
  36. package/dashboard/dist/assets/{folder-Bvjj8Vn9.js → folder-CqXeSKeC.js} +1 -1
  37. package/dashboard/dist/assets/{git-branch-DL8p9kVC.js → git-branch-SqFf4Ru5.js} +1 -1
  38. package/dashboard/dist/assets/{index-BvScJmJM.js → index-Dru5HYy0.js} +1 -1
  39. package/dashboard/dist/assets/{index-11DuhKhc.js → index-nufWop4p.js} +18 -18
  40. package/dashboard/dist/assets/{list-Dj4i9N75.js → list-DBOD6IUt.js} +1 -1
  41. package/dashboard/dist/assets/{minus-DwlFabsT.js → minus-fQI1Syn2.js} +1 -1
  42. package/dashboard/dist/assets/{pen-line-D7UzECt6.js → pen-line-Bkbbngl5.js} +1 -1
  43. package/dashboard/dist/assets/{proxy-B9XRqHD9.js → proxy-teW12DdZ.js} +1 -1
  44. package/dashboard/dist/assets/{search-BQbBTIYl.js → search-Bq3ygFUW.js} +1 -1
  45. package/dashboard/dist/assets/{shallow-Clb1Lyd_.js → shallow-22ZN8sFt.js} +1 -1
  46. package/dashboard/dist/assets/{table-BqxCXid2.js → table-BEYtdWc4.js} +1 -1
  47. package/dashboard/dist/assets/{trash-2-6rN9B-EQ.js → trash-2-DMqGBgcF.js} +1 -1
  48. package/dashboard/dist/assets/{wrench-BScEJFqC.js → wrench-B84-zdLI.js} +1 -1
  49. package/dashboard/dist/assets/{zap-DxUhG-gk.js → zap-9DVkGVtt.js} +1 -1
  50. package/dashboard/dist/index.html +1 -1
  51. package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.d.ts +1 -1
  52. package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.js +5 -4
  53. package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.js.map +1 -1
  54. package/dashboard/dist-server/dashboard/src/server/agents/codex-cli-adapter.js +1 -1
  55. package/dashboard/dist-server/dashboard/src/server/agents/codex-cli-adapter.js.map +1 -1
  56. package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.d.ts +1 -1
  57. package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.js +3 -4
  58. package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.js.map +1 -1
  59. package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.test.js +4 -4
  60. package/dashboard/dist-server/dashboard/src/server/agents/tools/issue-mcp-server.test.js.map +1 -1
  61. package/dashboard/dist-server/dashboard/src/server/commander/commander-agent.js +4 -3
  62. package/dashboard/dist-server/dashboard/src/server/commander/commander-agent.js.map +1 -1
  63. package/dashboard/dist-server/dashboard/src/server/commander/commander-agent.test.js +20 -7
  64. package/dashboard/dist-server/dashboard/src/server/commander/commander-agent.test.js.map +1 -1
  65. package/dashboard/dist-server/dashboard/src/server/execution/wave-executor.d.ts +1 -1
  66. package/dashboard/dist-server/dashboard/src/server/execution/wave-executor.js +4 -4
  67. package/dashboard/dist-server/dashboard/src/server/execution/wave-executor.js.map +1 -1
  68. package/dashboard/dist-server/dashboard/src/server/index.js +2 -1
  69. package/dashboard/dist-server/dashboard/src/server/index.js.map +1 -1
  70. package/dashboard/dist-server/dashboard/src/server/routes/issues.js +14 -14
  71. package/dashboard/dist-server/dashboard/src/server/routes/issues.js.map +1 -1
  72. package/dashboard/dist-server/dashboard/src/server/routes/linear.js +7 -5
  73. package/dashboard/dist-server/dashboard/src/server/routes/linear.js.map +1 -1
  74. package/dashboard/dist-server/dashboard/src/server/state/state-manager.js +144 -23
  75. package/dashboard/dist-server/dashboard/src/server/state/state-manager.js.map +1 -1
  76. package/dashboard/dist-server/dashboard/src/server/utils/issue-store.d.ts +6 -0
  77. package/dashboard/dist-server/dashboard/src/server/utils/issue-store.js +24 -2
  78. package/dashboard/dist-server/dashboard/src/server/utils/issue-store.js.map +1 -1
  79. package/dashboard/dist-server/dashboard/src/server/ws/handlers/execution-handler.js +4 -7
  80. package/dashboard/dist-server/dashboard/src/server/ws/handlers/execution-handler.js.map +1 -1
  81. package/dashboard/dist-server/dashboard/src/shared/constants.js +2 -1
  82. package/dashboard/dist-server/dashboard/src/shared/constants.js.map +1 -1
  83. package/dashboard/dist-server/dashboard/src/shared/constants.test.js +5 -5
  84. package/dashboard/dist-server/dashboard/src/shared/constants.test.js.map +1 -1
  85. package/dashboard/dist-server/dashboard/src/shared/issue-types.test.js +4 -4
  86. package/dashboard/dist-server/dashboard/src/shared/issue-types.test.js.map +1 -1
  87. package/dashboard/dist-server/src/commands/delegate.js +7 -1
  88. package/dashboard/dist-server/src/commands/delegate.js.map +1 -1
  89. package/dist/src/commands/delegate.d.ts.map +1 -1
  90. package/dist/src/commands/delegate.js +7 -1
  91. package/dist/src/commands/delegate.js.map +1 -1
  92. package/package.json +1 -1
  93. package/workflows/delegate-usage.md +39 -41
  94. package/workflows/execute.md +154 -34
  95. package/workflows/init.md +1 -1
  96. package/workflows/maestro-coordinate.codex.md +1 -1
  97. package/workflows/maestro-coordinate.md +1 -1
  98. package/workflows/maestro.md +2 -2
  99. package/workflows/memory.md +2 -1
  100. package/workflows/plan.md +9 -2
  101. package/workflows/retrospective.md +2 -2
  102. package/workflows/roadmap.md +1 -1
  103. package/.claude/commands/learn-retro-decision.md +0 -198
  104. package/.claude/commands/learn-retro-git.md +0 -160
  105. package/dashboard/dist/assets/ChatPage-v19GURYH.js +0 -8
  106. 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
- ### 面向 Claude Code & Codex 的多智能体工作流编排
5
+ ### 多智能体时代的编排层
6
6
 
7
- **一条命令,多个 AI 智能体,结构化交付。**
7
+ **不仅是执行,更是编排。**
8
8
 
9
9
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
10
10
  [![Node.js](https://img.shields.io/badge/Node.js-≥18-339933?logo=node.js&logoColor=white)](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
- # 自然语言 —— Maestro-Flow 路由到最优命令链
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 plan execute | 快速修复、小功能 |
86
- | Scratch 模式 | `analyze -q` `plan --dir` `execute --dir` | 不需要 roadmap,直接干 |
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
- - **选个智能体,点播放** 在 Issue 卡片上选 Claude / Codex / Gemini,点执行
107
- - **批量派发** — 多选 Issue,并行发送给智能体
108
- - **看智能体工作** — 实时 CLI 输出流式面板
109
- - **Issue 全生命周期** — 创建、分析、规划、执行、关闭 —— 全在看板上
110
- - **Linear 同步** — 导入/导出 Issue 到 Linear,支持团队协作
72
+ 51 个斜杠命令覆盖 6 大类别,驱动从项目初始化到质量复盘的每一个环节。
111
73
 
112
- ### Commander Agent
74
+ ### 2. 自主驾驶
113
75
 
114
- 自主监督者。后台运行 tick 循环:
76
+ **Commander Agent** -- 后台运行的自主监督者:
115
77
 
116
78
  ```
117
- 评估(assess) 决策(decide) 派发(dispatch) 等待 评估 ...
79
+ 评估(assess) -> 决策(decide) -> 派发(dispatch) -> 等待 -> 评估 -> ...
118
80
  ```
119
81
 
120
- 它读取项目状态(阶段、任务、Issue、智能体工位),判断什么需要处理,自动派发智能体。三档配置:`conservative`、`balanced`、`aggressive`。
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 视角扫描:Bug、UX、技术债、安全、性能、测试缺口、代码质量、文档 |
142
- | **分析** | `/manage-issue-analyze` | CLI 探索式根因分析,将结构化 `analysis` 写入 Issue |
143
- | **规划** | `/manage-issue-plan` | 生成解决方案步骤 —— 目标文件、代码变更、验证条件 |
144
- | **执行** | `/manage-issue-execute` | 双模式:服务器在线走 Dashboard API 派发,离线走 CLI 直接执行 |
145
- | **关闭** | 自动 | 验证通过 `resolved` `closed` |
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
- ### Issue 如何连接主干管线
102
+ 质量命令(`review`、`test`、`verify`)自动为发现的问题创建 Issue。Issue 修复的代码回流到阶段管线。闭环自动关闭。
148
103
 
149
- ```mermaid
150
- graph TB
151
- subgraph 阶段管线
152
- EX[execute] --> VE[verify]
153
- VE --> RE[review]
154
- RE --> TE[test]
155
- end
156
- subgraph Issue 闭环
157
- DI[discover] --> AN[analyze]
158
- AN --> PL[plan]
159
- PL --> IX[execute]
160
- end
161
- RE -->|critical/high 发现| DI
162
- TE -->|测试失败| DI
163
- VE -->|验证缺口| DI
164
- IX -->|修复代码回流| EX
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
- 质量命令(`review`、`test`、`verify`)自动为发现的问题创建 Issue。Issue 修复的代码回流到阶段。闭环自动关闭。
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 不挑一个 AI —— 它让它们一起干:
141
+ Maestro-Flow 协调多个 AI 智能体并行工作:
174
142
 
175
143
  ```
176
- ┌────────────────────────────────┐
177
- ExecutionScheduler
178
- │ (波次并行执行引擎) │
179
- └───────────┬────────────────────┘
180
-
181
- ┌──────────────┼──────────────┐
182
-
183
- ┌─────┴─────┐ ┌─────┴──────┐ ┌────┴──────┐
184
- Claude Codex Gemini
185
- Agent SDK CLI CLI
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** 原生 Claude Agent SDK 驱动 Claude Code 进程
191
- - **CLI 适配器** Codex、Gemini、Qwen、OpenCode 全部通过 `maestro 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
- ## 命令 Overlay 系统
164
+ 9 个上下文感知 Hook,3 级安装:
197
165
 
198
- 非侵入式地为 `.claude/commands/*.md` 文件打补丁 —— 增加步骤、阅读要求、质量门禁 —— 无需编辑原始文件。Overlay 在 `maestro install` 升级后自动重新应用。
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
- /maestro-overlay "在 maestro-execute 执行后增加 CLI 验证"
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 overlay add my-overlay.json # 安装 + 应用
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
- ## 36 个命令,21 个 Agent
198
+ ## 51 个命令,21 个 Agent
218
199
 
219
- ### 命令(Claude Code 斜杠命令)
200
+ ### 命令
220
201
 
221
- | 类别 | 数量 | 用途 |
222
- |------|------|------|
223
- | `maestro-*` | 15 | 全生命周期 init、brainstorm、roadmap、analyze、plan、execute、verify、phase-transition |
224
- | `manage-*` | 9 | Issue CRUD、发现、分析、规划、执行、代码库文档、记忆管理 |
225
- | `quality-*` | 7 | review、test、debug、test-gen、integration-test、refactor、sync |
226
- | `spec-*` | 4 | 规格说明 setup、add、load、map |
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 定义 —— 每个是聚焦的 Markdown 文件,Claude Code 按需加载。包括 `workflow-planner`、`workflow-executor`、`issue-discover-agent`、`workflow-debugger`、`workflow-verifier`、`team-worker` 等。
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
- - (可选)Codex CLI、Gemini CLI 用于多智能体工作流
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
- 将 Maestro-Flow 工具暴露给 Claude Desktop 和其他 MCP 客户端:
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
- npm run mcp # stdio 传输
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
- ├── bin/ # CLI 入口
296
- ├── src/ # 核心 CLICommander.js + MCP SDK
297
- ├── commands/ # 11 个 CLI 命令(serve, run, cli, ext, tool, ...)
298
- ├── mcp/ # MCP 服务器(stdio 传输)
299
- └── core/ # 工具注册、扩展加载器
300
- ├── dashboard/ # 实时 Web 仪表盘
301
- └── src/
302
- ├── client/ # React 19 + Zustand + Tailwind CSS 4
303
- │ └── components/
304
- │ └── kanban/ # 19 个看板组件
305
- ├── server/ # Hono API + WebSocket + SSE
306
- ├── agents/ # AgentManager + 适配器(Claude SDK, Codex CLI, OpenCode)
307
- │ ├── commander/ # 自主 Commander Agent
308
- │ │ └── execution/ # ExecutionScheduler + WaveExecutor
309
- │ └── shared/ # 共享类型
310
- ├── .claude/
311
- │ ├── commands/ # 36 个斜杠命令(.md
312
- │ └── agents/ # 21 Agent 定义(.md)
313
- ├── workflows/ # 36 个工作流实现(.md)
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/sdkstdio |
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)** 全部 36 个命令,含工作流图表、管线衔接、Issue 闭环、快速通道
334
- - **[Delegate 异步执行指南](guide/delegate-async-guide.md)** 异步任务委派:CLI & MCP 用法、消息注入、链式调用、Broker 生命周期、delegate vs cli 对比
335
- - **[Overlay 系统指南](guide/overlay-guide.md)** 非侵入式命令扩展:overlay 格式、section 注入、bundle 打包/导入、交互式 TUI 管理
336
- - **[Team Lite — 使用指南](guide/team-lite-guide.md)** 2-8 人小团队日常协作:加入、同步、队友活跃、冲突预飞检
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-11DuhKhc.js";import{C as me}from"./code-zxwuybO8.js";import{F as W,a as ge,T as ve}from"./TreeBrowser-0VIMWclo.js";import{S as Q}from"./search-BQbBTIYl.js";import{u as Z}from"./shallow-Clb1Lyd_.js";import{M as be}from"./MarkdownRenderer-CCXHaut3.js";import{C as ee}from"./chevron-right-Yts3bi8p.js";import{D as te}from"./folder-Bvjj8Vn9.js";import{C as re}from"./circle-4Ci4Xolf.js";import{C as $}from"./circle-check-BA5_XqeV.js";import{A as ye}from"./index-BvScJmJM.js";import{m as N}from"./proxy-B9XRqHD9.js";/**
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.