openmatrix 0.1.43 → 0.1.44

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 (2) hide show
  1. package/package.json +1 -1
  2. package/skills/start.md +76 -104
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openmatrix",
3
- "version": "0.1.43",
3
+ "version": "0.1.44",
4
4
  "description": "AI Agent task orchestration system with Claude Code Skills integration",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
package/skills/start.md CHANGED
@@ -4,20 +4,11 @@ description: 启动新的任务执行周期
4
4
  ---
5
5
 
6
6
  <EXTREMELY-IMPORTANT>
7
- ## 必须使用此 Skill 的情况
8
-
9
7
  **任何可以拆分为多个步骤的任务,都必须使用 /om:start 执行!**
10
8
 
11
- 禁止行为:
12
- - ❌ 直接开始写代码
13
- - ❌ 直接修改多个文件
14
- - ❌ 跳过任务规划直接执行
15
-
16
- **判断标准:**
17
- - 任务需要修改 2+ 个文件 → 必须使用
18
- - 任务需要 30+ 分钟 → 必须使用
19
- - 任务包含多个子任务 → 必须使用
9
+ 禁止: 直接写代码 / 直接改多文件 / 跳过规划
20
10
 
11
+ 判断: 改 2+ 文件 → 用 /om:start | 30+ 分钟 → 用 /om:start | 多子任务 → 用 /om:start
21
12
  **When in doubt → USE /om:start.**
22
13
  </EXTREMELY-IMPORTANT>
23
14
 
@@ -26,28 +17,26 @@ description: 启动新的任务执行周期
26
17
  </NO-OTHER-SKILLS>
27
18
 
28
19
  <objective>
29
- 解析任务,确认后启动执行。核心原则:理解优先于配置。
20
+ 确认配置 → 拆解任务 → 执行 → 验证 → 完成
30
21
  </objective>
31
22
 
32
23
  <process>
33
24
  ## 前置检查
34
25
 
35
- 1. **初始化** - 检查 `.openmatrix/` 目录,不存在则 `openmatrix start --init-only`
36
- 2. **检查状态** - 如果已有 running 状态,提示先完成或暂停
37
- 3. **Git 检查** - 无 `.git` 则询问是否初始化
38
- 4. **解析输入** - `$ARGUMENTS` 为空则询问用户任务内容
39
- 5. **检查 brainstorm** - 如果有完成的头脑风暴会话,继承其答案
26
+ 1. `.openmatrix/` 不存在则 `openmatrix start --init-only`
27
+ 2. 已有 running 状态则提示先完成或暂停
28
+ 3. 无 `.git` 则询问是否初始化
29
+ 4. `$ARGUMENTS` 为空则询问用户任务内容
30
+ 5. 有已完成的 brainstorm 会话则继承答案
40
31
 
41
32
  ---
42
33
 
43
- ## Step 1: 理解 + 质量选择
34
+ ## Step 1: 配置
44
35
 
45
- 调用 CLI 分析任务:
46
36
  ```bash
47
37
  openmatrix analyze "$ARGUMENTS" --markdown
48
38
  ```
49
39
 
50
- 让用户选择质量级别和确认理解:
51
40
  ```typescript
52
41
  AskUserQuestion({
53
42
  questions: [
@@ -55,28 +44,29 @@ AskUserQuestion({
55
44
  question: "选择质量级别:",
56
45
  header: "质量",
57
46
  options: [
58
- { label: "fast", description: "快速原型,>20% 覆盖率,无 TDD/Lint" },
47
+ { label: "fast", description: "快速原型,>20% 覆盖率" },
59
48
  { label: "balanced (推荐)", description: "日常开发,>60% 覆盖率" },
60
- { label: "strict", description: "生产代码,TDD + >80% 覆盖率" }
49
+ { label: "strict", description: "生产代码,TDD + >80%" }
61
50
  ],
62
51
  multiSelect: false
63
52
  },
64
53
  {
65
- question: "是否需要生成文档?",
54
+ question: "是否需要文档?",
66
55
  header: "文档",
67
56
  options: [
68
- { label: "无需文档", description: "不生成文档" },
69
- { label: "基础文档", description: "README 或 API 文档" },
70
- { label: "完整文档", description: "详细文档和示例" }
57
+ { label: "无需文档", description: "不生成" },
58
+ { label: "基础文档", description: "README 或 API" },
59
+ { label: "完整文档", description: "文档 + 示例" }
71
60
  ],
72
61
  multiSelect: false
73
62
  },
74
63
  {
75
- question: "以上理解正确吗?",
76
- header: "确认",
64
+ question: "执行模式:",
65
+ header: "模式",
77
66
  options: [
78
- { label: "确认执行", description: "开始执行" },
79
- { label: "补充说明", description: "提供更多细节" }
67
+ { label: "全自动", description: "问题自动跳过记录到 Meeting" },
68
+ { label: "关键节点确认", description: "plan/merge 时暂停" },
69
+ { label: "每步确认", description: "每任务完成后暂停" }
80
70
  ],
81
71
  multiSelect: false
82
72
  }
@@ -84,101 +74,83 @@ AskUserQuestion({
84
74
  })
85
75
  ```
