openmatrix 0.2.23 → 0.2.25

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/skills/auto.md CHANGED
@@ -1,415 +1,383 @@
1
- ---
2
- name: om:auto
3
- description: "Use when the user wants fully automated task execution with zero manual approvals. Triggers on AUTOMATION intent: user explicitly requests hands-free execution, wants to skip all confirmations, or needs batch processing without interruptions. DO NOT trigger on: interactive requests, debugging, or status checks. Intent signals: user says 'fully auto', 'hands-free', 'no interruptions', 'skip approvals', or describes large batch operations."
4
- ---
5
-
6
- <INTENT-JUDGMENT>
7
- ## 意图判断指南
8
-
9
- **AI 应根据用户语义判断意图:**
10
-
11
- ### 触发信号(全自动意图)
12
-
13
- - 用户明确要"全自动执行"
14
- - 需要跳过所有审批确认
15
- - 批量操作,不希望中断
16
- - 用户表达"直接执行"、"不要问我"
17
-
18
- ### 不触发信号
19
-
20
- | 用户意图 | 应调用 |
21
- |---------|--------|
22
- | 需要交互确认 | /om:start |
23
- | 调查问题 | /om:debug |
24
- | 查看状态 | /om:status |
25
-
26
- ### 示例判断
27
-
28
- | 用户消息 | 判断 | 结果 |
29
- |---------|------|------|
30
- | "全自动执行" | 全自动意图 | 触发 ✓ |
31
- | "不要问我直接做" | 无中断意图 | 触发 |
32
- | "批量重构跳过确认" | 批量自动化 | 触发 |
33
- | "交互式执行" | 需要确认 | /om:start |
34
- | "查看执行状态" | 状态检查 | /om:status |
35
- </INTENT-JUDGMENT>
36
-
37
- <NOTE>
38
- ## 注意:区分 `/om:auto` 指令与「全自动执行」模式
39
-
40
- - **`/om:auto`** 是一个 **Skill 指令**,为 Agent 无障碍执行准备
41
- - **「全自动执行」**是 `/om:start` 中用户选择的 **执行模式选项**
42
-
43
- **关键区别**:`/om:auto` 不创建 Meeting 记录,直接跳过阻塞任务。
44
-
45
- **相关技能**: `/om:start` (交互式) | `/om:status` (状态查看) | `/om:report` (报告)
46
- </NOTE>
47
-
48
- <NO-OTHER-SKILLS>
49
- **绝对禁止**调用以下任何技能或工具:
50
- - ❌ gsd-executor、gsd:* 等 GSD 相关技能
51
- - ❌ superpowers:* 等 superpowers 相关技能
52
- - ❌ 任何其他任务编排相关的 Agent 或工具
53
-
54
- **Step 6 只能使用 Agent 工具** — 直接调用 Agent,不通过任何中间层。
55
-
56
- 违规调用将导致执行失败。
57
- </NO-OTHER-SKILLS>
58
-
59
- <MANDATORY-EXECUTION-ORDER>
60
- ## 执行顺序 - 必须严格按此顺序,不得跳过任何步骤
61
-
62
- ```
63
- Step 1: 初始化 .openmatrix 目录
64
- Step 2: AI 分析任务,提取 goals,生成 plan
65
- Step 3: 写入 .openmatrix/tasks-input.json ← 必须完成
66
- Step 4: 调用 openmatrix start --tasks-json ← 必须完成,不可跳过
67
- Step 5: CLI 返回结果中读取 subagentTasks 列表 ← 必须完成
68
- Step 6: 逐个执行 subagentTasks(调用 Agent 工具) ← 只有这步才能写代码
69
- ```
70
-
71
- **违反以下任一规则将导致任务执行失败:**
72
-
73
- **禁止在 Step 4 之前写任何业务代码** — 所有代码必须在 Step 6 通过 Agent 执行
74
- ❌ **禁止跳过 Step 4** — 必须调用 CLI,不能用其他方式代替
75
- **禁止自行规划 Phase** 任务由 CLI 的 TaskPlanner 拆分,AI 只提取 goals
76
- **禁止用 Bash/npm/write 直接写业务代码** — 业务代码只能通过 Step 6 的 Agent 执行
77
- </MANDATORY-EXECUTION-ORDER>
78
-
79
- <BYPASS-MODE>
80
- ## 全自动模式 - 自动批准所有操作
81
-
82
- 1. **所有 Bash 命令自动批准** - 不询问确认
83
- 2. **所有文件操作自动批准** - 不询问确认
84
- 3. **所有 Agent 调用自动批准** - 不询问确认
85
- 4. **所有审批点自动批准** - plan/merge/deploy 自动通过
86
-
87
- **执行时不要请求用户确认任何操作。**
88
- </BYPASS-MODE>
89
-
90
- <objective>
91
- 全自动执行任务。AI 提取目标后通过 CLI 拆分任务,然后通过 Agent 逐个执行。
92
- </objective>
93
-
94
- <process>
95
-
96
- ## === 准备阶段(此阶段不得写任何业务代码)===
97
-
98
- ### Step 1: 初始化
99
-
100
- 检查 `.openmatrix/` 目录是否存在,不存在则初始化:
101
- ```bash
102
- openmatrix start --init-only
103
- ```
104
-
105
- 读取 `.openmatrix/state.json`,如果 `status === 'running'`,提示用户先完成或暂停。
106
-
107
- ### Step 2: AI 分析任务,提取 goals 和生成 plan
108
-
109
- 解析 `$ARGUMENTS`(文件路径或任务描述),从中提取:
110
- - **goals**: 至少 3-8 个独立功能目标,每个 goal 应该是独立可交付的功能模块
111
- - **constraints**: 技术栈、兼容性等约束
112
- - **deliverables**: 交付物列表
113
- - **plan**: 技术方案、模块划分、接口设计、关键决策
114
-
115
- 解析 `$ARGUMENTS` 中的 `--quality` 参数(默认 strict)。
116
-
117
- ### Step 3: 写入 tasks-input.json
118
-
119
- 用 Write 工具将以下 JSON 写入 `.openmatrix/tasks-input.json`:
120
-
121
- ```json
122
- {
123
- "title": "任务标题",
124
- "description": "整体描述",
125
- "goals": ["目标1", "目标2", "目标3"],
126
- "constraints": ["约束1"],
127
- "deliverables": ["src/xxx.ts"],
128
- "answers": { "技术栈": "..." },
129
- "quality": "strict",
130
- "mode": "auto",
131
- "plan": "## 技术方案\n1. ...\n2. ..."
132
- }
133
- ```
134
-
135
- **goals 是最核心的字段**,CLI TaskPlanner 会为每个 goal 生成 开发+测试 任务对。
136
-
137
- ### Step 4: 调用 CLI 创建任务 ⚠️ 不可跳过
138
-
139
- **这是最关键的步骤。必须执行以下命令,不能跳过:**
140
-
141
- ```bash
142
- openmatrix start --tasks-json @.openmatrix/tasks-input.json --json
143
- ```
144
-
145
- 此命令会:
146
- - 调用 TaskPlanner 将 goals 拆分为子任务
147
- - 创建任务文件到 `.openmatrix/tasks/` 目录
148
- - 返回 JSON 包含 `subagentTasks` 列表
149
-
150
- ### Step 5: 读取 subagentTasks
151
-
152
- CLI 返回的 JSON 中 `subagentTasks` 数组包含每个待执行任务:
153
- ```json
154
- {
155
- "subagentTasks": [
156
- {
157
- "subagent_type": "Plan",
158
- "description": "简短描述",
159
- "prompt": "完整执行提示词",
160
- "taskId": "TASK-001",
161
- "agentType": "planner",
162
- "timeout": 300000
163
- }
164
- ]
165
- }
166
- ```
167
-
168
- ## === 执行阶段(只有此阶段才能写业务代码)===
169
-
170
- ### Step 6: 逐个执行 subagentTasks(禁止中断)
171
-
172
- <LOOP-ENFORCEMENT>
173
- **此步骤是执行循环,必须执行完所有任务后才能停止。**
174
-
175
- **禁止在还有未完成任务时停止** — 即使 Agent 返回了大段输出,也必须继续下一个
176
- **禁止询问"是否继续"** 直接执行下一个任务
177
- **禁止输出"让我知道是否..."后停止** — 继续执行
178
- ❌ **禁止因为上下文压缩而忘记剩余任务** — 通过 CLI 命令从磁盘获取真实状态
179
-
180
- **文件持久化循环(防止上下文压缩丢失状态):**
181
- ```bash
182
- # 每个 Agent 完成后执行:
183
- openmatrix complete TASK-XXX --success # 标记完成 + 更新统计(含自动 git commit)
184
-
185
- # 提交验证(防止 commit 静默失败):
186
- git status --porcelain # 检查是否有未提交的文件
187
- # 如果有未提交文件 → 必须手动提交:
188
- git add . && git commit -m "feat(TASK-XXX): 任务标题"
189
-
190
- openmatrix step --json # 获取下一个任务 + 检查是否全部完成
191
- ```
192
- `openmatrix step` 从磁盘读取真实状态,不依赖上下文记忆。
193
-
194
- **中断恢复:** 如果会话中断,再次执行 `/om:auto` 时:
195
- 1. 执行 `openmatrix step --json`
196
- 2. 如果返回 `status: "next"` → 从返回的任务继续执行
197
- 3. 如果返回 `status: "done"` → 所有任务已完成
198
- 4. 如果返回 `status: "blocked"` → 有阻塞任务需要处理
199
- </LOOP-ENFORCEMENT>
200
-
201
- #### 6.1 歧义检测机制(全自动模式)
202
-
203
- **Agent 输出中可能包含歧义报告(JSON 格式):**
204
-
205
- Agent 输出包含以下标记时,表示检测到歧义:
206
- ```
207
- <AMBIGUITY_REPORT>
208
- {
209
- "ambiguities": [
210
- {
211
- "type": "missing_info" | "conflicting_req" | "unclear_scope" | "tech_choice" | "edge_case",
212
- "severity": "critical" | "high" | "medium" | "low",
213
- "description": "歧义描述",
214
- "suggestions": ["建议1", "建议2"]
215
- }
216
- ],
217
- "overallSeverity": "critical" | "high" | "medium" | "low"
218
- }
219
- </AMBIGUITY_REPORT>
220
- ```
221
-
222
- **5 种歧义类型说明:**
223
-
224
- | 类型 | 说明 | 示例 |
225
- |------|------|------|
226
- | `missing_info` | 缺失关键信息 | "未指定数据库类型" |
227
- | `conflicting_req` | 需求冲突 | "既要高性能又要低成本" |
228
- | `unclear_scope` | 范围不清晰 | "是否包含历史数据处理?" |
229
- | `tech_choice` | 技术选型歧义 | "用 REST 还是 GraphQL?" |
230
- | `edge_case` | 边界情况未定义 | "超过限制时如何处理?" |
231
-
232
- #### 6.2 歧义处理策略(全自动模式)
233
-
234
- **在 `/om:auto` 全自动模式下,所有歧义都写入 Meeting 继续执行,不中断流程:**
235
-
236
- | 严重程度 | 处理方式 |
237
- |---------|---------|
238
- | **Critical** | Meeting + 继续执行其他任务 |
239
- | **High** | Meeting + 继续执行其他任务 |
240
- | **Medium** | Meeting + 继续执行其他任务 |
241
- | **Low** | Meeting + 继续执行其他任务 |
242
-
243
- **全自动模式特点:**
244
- - **不使用 AskUserQuestion** — 全自动执行,零人工干预
245
- - **所有歧义写入 Meeting**执行完成后统一展示
246
- - ✅ **继续执行其他任务** — 最大化并行度,无阻塞等待
247
-
248
- **Meeting 处理流程:**
249
- ```bash
250
- # 检测到歧义时,写入 Meeting 记录并继续执行
251
- openmatrix meeting --create --task TASK-XXX --reason "歧义: ${description}" --severity ${overallSeverity}
252
-
253
- # 继续执行下一个任务
254
- openmatrix step --json
255
- ```
256
-
257
- **执行完成后提示用户:**
258
- ```
259
- ⚠️ 检测到 N 个歧义记录,请使用 `/om:meeting` 统一处理
260
- ```
261
-
262
- #### 6.3 执行 Agent 任务
263
-
264
- ```typescript
265
- Agent({
266
- subagent_type: task.subagent_type,
267
- description: task.description,
268
- prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要(不超过3行):\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行以下 Git 命令**:\n- ❌ git commit — 所有提交统一通过 openmatrix complete 执行\n- ❌ git checkout — 不要切换分支\n- ❌ git merge — 不要合并其他分支\n- ❌ git pull — 不要拉取远程更新\n- ❌ git push — 不要推送代码\n- ❌ git rebase — 不要变基\n- ❌ git branch — 不要创建/删除分支\n\n✅ 允许:git status, git diff, git log",
269
- isolation: task.isolation,
270
- run_in_background: true
271
- })
272
- ```
273
-
274
- > ⚠️ **必须使用原生 Agent 工具** 禁止调用 gsd-executor、superpowers 或任何其他编排技能。
275
- >
276
- > **上下文节省**: 使用 `run_in_background: true` 后台执行,Agent 完成后仅返回简短摘要,大幅节省主会话上下文。
277
- >
278
- > 🚫 **Agent 内部禁止 Git 操作** — 禁止执行:git commit, git checkout, git merge, git pull, git push, git rebase, git branch。所有提交必须通过 `openmatrix complete` 执行。
279
-
280
- 每个 Agent 完成后:
281
- 1. **保存 Agent 上下文** 将执行结果摘要写入 `.openmatrix/tasks/TASK-XXX/context.md`,格式如下:
282
-
283
- ```markdown
284
- ## 任务: TASK-XXX 任务标题
285
-
286
- ### 关键决策
287
- - [做出的重要决策]
288
-
289
- ### 创建/修改的文件
290
- - `path/to/file1.ts` - 简述用途
291
- - `path/to/file2.ts` - 简述用途
292
-
293
- ### 重要发现
294
- - [发现的问题、模式、注意事项]
295
-
296
- ### 对后续任务的建议
297
- - [下一个 Agent 应该注意什么]
298
- ```
299
-
300
- 2. **标记完成并更新统计(必须执行):**
301
- ```bash
302
- openmatrix complete TASK-XXX --success
303
- ```
304
-
305
- 3. **获取下一个任务(必须执行,防止上下文压缩丢失):**
306
- ```bash
307
- openmatrix step --json
308
- ```
309
-
310
- **返回值解析:**
311
-
312
- | status | 含义 | 后续操作 |
313
- |--------|------|---------|
314
- | `next` | 有下一个任务 | 继续执行返回的 `subagent` 配置 |
315
- | `done` | 所有任务完成 | 进入最终提交 |
316
- | `blocked` | 无可执行任务 | `/om:auto` 直接跳过,继续执行其他任务 |
317
-
318
- **`next` 返回结构:**
319
- ```json
320
- {
321
- "status": "next",
322
- "task": { "id": "TASK-XXX", "title": "...", "status": "in_progress" },
323
- "subagent": { "subagent_type": "...", "description": "...", "prompt": "...", "timeout": 120000 },
324
- "statistics": { "total": 5, "completed": 2, "remaining": 3, "failed": 0 }
325
- }
326
- ```
327
-
328
- **Meeting 处理机制:**
329
- `/om:auto` 不创建 Meeting 记录,直接跳过阻塞任务,无障碍执行。
330
-
331
-
332
- **Agent 上下文共享机制 (Agent Memory):**
333
-
334
- 每个 Agent 执行时会自动接收前序 Agent 的上下文信息(通过 `context.md` 文件)。
335
- 这确保 Agent 之间共享知识、避免重复工作、保持决策一致性。
336
-
337
- ```
338
- Agent-1 完成 → 写入 context.md → Agent-2 读取 Agent-1 的上下文 → 写入 context.md → ...
339
- ```
340
- ```bash
341
- git add . && git commit -m "$(cat <<'EOF'
342
- feat: 任务标题
343
-
344
- 改动点1
345
- 改动点2
346
-
347
- 影响范围: 模块名
348
- 文件改动: 文件1, 文件2
349
-
350
- Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
351
- EOF
352
- )"
353
- ```
354
-
355
- **在 auto 模式下不得询问用户确认,自动批准所有审批点。**
356
-
357
- **Git 提交格式规范(所有提交必须遵守):**
358
-
359
- ```
360
- <type>(TASK-XXX): 简短描述
361
-
362
- 改动点1
363
- 改动点2
364
-
365
- 影响范围: 模块名
366
- 文件改动: 文件1, 文件2
367
-
368
- Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
369
- ```
370
-
371
- **type 映射:** feat(新功能) / fix(修复) / test(测试) / refactor(重构) / docs(文档)
372
- **禁止使用 emoji**,使用纯文本格式
373
-
374
- </process>
375
-
376
- <arguments>
377
- $ARGUMENTS
378
- </arguments>
379
-
380
- <examples>
381
- /om:auto "实现用户登录功能"
382
- /om:auto task.md --quality fast
383
- /om:auto task.md --quality balanced
384
- </examples>
385
-
386
- <notes>
387
- ## 质量级别
388
-
389
- | 级别 | TDD | 覆盖率 | Lint | 安全扫描 |
390
- |------|:---:|:------:|:----:|:--------:|
391
- | **strict** | ✅ | >80% | ✅ | ✅ |
392
- | **balanced** | ❌ | >60% | ✅ | ✅ |
393
- | **fast** | ❌ | 无要求 | ❌ | ❌ |
394
-
395
- ## 执行流程
396
-
397
- ```
398
- Step 1: 初始化 .openmatrix → Step 2: 提取 goals + plan → Step 3: 写入 tasks-input.json
399
- → Step 4: openmatrix start --tasks-json (必须) → Step 5: 读取 subagentTasks
400
- → Step 6: Agent 逐个执行 (只有这里写代码)
401
- ```
402
-
403
- ## Git 提交格式
404
-
405
- ```
406
- <type>(TASK-XXX): 简短描述
407
-
408
- 改动点1 / 改动点2
409
- 影响范围: 模块名
410
- 文件改动: 文件1, 文件2
411
- Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
412
- ```
413
-
414
- type: feat/fix/test/refactor/docs。禁止 emoji。
415
- </notes>
1
+ ---
2
+ name: om:auto
3
+ description: "Use when the user wants fully automated task execution with zero manual approvals. Triggers on AUTOMATION intent: user explicitly requests hands-free execution, wants to skip all confirmations, or needs batch processing without interruptions. Expects plan.md + tasks-input.json to already exist (generated by /om:plan). DO NOT trigger on: interactive requests, debugging, or status checks. Intent signals: user says 'fully auto', 'hands-free', 'no interruptions', 'skip approvals', or describes large batch operations."
4
+ ---
5
+
6
+ <INTENT-JUDGMENT>
7
+ ## 意图判断指南
8
+
9
+ **AI 应根据用户语义判断意图:**
10
+
11
+ ### 触发信号(全自动意图)
12
+
13
+ - 用户明确要"全自动执行"
14
+ - 需要跳过所有审批确认
15
+ - 批量操作,不希望中断
16
+ - 用户表达"直接执行"、"不要问我"
17
+
18
+ ### 不触发信号
19
+
20
+ | 用户意图 | 应调用 |
21
+ |---------|--------|
22
+ | 需要交互确认 | /om:start |
23
+ | 需要生成技术方案 | /om:plan |
24
+ | 调查问题 | /om:debug |
25
+ | 查看状态 | /om:status |
26
+
27
+ ### 示例判断
28
+
29
+ | 用户消息 | 判断 | 结果 |
30
+ |---------|------|------|
31
+ | "全自动执行" | 全自动意图 | 触发 |
32
+ | "不要问我直接做" | 无中断意图 | 触发 |
33
+ | "批量重构跳过确认" | 批量自动化 | 触发 |
34
+ | "交互式执行" | 需要确认 | /om:start |
35
+ | "生成技术方案" | 方案生成 | /om:plan |
36
+ | "查看执行状态" | 状态检查 | /om:status |
37
+ </INTENT-JUDGMENT>
38
+
39
+ <NO-OTHER-SKILLS>
40
+ **绝对禁止**调用以下任何技能或工具:
41
+ - gsd-executor、gsd:* GSD 相关技能
42
+ - superpowers:* 等 superpowers 相关技能
43
+ - 任何其他任务编排相关的 Agent 或工具
44
+
45
+ **Step 5 只能使用 Agent 工具** 直接调用 Agent,不通过任何中间层。
46
+
47
+ 违规调用将导致执行失败。
48
+
49
+ **相关技能**: `/om:brainstorm` (需求探索) | `/om:plan` (方案生成) | `/om:start` (交互式执行) | `/om:status` (状态查看) | `/om:report` (报告)
50
+ </NO-OTHER-SKILLS>
51
+
52
+ <MANDATORY-EXECUTION-ORDER>
53
+ ## 执行顺序 - 必须严格按此顺序,不得跳过任何步骤
54
+
55
+ ```
56
+ Step 1: 初始化 .openmatrix 目录
57
+ Step 2: 验证前置条件(plan.md + tasks-input.json 必须已存在)
58
+ Step 3: 调用 openmatrix start --tasks-json --mode auto ← 必须完成,不可跳过
59
+ Step 4: 从 CLI 返回结果中读取 subagentTasks 列表 ← 必须完成
60
+ Step 5: 逐个执行 subagentTasks(调用 Agent 工具) ← 只有这步才能写代码
61
+ ```
62
+
63
+ **违反以下任一规则将导致任务执行失败:**
64
+
65
+ - **禁止在 Step 5 之前写任何业务代码** 所有代码必须在 Step 5 通过 Agent 执行
66
+ - **禁止跳过 Step 3** 必须调用 CLI,不能用其他方式代替
67
+ - **禁止自行规划 Phase** — 任务由 CLI TaskPlanner 拆分,AI 只提取 goals
68
+ - **禁止用 Bash/npm/write 直接写业务代码** — 业务代码只能通过 Step 5 Agent 执行
69
+ - **禁止在 auto 中生成 plan** — plan 由 /om:plan 生成,auto 只负责执行
70
+ </MANDATORY-EXECUTION-ORDER>
71
+
72
+ <BYPASS-MODE>
73
+ ## 全自动模式 - 自动批准所有操作
74
+
75
+ 1. **所有 Bash 命令自动批准** - 不询问确认
76
+ 2. **所有文件操作自动批准** - 不询问确认
77
+ 3. **所有 Agent 调用自动批准** - 不询问确认
78
+ 4. **所有审批点自动批准** - plan/merge/deploy 自动通过
79
+
80
+ **执行时不要请求用户确认任何操作。**
81
+ </BYPASS-MODE>
82
+
83
+ <objective>
84
+ 全自动执行任务。读取已有的 plan.md + tasks-input.json,通过 CLI 拆分任务,然后通过 Agent 逐个执行。无交互、无审批、无中断。
85
+
86
+ 本 Skill 只做执行,不做方案生成。如果 plan.md 或 tasks-input.json 不存在,自动调用 /om:plan 生成。
87
+ </objective>
88
+
89
+ <process>
90
+
91
+ ## === 准备阶段(此阶段不得写任何业务代码)===
92
+
93
+ ### Step 1: 初始化
94
+
95
+ 检查 `.openmatrix/` 目录是否存在,不存在则初始化:
96
+ ```bash
97
+ openmatrix start --init-only
98
+ ```
99
+
100
+ 读取 `.openmatrix/state.json`,如果 `status === 'running'`,提示用户先完成或暂停。
101
+
102
+ ### Step 2: 验证前置条件
103
+
104
+ **检查 plan.md 和 tasks-input.json 是否已存在:**
105
+
106
+ ```bash
107
+ cat .openmatrix/tasks-input.json 2>/dev/null || echo "NOT_FOUND"
108
+ cat .openmatrix/plan.md 2>/dev/null || echo "NOT_FOUND"
109
+ ```
110
+
111
+ | 情况 | 处理方式 |
112
+ |------|---------|
113
+ | 两个都存在 | 读取内容,继续 Step 3 |
114
+ | 只有 tasks-input.json | 继续执行(plan.md 可选) |
115
+ | 不存在,有 `$ARGUMENTS` | 自动调用 `/om:plan` 生成方案(传入参数) |
116
+ | 不存在,无参数 | 提示用户先执行 `/om:plan` |
117
+
118
+ > **注意**: auto 不询问任何问题,直接执行。质量级别通过 `--quality` 参数指定(默认 strict)。
119
+
120
+ ### Step 3: 调用 CLI 创建任务 ⚠️ 不可跳过
121
+
122
+ **这是最关键的步骤。必须执行以下命令,不能跳过:**
123
+
124
+ ```bash
125
+ openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality <质量等级> --mode auto --json
126
+ ```
127
+
128
+ 如果启用了 E2E 测试,加上 `--e2e-tests`:
129
+ ```bash
130
+ openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality strict --mode auto --e2e-tests --json
131
+ ```
132
+
133
+ 此命令会:
134
+ - 读取 plan.md 作为任务上下文
135
+ - 调用 TaskPlanner goals 拆分为子任务
136
+ - 创建任务文件到 `.openmatrix/tasks/` 目录
137
+ - 返回 JSON 包含 `subagentTasks` 列表
138
+
139
+ ### Step 4: 读取 subagentTasks
140
+
141
+ CLI 返回的 JSON 中 `subagentTasks` 数组包含每个待执行任务:
142
+ ```json
143
+ {
144
+ "subagentTasks": [
145
+ {
146
+ "subagent_type": "Plan",
147
+ "description": "简短描述",
148
+ "prompt": "完整执行提示词",
149
+ "taskId": "TASK-001",
150
+ "agentType": "planner",
151
+ "timeout": 300000
152
+ }
153
+ ]
154
+ }
155
+ ```
156
+
157
+ ## === 执行阶段(只有此阶段才能写业务代码)===
158
+
159
+ ### Step 5: 逐个执行 subagentTasks(禁止中断)
160
+
161
+ <LOOP-ENFORCEMENT>
162
+ **此步骤是执行循环,必须执行完所有任务后才能停止。**
163
+
164
+ - **禁止在还有未完成任务时停止** — 即使 Agent 返回了大段输出,也必须继续下一个
165
+ - **禁止询问"是否继续"** — 直接执行下一个任务
166
+ - **禁止输出"让我知道是否..."后停止** — 继续执行
167
+ - **禁止因为上下文压缩而忘记剩余任务** — 通过 CLI 命令从磁盘获取真实状态
168
+
169
+ **文件持久化循环(防止上下文压缩丢失状态):**
170
+ ```bash
171
+ # 每个 Agent 完成后执行:
172
+ openmatrix complete TASK-XXX --success --summary "决策: xxx; 文件: xxx"
173
+
174
+ # 提交验证(防止 commit 静默失败):
175
+ git status --porcelain
176
+ # 如果有未提交文件 必须手动提交:
177
+ git add . && git commit -m "feat(TASK-XXX): 任务标题"
178
+
179
+ openmatrix step --json # 获取下一个任务 + 检查是否全部完成
180
+ ```
181
+ `openmatrix step` 从磁盘读取真实状态,不依赖上下文记忆。
182
+ </LOOP-ENFORCEMENT>
183
+
184
+ #### 5.1 歧义检测机制(全自动模式)
185
+
186
+ **Agent 输出中可能包含歧义报告(JSON 格式):**
187
+
188
+ Agent 输出包含以下标记时,表示检测到歧义:
189
+ ```
190
+ <AMBIGUITY_REPORT>
191
+ {
192
+ "ambiguities": [
193
+ {
194
+ "type": "missing_info" | "conflicting_req" | "unclear_scope" | "tech_choice" | "edge_case",
195
+ "severity": "critical" | "high" | "medium" | "low",
196
+ "description": "歧义描述",
197
+ "suggestions": ["建议1", "建议2"]
198
+ }
199
+ ],
200
+ "overallSeverity": "critical" | "high" | "medium" | "low"
201
+ }
202
+ </AMBIGUITY_REPORT>
203
+ ```
204
+
205
+ #### 5.2 歧义处理策略(全自动模式)
206
+
207
+ **在 `/om:auto` 全自动模式下,所有歧义写入 Meeting 继续执行,不中断流程:**
208
+
209
+ | 严重程度 | 处理方式 |
210
+ |---------|---------|
211
+ | **Critical** | Meeting + 继续执行其他任务 |
212
+ | **High** | Meeting + 继续执行其他任务 |
213
+ | **Medium** | Meeting + 继续执行其他任务 |
214
+ | **Low** | Meeting + 继续执行其他任务 |
215
+
216
+ **全自动模式特点:**
217
+ - **不使用 AskUserQuestion** 全自动执行,零人工干预
218
+ - **所有歧义写入 Meeting** — 执行完成后统一展示
219
+ - **继续执行其他任务** — 最大化并行度,无阻塞等待
220
+
221
+ **Meeting 处理流程:**
222
+ ```bash
223
+ openmatrix meeting --create --task TASK-XXX --reason "歧义: ${description}" --severity ${overallSeverity}
224
+ openmatrix step --json
225
+ ```
226
+
227
+ **执行完成后提示用户:**
228
+ ```
229
+ 检测到 N 个歧义记录,请使用 /om:meeting 统一处理
230
+ ```
231
+
232
+ #### 5.3 执行 Agent 任务
233
+
234
+ ```typescript
235
+ Agent({
236
+ subagent_type: task.subagent_type,
237
+ description: task.description,
238
+ prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要(不超过3行):\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行以下 Git 命令**:\n- ❌ git commit — 所有提交统一通过 openmatrix complete 执行\n- ❌ git checkout — 不要切换分支\n- ❌ git merge — 不要合并其他分支\n- ❌ git pull — 不要拉取远程更新\n- ❌ git push — 不要推送代码\n- ❌ git rebase — 不要变基\n- ❌ git branch — 不要创建/删除分支\n\n✅ 允许:git status, git diff, git log",
239
+ isolation: task.isolation,
240
+ run_in_background: true
241
+ })
242
+ ```
243
+
244
+ 每个 Agent 完成后:
245
+ 1. **保存 Agent 上下文**将执行结果摘要写入 `.openmatrix/tasks/TASK-XXX/context.md`:
246
+
247
+ ```markdown
248
+ ## 任务: TASK-XXX 任务标题
249
+
250
+ ### 关键决策
251
+ - [做出的重要决策]
252
+
253
+ ### 创建/修改的文件
254
+ - `path/to/file1.ts` - 简述用途
255
+
256
+ ### 对后续任务的建议
257
+ - [下一个 Agent 应该注意什么]
258
+ ```
259
+
260
+ 2. **标记完成并更新统计(必须执行):**
261
+ ```bash
262
+ openmatrix complete TASK-XXX --success
263
+ ```
264
+
265
+ 3. **获取下一个任务(必须执行,防止上下文压缩丢失):**
266
+ ```bash
267
+ openmatrix step --json
268
+ ```
269
+
270
+ **返回值解析:**
271
+
272
+ | status | 含义 | 后续操作 |
273
+ |--------|------|---------|
274
+ | `next` | 有下一个任务 | 继续执行返回的 `subagent` 配置 |
275
+ | `done` | 所有任务完成 | 进入最终提交 |
276
+ | `blocked` | 无可执行任务 | 直接跳过,继续执行其他任务 |
277
+
278
+ **中断恢复:** 如果会话中断,再次执行 `/om:auto` 时:
279
+ 1. 执行 `openmatrix step --json`
280
+ 2. 如果返回 `status: "next"` → 从返回的任务继续执行
281
+ 3. 如果返回 `status: "done"` 所有任务已完成
282
+ 4. 如果返回 `status: "blocked"` → 有阻塞任务需要处理
283
+
284
+ **Agent 上下文共享机制 (Agent Memory):**
285
+
286
+ 每个 Agent 执行时会自动接收前序 Agent 的上下文信息(通过 `context.md` 文件)。
287
+
288
+ ```
289
+ Agent-1 完成 → 写入 context.md → Agent-2 读取 Agent-1 的上下文 → 写入 context.md → ...
290
+ ```
291
+
292
+ **所有任务完成后,执行最终 Git 提交:**
293
+ ```bash
294
+ git add . && git commit -m "$(cat <<'EOF'
295
+ feat: 任务标题
296
+
297
+ 改动点1
298
+ 改动点2
299
+
300
+ 影响范围: 模块名
301
+ 文件改动: 文件1, 文件2
302
+
303
+ Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
304
+ EOF
305
+ )"
306
+ ```
307
+
308
+ **Git 提交格式规范(所有提交必须遵守):**
309
+
310
+ ```
311
+ <type>(TASK-XXX): 简短描述
312
+
313
+ 改动点1
314
+ 改动点2
315
+
316
+ 影响范围: 模块名
317
+ 文件改动: 文件1, 文件2
318
+
319
+ Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
320
+ ```
321
+
322
+ **type 映射:** feat(新功能) / fix(修复) / test(测试) / refactor(重构) / docs(文档)
323
+ **禁止使用 emoji**,使用纯文本格式
324
+
325
+ </process>
326
+
327
+ <arguments>
328
+ $ARGUMENTS
329
+ </arguments>
330
+
331
+ <examples>
332
+ /om:auto
333
+ /om:auto "实现用户登录功能"
334
+ /om:auto --quality fast
335
+ </examples>
336
+
337
+ <notes>
338
+ ## 流程定位
339
+
340
+ ```
341
+ 需求 brainstorm (澄清需求) plan (生成方案) → auto (全自动执行) → end
342
+ ```
343
+
344
+ auto 和 start 在同一位置,区别在于:
345
+ - **start**: 交互式,询问质量/E2E/模式,有审批节点
346
+ - **auto**: 零交互,不询问任何问题,无审批节点,质量通过 --quality 指定
347
+
348
+ 前置条件(同 start):
349
+ - `.openmatrix/plan.md` — 技术方案(由 /om:plan 生成)
350
+ - `.openmatrix/tasks-input.json` 结构化元数据(由 /om:plan 生成)
351
+
352
+ 如果前置条件不满足,自动调用 /om:plan 生成。
353
+
354
+ ## 执行流程
355
+
356
+ ```
357
+ Step 1: 初始化 → Step 2: 验证前置条件
358
+ → Step 3: openmatrix start --tasks-json --mode auto (必须)
359
+ → Step 4: 读取 subagentTasks
360
+ → Step 5: Agent 逐个执行 (只有这里写代码)
361
+ ```
362
+
363
+ ## 质量级别
364
+
365
+ | 级别 | TDD | 覆盖率 | Lint | 安全扫描 |
366
+ |------|:---:|:------:|:----:|:--------:|
367
+ | **strict** | Y | >80% | Y | Y |
368
+ | **balanced** | N | >60% | Y | Y |
369
+ | **fast** | N | 无要求 | N | N |
370
+
371
+ ## Git 提交格式
372
+
373
+ ```
374
+ <type>(TASK-XXX): 简短描述
375
+
376
+ 改动点1 / 改动点2
377
+ 影响范围: 模块名
378
+ 文件改动: 文件1, 文件2
379
+ Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
380
+ ```
381
+
382
+ type: feat/fix/test/refactor/docs。禁止 emoji。
383
+ </notes>