maestro-flow 0.5.3 → 0.5.31

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 (259) hide show
  1. package/.agents/skills/learn-follow/SKILL.md +114 -114
  2. package/.agents/skills/learn-investigate/SKILL.md +138 -139
  3. package/.agents/skills/learn-second-opinion/SKILL.md +105 -109
  4. package/.agents/skills/maestro/SKILL.md +2 -10
  5. package/.agents/skills/maestro-amend/SKILL.md +152 -152
  6. package/.agents/skills/maestro-analyze/SKILL.md +201 -252
  7. package/.agents/skills/maestro-blueprint/SKILL.md +175 -190
  8. package/.agents/skills/maestro-brainstorm/SKILL.md +196 -200
  9. package/.agents/skills/maestro-collab/SKILL.md +159 -159
  10. package/.agents/skills/maestro-companion/SKILL.md +517 -517
  11. package/.agents/skills/maestro-composer/SKILL.md +173 -164
  12. package/.agents/skills/maestro-execute/SKILL.md +169 -170
  13. package/.agents/skills/maestro-fork/SKILL.md +97 -96
  14. package/.agents/skills/maestro-grill/SKILL.md +161 -162
  15. package/.agents/skills/maestro-guard/SKILL.md +93 -92
  16. package/.agents/skills/maestro-impeccable/SKILL.md +296 -253
  17. package/.agents/skills/maestro-init/SKILL.md +117 -118
  18. package/.agents/skills/maestro-merge/SKILL.md +73 -66
  19. package/.agents/skills/maestro-milestone-audit/SKILL.md +4 -10
  20. package/.agents/skills/maestro-milestone-complete/SKILL.md +6 -7
  21. package/.agents/skills/maestro-milestone-release/SKILL.md +122 -131
  22. package/.agents/skills/maestro-next/SKILL.md +241 -245
  23. package/.agents/skills/maestro-overlay/SKILL.md +176 -166
  24. package/.agents/skills/maestro-plan/SKILL.md +211 -197
  25. package/.agents/skills/maestro-player/SKILL.md +167 -167
  26. package/.agents/skills/maestro-quick/SKILL.md +69 -63
  27. package/.agents/skills/maestro-ralph/SKILL.md +2 -36
  28. package/.agents/skills/maestro-ralph-beta/SKILL.md +861 -872
  29. package/.agents/skills/maestro-ralph-execute/SKILL.md +234 -234
  30. package/.agents/skills/maestro-roadmap/SKILL.md +159 -172
  31. package/.agents/skills/maestro-swarm-workflow/SKILL.md +229 -250
  32. package/.agents/skills/maestro-tools-execute/SKILL.md +108 -103
  33. package/.agents/skills/maestro-tools-register/SKILL.md +148 -143
  34. package/.agents/skills/maestro-ui-codify/SKILL.md +103 -86
  35. package/.agents/skills/maestro-universal-workflow/SKILL.md +534 -547
  36. package/.agents/skills/maestro-update/SKILL.md +109 -106
  37. package/.agents/skills/manage-codebase-rebuild/SKILL.md +73 -71
  38. package/.agents/skills/manage-harvest/SKILL.md +83 -81
  39. package/.agents/skills/manage-issue/SKILL.md +59 -60
  40. package/.agents/skills/manage-issue-discover/SKILL.md +70 -68
  41. package/.agents/skills/manage-kg-extractors/SKILL.md +130 -0
  42. package/.agents/skills/manage-knowhow/SKILL.md +70 -66
  43. package/.agents/skills/manage-knowhow-capture/SKILL.md +79 -69
  44. package/.agents/skills/manage-knowledge-audit/SKILL.md +91 -74
  45. package/.agents/skills/manage-status/SKILL.md +52 -42
  46. package/.agents/skills/manage-wiki/SKILL.md +69 -58
  47. package/.agents/skills/odyssey-debug/SKILL.md +445 -459
  48. package/.agents/skills/odyssey-improve/SKILL.md +477 -491
  49. package/.agents/skills/odyssey-planex/SKILL.md +576 -587
  50. package/.agents/skills/odyssey-review-test-fix/SKILL.md +400 -413
  51. package/.agents/skills/odyssey-ui/SKILL.md +431 -448
  52. package/.agents/skills/quality-auto-test/SKILL.md +140 -123
  53. package/.agents/skills/quality-debug/SKILL.md +145 -106
  54. package/.agents/skills/quality-refactor/SKILL.md +91 -53
  55. package/.agents/skills/quality-retrospective/SKILL.md +109 -63
  56. package/.agents/skills/quality-review/SKILL.md +141 -114
  57. package/.agents/skills/quality-sync/SKILL.md +74 -38
  58. package/.agents/skills/quality-test/SKILL.md +133 -103
  59. package/.agents/skills/security-audit/SKILL.md +217 -166
  60. package/.agents/skills/spec-add/SKILL.md +66 -59
  61. package/.agents/skills/spec-load/SKILL.md +68 -68
  62. package/.agents/skills/spec-remove/SKILL.md +42 -42
  63. package/.agents/skills/spec-setup/SKILL.md +38 -41
  64. package/.agy/skills/learn-follow/SKILL.md +114 -114
  65. package/.agy/skills/learn-investigate/SKILL.md +138 -139
  66. package/.agy/skills/learn-second-opinion/SKILL.md +105 -109
  67. package/.agy/skills/maestro/SKILL.md +2 -10
  68. package/.agy/skills/maestro-amend/SKILL.md +152 -152
  69. package/.agy/skills/maestro-analyze/SKILL.md +201 -252
  70. package/.agy/skills/maestro-blueprint/SKILL.md +175 -190
  71. package/.agy/skills/maestro-brainstorm/SKILL.md +196 -200
  72. package/.agy/skills/maestro-collab/SKILL.md +159 -159
  73. package/.agy/skills/maestro-companion/SKILL.md +517 -517
  74. package/.agy/skills/maestro-composer/SKILL.md +173 -164
  75. package/.agy/skills/maestro-execute/SKILL.md +169 -170
  76. package/.agy/skills/maestro-fork/SKILL.md +97 -96
  77. package/.agy/skills/maestro-grill/SKILL.md +161 -162
  78. package/.agy/skills/maestro-guard/SKILL.md +93 -92
  79. package/.agy/skills/maestro-impeccable/SKILL.md +296 -253
  80. package/.agy/skills/maestro-init/SKILL.md +117 -118
  81. package/.agy/skills/maestro-merge/SKILL.md +73 -66
  82. package/.agy/skills/maestro-milestone-audit/SKILL.md +4 -10
  83. package/.agy/skills/maestro-milestone-complete/SKILL.md +6 -7
  84. package/.agy/skills/maestro-milestone-release/SKILL.md +122 -131
  85. package/.agy/skills/maestro-next/SKILL.md +241 -245
  86. package/.agy/skills/maestro-overlay/SKILL.md +176 -166
  87. package/.agy/skills/maestro-plan/SKILL.md +211 -197
  88. package/.agy/skills/maestro-player/SKILL.md +167 -167
  89. package/.agy/skills/maestro-quick/SKILL.md +69 -63
  90. package/.agy/skills/maestro-ralph/SKILL.md +2 -36
  91. package/.agy/skills/maestro-ralph-beta/SKILL.md +861 -872
  92. package/.agy/skills/maestro-ralph-execute/SKILL.md +234 -234
  93. package/.agy/skills/maestro-roadmap/SKILL.md +159 -172
  94. package/.agy/skills/maestro-swarm-workflow/SKILL.md +229 -250
  95. package/.agy/skills/maestro-tools-execute/SKILL.md +108 -103
  96. package/.agy/skills/maestro-tools-register/SKILL.md +148 -143
  97. package/.agy/skills/maestro-ui-codify/SKILL.md +103 -86
  98. package/.agy/skills/maestro-universal-workflow/SKILL.md +534 -547
  99. package/.agy/skills/maestro-update/SKILL.md +109 -106
  100. package/.agy/skills/manage-codebase-rebuild/SKILL.md +73 -71
  101. package/.agy/skills/manage-harvest/SKILL.md +83 -81
  102. package/.agy/skills/manage-issue/SKILL.md +59 -60
  103. package/.agy/skills/manage-issue-discover/SKILL.md +70 -68
  104. package/.agy/skills/manage-kg-extractors/SKILL.md +130 -0
  105. package/.agy/skills/manage-knowhow/SKILL.md +70 -66
  106. package/.agy/skills/manage-knowhow-capture/SKILL.md +79 -69
  107. package/.agy/skills/manage-knowledge-audit/SKILL.md +91 -74
  108. package/.agy/skills/manage-status/SKILL.md +52 -42
  109. package/.agy/skills/manage-wiki/SKILL.md +69 -58
  110. package/.agy/skills/odyssey-debug/SKILL.md +445 -459
  111. package/.agy/skills/odyssey-improve/SKILL.md +477 -491
  112. package/.agy/skills/odyssey-planex/SKILL.md +576 -587
  113. package/.agy/skills/odyssey-review-test-fix/SKILL.md +400 -413
  114. package/.agy/skills/odyssey-ui/SKILL.md +431 -448
  115. package/.agy/skills/quality-auto-test/SKILL.md +140 -123
  116. package/.agy/skills/quality-debug/SKILL.md +145 -106
  117. package/.agy/skills/quality-refactor/SKILL.md +91 -53
  118. package/.agy/skills/quality-retrospective/SKILL.md +109 -63
  119. package/.agy/skills/quality-review/SKILL.md +141 -114
  120. package/.agy/skills/quality-sync/SKILL.md +74 -38
  121. package/.agy/skills/quality-test/SKILL.md +133 -103
  122. package/.agy/skills/security-audit/SKILL.md +217 -166
  123. package/.agy/skills/spec-add/SKILL.md +66 -59
  124. package/.agy/skills/spec-load/SKILL.md +68 -68
  125. package/.agy/skills/spec-remove/SKILL.md +42 -42
  126. package/.agy/skills/spec-setup/SKILL.md +38 -41
  127. package/.claude/commands/learn-follow.md +127 -127
  128. package/.claude/commands/learn-investigate.md +151 -152
  129. package/.claude/commands/learn-second-opinion.md +118 -122
  130. package/.claude/commands/maestro-amend.md +164 -164
  131. package/.claude/commands/maestro-analyze.md +215 -266
  132. package/.claude/commands/maestro-blueprint.md +189 -204
  133. package/.claude/commands/maestro-brainstorm.md +209 -213
  134. package/.claude/commands/maestro-collab.md +172 -172
  135. package/.claude/commands/maestro-companion.md +531 -531
  136. package/.claude/commands/maestro-composer.md +188 -179
  137. package/.claude/commands/maestro-execute.md +183 -184
  138. package/.claude/commands/maestro-fork.md +111 -110
  139. package/.claude/commands/maestro-grill.md +175 -176
  140. package/.claude/commands/maestro-guard.md +103 -102
  141. package/.claude/commands/maestro-impeccable.md +311 -268
  142. package/.claude/commands/maestro-init.md +130 -131
  143. package/.claude/commands/maestro-merge.md +87 -80
  144. package/.claude/commands/maestro-milestone-audit.md +4 -10
  145. package/.claude/commands/maestro-milestone-complete.md +6 -7
  146. package/.claude/commands/maestro-milestone-release.md +136 -145
  147. package/.claude/commands/maestro-next.md +253 -257
  148. package/.claude/commands/maestro-overlay.md +188 -178
  149. package/.claude/commands/maestro-plan.md +225 -211
  150. package/.claude/commands/maestro-player.md +182 -182
  151. package/.claude/commands/maestro-quick.md +83 -77
  152. package/.claude/commands/maestro-ralph-beta.md +875 -886
  153. package/.claude/commands/maestro-ralph-execute.md +247 -247
  154. package/.claude/commands/maestro-ralph.md +2 -36
  155. package/.claude/commands/maestro-roadmap.md +173 -186
  156. package/.claude/commands/maestro-swarm-workflow.md +243 -264
  157. package/.claude/commands/maestro-tools-execute.md +122 -117
  158. package/.claude/commands/maestro-tools-register.md +162 -157
  159. package/.claude/commands/maestro-ui-codify.md +117 -100
  160. package/.claude/commands/maestro-universal-workflow.md +548 -561
  161. package/.claude/commands/maestro-update.md +122 -119
  162. package/.claude/commands/maestro.md +2 -10
  163. package/.claude/commands/manage-codebase-rebuild.md +87 -85
  164. package/.claude/commands/manage-harvest.md +97 -95
  165. package/.claude/commands/manage-issue-discover.md +83 -81
  166. package/.claude/commands/manage-issue.md +72 -73
  167. package/.claude/commands/manage-kg-extractors.md +128 -0
  168. package/.claude/commands/manage-knowhow-capture.md +92 -82
  169. package/.claude/commands/manage-knowhow.md +83 -79
  170. package/.claude/commands/manage-knowledge-audit.md +105 -88
  171. package/.claude/commands/manage-status.md +62 -52
  172. package/.claude/commands/manage-wiki.md +82 -71
  173. package/.claude/commands/odyssey-debug.md +459 -473
  174. package/.claude/commands/odyssey-improve.md +491 -505
  175. package/.claude/commands/odyssey-planex.md +590 -601
  176. package/.claude/commands/odyssey-review-test-fix.md +414 -427
  177. package/.claude/commands/odyssey-ui.md +445 -462
  178. package/.claude/commands/quality-auto-test.md +153 -136
  179. package/.claude/commands/quality-debug.md +159 -120
  180. package/.claude/commands/quality-refactor.md +105 -67
  181. package/.claude/commands/quality-retrospective.md +123 -77
  182. package/.claude/commands/quality-review.md +155 -128
  183. package/.claude/commands/quality-sync.md +88 -52
  184. package/.claude/commands/quality-test.md +147 -117
  185. package/.claude/commands/security-audit.md +230 -179
  186. package/.claude/commands/spec-add.md +77 -70
  187. package/.claude/commands/spec-load.md +78 -78
  188. package/.claude/commands/spec-remove.md +55 -55
  189. package/.claude/commands/spec-setup.md +49 -52
  190. package/dist/src/cli.js +1 -1
  191. package/dist/src/cli.js.map +1 -1
  192. package/dist/src/commands/kg.d.ts.map +1 -1
  193. package/dist/src/commands/kg.js +11 -5
  194. package/dist/src/commands/kg.js.map +1 -1
  195. package/dist/src/graph/kg/extraction/code/code-extractor.d.ts +2 -0
  196. package/dist/src/graph/kg/extraction/code/code-extractor.d.ts.map +1 -1
  197. package/dist/src/graph/kg/extraction/code/code-extractor.js +32 -3
  198. package/dist/src/graph/kg/extraction/code/code-extractor.js.map +1 -1
  199. package/dist/src/graph/kg/extraction/code/plugin-engine.d.ts +35 -0
  200. package/dist/src/graph/kg/extraction/code/plugin-engine.d.ts.map +1 -0
  201. package/dist/src/graph/kg/extraction/code/plugin-engine.js +573 -0
  202. package/dist/src/graph/kg/extraction/code/plugin-engine.js.map +1 -0
  203. package/dist/src/graph/kg/extraction/code/plugin-types.d.ts +95 -0
  204. package/dist/src/graph/kg/extraction/code/plugin-types.d.ts.map +1 -0
  205. package/dist/src/graph/kg/extraction/code/plugin-types.js +5 -0
  206. package/dist/src/graph/kg/extraction/code/plugin-types.js.map +1 -0
  207. package/dist/src/graph/kg/extraction/orchestrator.d.ts.map +1 -1
  208. package/dist/src/graph/kg/extraction/orchestrator.js +17 -5
  209. package/dist/src/graph/kg/extraction/orchestrator.js.map +1 -1
  210. package/dist/src/graph/kg/schema.sql +16 -11
  211. package/dist/src/graph/kg/surface/cli.d.ts.map +1 -1
  212. package/dist/src/graph/kg/surface/cli.js +153 -56
  213. package/dist/src/graph/kg/surface/cli.js.map +1 -1
  214. package/dist/src/hooks/workspace.d.ts +4 -2
  215. package/dist/src/hooks/workspace.d.ts.map +1 -1
  216. package/dist/src/hooks/workspace.js +6 -2
  217. package/dist/src/hooks/workspace.js.map +1 -1
  218. package/package.json +91 -91
  219. package/workflows/analyze.md +25 -49
  220. package/workflows/auto-test.md +699 -699
  221. package/workflows/blueprint.md +403 -431
  222. package/workflows/brainstorm.md +54 -195
  223. package/workflows/business-test.md +570 -570
  224. package/workflows/claude-instructions.md +23 -51
  225. package/workflows/codex-instructions.md +27 -77
  226. package/workflows/coding-philosophy.md +69 -69
  227. package/workflows/command-authoring.md +823 -823
  228. package/workflows/debug.md +43 -98
  229. package/workflows/delegate-usage.md +39 -241
  230. package/workflows/execute.md +4 -53
  231. package/workflows/grill.md +12 -56
  232. package/workflows/harvest.md +22 -68
  233. package/workflows/init.md +148 -148
  234. package/workflows/instruction-authoring-guide.md +97 -0
  235. package/workflows/issue-execute.md +110 -110
  236. package/workflows/issue-gaps-analyze.codex.md +260 -260
  237. package/workflows/issue-gaps-analyze.md +216 -216
  238. package/workflows/issue-plan.md +110 -110
  239. package/workflows/issue.md +338 -346
  240. package/workflows/knowhow.md +0 -32
  241. package/workflows/learn.md +277 -277
  242. package/workflows/maestro-chain-execute.md +20 -20
  243. package/workflows/refactor.md +22 -44
  244. package/workflows/retrospective.md +16 -65
  245. package/workflows/review.md +446 -486
  246. package/workflows/roadmap.md +35 -132
  247. package/workflows/skill-authoring.md +265 -265
  248. package/workflows/spec-generate.md +470 -470
  249. package/workflows/specs-remove.md +104 -104
  250. package/workflows/sync.md +11 -41
  251. package/workflows/test-gen.md +226 -226
  252. package/workflows/test.md +385 -475
  253. package/workflows/ui-design.md +391 -391
  254. package/workflows/ui-style.md +199 -199
  255. package/workflows/wiki-connect.md +151 -151
  256. package/workflows/wiki-digest.md +178 -178
  257. package/workflows/wiki-manage.md +109 -109
  258. package/workflows/cli-tools-usage.md +0 -252
  259. package/workflows/delegate-protocol.codex.md +0 -65
