openmatrix 0.1.0 → 0.1.2
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/README.md +397 -512
- package/dist/cli/commands/auto.d.ts +2 -0
- package/dist/cli/commands/auto.js +226 -0
- package/dist/cli/commands/install-skills.d.ts +3 -0
- package/dist/cli/commands/install-skills.js +134 -0
- package/dist/cli/index.js +4 -0
- package/package.json +3 -2
- package/skills/auto.md +218 -0
- package/skills/om.md +124 -0
- package/skills/start.md +153 -21
package/README.md
CHANGED
|
@@ -1,512 +1,397 @@
|
|
|
1
|
-
# OpenMatrix
|
|
2
|
-
|
|
3
|
-
<div align="center">
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
*自动化 ≠ 牺牲质量 | 高质量 ≠ 手动操作*
|
|
8
|
-
|
|
9
|
-
[](https://
|
|
10
|
-
[](https://opensource.org/licenses/MIT)
|
|
11
|
-
[](https://nodejs.org/)
|
|
12
|
-
[](https://claude.ai/code)
|
|
13
|
-
|
|
14
|
-
|
|
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
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
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
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
```
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
```
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
###
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
```
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
"acceptance": { "met": 5, "total": 5 }
|
|
399
|
-
}
|
|
400
|
-
```
|
|
401
|
-
|
|
402
|
-
---
|
|
403
|
-
|
|
404
|
-
## 常见问题
|
|
405
|
-
|
|
406
|
-
### Q: 哪种质量级别适合我？
|
|
407
|
-
|
|
408
|
-
| 你的场景 | 推荐级别 |
|
|
409
|
-
|---------|---------|
|
|
410
|
-
| 🏭 生产代码、核心功能 | **strict** |
|
|
411
|
-
| 📦 日常功能开发 | **balanced** |
|
|
412
|
-
| 🏃 快速原型、POC | **fast** |
|
|
413
|
-
|
|
414
|
-
### Q: OpenMatrix 和 superpowers 可以一起用吗？
|
|
415
|
-
|
|
416
|
-
**A**: 可以！OpenMatrix 自动执行任务，superpowers 提供额外技能。
|
|
417
|
-
|
|
418
|
-
### Q: Meeting 是什么？
|
|
419
|
-
|
|
420
|
-
**A**: 遇到阻塞时创建记录，但**不停止执行**。最后用 `/om:meeting` 统一处理。
|
|
421
|
-
|
|
422
|
-
---
|
|
423
|
-
|
|
424
|
-
## 配置
|
|
425
|
-
|
|
426
|
-
`.openmatrixrc.json`:
|
|
427
|
-
|
|
428
|
-
```json
|
|
429
|
-
{
|
|
430
|
-
"quality": {
|
|
431
|
-
"tdd": false,
|
|
432
|
-
"minCoverage": 60,
|
|
433
|
-
"strictLint": true,
|
|
434
|
-
"securityScan": true
|
|
435
|
-
},
|
|
436
|
-
"approvalPoints": ["plan", "merge"],
|
|
437
|
-
"agents": { "maxConcurrent": 3 }
|
|
438
|
-
}
|
|
439
|
-
```
|
|
440
|
-
|
|
441
|
-
---
|
|
442
|
-
|
|
443
|
-
## 开发
|
|
444
|
-
|
|
445
|
-
```bash
|
|
446
|
-
git clone https://github.com/bigfish1913/openmatrix.git
|
|
447
|
-
cd openmatrix && npm install && npm run build && npm test
|
|
448
|
-
```
|
|
449
|
-
|
|
450
|
-
---
|
|
451
|
-
|
|
452
|
-
## Roadmap
|
|
453
|
-
|
|
454
|
-
- [x] TDD 模式
|
|
455
|
-
- [x] 6 道质量门禁
|
|
456
|
-
- [x] Meeting 机制
|
|
457
|
-
- [x] 质量报告
|
|
458
|
-
- [x] AI 验收
|
|
459
|
-
- [ ] VSCode 扩展
|
|
460
|
-
- [ ] Python/Go 支持
|
|
461
|
-
- [ ] CI/CD 集成
|
|
462
|
-
|
|
463
|
-
---
|
|
464
|
-
|
|
465
|
-
<div align="center">
|
|
466
|
-
|
|
467
|
-
**如果觉得有用，请给个 ⭐ Star！**
|
|
468
|
-
|
|
469
|
-
MIT © 2024 | Made by [bigfish1913](https://github.com/bigfish1913)
|
|
470
|
-
|
|
471
|
-
</div>
|
|
472
|
-
|
|
473
|
-
---
|
|
474
|
-
|
|
475
|
-
# English
|
|
476
|
-
|
|
477
|
-
## OpenMatrix: High Quality + Full Automation
|
|
478
|
-
|
|
479
|
-
The **only** AI task orchestration with TDD + Quality Gates + 100% Automation.
|
|
480
|
-
|
|
481
|
-
### Quick Start
|
|
482
|
-
|
|
483
|
-
```bash
|
|
484
|
-
# Install
|
|
485
|
-
git clone https://github.com/bigfish1913/openmatrix.git
|
|
486
|
-
cd openmatrix && npm install && npm run build && npm link
|
|
487
|
-
mkdir -p ~/.claude/commands/om && cp skills/*.md ~/.claude/commands/om/
|
|
488
|
-
|
|
489
|
-
# Use (first question asks quality level)
|
|
490
|
-
/om:start Implement user login
|
|
491
|
-
```
|
|
492
|
-
|
|
493
|
-
### Quality Levels
|
|
494
|
-
|
|
495
|
-
| Level | TDD | Coverage | Gates | Use Case |
|
|
496
|
-
|-------|:---:|:--------:|:-----:|----------|
|
|
497
|
-
| **strict** | ✅ | 80% | 6 | Production code |
|
|
498
|
-
| **balanced** | ❌ | 60% | 4 | Daily development |
|
|
499
|
-
| **fast** | ❌ | 0% | 1 | Prototypes |
|
|
500
|
-
|
|
501
|
-
### Key Features
|
|
502
|
-
|
|
503
|
-
- ✅ **Quality Level Selection** - First question you answer
|
|
504
|
-
- ✅ **TDD Mode** - strict level includes test-first
|
|
505
|
-
- ✅ **6 Quality Gates** - Build, Tests, Coverage, Lint, Security, Acceptance
|
|
506
|
-
- ✅ **AI Acceptance** - Reviewer Agent validates final result
|
|
507
|
-
- ✅ **Meeting Mechanism** - Blockers don't stop execution
|
|
508
|
-
- ✅ **Quality Reports** - JSON format for every task
|
|
509
|
-
|
|
510
|
-
### License
|
|
511
|
-
|
|
512
|
-
MIT
|
|
1
|
+
# OpenMatrix
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
|
|
5
|
+
**同时实现 TDD + 严格质量门禁 + 全自动执行的 AI 任务编排系统**
|
|
6
|
+
|
|
7
|
+
*自动化 ≠ 牺牲质量 | 高质量 ≠ 手动操作*
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/openmatrix)
|
|
10
|
+
[](https://opensource.org/licenses/MIT)
|
|
11
|
+
[](https://nodejs.org/)
|
|
12
|
+
[](https://claude.ai/code)
|
|
13
|
+
[](https://matrix.laofu.online/)
|
|
14
|
+
|
|
15
|
+
**[📚 官方文档](https://matrix.laofu.online/docs/)** | **[🚀 快速开始](https://matrix.laofu.online/docs/getting-started/)** | **[💬 GitHub](https://github.com/bigfish1913/openmatrix)**
|
|
16
|
+
|
|
17
|
+
**[中文](README.md)** | **[English](README_EN.md)**
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 一句话介绍
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
/om 实现用户登录
|
|
27
|
+
# 自动启动任务编排，第一个问题选质量级别，然后全自动执行
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
> `/om` 是 `/om:start` 的快捷方式，功能完全相同
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 执行流程概览
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
用户输入 → 质量选择 → 任务规划 → 执行 → 质量门禁 → AI验收 → Meeting处理 → 完成
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
| 阶段 | 说明 | 关键点 |
|
|
41
|
+
|:----:|------|--------|
|
|
42
|
+
| 0 | 交互问答 | **第一个问题选质量级别** |
|
|
43
|
+
| 1 | 任务规划 | Planner Agent 生成计划 |
|
|
44
|
+
| 2 | 任务执行 | strict/balanced/fast 三种模式 |
|
|
45
|
+
| 3 | 质量门禁 | 6 道质量门禁验证 |
|
|
46
|
+
| 4 | AI 验收 | Reviewer Agent 最终确认 |
|
|
47
|
+
| 5 | Meeting | 阻塞不中断，最后处理并**重新执行** |
|
|
48
|
+
| 6 | 最终报告 | 质量评分 + 产出文件 |
|
|
49
|
+
|
|
50
|
+
📖 **详细流程图**: [docs/FLOW.md](docs/FLOW.md) (含 Mermaid 图表)
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 为什么选择 OpenMatrix？
|
|
55
|
+
|
|
56
|
+
### 与 superpowers / gsd 对比
|
|
57
|
+
|
|
58
|
+
| 特性 | OpenMatrix | superpowers | gsd |
|
|
59
|
+
|------|:----------:|:-----------:|:---:|
|
|
60
|
+
| **100% 自动化** | ✅ auto 模式 | ❌ 50% | ❌ 60% |
|
|
61
|
+
| **TDD 内置** | ✅ strict 模式 | ❌ 需手动 | ❌ 无 |
|
|
62
|
+
| **覆盖率强制** | ✅ 60-80% | ❌ 无 | ❌ 无 |
|
|
63
|
+
| **安全扫描** | ✅ npm audit | ❌ 无 | ❌ 无 |
|
|
64
|
+
| **AI 验收** | ✅ Reviewer Agent | ❌ 无 | 部分 |
|
|
65
|
+
| **阻塞不中断** | ✅ Meeting 机制 | ❌ 停止 | ❌ 停止 |
|
|
66
|
+
| **质量报告** | ✅ JSON + MD | ❌ 无 | 部分 |
|
|
67
|
+
| **上手难度** | ⚡ 一句话开始 | 中等 | 较高 |
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 快速开始
|
|
72
|
+
|
|
73
|
+
### 安装
|
|
74
|
+
|
|
75
|
+
**方式一: NPM 安装 (推荐)**
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
# 全局安装
|
|
79
|
+
npm install -g openmatrix
|
|
80
|
+
|
|
81
|
+
# Skills 会自动安装到 ~/.claude/commands/om/
|
|
82
|
+
# 如果自动安装失败，手动执行:
|
|
83
|
+
openmatrix install-skills
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
**方式二: 从源码安装**
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
# 克隆并安装
|
|
90
|
+
git clone https://github.com/bigfish1913/openmatrix.git
|
|
91
|
+
cd openmatrix && npm install && npm run build && npm link
|
|
92
|
+
|
|
93
|
+
# 安装 Skills (如果 postinstall 未自动执行)
|
|
94
|
+
openmatrix install-skills
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### 验证安装
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
# 检查 CLI 是否可用
|
|
101
|
+
openmatrix --version
|
|
102
|
+
|
|
103
|
+
# 检查 Skills 是否安装成功
|
|
104
|
+
openmatrix install-skills
|
|
105
|
+
# 或直接查看
|
|
106
|
+
ls ~/.claude/commands/om/
|
|
107
|
+
# 应显示: start.md auto.md status.md approve.md meeting.md resume.md retry.md report.md
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### 第一次使用
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
/om:start 实现用户登录功能
|
|
114
|
+
|
|
115
|
+
# 系统会先问:
|
|
116
|
+
┌─────────────────────────────────────────────────────────┐
|
|
117
|
+
│ 问题 0: 选择质量级别 │
|
|
118
|
+
├─────────────────────────────────────────────────────────┤
|
|
119
|
+
│ 🚀 strict → TDD + 80%覆盖率 + AI验收 (推荐生产代码) │
|
|
120
|
+
│ ⚖️ balanced → 60%覆盖率 + AI验收 (日常开发) │
|
|
121
|
+
│ ⚡ fast → 无质量门禁 (快速原型) │
|
|
122
|
+
└─────────────────────────────────────────────────────────┘
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## 核心特性
|
|
128
|
+
|
|
129
|
+
### 1️⃣ 三级质量配置 (第一个问题就让你选)
|
|
130
|
+
|
|
131
|
+
| 级别 | TDD | 覆盖率 | Lint | 安全 | AI验收 | 适用场景 |
|
|
132
|
+
|:----:|:---:|:------:|:----:|:----:|:------:|---------|
|
|
133
|
+
| **strict** | ✅ | >80% | ✅ 严格 | ✅ | ✅ | 🏭 **生产代码** |
|
|
134
|
+
| **balanced** | ❌ | >60% | ✅ | ✅ | ✅ | 📦 日常开发 |
|
|
135
|
+
| **fast** | ❌ | >20% | ❌ | ❌ | ❌ | 🏃 快速原型 |
|
|
136
|
+
|
|
137
|
+
> strict 可配置为 100%。默认 >80% 覆盖核心业务逻辑。
|
|
138
|
+
|
|
139
|
+
### 2️⃣ 六道质量门禁 (Verify 阶段)
|
|
140
|
+
|
|
141
|
+
```
|
|
142
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
143
|
+
│ Verify 阶段 - 质量门禁 │
|
|
144
|
+
├─────────────────────────────────────────────────────────────┤
|
|
145
|
+
│ 🚪 Gate 1: 编译检查 npm run build → 必须通过 │
|
|
146
|
+
│ 🚪 Gate 2: 测试运行 npm test → 必须通过 │
|
|
147
|
+
│ 🚪 Gate 3: 覆盖率检查 >20%/60%/80% → 可配置 │
|
|
148
|
+
│ 🚪 Gate 4: Lint 检查 无 error → 可配置 │
|
|
149
|
+
│ 🚪 Gate 5: 安全扫描 npm audit → 无高危漏洞 │
|
|
150
|
+
│ 🚪 Gate 6: 验收标准 用户定义 → 必须全部满足 │
|
|
151
|
+
└─────────────────────────────────────────────────────────────┘
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### 3️⃣ TDD 模式 (strict 级别)
|
|
155
|
+
|
|
156
|
+
```
|
|
157
|
+
传统开发: 代码 → 测试 → Bug → 修复 → 回归 → ... (循环多次)
|
|
158
|
+
|
|
159
|
+
OpenMatrix TDD (strict):
|
|
160
|
+
🧪 测试阶段: 先写测试 (RED - 测试必须失败)
|
|
161
|
+
✨ 开发阶段: 再写代码 (GREEN - 测试必须通过)
|
|
162
|
+
✅ 验证阶段: 6道质量门禁
|
|
163
|
+
🎉 验收阶段: AI Reviewer 最终确认
|
|
164
|
+
|
|
165
|
+
结果: 第一次就写对，无需返工
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
### 4️⃣ Meeting 机制 (阻塞不中断)
|
|
169
|
+
|
|
170
|
+
```
|
|
171
|
+
❌ 其他方案:
|
|
172
|
+
TASK-001 ✓ → TASK-002 阻塞 ⏸️ → 等用户... (浪费时间)
|
|
173
|
+
|
|
174
|
+
✅ OpenMatrix:
|
|
175
|
+
TASK-001 ✓ → TASK-002 阻塞 → 创建Meeting → 跳过 ↷
|
|
176
|
+
TASK-003 ✓ → TASK-004 ✓ → 完成!
|
|
177
|
+
→ 用户用 /om:meeting 统一处理所有阻塞
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
### 5️⃣ AI 验收 (Accept 阶段)
|
|
181
|
+
|
|
182
|
+
```
|
|
183
|
+
Accept 阶段由 Reviewer Agent 执行:
|
|
184
|
+
├── 检查 verify-report.md
|
|
185
|
+
├── 验证所有验收标准
|
|
186
|
+
├── 确认代码可合并
|
|
187
|
+
└── 生成 accept-report.md
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
## 执行流程
|
|
193
|
+
|
|
194
|
+
### strict 模式 (推荐生产代码)
|
|
195
|
+
|
|
196
|
+
```
|
|
197
|
+
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
|
198
|
+
│ TDD │────▶│ Develop │────▶│ Verify │────▶│ Accept │
|
|
199
|
+
│ 🧪 RED │ │ ✨ GREEN│ │ ✅ 6门禁│ │ 🎉 AI │
|
|
200
|
+
└─────────┘ └─────────┘ └─────────┘ └─────────┘
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
### balanced 模式 (日常开发)
|
|
204
|
+
|
|
205
|
+
```
|
|
206
|
+
┌─────────┐ ┌─────────┐ ┌─────────┐
|
|
207
|
+
│ Develop │────▶│ Verify │────▶│ Accept │
|
|
208
|
+
│ ✨ 编码 │ │ ✅ 4门禁│ │ 🎉 AI │
|
|
209
|
+
└─────────┘ └─────────┘ └─────────┘
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
---
|
|
213
|
+
|
|
214
|
+
## Skills 命令
|
|
215
|
+
|
|
216
|
+
| 命令 | 用途 |
|
|
217
|
+
|------|------|
|
|
218
|
+
| `/om` | **默认入口** - 直接输入任务描述即可启动 |
|
|
219
|
+
| `/om:start` | 启动新任务 (第一个问题选质量级别) |
|
|
220
|
+
| `/om:auto` | 🚀 **全自动执行** - 无阻塞、无确认、直接完成 |
|
|
221
|
+
| `/om:status` | 查看状态 |
|
|
222
|
+
| `/om:approve` | 审批决策 |
|
|
223
|
+
| `/om:meeting` | 处理阻塞问题 |
|
|
224
|
+
| `/om:resume` | 恢复中断 |
|
|
225
|
+
| `/om:retry` | 重试失败 |
|
|
226
|
+
| `/om:report` | 生成报告 |
|
|
227
|
+
|
|
228
|
+
> `/om` 是 `/om:start` 的快捷方式，功能完全相同
|
|
229
|
+
|
|
230
|
+
### `/om:start` 执行流程 (含 Meeting 机制)
|
|
231
|
+
|
|
232
|
+
```
|
|
233
|
+
┌──────────────────────────────────────────────────────────────────────────┐
|
|
234
|
+
│ 执行阶段 │
|
|
235
|
+
├──────────────────────────────────────────────────────────────────────────┤
|
|
236
|
+
│ │
|
|
237
|
+
│ TASK-001 ✅ ──→ TASK-002 ⚠️阻塞 ──→ 创建Meeting ──→ 跳过 ↷ │
|
|
238
|
+
│ │ │
|
|
239
|
+
│ ↓ │
|
|
240
|
+
│ TASK-003 ✅ ──→ TASK-004 ✅ ──→ TASK-005 ✅ ──→ 所有任务执行完成 │
|
|
241
|
+
│ │
|
|
242
|
+
└──────────────────────────────────────────────────────────────────────────┘
|
|
243
|
+
│
|
|
244
|
+
▼
|
|
245
|
+
┌──────────────────────────────────────────────────────────────────────────┐
|
|
246
|
+
│ Meeting 自动检测 │
|
|
247
|
+
├──────────────────────────────────────────────────────────────────────────┤
|
|
248
|
+
│ │
|
|
249
|
+
│ ┌─────────────────────┐ │
|
|
250
|
+
│ │ 有 pending Meeting? │ │
|
|
251
|
+
│ └──────────┬──────────┘ │
|
|
252
|
+
│ ╱ \ │
|
|
253
|
+
│ 否 是 │
|
|
254
|
+
│ │ │ │
|
|
255
|
+
│ ▼ ▼ │
|
|
256
|
+
│ ┌───────┐ ┌─────────────────────────────┐ │
|
|
257
|
+
│ │ 完成! │ │ 📋 交互式处理 Meeting │ │
|
|
258
|
+
│ └───────┘ │ ┌─────────────────────────┐│ │
|
|
259
|
+
│ │ │ [1] TASK-002: 数据库连接││ │
|
|
260
|
+
│ │ │ 💡提供信息 / ⏭️跳过 ││ │
|
|
261
|
+
│ │ │ [2] TASK-005: API决策 ││ │
|
|
262
|
+
│ │ │ 🤔选择方案 ││ │
|
|
263
|
+
│ │ └─────────────────────────┘│ │
|
|
264
|
+
│ └──────────────┬──────────────┘ │
|
|
265
|
+
│ │ │
|
|
266
|
+
│ ▼ │
|
|
267
|
+
│ ┌─────────────────────────────┐ │
|
|
268
|
+
│ │ 用户提供信息/选择方案 │ │
|
|
269
|
+
│ │ ↓ │ │
|
|
270
|
+
│ │ 🔄 重新执行阻塞任务 │ │
|
|
271
|
+
│ │ TASK-002 ✅ │ │
|
|
272
|
+
│ └──────────────┬──────────────┘ │
|
|
273
|
+
│ │ │
|
|
274
|
+
└────────────────────────────────────────────┼──────────────────────────────┘
|
|
275
|
+
│
|
|
276
|
+
▼
|
|
277
|
+
┌───────────┐
|
|
278
|
+
│ 完成! 🎉 │
|
|
279
|
+
└───────────┘
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
### `/om:auto` 全自动模式
|
|
283
|
+
|
|
284
|
+
**适用场景**: CI/CD、自动化脚本、无需人工干预的任务
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
/om:auto 实现用户登录功能 # 默认 strict 模式
|
|
288
|
+
/om:auto --mode=balanced 添加API接口 # 指定 balanced 模式
|
|
289
|
+
/om:auto --fast 创建CLI工具 # 快速原型模式
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
**特点**:
|
|
293
|
+
- ❌ 无审批点确认
|
|
294
|
+
- ❌ 无 Phase 间暂停
|
|
295
|
+
- ❌ Meeting 自动跳过 (记录但不阻塞)
|
|
296
|
+
- ✅ 默认 strict 质量级别
|
|
297
|
+
- ✅ 适合 CI/CD 集成
|
|
298
|
+
|
|
299
|
+
**与 `/om:start` 对比**:
|
|
300
|
+
|
|
301
|
+
| 特性 | `/om:start` | `/om:auto` |
|
|
302
|
+
|------|-------------|------------|
|
|
303
|
+
| 质量级别 | 交互式选择 | 参数指定/默认 strict |
|
|
304
|
+
| 审批确认 | 根据配置 | 全部跳过 |
|
|
305
|
+
| Meeting | 交互式处理 | 自动跳过 |
|
|
306
|
+
| 适用场景 | 日常开发 | CI/CD、自动化 |
|
|
307
|
+
|
|
308
|
+
---
|
|
309
|
+
|
|
310
|
+
## 质量报告
|
|
311
|
+
|
|
312
|
+
每个任务完成后生成:
|
|
313
|
+
|
|
314
|
+
```json
|
|
315
|
+
{
|
|
316
|
+
"taskId": "TASK-001",
|
|
317
|
+
"overall": "pass",
|
|
318
|
+
"tests": { "passed": 15, "failed": 0, "coverage": 82 },
|
|
319
|
+
"build": { "success": true },
|
|
320
|
+
"lint": { "errors": 0, "warnings": 3 },
|
|
321
|
+
"security": { "vulnerabilities": [] },
|
|
322
|
+
"acceptance": { "met": 5, "total": 5 }
|
|
323
|
+
}
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
---
|
|
327
|
+
|
|
328
|
+
## 常见问题
|
|
329
|
+
|
|
330
|
+
### Q: 哪种质量级别适合我？
|
|
331
|
+
|
|
332
|
+
| 你的场景 | 推荐级别 |
|
|
333
|
+
|---------|---------|
|
|
334
|
+
| 🏭 生产代码、核心功能 | **strict** |
|
|
335
|
+
| 📦 日常功能开发 | **balanced** |
|
|
336
|
+
| 🏃 快速原型、POC | **fast** |
|
|
337
|
+
|
|
338
|
+
### Q: OpenMatrix 和 superpowers 可以一起用吗？
|
|
339
|
+
|
|
340
|
+
**A**: 可以！OpenMatrix 自动执行任务，superpowers 提供额外技能。
|
|
341
|
+
|
|
342
|
+
### Q: Meeting 是什么？
|
|
343
|
+
|
|
344
|
+
**A**: 遇到阻塞时创建记录，但**不停止执行**。最后用 `/om:meeting` 统一处理。
|
|
345
|
+
|
|
346
|
+
---
|
|
347
|
+
|
|
348
|
+
## 配置
|
|
349
|
+
|
|
350
|
+
`.openmatrixrc.json`:
|
|
351
|
+
|
|
352
|
+
```json
|
|
353
|
+
{
|
|
354
|
+
"quality": {
|
|
355
|
+
"tdd": false,
|
|
356
|
+
"minCoverage": 60,
|
|
357
|
+
"strictLint": true,
|
|
358
|
+
"securityScan": true
|
|
359
|
+
},
|
|
360
|
+
"approvalPoints": ["plan", "merge"],
|
|
361
|
+
"agents": { "maxConcurrent": 3 }
|
|
362
|
+
}
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
---
|
|
366
|
+
|
|
367
|
+
## 开发
|
|
368
|
+
|
|
369
|
+
```bash
|
|
370
|
+
git clone https://github.com/bigfish1913/openmatrix.git
|
|
371
|
+
cd openmatrix && npm install && npm run build && npm test
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
---
|
|
375
|
+
|
|
376
|
+
## Roadmap
|
|
377
|
+
|
|
378
|
+
- [x] TDD 模式
|
|
379
|
+
- [x] 6 道质量门禁
|
|
380
|
+
- [x] Meeting 机制
|
|
381
|
+
- [x] 质量报告
|
|
382
|
+
- [x] AI 验收
|
|
383
|
+
- [x] `/om:auto` 全自动模式
|
|
384
|
+
- [x] Meeting 自动处理
|
|
385
|
+
- [ ] VSCode 扩展
|
|
386
|
+
- [ ] Python/Go 支持
|
|
387
|
+
- [ ] CI/CD 集成
|
|
388
|
+
|
|
389
|
+
---
|
|
390
|
+
|
|
391
|
+
<div align="center">
|
|
392
|
+
|
|
393
|
+
**如果觉得有用，请给个 ⭐ Star！**
|
|
394
|
+
|
|
395
|
+
MIT © 2024 | Made by [bigfish1913](https://github.com/bigfish1913)
|
|
396
|
+
|
|
397
|
+
</div>
|