maestro-flow-one 0.2.34 → 0.2.35
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/maestro-flow/commands/learn/investigate.md +151 -152
- package/maestro-flow/commands/learn/second-opinion.md +118 -122
- package/maestro-flow/commands/lifecycle/analyze.md +215 -266
- package/maestro-flow/commands/lifecycle/blueprint.md +189 -204
- package/maestro-flow/commands/lifecycle/brainstorm.md +209 -213
- package/maestro-flow/commands/lifecycle/companion.md +531 -531
- package/maestro-flow/commands/lifecycle/composer.md +188 -179
- package/maestro-flow/commands/lifecycle/execute.md +183 -184
- package/maestro-flow/commands/lifecycle/fork.md +111 -110
- package/maestro-flow/commands/lifecycle/grill.md +175 -176
- package/maestro-flow/commands/lifecycle/guard.md +103 -102
- package/maestro-flow/commands/lifecycle/impeccable.md +311 -268
- package/maestro-flow/commands/lifecycle/init.md +130 -131
- package/maestro-flow/commands/lifecycle/merge.md +87 -80
- package/maestro-flow/commands/lifecycle/next.md +253 -257
- package/maestro-flow/commands/lifecycle/overlay.md +188 -178
- package/maestro-flow/commands/lifecycle/plan.md +225 -211
- package/maestro-flow/commands/lifecycle/quick.md +83 -77
- package/maestro-flow/commands/lifecycle/roadmap.md +173 -186
- package/maestro-flow/commands/lifecycle/swarm-workflow.md +243 -264
- package/maestro-flow/commands/lifecycle/tools-execute.md +122 -117
- package/maestro-flow/commands/lifecycle/tools-register.md +162 -157
- package/maestro-flow/commands/lifecycle/ui-codify.md +117 -100
- package/maestro-flow/commands/lifecycle/universal-workflow.md +548 -561
- package/maestro-flow/commands/lifecycle/update.md +122 -119
- package/maestro-flow/commands/manage/codebase-rebuild.md +87 -85
- package/maestro-flow/commands/manage/harvest.md +97 -95
- package/maestro-flow/commands/manage/issue-discover.md +83 -81
- package/maestro-flow/commands/manage/issue.md +72 -73
- package/maestro-flow/commands/manage/kg-extractors.md +128 -0
- package/maestro-flow/commands/manage/knowhow-capture.md +92 -82
- package/maestro-flow/commands/manage/knowhow.md +83 -79
- package/maestro-flow/commands/manage/knowledge-audit.md +105 -88
- package/maestro-flow/commands/manage/status.md +62 -52
- package/maestro-flow/commands/manage/wiki.md +82 -71
- package/maestro-flow/commands/milestone/audit.md +4 -10
- package/maestro-flow/commands/milestone/complete.md +6 -7
- package/maestro-flow/commands/milestone/release.md +136 -145
- package/maestro-flow/commands/quality/auto-test.md +153 -136
- package/maestro-flow/commands/quality/debug.md +159 -120
- package/maestro-flow/commands/quality/refactor.md +105 -67
- package/maestro-flow/commands/quality/retrospective.md +123 -77
- package/maestro-flow/commands/quality/review.md +155 -128
- package/maestro-flow/commands/quality/sync.md +88 -52
- package/maestro-flow/commands/quality/test.md +147 -117
- package/maestro-flow/commands/spec/add.md +77 -70
- package/maestro-flow/commands/spec/setup.md +49 -52
- package/package.json +1 -1
- package/maestro-flow/commands/lifecycle/odyssey-debug.md +0 -473
- package/maestro-flow/commands/lifecycle/odyssey-improve.md +0 -505
- package/maestro-flow/commands/lifecycle/odyssey-planex.md +0 -601
- package/maestro-flow/commands/lifecycle/odyssey-review-test-fix.md +0 -427
- package/maestro-flow/commands/lifecycle/odyssey-ui.md +0 -462
- package/maestro-flow/commands/lifecycle/security-audit.md +0 -179
|
@@ -1,257 +1,253 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: maestro-next
|
|
3
|
-
description: Single-command recommendation — pick the best next command from the pool and execute it
|
|
4
|
-
argument-hint: "<intent> [-y] [--dry-run] [--top N] [--list]"
|
|
5
|
-
allowed-tools:
|
|
6
|
-
- Read
|
|
7
|
-
- Bash
|
|
8
|
-
- Glob
|
|
9
|
-
- Grep
|
|
10
|
-
- Skill
|
|
11
|
-
- AskUserQuestion
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
<purpose>
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
S_PARSE:
|
|
60
|
-
→
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
→
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
→
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
→ S_EXECUTE WHEN:
|
|
78
|
-
→
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
→
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
|
107
|
-
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
|
134
|
-
|
|
135
|
-
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
|
153
|
-
|
|
154
|
-
|
|
|
155
|
-
|
|
|
156
|
-
|
|
|
157
|
-
|
|
|
158
|
-
|
|
|
159
|
-
|
|
|
160
|
-
|
|
|
161
|
-
|
|
|
162
|
-
|
|
|
163
|
-
|
|
|
164
|
-
|
|
|
165
|
-
|
|
|
166
|
-
|
|
|
167
|
-
|
|
|
168
|
-
|
|
|
169
|
-
|
|
|
170
|
-
|
|
|
171
|
-
|
|
|
172
|
-
|
|
|
173
|
-
|
|
|
174
|
-
|
|
|
175
|
-
|
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
|
184
|
-
|
|
185
|
-
|
|
|
186
|
-
|
|
|
187
|
-
|
|
|
188
|
-
|
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
###
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
|
235
|
-
|
|
236
|
-
|
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
- [ ]
|
|
245
|
-
- [ ]
|
|
246
|
-
- [ ]
|
|
247
|
-
- [ ]
|
|
248
|
-
- [ ]
|
|
249
|
-
- [ ]
|
|
250
|
-
- [ ]
|
|
251
|
-
- [ ]
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
- [ ] 不创建 session / 不生成 status.json / 不触发后续 chain
|
|
255
|
-
- [ ] `--list` 模式按 workflow 簇分组展示
|
|
256
|
-
|
|
257
|
-
</appendix>
|
|
1
|
+
---
|
|
2
|
+
name: maestro-next
|
|
3
|
+
description: Single-command recommendation — pick the best next command from the pool and execute it
|
|
4
|
+
argument-hint: "<intent> [-y] [--dry-run] [--top N] [--list]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- Read
|
|
7
|
+
- Bash
|
|
8
|
+
- Glob
|
|
9
|
+
- Grep
|
|
10
|
+
- Skill
|
|
11
|
+
- AskUserQuestion
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
<purpose>
|
|
15
|
+
解析 intent + project state → 路由表评分 → 推荐单个原子命令 → 确认后 `Skill()` 执行。
|
|
16
|
+
不创建 session、不构建 chain、不写 status.json。
|
|
17
|
+
</purpose>
|
|
18
|
+
|
|
19
|
+
<context>
|
|
20
|
+
$ARGUMENTS — 意图文本 + 可选 flags。
|
|
21
|
+
|
|
22
|
+
**Flags:**
|
|
23
|
+
- `-y` / `--yes` — 跳过确认,直接执行 top pick
|
|
24
|
+
- `--dry-run` — 仅显示推荐结果,不执行
|
|
25
|
+
- `--top N` — 显示前 N 个候选(默认 3)
|
|
26
|
+
- `--list` — 仅列出可推荐命令池,不做推荐
|
|
27
|
+
|
|
28
|
+
**候选池:** 仅 A_SCORE_CANDIDATES 路由表中列出的命令。管线编排器(`maestro` / `maestro-ralph*` / `maestro-player` / `maestro-composer`)**永远不在候选池**。
|
|
29
|
+
</context>
|
|
30
|
+
|
|
31
|
+
<invariants>
|
|
32
|
+
1. **不创建 session / 不写 status.json / 不触发后续 chain** — 单次原子执行,产出由目标命令自行管理
|
|
33
|
+
2. **管线编排器不在候选池** — 仅推荐原子命令
|
|
34
|
+
3. **空 intent 或 "继续/下一步/next/接下来"** → 直接采用 lifecycle_position 推断的自然下一步
|
|
35
|
+
4. **字面命中路由表优先** — lifecycle 仅作加分;命中失败时 lifecycle 上升为决定性信号
|
|
36
|
+
5. **参数传递** — 默认 intent 原文作为第一个 arg;用户可在确认环节修改;`-y` 仅当用户传入时透传到 skill args
|
|
37
|
+
6. **`--list` 模式跳过 lifecycle 推断与评分**,仅按 workflow 簇分组列出全部候选
|
|
38
|
+
</invariants>
|
|
39
|
+
|
|
40
|
+
<state_machine>
|
|
41
|
+
|
|
42
|
+
<states>
|
|
43
|
+
S_PARSE — 解析 ARGUMENTS、提取 flags PERSIST: —
|
|
44
|
+
S_STATE — 读 project state、推断 lifecycle_position PERSIST: —
|
|
45
|
+
S_RANK — 路由表评分、生成 top-N candidates PERSIST: —
|
|
46
|
+
S_LIST — `--list` 模式:分组展示候选池 PERSIST: —
|
|
47
|
+
S_PRESENT — 显示 top pick + 备选 + 推荐理由 + 执行参数 PERSIST: —
|
|
48
|
+
S_CONFIRM — AskUserQuestion 选择/修改参数(auto_mode 跳过) PERSIST: —
|
|
49
|
+
S_EXECUTE — `Skill({ skill, args })` 单次调用 PERSIST: —
|
|
50
|
+
S_FALLBACK — intent 空且 clarification 失败 PERSIST: —
|
|
51
|
+
</states>
|
|
52
|
+
|
|
53
|
+
<transitions>
|
|
54
|
+
|
|
55
|
+
S_PARSE:
|
|
56
|
+
→ S_LIST WHEN: --list flag
|
|
57
|
+
→ S_STATE WHEN: intent text present
|
|
58
|
+
→ S_STATE WHEN: keyword "continue"/"next"/"go"/"继续"/"下一步"/"接下来"
|
|
59
|
+
→ S_PARSE WHEN: no intent (max 1 clarify round) DO: AskUserQuestion
|
|
60
|
+
→ S_FALLBACK WHEN: clarification empty
|
|
61
|
+
|
|
62
|
+
S_STATE:
|
|
63
|
+
→ S_RANK DO: A_INFER_LIFECYCLE
|
|
64
|
+
|
|
65
|
+
S_RANK:
|
|
66
|
+
→ S_PRESENT DO: A_SCORE_CANDIDATES
|
|
67
|
+
|
|
68
|
+
S_LIST:
|
|
69
|
+
→ END DO: 按 workflow 簇分组列出全部候选 + description
|
|
70
|
+
|
|
71
|
+
S_PRESENT:
|
|
72
|
+
→ END WHEN: --dry-run
|
|
73
|
+
→ S_EXECUTE WHEN: -y / --yes
|
|
74
|
+
→ S_CONFIRM WHEN: not auto_mode
|
|
75
|
+
|
|
76
|
+
S_CONFIRM:
|
|
77
|
+
→ S_EXECUTE WHEN: 用户确认 top pick / 选备选 / 改参数
|
|
78
|
+
→ END WHEN: 用户取消
|
|
79
|
+
|
|
80
|
+
S_EXECUTE:
|
|
81
|
+
→ END DO: Skill({ skill: <chosen>, args: <args> }) → 输出 "✅ 已执行 /<command>"
|
|
82
|
+
|
|
83
|
+
S_FALLBACK:
|
|
84
|
+
→ END DO: raise E001
|
|
85
|
+
|
|
86
|
+
</transitions>
|
|
87
|
+
|
|
88
|
+
<actions>
|
|
89
|
+
|
|
90
|
+
### A_INFER_LIFECYCLE
|
|
91
|
+
|
|
92
|
+
读 project state 推断 `lifecycle_position`(核心信号):
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
cat .workflow/state.json 2>$null # phase / milestone / artifacts
|
|
96
|
+
ls -la .workflow/scratch/ 2>$null | head -10 # 最近 artifact (mtime DESC)
|
|
97
|
+
ls -la .workflow/.maestro/ 2>$null | head -5 # 进行中的 session
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
**项目状态 → lifecycle_position → 自然下一步:**
|
|
101
|
+
|
|
102
|
+
| 项目状态 | lifecycle_position | 自然下一步 |
|
|
103
|
+
|---------|-------------------|-----------|
|
|
104
|
+
| 无 `.workflow/` + 无源码 | brainstorm | `maestro-brainstorm` |
|
|
105
|
+
| 无 `.workflow/` + 有源码 | init | `maestro-init` |
|
|
106
|
+
| 有 state.json,无 roadmap,无 milestones | analyze-macro | `maestro-analyze` (宏观调研) |
|
|
107
|
+
| 有 macro analyze artifact,无 roadmap | roadmap | `maestro-roadmap` |
|
|
108
|
+
| 有 roadmap,未启动 phase | analyze | `maestro-analyze {phase}` |
|
|
109
|
+
| 最新 artifact = analyze | plan | `maestro-plan {phase}` |
|
|
110
|
+
| 最新 artifact = plan | execute | `maestro-execute {phase}` |
|
|
111
|
+
| 最新 artifact = execute | review | `quality-review {phase}` |
|
|
112
|
+
| review verdict=PASS | test-gen | `quality-auto-test {phase}` |
|
|
113
|
+
| 测试全绿 | milestone-audit | `maestro-milestone-audit` |
|
|
114
|
+
| 当前 milestone 全 phase 完成 | milestone-complete | `maestro-milestone-complete` |
|
|
115
|
+
| 任一 stage 产物含 gaps/failed | debug | `quality-debug {gap}` |
|
|
116
|
+
|
|
117
|
+
**Maestro Lifecycle 主线:**
|
|
118
|
+
```
|
|
119
|
+
brainstorm → blueprint → init → analyze-macro → roadmap
|
|
120
|
+
→ [per phase] analyze → plan → execute (includes verification)
|
|
121
|
+
→ [quality gate] review → auto-test → test
|
|
122
|
+
→ milestone-audit → milestone-complete → milestone-release
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
### A_SCORE_CANDIDATES
|
|
126
|
+
|
|
127
|
+
**评分信号**(高→低):
|
|
128
|
+
|
|
129
|
+
| 信号 | 权重 | 说明 |
|
|
130
|
+
|------|------|------|
|
|
131
|
+
| intent 命中路由表关键词 | 高 | 字面匹配主依据 |
|
|
132
|
+
| **lifecycle 自然下一步** | **高** | 空 intent / "继续" / "next" 时为决定性 |
|
|
133
|
+
| `name` 关键词命中 intent | 中 | intent 含 "test" → quality-test/quality-auto-test 加分 |
|
|
134
|
+
| Workflow 簇匹配 | 中 | intent 涉及学习/知识/issue 等场景触发对应簇 |
|
|
135
|
+
| Recent activity 反向避免 | 低 | 刚完成的 stage 短期内降权 |
|
|
136
|
+
|
|
137
|
+
**特殊意图处理:**
|
|
138
|
+
|
|
139
|
+
| Intent 模式 | top pick |
|
|
140
|
+
|------------|---------|
|
|
141
|
+
| 空 / "继续" / "下一步" / "next" / "接下来" | lifecycle 自然下一步 |
|
|
142
|
+
| "什么状态" / "现在到哪了" / "status" | `manage-status` |
|
|
143
|
+
| 字面命中路由表 | 路由表优先(lifecycle 仅加分) |
|
|
144
|
+
| 无任何匹配 | lifecycle 下一步 + raise W002 |
|
|
145
|
+
|
|
146
|
+
**意图 → 命令路由表**(候选池):
|
|
147
|
+
|
|
148
|
+
| 意图关键词 | 推荐命令 |
|
|
149
|
+
|-----------|---------|
|
|
150
|
+
| 头脑风暴 / 探索 / brainstorm / ideate | `maestro-brainstorm` |
|
|
151
|
+
| 规格 / 正式文档 / spec-generate / blueprint | `maestro-blueprint` |
|
|
152
|
+
| 分析 / analyze / 多维度调研 | `maestro-analyze` |
|
|
153
|
+
| 规划 / plan / 任务分解 | `maestro-plan` |
|
|
154
|
+
| 实现 / 执行 / execute | `maestro-execute` |
|
|
155
|
+
| 验证 / verify / 验收 | `maestro-execute` |
|
|
156
|
+
| 调试 / debug / 排查 / bug | `quality-debug` |
|
|
157
|
+
| 审查 / review / 代码审查 | `quality-review` |
|
|
158
|
+
| 测试 / test / UAT | `quality-test` / `quality-auto-test` |
|
|
159
|
+
| 重构 / refactor / 技术债 | `quality-refactor` |
|
|
160
|
+
| 同步文档 / sync docs | `quality-sync` |
|
|
161
|
+
| 回顾 / retro | `quality-retrospective` |
|
|
162
|
+
| issue / 缺陷管理 | `manage-issue` / `manage-issue-discover` |
|
|
163
|
+
| wiki / 知识图谱 | `manage-wiki` (含 connect/digest 子命令) |
|
|
164
|
+
| spec / 规则 / 约束 | `spec-load` / `spec-add` / `spec-setup` |
|
|
165
|
+
| 项目初始化 / init | `maestro-init` |
|
|
166
|
+
| 状态 / status / 仪表盘 | `manage-status` |
|
|
167
|
+
| 文档重建 / codebase 文档 | `manage-codebase-rebuild` / `quality-sync` |
|
|
168
|
+
| 安全 / security / OWASP | `security-audit` |
|
|
169
|
+
| 跟读 / 学习 / 阅读源码 | `learn-follow` / `learn-investigate` |
|
|
170
|
+
| 第二意见 / challenge / consult | `learn-second-opinion` |
|
|
171
|
+
| 提取知识 / harvest | `manage-harvest` / `manage-knowhow-capture` |
|
|
172
|
+
| 设计 / UI / 前端打磨 | `maestro-impeccable` |
|
|
173
|
+
| 里程碑 / milestone | `maestro-milestone-audit` / `maestro-milestone-release` / `maestro-milestone-complete` |
|
|
174
|
+
| fork / 分支 / 并行开发 | `maestro-fork` / `maestro-merge` |
|
|
175
|
+
| 覆盖层 / overlay / amend | `maestro-overlay` / `maestro-amend` |
|
|
176
|
+
|
|
177
|
+
**辅助 workflow 簇**(场景触发,非主线):
|
|
178
|
+
|
|
179
|
+
| 簇 | 触发 | 主推链路 |
|
|
180
|
+
|----|------|---------|
|
|
181
|
+
| Learning | 接触新代码/未知模块 | `learn-follow` → `learn-decompose` → `learn-second-opinion` |
|
|
182
|
+
| Knowledge | 提炼经验 / 沉淀知识 | `manage-harvest` → `manage-knowhow-capture` → `spec-add` |
|
|
183
|
+
| Wiki | 知识图谱整理 | `manage-wiki health` → `manage-wiki connect` → `manage-wiki digest` |
|
|
184
|
+
| Issue | 缺陷管理 | `manage-issue-discover` → `manage-issue` |
|
|
185
|
+
| 文档同步 | 代码大改后 | `quality-sync` → `manage-codebase-rebuild` (if major) |
|
|
186
|
+
| 重构 | 技术债积累 | `quality-refactor` → `quality-review` |
|
|
187
|
+
| 发布 | 里程碑结束 | `maestro-milestone-audit` → `maestro-milestone-release` |
|
|
188
|
+
| 并行开发 | 多 milestone 并行 | `maestro-fork` → ... → `maestro-merge` |
|
|
189
|
+
|
|
190
|
+
输出 ranked candidates,取 top N(默认 3)。
|
|
191
|
+
|
|
192
|
+
</actions>
|
|
193
|
+
|
|
194
|
+
</state_machine>
|
|
195
|
+
|
|
196
|
+
<presentation>
|
|
197
|
+
|
|
198
|
+
### `--list` 模式
|
|
199
|
+
|
|
200
|
+
按 workflow 簇(主线 / Learning / Knowledge / Wiki / Issue / 文档 / 重构 / 发布 / 并行)分组展示全部候选 + description,结束。
|
|
201
|
+
|
|
202
|
+
### 正常模式
|
|
203
|
+
|
|
204
|
+
```
|
|
205
|
+
🎯 推荐 (top pick): /<command-name>
|
|
206
|
+
<description>
|
|
207
|
+
推荐理由: <命中规则 + lifecycle 位置一句话>
|
|
208
|
+
|
|
209
|
+
备选:
|
|
210
|
+
2. /<alt-1> — <description>
|
|
211
|
+
3. /<alt-2> — <description>
|
|
212
|
+
|
|
213
|
+
执行参数: <args>
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
`--dry-run` 展示后结束;`-y` 直接 S_EXECUTE;否则:
|
|
217
|
+
|
|
218
|
+
AskUserQuestion (single-select, header: "执行确认"):
|
|
219
|
+
- **执行推荐** (Recommended) — run top pick with shown args
|
|
220
|
+
- **选择备选** — pick from alternative commands
|
|
221
|
+
- **修改参数** — adjust args before executing
|
|
222
|
+
- **取消** — do nothing
|
|
223
|
+
|
|
224
|
+
</presentation>
|
|
225
|
+
|
|
226
|
+
<appendix>
|
|
227
|
+
|
|
228
|
+
### Error Codes
|
|
229
|
+
|
|
230
|
+
| Code | Severity | Condition | Recovery |
|
|
231
|
+
|------|----------|-----------|----------|
|
|
232
|
+
| E001 | error | intent 空且 clarification 后仍空 | 提供意图描述或使用 `--list` 浏览 |
|
|
233
|
+
| E002 | error | 候选池为空(`.claude/commands/` 缺失或无 .md) | 检查 commands 目录 |
|
|
234
|
+
| E003 | error | 选定命令名无法解析为有效 skill | 列出有效命令重选 |
|
|
235
|
+
| W001 | warning | top1 与 top2 得分差距 < 阈值 | 强制展示前 3 让用户裁决 |
|
|
236
|
+
| W002 | warning | intent 与所有候选匹配度均低 | 提示考虑 `/maestro` 或 `/maestro-ralph` 走管线 |
|
|
237
|
+
|
|
238
|
+
### Success Criteria
|
|
239
|
+
|
|
240
|
+
- [ ] Intent 解析 + flags 提取完成
|
|
241
|
+
- [ ] 读取 `.workflow/state.json` + scratch artifacts 推断 lifecycle_position
|
|
242
|
+
- [ ] 候选池等于路由表(管线编排器不在)
|
|
243
|
+
- [ ] 评分综合:intent 字面匹配 + lifecycle 下一步 + workflow 簇 + recent activity
|
|
244
|
+
- [ ] 空 intent / "继续" / "下一步" → 直接采用 lifecycle 推断的下一步
|
|
245
|
+
- [ ] top pick 展示附"推荐理由"(命中规则 + lifecycle 位置)
|
|
246
|
+
- [ ] `--dry-run` 仅展示,不执行
|
|
247
|
+
- [ ] `-y` 自动执行 top pick;用户传入时透传到 skill args
|
|
248
|
+
- [ ] 非自动模式通过 AskUserQuestion 确认或选备选
|
|
249
|
+
- [ ] 选定命令通过单次 `Skill()` 调用执行
|
|
250
|
+
- [ ] 不创建 session / 不生成 status.json / 不触发后续 chain
|
|
251
|
+
- [ ] `--list` 模式按 workflow 簇分组展示
|
|
252
|
+
|
|
253
|
+
</appendix>
|