86
76
 
87
- ---
88
-
89
- ## Step 2: 拆解 + 执行模式
77
+ 展示配置总结,让用户确认或修改:
90
78
 
91
- ```bash
92
- openmatrix start "$TASK_INPUT" --quality "$QUALITY_LEVEL" --mode "$MODE" --json
93
79
  ```
94
-
95
- **必须解析 CLI 返回的 JSON 并执行 SubagentTask:**
96
-
97
- ```typescript
98
- const result = JSON.parse(cliOutput);
99
- if (result.status === 'continue' && result.subagentTasks?.length > 0) {
100
- for (const task of result.subagentTasks) {
101
- await Agent({
102
- subagent_type: task.subagent_type,
103
- description: task.description,
104
- prompt: task.prompt,
105
- isolation: task.isolation
106
- });
107
- await Bash({
108
- command: `openmatrix complete ${task.taskId} --${success ? 'success' : 'failed'}`,
109
- description: `Mark task ${task.taskId}`
110
- });
111
- }
112
- }
80
+ 任务配置:
81
+ 任务: (标题)
82
+ 质量: balanced (>60% 覆盖率)
83
+ 文档: 基础文档
84
+ 模式: 全自动
85
+ 技术栈: TypeScript, Vue.js
113
86
  ```
114
87
 
115
- 选择执行模式:
116
88
  ```typescript
117
89
  AskUserQuestion({
118
90
  questions: [{
119
- question: "选择执行模式:",
120
- header: "模式",
91
+ question: "以上配置正确吗?",
92
+ header: "确认",
121
93
  options: [
122
- { label: "全自动执行", description: "问题自动跳过记录到 Meeting" },
123
- { label: "关键节点确认", description: "plan/merge 时暂停确认" },
124
- { label: "每步确认", description: "每任务完成后暂停" }
94
+ { label: "确认,开始执行", description: "使用以上配置" },
95
+ { label: "需要修改", description: "修改某项配置" },
96
+ { label: "补充说明", description: "提供更多任务细节" }
125
97
  ],
126
98
  multiSelect: false
127
99
  }]
128
100
  })
129
101
  ```
130
102
 
103
+ **确认** → Step 2 | **修改** → 回到 Step 1 | **补充** → 询问后重新分析
104
+
131
105
  ---
132
106
 
133
- ## Step 3: 执行
107
+ ## Step 2: 拆解
134
108
 
135
- 从此步骤开始,除非遇到风险操作或 meeting,**不得暂停询问用户**。
109
+ ```bash
110
+ openmatrix start "$TASK_INPUT" --quality "$QUALITY" --mode "$MODE" --json
111
+ ```
136
112
 
137
- ### 执行循环
113
+ CLI 返回 3 个任务: 规划(planner) → 开发(coder) → 验证(tester)
138
114
 
115
+ 展示任务列表:
139
116
  ```
140
- while (有待执行任务) {
141
- 1. 读取状态文件获取 SubagentTask
142
- 2. Agent 工具执行 Subagent
143
- 3. openmatrix complete <taskId> --success/--failed
144
- 4. Git 自动提交
145
- 5. 检查是否需要审批 (按执行模式)
146
- }
117
+ 任务计划:
118
+ 1. [规划] XXX - 需求分析与规划
119
+ 2. [开发] XXX - 开发实现 (依赖 1)
120
+ 3. [验证] XXX - 验证 (依赖 2)
147
121
  ```
148
122
 
149
- ### 失败处理
150
-
151
- 失败的任务自动跳过并记录。执行结束后统一提示失败任务,提供重试/跳过选项。
152
-
153
- ### Meeting 处理
154
-
155
- 阻塞任务自动记录到 Meeting。使用 AskUserQuestion 逐个处理: 提供信息/跳过/重试。
156
-
157
123
  ---