@@ -1,264 +1,243 @@
1
- ---
2
- name: maestro-swarm-workflow
3
- description: Parallel workflow accelerator — route intent to fixed Workflow scripts for multi-agent concurrent execution
4
- argument-hint: "<intent> [--script <name>] [--dims <d1,d2>] [--roles <r1,r2>] [--count N] [--tier quick|standard] [--resume <runId>]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Edit
9
- - Bash
10
- - Glob
11
- - Grep
12
- - Workflow
13
- - AskUserQuestion
14
- ---
15
- <purpose>
16
- Parallel accelerator layer for maestro commands. Routes user intent to pre-built Workflow scripts
17
- that leverage `parallel()` / `pipeline()` for multi-agent concurrent execution.
18
-
19
- Complements maestro-ralph (sequential decision chain) — ralph manages state + decisions,
20
- swarm-workflow provides parallel compute bursts within individual steps.
21
-
22
- Scripts: `~/.maestro/workflows/swarm/wf-*.js`
23
-
24
- | Script | Accelerates | Adversarial Pattern |
25
- |--------|-------------|---------------------|
26
- | `wf-analyze` | maestro-analyze | explore → 6-dim scoring → **skeptic cross-verify** → **3-way advocacy (go/no-go/conditional) + referee** |
27
- | `wf-brainstorm` | maestro-brainstorm | multi-role analysis → **3-specialist cross-review** → **3-proposal competition** → **arbitrator** |
28
- | `wf-review` | quality-review | 6-dim scan **3-vote adversarial verify (prosecutor/defense/judge)** → **3-perspective report + arbitrated verdict** |
29
- | `wf-verify` | maestro-execute (verification gate) | 3-layer + antipattern + convergence **prosecutor vs defender debate** → **judge verdict** |
30
- | `wf-grill` | maestro-grill | explore parallel branch stress → **meta-skeptic challenge** → **3-vote verdict (optimist/pessimist/realist)** |
31
- | `wf-plan` | maestro-plan | parallel context **3-strategy competing proposals** → **judge panel scoring** → **3-critic adversarial check** |
32
- | `wf-execute` | maestro-execute | wave-based parallel execution → **adversarial convergence spot-check** → **3-vote status determination** |
33
- | `wf-milestone-audit` | maestro-milestone-audit | parallel 3-dim audit → **adversarial dimension challenge** → **3-vote verdict (strict/lenient/objective)** |
34
-
35
- Integration modes:
36
- - **Standalone**: `/maestro-swarm-workflow "analyze auth module"` — direct invocation
37
- - **Ralph step**: ralph chain 中某个 step 可指定 `swarm-workflow` 作为加速执行器
38
- - **Chained**: 输出 JSON 可被下游命令通过 `--from` 消费
39
- </purpose>
40
-
41
- <context>
42
- $ARGUMENTS intent text with optional flags.
43
-
44
- **Parse:**
45
- ```
46
- --script <name> → 强制指定脚本(wf-analyze, wf-brainstorm, wf-review, wf-verify)
47
- --dims <d1,d2> → 限定分析维度(analyze: architecture,complexity,patterns,risk,testability,performance)
48
- --roles <r1,r2> → 限定角色(brainstorm: system-architect,product-manager,test-strategist,ux-expert,security-analyst,data-architect)
49
- --count N → 角色数量(brainstorm 默认 3)
50
- --tier <level> → review 层级(quick=2 维度, standard=4 维度)
51
- --resume <runId> → 从之前的 workflow 运行恢复(增量重跑)
52
- Remaining intent
53
- ```
54
-
55
- **Script inventory** (`~/.maestro/workflows/swarm/`):
56
-
57
- | Script | args 接口 |
58
- |--------|-----------|
59
- | `wf-analyze` | `{ target, scope, context, phase?, dimensions? }` |
60
- | `wf-brainstorm` | `{ topic, context, count?, roles? }` |
61
- | `wf-review` | `{ target, scope, specs?, tier?, dimensions? }` |
62
- | `wf-verify` | `{ goals, plan_dir?, scope?, task_files?, must_haves?, skip_antipattern? }` |
63
- | `wf-grill` | `{ topic, context?, depth?: "shallow"\|"standard"\|"deep" }` |
64
- | `wf-plan` | `{ context_dir?, from?, phase?, scope?, specs?, gaps?, quick? }` |
65
- | `wf-execute` | `{ plan_dir, specs?, codebase_context?, wiki_context?, auto_commit? }` |
66
- | `wf-milestone-audit` | `{ milestone?, is_adhoc? }` |
67
- </context>
68
-
69
- <state_machine>
70
-
71
- <states>
72
- S_PARSE — 解析参数和意图 PERSIST:
73
- S_ROUTE — 路由到目标脚本 PERSIST:
74
- S_CONTEXT — 组装 context payload PERSIST: —
75
- S_DISPATCH — 调用 Workflow 工具 PERSIST: —
76
- S_INGEST — 处理返回结果 PERSIST:
77
- S_FALLBACK — 无法路由 PERSIST:
78
- </states>
79
-
80
- <transitions>
81
-
82
- S_PARSE:
83
- → S_ROUTE WHEN: intent parsed DO: A_PARSE_ARGS
84
- → S_FALLBACK WHEN: no intent
85
-
86
- S_ROUTE:
87
- S_CONTEXT WHEN: script resolved DO: A_ROUTE_SCRIPT
88
- → S_FALLBACK WHEN: ambiguous intent DO: AskUserQuestion
89
-
90
- S_CONTEXT:
91
- S_DISPATCH DO: A_ASSEMBLE_CONTEXT
92
-
93
- S_DISPATCH:
94
- → S_INGEST WHEN: workflow completed DO: A_DISPATCH_WORKFLOW
95
- S_FALLBACK WHEN: workflow failed
96
-
97
- S_INGEST:
98
- → END DO: A_INGEST_RESULTS
99
-
100
- S_FALLBACK:
101
- S_PARSE WHEN: user provides input
102
- END WHEN: user cancels
103
-
104
- </transitions>
105
-
106
- <actions>
107
-
108
- ### A_PARSE_ARGS
109
-
110
- 1. 提取 flags(--script, --dims, --roles, --count, --tier, --resume)
111
- 2. 剩余文本作为 intent
112
- 3. 若有 --resume,记录 resumeRunId
113
-
114
- ### A_ROUTE_SCRIPT
115
-
116
- Intent-to-script routing(按关键词匹配,--script 优先级最高):
117
-
118
- | Keywords | Script |
119
- |----------|--------|
120
- | 分析 / analyze / 探索 / explore / 架构 / architecture / 复杂度 / 风险 | `wf-analyze` |
121
- | 头脑风暴 / brainstorm / 方案 / 设计 / 评估 / evaluate / 多角度 | `wf-brainstorm` |
122
- | 审查 / review / 代码审查 / code review / 质量 / quality | `wf-review` |
123
- | 验证 / verify / 检查 / check / 反模式 / antipattern | `wf-verify` |
124
- | 拷问 / grill / 压力测试 / stress-test / 挑战 / challenge | `wf-grill` |
125
- | 规划 / plan / 任务分解 / decompose / 分波 / wave | `wf-plan` |
126
- | 执行 / execute / 实现 / implement / 开发 / develop | `wf-execute` |
127
- | 里程碑审计 / milestone-audit / 集成检查 / integration | `wf-milestone-audit` |
128
-
129
- 多命中 AskUserQuestion 让用户选择。
130
-
131
- ### A_ASSEMBLE_CONTEXT
132
-
133
- 根据目标脚本组装 args payload:
134
-
135
- **wf-analyze:**
136
- 1. Read `.workflow/state.json` 获取当前 phase/milestone 信息
137
- 2. `target` = intent 中的目标描述
138
- 3. `scope` = 从 intent 推断文件范围,或读 roadmap 获取 phase scope
139
- 4. `context` = 拼接相关上下文(上游 artifact 摘要、specs)
140
- 5. `dimensions` = --dims 解析结果(可选)
141
-
142
- **wf-brainstorm:**
143
- 1. `topic` = intent 文本
144
- 2. `context` = 读取相关代码文件摘要 + 已有 specs
145
- 3. `count` = --count 或默认 3
146
- 4. `roles` = --roles 解析结果(可选)
147
-
148
- **wf-review:**
149
- 1. `target` = 读 git diff 描述变更范围
150
- 2. `scope` = 变更文件列表
151
- 3. `tier` = --tier 或 "standard"
152
- 4. `dimensions` = --dims 解析结果(可选)
153
-
154
- **wf-verify:**
155
- 1. `goals` = 读最近的 plan artifact 提取目标列表
156
- 2. `plan_dir` = 定位最近的 plan scratch 目录
157
- 3. `scope` = plan 涉及的文件范围
158
- 4. `skip_tests` / `skip_antipattern` = flags 提取
159
-
160
- ### A_DISPATCH_WORKFLOW
161
-
162
- 1. 确定 scriptPath = `~/.maestro/workflows/swarm/{script}.js`(展开为绝对路径)
163
- 2. 构建 Workflow 调用:
164
- ```
165
- Workflow({
166
- scriptPath: absoluteScriptPath,
167
- args: assembledArgs,
168
- resumeFromRunId: resumeRunId // 若有
169
- })
170
- ```
171
- 3. 等待 Workflow 返回结果
172
- 4. 记录 runId 用于潜在的后续 resume
173
-
174
- ### A_INGEST_RESULTS
175
-
176
- Workflow 返回 JSON 后:
177
-
178
- 1. **摘要输出**:按脚本类型格式化关键指标(含对抗决策结果)
179
- - analyze: overall_score, scope_verdict, adversarial_outcome (go/no-go/conditional advocacy + referee), scores_challenged count
180
- - brainstorm: role count, conflict/synergy count, 3-proposal competition result, arbitration notes
181
- - review: verdict (APPROVE/REQUEST_CHANGES/BLOCK), 3-vote tally, confirmed vs false-positive count, adversarial_verdict
182
- - verify: overall_status, prosecutor vs defender confidence, adversarial_outcome, gap count
183
- - grill: overall_verdict, meta-skeptic quality rating, 3-vote verdict tally, overblown findings count
184
- - plan: selected_strategy (breadth/depth/risk), judge panel scores, 3-critic adversarial check verdict
185
- - execute: 3-vote status (DONE/DONE_WITH_CONCERNS/NEEDS_RETRY), convergence trust %, discrepancy count
186
- - milestone-audit: 3-vote verdict, dimensions_overturned count, next_step
187
-
188
- 2. **Artifact 写入**(可选):
189
- - 若当前在 ralph session 中(检测 `.workflow/.maestro/ralph-*/status.json` 状态为 running):
190
- 将结果写入对应 step scratch 目录,格式兼容命令产出
191
- - 否则写入 `.workflow/scratch/{YYYYMMDD}-swarm-{script}-{slug}/results.json`
192
-
193
- 3. **Ralph 兼容产出**:
194
- - analyze → `analysis.md` + `context.md`(decisions)+ `conclusions.json` + `adversarial-debate.json`
195
- - brainstorm → `guidance-specification.md` + `proposals-competition.json`
196
- - review → `review.json`(含 adversarial_verdict + 3-vote tally)
197
- - verify → `verification.json`(含 adversarial_outcome: prosecutor/defender debate)
198
- - grill → `grill-results.json`(含 meta-challenge + 3-vote verdict)
199
- - plan `plan.json`(含 competition scores + critic feedback)
200
- - execute → `execution-report.json`(含 convergence_checks + 3-vote status)
201
- - milestone-audit `audit-report.json`(含 dimension challenges + 3-vote verdict)
202
-
203
- 4. **RunId 提示**:显示 `Resume: /maestro-swarm-workflow --resume {runId}` 用于增量重跑
204
-
205
- </actions>
206
-
207
- </state_machine>
208
-
209
- <invariants>
210
- 1. **只做并行加速,不做状态决策** 不修改 ralph status.json,不推进 step
211
- 2. **args 预编译** — 所有 FS 读取在 A_ASSEMBLE_CONTEXT 完成,脚本内 agent 通过工具自行读取补充
212
- 3. **产出格式兼容** — 写入的 artifact 格式必须与对应命令(analyze/brainstorm/review/verify)的产出一致
213
- 4. **resume 透传** — resumeFromRunId 直接透传给 Workflow 工具,利用内置缓存机制
214
- 5. **脚本只读** 路由命令不修改 `~/.maestro/workflows/swarm/wf-*.js` 脚本文件
215
- 6. **结果必须展示** — Workflow 返回后必须向用户展示格式化摘要,不得静默完成
216
- </invariants>
217
-
218
- <appendix>
219
-
220
- ### Ralph 集成
221
-
222
- Ralph 可以在 A_BUILD_STEPS 中将某些 step 的执行方式标记为 `swarm-workflow`:
223
-
224
- ```json
225
- {
226
- "index": 2,
227
- "skill": "maestro-swarm-workflow",
228
- "args": "--script wf-analyze {phase}",
229
- "stage": "analyze",
230
- "command_scope": "project",
231
- "command_path": "<resolved by maestro ralph skills --platform claude>"
232
- }
233
- ```
234
-
235
- ralph-execute 正常通过 `maestro ralph next` 加载并执行,swarm-workflow 内部再调 Workflow 工具。
236
-
237
- ### 输出示例
238
-
239
- ```
240
- ┌─ wf-analyze ──────────────────────────────────────┐
241
- │ Explore [████████████████████] 6/6 dimensions │
242
- │ Synthesize [████████████████] done │
243
- ├────────────────────────────────────────────────────┤
244
- │ Score: 7.2/10 Scope: medium Verdict: go │
245
- │ Findings: 23 total (2 critical, 5 high) │
246
- │ Cross-cutting: 3 themes │
247
- │ Decisions: 4 locked, 2 free, 1 deferred │
248
- ├────────────────────────────────────────────────────┤
249
- │ Output: .workflow/scratch/20260530-swarm-analyze/ │
250
- │ Resume: /maestro-swarm-workflow --resume wf_abc123 │
251
- └────────────────────────────────────────────────────┘
252
- ```
253
-
254
- ### Error Codes
255
-
256
- | Code | Description | Recovery |
257
- |------|-------------|----------|
258
- | E001 | No intent and no --script | Prompt for intent |
259
- | E002 | Ambiguous routing | AskUserQuestion |
260
- | E003 | Script file not found | Check .claude/workflows/ |
261
- | E004 | Workflow execution failed | Show error, suggest --resume |
262
- | E005 | Result ingestion failed | Write raw JSON to scratch |
263
-
264
- </appendix>
1
+ ---
2
+ name: maestro-swarm-workflow
3
+ description: Parallel workflow accelerator — route intent to fixed Workflow scripts for multi-agent concurrent execution
4
+ argument-hint: "<intent> [--script <name>] [--dims <d1,d2>] [--roles <r1,r2>] [--count N] [--tier quick|standard] [--resume <runId>]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ - Bash
10
+ - Glob
11
+ - Grep
12
+ - Workflow
13
+ - AskUserQuestion
14
+ ---
15
+ <purpose>
16
+ Parallel accelerator: route intent to pre-built Workflow scripts (`wf-*.js`) for multi-agent
17
+ concurrent execution with adversarial decision patterns. Complements ralph's sequential chain.
18
+ </purpose>
19
+
20
+ <context>
21
+ $ARGUMENTS — intent text with optional flags.
22
+
23
+ **Parse:**
24
+ ```
25
+ --script <name> → 强制指定脚本(wf-analyze, wf-brainstorm, wf-review, wf-verify)
26
+ --dims <d1,d2> → 限定分析维度(analyze: architecture,complexity,patterns,risk,testability,performance)
27
+ --roles <r1,r2> → 限定角色(brainstorm: system-architect,product-manager,test-strategist,ux-expert,security-analyst,data-architect)
28
+ --count N 角色数量(brainstorm 默认 3
29
+ --tier <level> review 层级(quick=2 维度, standard=4 维度)
30
+ --resume <runId>从之前的 workflow 运行恢复(增量重跑)
31
+ Remaining intent
32
+ ```
33
+
34
+ **Script inventory** (`~/.maestro/workflows/swarm/`):
35
+
36
+ | Script | args 接口 |
37
+ |--------|-----------|
38
+ | `wf-analyze` | `{ target, scope, context, phase?, dimensions? }` |
39
+ | `wf-brainstorm` | `{ topic, context, count?, roles? }` |
40
+ | `wf-review` | `{ target, scope, specs?, tier?, dimensions? }` |
41
+ | `wf-verify` | `{ goals, plan_dir?, scope?, task_files?, must_haves?, skip_antipattern? }` |
42
+ | `wf-grill` | `{ topic, context?, depth?: "shallow"\|"standard"\|"deep" }` |
43
+ | `wf-plan` | `{ context_dir?, from?, phase?, scope?, specs?, gaps?, quick? }` |
44
+ | `wf-execute` | `{ plan_dir, specs?, codebase_context?, wiki_context?, auto_commit? }` |
45
+ | `wf-milestone-audit` | `{ milestone?, is_adhoc? }` |
46
+ </context>
47
+
48
+ <state_machine>
49
+
50
+ <states>
51
+ S_PARSE — 解析参数和意图 PERSIST:
52
+ S_ROUTE 路由到目标脚本 PERSIST: —
53
+ S_CONTEXT — 组装 context payload PERSIST: —
54
+ S_DISPATCH — 调用 Workflow 工具 PERSIST: —
55
+ S_INGEST — 处理返回结果 PERSIST:
56
+ S_FALLBACK — 无法路由 PERSIST: —
57
+ </states>
58
+
59
+ <transitions>
60
+
61
+ S_PARSE:
62
+ S_ROUTE WHEN: intent parsed DO: A_PARSE_ARGS
63
+ S_FALLBACK WHEN: no intent
64
+
65
+ S_ROUTE:
66
+ S_CONTEXT WHEN: script resolved DO: A_ROUTE_SCRIPT
67
+ → S_FALLBACK WHEN: ambiguous intent DO: AskUserQuestion
68
+
69
+ S_CONTEXT:
70
+ → S_DISPATCH DO: A_ASSEMBLE_CONTEXT
71
+
72
+ S_DISPATCH:
73
+ S_INGEST WHEN: workflow completed DO: A_DISPATCH_WORKFLOW
74
+ S_FALLBACK WHEN: workflow failed
75
+
76
+ S_INGEST:
77
+ END DO: A_INGEST_RESULTS
78
+
79
+ S_FALLBACK:
80
+ → S_PARSE WHEN: user provides input
81
+ → END WHEN: user cancels
82
+
83
+ </transitions>
84
+
85
+ <actions>
86
+
87
+ ### A_PARSE_ARGS
88
+
89
+ 1. 提取 flags(--script, --dims, --roles, --count, --tier, --resume)
90
+ 2. 剩余文本作为 intent
91
+ 3. 若有 --resume,记录 resumeRunId
92
+
93
+ ### A_ROUTE_SCRIPT
94
+
95
+ Intent-to-script routing(按关键词匹配,--script 优先级最高):
96
+
97
+ | Keywords | Script |
98
+ |----------|--------|
99
+ | 分析 / analyze / 探索 / explore / 架构 / architecture / 复杂度 / 风险 | `wf-analyze` |
100
+ | 头脑风暴 / brainstorm / 方案 / 设计 / 评估 / evaluate / 多角度 | `wf-brainstorm` |
101
+ | 审查 / review / 代码审查 / code review / 质量 / quality | `wf-review` |
102
+ | 验证 / verify / 检查 / check / 反模式 / antipattern | `wf-verify` |
103
+ | 拷问 / grill / 压力测试 / stress-test / 挑战 / challenge | `wf-grill` |
104
+ | 规划 / plan / 任务分解 / decompose / 分波 / wave | `wf-plan` |
105
+ | 执行 / execute / 实现 / implement / 开发 / develop | `wf-execute` |
106
+ | 里程碑审计 / milestone-audit / 集成检查 / integration | `wf-milestone-audit` |
107
+
108
+ 多命中 → AskUserQuestion 让用户选择。
109
+
110
+ ### A_ASSEMBLE_CONTEXT
111
+
112
+ 根据目标脚本组装 args payload:
113
+
114
+ **wf-analyze:**
115
+ 1. Read `.workflow/state.json` 获取当前 phase/milestone 信息
116
+ 2. `target` = intent 中的目标描述
117
+ 3. `scope` = 从 intent 推断文件范围,或读 roadmap 获取 phase scope
118
+ 4. `context` = 拼接相关上下文(上游 artifact 摘要、specs)
119
+ 5. `dimensions` = --dims 解析结果(可选)
120
+
121
+ **wf-brainstorm:**
122
+ 1. `topic` = intent 文本
123
+ 2. `context` = 读取相关代码文件摘要 + 已有 specs
124
+ 3. `count` = --count 或默认 3
125
+ 4. `roles` = --roles 解析结果(可选)
126
+
127
+ **wf-review:**
128
+ 1. `target` = 读 git diff 描述变更范围
129
+ 2. `scope` = 变更文件列表
130
+ 3. `tier` = --tier 或 "standard"
131
+ 4. `dimensions` = --dims 解析结果(可选)
132
+
133
+ **wf-verify:**
134
+ 1. `goals` = 读最近的 plan artifact 提取目标列表
135
+ 2. `plan_dir` = 定位最近的 plan scratch 目录
136
+ 3. `scope` = plan 涉及的文件范围
137
+ 4. `skip_tests` / `skip_antipattern` = flags 提取
138
+
139
+ ### A_DISPATCH_WORKFLOW
140
+
141
+ 1. 确定 scriptPath = `~/.maestro/workflows/swarm/{script}.js`(展开为绝对路径)
142
+ 2. 构建 Workflow 调用:
143
+ ```
144
+ Workflow({
145
+ scriptPath: absoluteScriptPath,
146
+ args: assembledArgs,
147
+ resumeFromRunId: resumeRunId // 若有
148
+ })
149
+ ```
150
+ 3. 等待 Workflow 返回结果
151
+ 4. 记录 runId 用于潜在的后续 resume
152
+
153
+ ### A_INGEST_RESULTS
154
+
155
+ Workflow 返回 JSON 后:
156
+
157
+ 1. **摘要输出**:按脚本类型格式化关键指标(含对抗决策结果)
158
+ - analyze: overall_score, scope_verdict, adversarial_outcome (go/no-go/conditional advocacy + referee), scores_challenged count
159
+ - brainstorm: role count, conflict/synergy count, 3-proposal competition result, arbitration notes
160
+ - review: verdict (APPROVE/REQUEST_CHANGES/BLOCK), 3-vote tally, confirmed vs false-positive count, adversarial_verdict
161
+ - verify: overall_status, prosecutor vs defender confidence, adversarial_outcome, gap count
162
+ - grill: overall_verdict, meta-skeptic quality rating, 3-vote verdict tally, overblown findings count
163
+ - plan: selected_strategy (breadth/depth/risk), judge panel scores, 3-critic adversarial check verdict
164
+ - execute: 3-vote status (DONE/DONE_WITH_CONCERNS/NEEDS_RETRY), convergence trust %, discrepancy count
165
+ - milestone-audit: 3-vote verdict, dimensions_overturned count, next_step
166
+
167
+ 2. **Artifact 写入**(可选):
168
+ - 若当前在 ralph session 中(检测 `.workflow/.maestro/ralph-*/status.json` 状态为 running):
169
+ 将结果写入对应 step 的 scratch 目录,格式兼容命令产出
170
+ - 否则写入 `.workflow/scratch/{YYYYMMDD}-swarm-{script}-{slug}/results.json`
171
+
172
+ 3. **Ralph 兼容产出**:
173
+ - analyze → `analysis.md` + `context.md`(decisions)+ `conclusions.json` + `adversarial-debate.json`
174
+ - brainstorm → `guidance-specification.md` + `proposals-competition.json`
175
+ - review → `review.json`(含 adversarial_verdict + 3-vote tally)
176
+ - verify `verification.json`(含 adversarial_outcome: prosecutor/defender debate)
177
+ - grill → `grill-results.json`(含 meta-challenge + 3-vote verdict)
178
+ - plan → `plan.json`(含 competition scores + critic feedback)
179
+ - execute `execution-report.json`(含 convergence_checks + 3-vote status)
180
+ - milestone-audit `audit-report.json`(含 dimension challenges + 3-vote verdict)
181
+
182
+ 4. **RunId 提示**:显示 `Resume: /maestro-swarm-workflow --resume {runId}` 用于增量重跑
183
+
184
+ </actions>
185
+
186
+ </state_machine>
187
+
188
+ <invariants>
189
+ 1. **只做并行加速,不做状态决策** 不修改 ralph status.json,不推进 step
190
+ 2. **args 预编译** 所有 FS 读取在 A_ASSEMBLE_CONTEXT 完成,脚本内 agent 通过工具自行读取补充
191
+ 3. **产出格式兼容** — 写入的 artifact 格式必须与对应命令(analyze/brainstorm/review/verify)的产出一致
192
+ 4. **resume 透传** — resumeFromRunId 直接透传给 Workflow 工具,利用内置缓存机制
193
+ 5. **脚本只读** — 路由命令不修改 `~/.maestro/workflows/swarm/wf-*.js` 脚本文件
194
+ 6. **结果必须展示** Workflow 返回后必须向用户展示格式化摘要,不得静默完成
195
+ </invariants>
196
+
197
+ <appendix>
198
+
199
+ ### Ralph 集成
200
+
201
+ Ralph 可以在 A_BUILD_STEPS 中将某些 step 的执行方式标记为 `swarm-workflow`:
202
+
203
+ ```json
204
+ {
205
+ "index": 2,
206
+ "skill": "maestro-swarm-workflow",
207
+ "args": "--script wf-analyze {phase}",
208
+ "stage": "analyze",
209
+ "command_scope": "project",
210
+ "command_path": "<resolved by maestro ralph skills --platform claude>"
211
+ }
212
+ ```
213
+
214
+ ralph-execute 正常通过 `maestro ralph next` 加载并执行,swarm-workflow 内部再调 Workflow 工具。
215
+
216
+ ### 输出示例
217
+
218
+ ```
219
+ ┌─ wf-analyze ──────────────────────────────────────┐
220
+ │ Explore [████████████████████] 6/6 dimensions │
221
+ │ Synthesize [████████████████] done │
222
+ ├────────────────────────────────────────────────────┤
223
+ │ Score: 7.2/10 Scope: medium Verdict: go │
224
+ │ Findings: 23 total (2 critical, 5 high) │
225
+ │ Cross-cutting: 3 themes │
226
+ Decisions: 4 locked, 2 free, 1 deferred │
227
+ ├────────────────────────────────────────────────────┤
228
+ Output: .workflow/scratch/20260530-swarm-analyze/ │
229
+ Resume: /maestro-swarm-workflow --resume wf_abc123 │
230
+ └────────────────────────────────────────────────────┘
231
+ ```
232
+
233
+ ### Error Codes
234
+
235
+ | Code | Description | Recovery |
236
+ |------|-------------|----------|
237
+ | E001 | No intent and no --script | Prompt for intent |
238
+ | E002 | Ambiguous routing | AskUserQuestion |
239
+ | E003 | Script file not found | Check .claude/workflows/ |
240
+ | E004 | Workflow execution failed | Show error, suggest --resume |
241
+ | E005 | Result ingestion failed | Write raw JSON to scratch |
242
+
243
+ </appendix>