158
124
 
159
- ## Step 4: 验证
125
+ ## Step 3: 执行
126
+
127
+ **从此步骤开始,除非遇到风险操作或 Meeting,不得暂停询问用户。**
160
128
 
161
- 根据质量级别自动执行: 编译 → 测试 → 覆盖率 → Lint → 安全扫描
129
+ ```
130
+ while (有待执行任务) {
131
+ 1. Agent 工具执行 SubagentTask
132
+ 2. openmatrix complete <taskId> --success/--failed
133
+ 3. Git 自动提交
134
+ }
135
+ ```
162
136
 
163
- 只需输出简短结果,如: `Tests: 15/15 passed, 85% | Build: OK | Lint: OK | Security: OK`
137
+ - **失败任务**: 自动跳过并记录,执行结束后统一提示
138
+ - **阻塞任务**: 记录到 Meeting,暂停用 AskUserQuestion 处理
164
139
 
165
140
  ---
166
141
 
167
- ## Step 5: 验收
142
+ ## Step 4: 验证 + 完成
168
143
 
169
- 检查验收标准是否全部通过。通过则继续,不通过则提示失败项。
144
+ 根据质量级别执行: 编译 → 测试 → 覆盖率 → Lint → 安全扫描
170
145
 
171
- ---
172
-
173
- ## Step 6: 完成
146
+ 输出: `Tests: 15/15, 85% | Build: OK | Lint: OK | Security: OK`
174
147
 
175
- 输出简短总结: 总任务数、成功/失败数、Git commits 数量。
148
+ 通过则输出总结: 任务数、成功/失败、commits 数。
149
+ 不通过则提示失败项。
176
150
 
177
151
  ---
178
152
 
179
- ## 风险操作清单
180
-
181
- 以下操作在任何执行模式下都需要用户确认:
153
+ ## 风险操作 (任何模式下都需确认)
182
154
 
183
155
  | 类型 | 操作 |
184
156
  |------|------|
@@ -195,29 +167,29 @@ $ARGUMENTS
195
167
  </arguments>
196
168
 
197
169
  <examples>
198
- /om:start # 交互式输入任务
199
- /om:start docs/task.md # 从文件读取任务
200
- /om:start "实现用户登录功能" # 直接描述任务
170
+ /om:start # 交互式输入
171
+ /om:start docs/task.md # 从文件
172
+ /om:start "实现用户登录功能" # 直接描述
201
173
  </examples>
202
174
 
203
175
  <notes>
204
176
  ## 质量级别
205
177
 
206
- | 级别 | TDD | 覆盖率 | Lint | 安全 | E2E | 适用场景 |
207
- |------|:---:|:------:|:----:|:----:|:---:|---------|
208
- | **strict** | ✅ | >80% | ✅ 严格 | ✅ | 可选 | 生产代码 |
209
- | **balanced** | ❌ | >60% | ✅ | ✅ | 可选 | 日常开发 |
210
- | **fast** | ❌ | >20% | ❌ | ❌ | ❌ | 快速原型 |
178
+ | 级别 | TDD | 覆盖率 | Lint | 安全 | 适用 |
179
+ |------|:---:|:------:|:----:|:----:|------|
180
+ | **strict** | ✅ | >80% | ✅ | ✅ | 生产代码 |
181
+ | **balanced** | ❌ | >60% | ✅ | ✅ | 日常开发 |
182
+ | **fast** | ❌ | >20% | ❌ | ❌ | 快速原型 |
211
183
 
212
184
  ## 执行模式
213
185
 
214
- | 模式 | 审批点 | 适用场景 |
215
- |------|--------|---------|
216
- | 全自动 | 自动批准 | 简单任务 |
217
- | 关键节点 | plan/merge 暂停 | 常规任务 |
218
- | 每步确认 | 每任务暂停 | 重要任务 |
186
+ | 模式 | 暂停点 | 适用 |
187
+ |------|--------|------|
188
+ | 全自动 | 不暂停 | 简单任务 |
189
+ | 关键节点 | plan/merge | 常规任务 |
190
+ | 每步确认 | 每任务 | 重要任务 |
219
191
 
220
- ## Git 提交格式
192
+ ## Git 提交
221
193
 
222
194
  ```
223
195
  <type>: (TASK-XXX) 简短描述