openmatrix 0.1.1 → 0.1.3

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 (5) hide show
  1. package/README.md +412 -389
  2. package/dist/cli/commands/install-skills.js +51 -4
  3. package/package.json +1 -1
  4. package/skills/om.md +124 -0
  5. package/skills/openmatrix-auto.md +64 -0
package/README.md CHANGED
@@ -1,389 +1,412 @@
1
- # OpenMatrix
2
-
3
- <div align="center">
4
-
5
- **同时实现 TDD + 严格质量门禁 + 全自动执行的 AI 任务编排系统**
6
-
7
- *自动化 ≠ 牺牲质量 | 高质量 ≠ 手动操作*
8
-
9
- [![npm version](https://badge.fury.io/js/openmatrix.svg)](https://www.npmjs.com/package/openmatrix)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
11
- [![Node](https://img.shields.io/badge/Node-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
12
- [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blue.svg)](https://claude.ai/code)
13
-
14
- **[中文](README.md)** | **[English](README_EN.md)**
15
-
16
- </div>
17
-
18
- ---
19
-
20
- ## 一句话介绍
21
-
22
- ```bash
23
- /om:start 实现用户登录
24
- # 第一个问题让你选择质量级别，然后全自动执行 + 严格质量保证
25
- ```
26
-
27
- ---
28
-
29
- ## 执行流程概览
30
-
31
- ```
32
- 用户输入 → 质量选择 → 任务规划 → 执行 → 质量门禁 → AI验收 → Meeting处理 → 完成
33
- ```
34
-
35
- | 阶段 | 说明 | 关键点 |
36
- |:----:|------|--------|
37
- | 0 | 交互问答 | **第一个问题选质量级别** |
38
- | 1 | 任务规划 | Planner Agent 生成计划 |
39
- | 2 | 任务执行 | strict/balanced/fast 三种模式 |
40
- | 3 | 质量门禁 | 6 道质量门禁验证 |
41
- | 4 | AI 验收 | Reviewer Agent 最终确认 |
42
- | 5 | Meeting | 阻塞不中断，最后处理并**重新执行** |
43
- | 6 | 最终报告 | 质量评分 + 产出文件 |
44
-
45
- 📖 **详细流程图**: [docs/FLOW.md](docs/FLOW.md) (含 Mermaid 图表)
46
-
47
- ---
48
-
49
- ## 为什么选择 OpenMatrix？
50
-
51
- ### 与 superpowers / gsd 对比
52
-
53
- | 特性 | OpenMatrix | superpowers | gsd |
54
- |------|:----------:|:-----------:|:---:|
55
- | **100% 自动化** | ✅ auto 模式 | ❌ 50% | ❌ 60% |
56
- | **TDD 内置** | ✅ strict 模式 | ❌ 需手动 | ❌ 无 |
57
- | **覆盖率强制** | ✅ 60-80% | ❌ 无 | ❌ 无 |
58
- | **安全扫描** | ✅ npm audit | ❌ 无 | ❌ 无 |
59
- | **AI 验收** | ✅ Reviewer Agent | ❌ 无 | 部分 |
60
- | **阻塞不中断** | ✅ Meeting 机制 | ❌ 停止 | ❌ 停止 |
61
- | **质量报告** | ✅ JSON + MD | ❌ 无 | 部分 |
62
- | **上手难度** | ⚡ 一句话开始 | 中等 | 较高 |
63
-
64
- ---
65
-
66
- ## 快速开始
67
-
68
- ### 安装
69
-
70
- **方式一: NPM 安装 (推荐)**
71
-
72
- ```bash
73
- # 全局安装
74
- npm install -g openmatrix
75
-
76
- # Skills 会自动安装到 ~/.claude/commands/om/
77
- # 如果自动安装失败，手动执行:
78
- openmatrix install-skills
79
- ```
80
-
81
- **方式二: 从源码安装**
82
-
83
- ```bash
84
- # 克隆并安装
85
- git clone https://github.com/bigfish1913/openmatrix.git
86
- cd openmatrix && npm install && npm run build && npm link
87
-
88
- # 安装 Skills (如果 postinstall 未自动执行)
89
- openmatrix install-skills
90
- ```
91
-
92
- ### 验证安装
93
-
94
- ```bash
95
- # 检查 CLI 是否可用
96
- openmatrix --version
97
-
98
- # 检查 Skills 是否安装成功
99
- openmatrix install-skills
100
- # 或直接查看
101
- ls ~/.claude/commands/om/
102
- # 应显示: start.md auto.md status.md approve.md meeting.md resume.md retry.md report.md
103
- ```
104
-
105
- ### 第一次使用
106
-
107
- ```bash
108
- /om:start 实现用户登录功能
109
-
110
- # 系统会先问:
111
- ┌─────────────────────────────────────────────────────────┐
112
- │ 问题 0: 选择质量级别 │
113
- ├─────────────────────────────────────────────────────────┤
114
- │ 🚀 strict → TDD + 80%覆盖率 + AI验收 (推荐生产代码) │
115
- │ ⚖️ balanced → 60%覆盖率 + AI验收 (日常开发) │
116
- │ ⚡ fast → 无质量门禁 (快速原型) │
117
- └─────────────────────────────────────────────────────────┘
118
- ```
119
-
120
- ---
121
-
122
- ## 核心特性
123
-
124
- ### 1️⃣ 三级质量配置 (第一个问题就让你选)
125
-
126
- | 级别 | TDD | 覆盖率 | Lint | 安全 | AI验收 | 适用场景 |
127
- |:----:|:---:|:------:|:----:|:----:|:------:|---------|
128
- | **strict** | ✅ | >80% | ✅ 严格 | ✅ | ✅ | 🏭 **生产代码** |
129
- | **balanced** | ❌ | >60% | ✅ | ✅ | ✅ | 📦 日常开发 |
130
- | **fast** | ❌ | >20% | ❌ | ❌ | ❌ | 🏃 快速原型 |
131
-
132
- > strict 可配置为 100%。默认 >80% 覆盖核心业务逻辑。
133
-
134
- ### 2️⃣ 六道质量门禁 (Verify 阶段)
135
-
136
- ```
137
- ┌─────────────────────────────────────────────────────────────┐
138
- │ Verify 阶段 - 质量门禁 │
139
- ├─────────────────────────────────────────────────────────────┤
140
- │ 🚪 Gate 1: 编译检查 npm run build → 必须通过 │
141
- │ 🚪 Gate 2: 测试运行 npm test → 必须通过 │
142
- │ 🚪 Gate 3: 覆盖率检查 >20%/60%/80% → 可配置 │
143
- │ 🚪 Gate 4: Lint 检查 无 error → 可配置 │
144
- │ 🚪 Gate 5: 安全扫描 npm audit → 无高危漏洞 │
145
- │ 🚪 Gate 6: 验收标准 用户定义 → 必须全部满足 │
146
- └─────────────────────────────────────────────────────────────┘
147
- ```
148
-
149
- ### 3️⃣ TDD 模式 (strict 级别)
150
-
151
- ```
152
- 传统开发: 代码 → 测试 → Bug → 修复 → 回归 → ... (循环多次)
153
-
154
- OpenMatrix TDD (strict):
155
- 🧪 测试阶段: 先写测试 (RED - 测试必须失败)
156
- ✨ 开发阶段: 再写代码 (GREEN - 测试必须通过)
157
- ✅ 验证阶段: 6道质量门禁
158
- 🎉 验收阶段: AI Reviewer 最终确认
159
-
160
- 结果: 第一次就写对，无需返工
161
- ```
162
-
163
- ### 4️⃣ Meeting 机制 (阻塞不中断)
164
-
165
- ```
166
- ❌ 其他方案:
167
- TASK-001 ✓ → TASK-002 阻塞 ⏸️ → 等用户... (浪费时间)
168
-
169
- ✅ OpenMatrix:
170
- TASK-001 ✓ → TASK-002 阻塞 → 创建Meeting → 跳过 ↷
171
- TASK-003 ✓ → TASK-004 ✓ → 完成!
172
- → 用户用 /om:meeting 统一处理所有阻塞
173
- ```
174
-
175
- ### 5️⃣ AI 验收 (Accept 阶段)
176
-
177
- ```
178
- Accept 阶段由 Reviewer Agent 执行:
179
- ├── 检查 verify-report.md
180
- ├── 验证所有验收标准
181
- ├── 确认代码可合并
182
- └── 生成 accept-report.md
183
- ```
184
-
185
- ---
186
-
187
- ## 执行流程
188
-
189
- ### strict 模式 (推荐生产代码)
190
-
191
- ```
192
- ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
193
- │ TDD │────▶│ Develop │────▶│ Verify │────▶│ Accept │
194
- │ 🧪 RED │ │ ✨ GREEN│ │ ✅ 6门禁│ │ 🎉 AI │
195
- └─────────┘ └─────────┘ └─────────┘ └─────────┘
196
- ```
197
-
198
- ### balanced 模式 (日常开发)
199
-
200
- ```
201
- ┌─────────┐ ┌─────────┐ ┌─────────┐
202
- │ Develop │────▶│ Verify │────▶│ Accept │
203
- │ ✨ 编码 │ │ ✅ 4门禁│ │ 🎉 AI │
204
- └─────────┘ └─────────┘ └─────────┘
205
- ```
206
-
207
- ---
208
-
209
- ## Skills 命令
210
-
211
- | 命令 | 用途 |
212
- |------|------|
213
- | `/om:start` | 启动新任务 (第一个问题选质量级别) |
214
- | `/om:auto` | 🚀 **全自动执行** - 无阻塞、无确认、直接完成 |
215
- | `/om:status` | 查看状态 |
216
- | `/om:approve` | 审批决策 |
217
- | `/om:meeting` | 处理阻塞问题 |
218
- | `/om:resume` | 恢复中断 |
219
- | `/om:retry` | 重试失败 |
220
- | `/om:report` | 生成报告 |
221
-
222
- ### `/om:start` 执行流程 (含 Meeting 机制)
223
-
224
- ```
225
- ┌──────────────────────────────────────────────────────────────────────────┐
226
- │ 执行阶段 │
227
- ├──────────────────────────────────────────────────────────────────────────┤
228
- │ │
229
- │ TASK-001 ✅ ──→ TASK-002 ⚠️阻塞 ──→ 创建Meeting ──→ 跳过 ↷ │
230
- │ │ │
231
- │ ↓ │
232
- │ TASK-003 ✅ ──→ TASK-004 ✅ ──→ TASK-005 ✅ ──→ 所有任务执行完成 │
233
- │ │
234
- └──────────────────────────────────────────────────────────────────────────┘
235
- │
236
- ▼
237
- ┌──────────────────────────────────────────────────────────────────────────┐
238
- │ Meeting 自动检测 │
239
- ├──────────────────────────────────────────────────────────────────────────┤
240
- │ │
241
- │ ┌─────────────────────┐ │
242
- │ │ 有 pending Meeting? │ │
243
- │ └──────────┬──────────┘ │
244
- │ ╱ \ │
245
- │ 否 是 │
246
- │ │ │ │
247
- │ ▼ ▼ │
248
- │ ┌───────┐ ┌─────────────────────────────┐ │
249
- │ │ 完成! │ │ 📋 交互式处理 Meeting │ │
250
- │ └───────┘ │ ┌─────────────────────────┐│ │
251
- │ │ │ [1] TASK-002: 数据库连接││ │
252
- │ │ │ 💡提供信息 / ⏭️跳过 ││ │
253
- │ │ │ [2] TASK-005: API决策 ││ │
254
- │ │ │ 🤔选择方案 ││ │
255
- │ │ └─────────────────────────┘│ │
256
- │ └──────────────┬──────────────┘ │
257
- │ │ │
258
- │ ▼ │
259
- │ ┌─────────────────────────────┐ │
260
- │ │ 用户提供信息/选择方案 │ │
261
- │ │ ↓ │ │
262
- │ │ 🔄 重新执行阻塞任务 │ │
263
- │ │ TASK-002 ✅ │ │
264
- │ └──────────────┬──────────────┘ │
265
- │ │ │
266
- └────────────────────────────────────────────┼──────────────────────────────┘
267
- │
268
- ▼
269
- ┌───────────┐
270
- │ 完成! 🎉 │
271
- └───────────┘
272
- ```
273
-
274
- ### `/om:auto` 全自动模式
275
-
276
- **适用场景**: CI/CD、自动化脚本、无需人工干预的任务
277
-
278
- ```bash
279
- /om:auto 实现用户登录功能 # 默认 strict 模式
280
- /om:auto --mode=balanced 添加API接口 # 指定 balanced 模式
281
- /om:auto --fast 创建CLI工具 # 快速原型模式
282
- ```
283
-
284
- **特点**:
285
- - ❌ 无审批点确认
286
- - ❌ 无 Phase 间暂停
287
- - ❌ Meeting 自动跳过 (记录但不阻塞)
288
- - ✅ 默认 strict 质量级别
289
- - ✅ 适合 CI/CD 集成
290
-
291
- **与 `/om:start` 对比**:
292
-
293
- | 特性 | `/om:start` | `/om:auto` |
294
- |------|-------------|------------|
295
- | 质量级别 | 交互式选择 | 参数指定/默认 strict |
296
- | 审批确认 | 根据配置 | 全部跳过 |
297
- | Meeting | 交互式处理 | 自动跳过 |
298
- | 适用场景 | 日常开发 | CI/CD、自动化 |
299
-
300
- ---
301
-
302
- ## 质量报告
303
-
304
- 每个任务完成后生成:
305
-
306
- ```json
307
- {
308
- "taskId": "TASK-001",
309
- "overall": "pass",
310
- "tests": { "passed": 15, "failed": 0, "coverage": 82 },
311
- "build": { "success": true },
312
- "lint": { "errors": 0, "warnings": 3 },
313
- "security": { "vulnerabilities": [] },
314
- "acceptance": { "met": 5, "total": 5 }
315
- }
316
- ```
317
-
318
- ---
319
-
320
- ## 常见问题
321
-
322
- ### Q: 哪种质量级别适合我？
323
-
324
- | 你的场景 | 推荐级别 |
325
- |---------|---------|
326
- | 🏭 生产代码、核心功能 | **strict** |
327
- | 📦 日常功能开发 | **balanced** |
328
- | 🏃 快速原型、POC | **fast** |
329
-
330
- ### Q: OpenMatrix 和 superpowers 可以一起用吗？
331
-
332
- **A**: 可以！OpenMatrix 自动执行任务，superpowers 提供额外技能。
333
-
334
- ### Q: Meeting 是什么？
335
-
336
- **A**: 遇到阻塞时创建记录，但**不停止执行**。最后用 `/om:meeting` 统一处理。
337
-
338
- ---
339
-
340
- ## 配置
341
-
342
- `.openmatrixrc.json`:
343
-
344
- ```json
345
- {
346
- "quality": {
347
- "tdd": false,
348
- "minCoverage": 60,
349
- "strictLint": true,
350
- "securityScan": true
351
- },
352
- "approvalPoints": ["plan", "merge"],
353
- "agents": { "maxConcurrent": 3 }
354
- }
355
- ```
356
-
357
- ---
358
-
359
- ## 开发
360
-
361
- ```bash
362
- git clone https://github.com/bigfish1913/openmatrix.git
363
- cd openmatrix && npm install && npm run build && npm test
364
- ```
365
-
366
- ---
367
-
368
- ## Roadmap
369
-
370
- - [x] TDD 模式
371
- - [x] 6 道质量门禁
372
- - [x] Meeting 机制
373
- - [x] 质量报告
374
- - [x] AI 验收
375
- - [x] `/om:auto` 全自动模式
376
- - [x] Meeting 自动处理
377
- - [ ] VSCode 扩展
378
- - [ ] Python/Go 支持
379
- - [ ] CI/CD 集成
380
-
381
- ---
382
-
383
- <div align="center">
384
-
385
- **如果觉得有用，请给个 ⭐ Star！**
386
-
387
- MIT © 2024 | Made by [bigfish1913](https://github.com/bigfish1913)
388
-
389
- </div>
1
+ # OpenMatrix
2
+
3
+ <div align="center">
4
+
5
+ **同时实现 TDD + 严格质量门禁 + 全自动执行的 AI 任务编排系统**
6
+
7
+ *自动化 ≠ 牺牲质量 | 高质量 ≠ 手动操作*
8
+
9
+ [![npm version](https://badge.fury.io/js/openmatrix.svg)](https://www.npmjs.com/package/openmatrix)
10
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
11
+ [![Node](https://img.shields.io/badge/Node-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
12
+ [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blue.svg)](https://claude.ai/code)
13
+ [![Website](https://img.shields.io/badge/官网-matrix.laofu.online-brightgreen)](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
+ 用户输入: 实现用户登录功能
38
+ ↓
39
+ 自动调用: /om:start 实现用户登录功能
40
+ ```
41
+
42
+ **支持的输入模式:**
43
+ - `实现...功能` / `添加...` / `修复...` / `优化...`
44
+ - `implement...` / `add...` / `fix...` / `build...`
45
+ - 任务文档路径: `docs/task.md`
46
+
47
+ ---
48
+
49
+ ## 执行流程概览
50
+
51
+ ```
52
+ 用户输入 → 质量选择 → 任务规划 → 执行 → 质量门禁 → AI验收 → Meeting处理 → 完成
53
+ ```
54
+
55
+ | 阶段 | 说明 | 关键点 |
56
+ |:----:|------|--------|
57
+ | 0 | 交互问答 | **第一个问题选质量级别** |
58
+ | 1 | 任务规划 | Planner Agent 生成计划 |
59
+ | 2 | 任务执行 | strict/balanced/fast 三种模式 |
60
+ | 3 | 质量门禁 | 6 道质量门禁验证 |
61
+ | 4 | AI 验收 | Reviewer Agent 最终确认 |
62
+ | 5 | Meeting | 阻塞不中断，最后处理并**重新执行** |
63
+ | 6 | 最终报告 | 质量评分 + 产出文件 |
64
+
65
+ 📖 **详细流程图**: [docs/FLOW.md](docs/FLOW.md) (含 Mermaid 图表)
66
+
67
+ ---
68
+
69
+ ## 为什么选择 OpenMatrix？
70
+
71
+ ### 与 superpowers / gsd 对比
72
+
73
+ | 特性 | OpenMatrix | superpowers | gsd |
74
+ |------|:----------:|:-----------:|:---:|
75
+ | **100% 自动化** | ✅ auto 模式 | ❌ 50% | ❌ 60% |
76
+ | **TDD 内置** | ✅ strict 模式 | ❌ 需手动 | ❌ 无 |
77
+ | **覆盖率强制** | ✅ 60-80% | ❌ 无 | ❌ 无 |
78
+ | **安全扫描** | ✅ npm audit | ❌ 无 | ❌ 无 |
79
+ | **AI 验收** | ✅ Reviewer Agent | ❌ 无 | 部分 |
80
+ | **阻塞不中断** | ✅ Meeting 机制 | ❌ 停止 | ❌ 停止 |
81
+ | **质量报告** | ✅ JSON + MD | ❌ 无 | 部分 |
82
+ | **上手难度** | ⚡ 一句话开始 | 中等 | 较高 |
83
+
84
+ ---
85
+
86
+ ## 快速开始
87
+
88
+ ### 安装
89
+
90
+ **方式一: NPM 安装 (推荐)**
91
+
92
+ ```bash
93
+ # 全局安装
94
+ npm install -g openmatrix
95
+
96
+ # Skills 会自动安装到 ~/.claude/commands/om/
97
+ # 如果自动安装失败，手动执行:
98
+ openmatrix install-skills
99
+ ```
100
+
101
+ **方式二: 从源码安装**
102
+
103
+ ```bash
104
+ # 克隆并安装
105
+ git clone https://github.com/bigfish1913/openmatrix.git
106
+ cd openmatrix && npm install && npm run build && npm link
107
+
108
+ # 安装 Skills (如果 postinstall 未自动执行)
109
+ openmatrix install-skills
110
+ ```
111
+
112
+ ### 验证安装
113
+
114
+ ```bash
115
+ # 检查 CLI 是否可用
116
+ openmatrix --version
117
+
118
+ # 检查 Skills 是否安装成功
119
+ openmatrix install-skills
120
+ # 或直接查看
121
+ ls ~/.claude/commands/om/
122
+ # 应显示: start.md auto.md status.md approve.md meeting.md resume.md retry.md report.md
123
+ ```
124
+
125
+ ### 第一次使用
126
+
127
+ ```bash
128
+ /om:start 实现用户登录功能
129
+
130
+ # 系统会先问:
131
+ ┌─────────────────────────────────────────────────────────┐
132
+ │ 问题 0: 选择质量级别 │
133
+ ├─────────────────────────────────────────────────────────┤
134
+ │ 🚀 strict → TDD + 80%覆盖率 + AI验收 (推荐生产代码) │
135
+ │ ⚖️ balanced → 60%覆盖率 + AI验收 (日常开发) │
136
+ │ ⚡ fast → 无质量门禁 (快速原型) │
137
+ └─────────────────────────────────────────────────────────┘
138
+ ```
139
+
140
+ ---
141
+
142
+ ## 核心特性
143
+
144
+ ### 1️⃣ 三级质量配置 (第一个问题就让你选)
145
+
146
+ | 级别 | TDD | 覆盖率 | Lint | 安全 | AI验收 | 适用场景 |
147
+ |:----:|:---:|:------:|:----:|:----:|:------:|---------|
148
+ | **strict** | ✅ | >80% | ✅ 严格 | ✅ | ✅ | 🏭 **生产代码** |
149
+ | **balanced** | ❌ | >60% | ✅ | ✅ | ✅ | 📦 日常开发 |
150
+ | **fast** | ❌ | >20% | ❌ | ❌ | ❌ | 🏃 快速原型 |
151
+
152
+ > strict 可配置为 100%。默认 >80% 覆盖核心业务逻辑。
153
+
154
+ ### 2️⃣ 六道质量门禁 (Verify 阶段)
155
+
156
+ ```
157
+ ┌─────────────────────────────────────────────────────────────┐
158
+ │ Verify 阶段 - 质量门禁 │
159
+ ├─────────────────────────────────────────────────────────────┤
160
+ │ 🚪 Gate 1: 编译检查 npm run build → 必须通过 │
161
+ │ 🚪 Gate 2: 测试运行 npm test → 必须通过 │
162
+ │ 🚪 Gate 3: 覆盖率检查 >20%/60%/80% → 可配置 │
163
+ │ 🚪 Gate 4: Lint 检查 无 error → 可配置 │
164
+ │ 🚪 Gate 5: 安全扫描 npm audit → 无高危漏洞 │
165
+ │ 🚪 Gate 6: 验收标准 用户定义 → 必须全部满足 │
166
+ └─────────────────────────────────────────────────────────────┘
167
+ ```
168
+
169
+ ### 3️⃣ TDD 模式 (strict 级别)
170
+
171
+ ```
172
+ 传统开发: 代码 → 测试 → Bug → 修复 → 回归 → ... (循环多次)
173
+
174
+ OpenMatrix TDD (strict):
175
+ 🧪 测试阶段: 先写测试 (RED - 测试必须失败)
176
+ ✨ 开发阶段: 再写代码 (GREEN - 测试必须通过)
177
+ ✅ 验证阶段: 6道质量门禁
178
+ 🎉 验收阶段: AI Reviewer 最终确认
179
+
180
+ 结果: 第一次就写对，无需返工
181
+ ```
182
+
183
+ ### 4️⃣ Meeting 机制 (阻塞不中断)
184
+
185
+ ```
186
+ ❌ 其他方案:
187
+ TASK-001 ✓ → TASK-002 阻塞 ⏸️ → 等用户... (浪费时间)
188
+
189
+ ✅ OpenMatrix:
190
+ TASK-001 ✓ → TASK-002 阻塞 → 创建Meeting → 跳过 ↷
191
+ TASK-003 ✓ → TASK-004 ✓ → 完成!
192
+ → 用户用 /om:meeting 统一处理所有阻塞
193
+ ```
194
+
195
+ ### 5️⃣ AI 验收 (Accept 阶段)
196
+
197
+ ```
198
+ Accept 阶段由 Reviewer Agent 执行:
199
+ ├── 检查 verify-report.md
200
+ ├── 验证所有验收标准
201
+ ├── 确认代码可合并
202
+ └── 生成 accept-report.md
203
+ ```
204
+
205
+ ---
206
+
207
+ ## 执行流程
208
+
209
+ ### strict 模式 (推荐生产代码)
210
+
211
+ ```
212
+ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
213
+ │ TDD │────▶│ Develop │────▶│ Verify │────▶│ Accept │
214
+ │ 🧪 RED │ │ ✨ GREEN│ │ ✅ 6门禁│ │ 🎉 AI │
215
+ └─────────┘ └─────────┘ └─────────┘ └─────────┘
216
+ ```
217
+
218
+ ### balanced 模式 (日常开发)
219
+
220
+ ```
221
+ ┌─────────┐ ┌─────────┐ ┌─────────┐
222
+ │ Develop │────▶│ Verify │────▶│ Accept │
223
+ │ ✨ 编码 │ │ ✅ 4门禁│ │ 🎉 AI │
224
+ └─────────┘ └─────────┘ └─────────┘
225
+ ```
226
+
227
+ ---
228
+
229
+ ## Skills 命令
230
+
231
+ | 命令 | 用途 |
232
+ |------|------|
233
+ | `/om` | **默认入口** - 直接输入任务描述即可启动 |
234
+ | `/om:start` | 启动新任务 (第一个问题选质量级别) |
235
+ | `/om:auto` | 🚀 **全自动执行** - 无阻塞、无确认、直接完成 |
236
+ | `/om:status` | 查看状态 |
237
+ | `/om:approve` | 审批决策 |
238
+ | `/om:meeting` | 处理阻塞问题 |
239
+ | `/om:resume` | 恢复中断 |
240
+ | `/om:retry` | 重试失败 |
241
+ | `/om:report` | 生成报告 |
242
+
243
+ > `/om` 是 `/om:start` 的快捷方式，功能完全相同
244
+
245
+ ### `/om:start` 执行流程 (含 Meeting 机制)
246
+
247
+ ```
248
+ ┌──────────────────────────────────────────────────────────────────────────┐
249
+ │ 执行阶段 │
250
+ ├──────────────────────────────────────────────────────────────────────────┤
251
+ │ │
252
+ │ TASK-001 ✅ ──→ TASK-002 ⚠️阻塞 ──→ 创建Meeting ──→ 跳过 ↷ │
253
+ │ │ │
254
+ │ ↓ │
255
+ │ TASK-003 ✅ ──→ TASK-004 ✅ ──→ TASK-005 ✅ ──→ 所有任务执行完成 │
256
+ │ │
257
+ └──────────────────────────────────────────────────────────────────────────┘
258
+ │
259
+ ▼
260
+ ┌──────────────────────────────────────────────────────────────────────────┐
261
+ │ Meeting 自动检测 │
262
+ ├──────────────────────────────────────────────────────────────────────────┤
263
+ │ │
264
+ │ ┌─────────────────────┐ │
265
+ │ │ 有 pending Meeting? │ │
266
+ │ └──────────┬──────────┘ │
267
+ │ ╱ \ │
268
+ │ 否 是 │
269
+ │ │ │ │
270
+ │ ▼ ▼ │
271
+ │ ┌───────┐ ┌─────────────────────────────┐ │
272
+ │ │ 完成! │ │ 📋 交互式处理 Meeting │ │
273
+ │ └───────┘ │ ┌─────────────────────────┐│ │
274
+ │ │ │ [1] TASK-002: 数据库连接││ │
275
+ │ │ │ 💡提供信息 / ⏭️跳过 ││ │
276
+ │ │ │ [2] TASK-005: API决策 ││ │
277
+ │ │ │ 🤔选择方案 ││ │
278
+ │ │ └─────────────────────────┘│ │
279
+ │ └──────────────┬──────────────┘ │
280
+ │ │ │
281
+ │ ▼ │
282
+ │ ┌─────────────────────────────┐ │
283
+ │ │ 用户提供信息/选择方案 │ │
284
+ │ │ ↓ │ │
285
+ │ │ 🔄 重新执行阻塞任务 │ │
286
+ │ │ TASK-002 ✅ │ │
287
+ │ └──────────────┬──────────────┘ │
288
+ │ │ │
289
+ └────────────────────────────────────────────┼──────────────────────────────┘
290
+ │
291
+ ▼
292
+ ┌───────────┐
293
+ │ 完成! 🎉 │
294
+ └───────────┘
295
+ ```
296
+
297
+ ### `/om:auto` 全自动模式
298
+
299
+ **适用场景**: CI/CD、自动化脚本、无需人工干预的任务
300
+
301
+ ```bash
302
+ /om:auto 实现用户登录功能 # 默认 strict 模式
303
+ /om:auto --mode=balanced 添加API接口 # 指定 balanced 模式
304
+ /om:auto --fast 创建CLI工具 # 快速原型模式
305
+ ```
306
+
307
+ **特点**:
308
+ - ❌ 无审批点确认
309
+ - ❌ 无 Phase 间暂停
310
+ - ❌ Meeting 自动跳过 (记录但不阻塞)
311
+ - ✅ 默认 strict 质量级别
312
+ - ✅ 适合 CI/CD 集成
313
+
314
+ **与 `/om:start` 对比**:
315
+
316
+ | 特性 | `/om:start` | `/om:auto` |
317
+ |------|-------------|------------|
318
+ | 质量级别 | 交互式选择 | 参数指定/默认 strict |
319
+ | 审批确认 | 根据配置 | 全部跳过 |
320
+ | Meeting | 交互式处理 | 自动跳过 |
321
+ | 适用场景 | 日常开发 | CI/CD、自动化 |
322
+
323
+ ---
324
+
325
+ ## 质量报告
326
+
327
+ 每个任务完成后生成:
328
+
329
+ ```json
330
+ {
331
+ "taskId": "TASK-001",
332
+ "overall": "pass",
333
+ "tests": { "passed": 15, "failed": 0, "coverage": 82 },
334
+ "build": { "success": true },
335
+ "lint": { "errors": 0, "warnings": 3 },
336
+ "security": { "vulnerabilities": [] },
337
+ "acceptance": { "met": 5, "total": 5 }
338
+ }
339
+ ```
340
+
341
+ ---
342
+
343
+ ## 常见问题
344
+
345
+ ### Q: 哪种质量级别适合我？
346
+
347
+ | 你的场景 | 推荐级别 |
348
+ |---------|---------|
349
+ | 🏭 生产代码、核心功能 | **strict** |
350
+ | 📦 日常功能开发 | **balanced** |
351
+ | 🏃 快速原型、POC | **fast** |
352
+
353
+ ### Q: OpenMatrix 和 superpowers 可以一起用吗？
354
+
355
+ **A**: 可以！OpenMatrix 自动执行任务，superpowers 提供额外技能。
356
+
357
+ ### Q: Meeting 是什么？
358
+
359
+ **A**: 遇到阻塞时创建记录，但**不停止执行**。最后用 `/om:meeting` 统一处理。
360
+
361
+ ---
362
+
363
+ ## 配置
364
+
365
+ `.openmatrixrc.json`:
366
+
367
+ ```json
368
+ {
369
+ "quality": {
370
+ "tdd": false,
371
+ "minCoverage": 60,
372
+ "strictLint": true,
373
+ "securityScan": true
374
+ },
375
+ "approvalPoints": ["plan", "merge"],
376
+ "agents": { "maxConcurrent": 3 }
377
+ }
378
+ ```
379
+
380
+ ---
381
+
382
+ ## 开发
383
+
384
+ ```bash
385
+ git clone https://github.com/bigfish1913/openmatrix.git
386
+ cd openmatrix && npm install && npm run build && npm test
387
+ ```
388
+
389
+ ---
390
+
391
+ ## Roadmap
392
+
393
+ - [x] TDD 模式
394
+ - [x] 6 道质量门禁
395
+ - [x] Meeting 机制
396
+ - [x] 质量报告
397
+ - [x] AI 验收
398
+ - [x] `/om:auto` 全自动模式
399
+ - [x] Meeting 自动处理
400
+ - [ ] VSCode 扩展
401
+ - [ ] Python/Go 支持
402
+ - [ ] CI/CD 集成
403
+
404
+ ---
405
+
406
+ <div align="center">
407
+
408
+ **如果觉得有用，请给个 ⭐ Star！**
409
+
410
+ MIT © 2024 | Made by [bigfish1913](https://github.com/bigfish1913)
411
+
412
+ </div>
package/dist/cli/commands/install-skills.js CHANGED
@@ -65,8 +65,8 @@ exports.installSkillsCommand = new commander_1.Command('install-skills')
65
65
  console.error(' Error:', err.message);
66
66
  process.exit(1);
67
67
  }
68
- // Get skill files
69
- const files = fs.readdirSync(skillsDir).filter(f => f.endsWith('.md'));
68
+ // Get skill files (excluding om.md and openmatrix-auto.md which are handled separately)
69
+ const files = fs.readdirSync(skillsDir).filter(f => f.endsWith('.md') && f !== 'om.md' && f !== 'openmatrix-auto.md');
70
70
  if (files.length === 0) {
71
71
  console.error('❌ No skill files found in:', skillsDir);
72
72
  process.exit(1);
@@ -75,6 +75,7 @@ exports.installSkillsCommand = new commander_1.Command('install-skills')
75
75
  let installed = 0;
76
76
  let skipped = 0;
77
77
  let failed = 0;
78
+ // Install skill files to ~/.claude/commands/om/
78
79
  files.forEach(file => {
79
80
  const src = path.join(skillsDir, file);
80
81
  const dest = path.join(commandsDir, file);
@@ -95,15 +96,61 @@ exports.installSkillsCommand = new commander_1.Command('install-skills')
95
96
  failed++;
96
97
  }
97
98
  });
99
+ // Install default /om command to ~/.claude/commands/om.md
100
+ const omSrc = path.join(skillsDir, 'om.md');
101
+ const omDest = path.join(claudeDir, 'commands', 'om.md');
102
+ if (fs.existsSync(omSrc)) {
103
+ try {
104
+ if (fs.existsSync(omDest) && !options.force) {
105
+ console.log(` ⏭️ Skipped: om.md (already exists)`);
106
+ skipped++;
107
+ }
108
+ else {
109
+ fs.copyFileSync(omSrc, omDest);
110
+ console.log(` ✅ Installed: /om (default entry)`);
111
+ installed++;
112
+ }
113
+ }
114
+ catch (err) {
115
+ console.log(` ❌ Failed: om.md (${err.message})`);
116
+ failed++;
117
+ }
118
+ }
119
+ // Install auto-detection instructions
120
+ const autoSrc = path.join(skillsDir, 'openmatrix-auto.md');
121
+ const autoDest = path.join(claudeDir, 'commands', 'openmatrix-auto.md');
122
+ if (fs.existsSync(autoSrc)) {
123
+ try {
124
+ if (fs.existsSync(autoDest) && !options.force) {
125
+ console.log(` ⏭️ Skipped: openmatrix-auto.md (already exists)`);
126
+ skipped++;
127
+ }
128
+ else {
129
+ fs.copyFileSync(autoSrc, autoDest);
130
+ console.log(` ✅ Installed: auto-detection rules`);
131
+ installed++;
132
+ }
133
+ }
134
+ catch (err) {
135
+ console.log(` ❌ Failed: openmatrix-auto.md (${err.message})`);
136
+ failed++;
137
+ }
138
+ }
98
139
  console.log('\n' + '─'.repeat(50));
99
140
  console.log(`📊 Summary:`);
100
141
  console.log(` ✅ Installed: ${installed}`);
101
142
  console.log(` ⏭️ Skipped: ${skipped}`);
102
143
  console.log(` ❌ Failed: ${failed}`);
103
- console.log(`\n📁 Location: ${commandsDir}`);
144
+ console.log(`\n📁 Skills: ${commandsDir}`);
145
+ console.log(`📁 Default: ${omDest}`);
104
146
  if (installed > 0) {
105
147
  console.log('\n🎉 Skills installed successfully!');
106
- console.log(' Try: /om:start <your task>');
148
+ console.log(' Try: /om <your task>');
149
+ console.log(' Or: /om:start <your task>');
150
+ console.log('\n💡 Auto-detection enabled!');
151
+ console.log(' Type task descriptions directly:');
152
+ console.log(' - "实现用户登录功能" → auto invokes /om:start');
153
+ console.log(' - "fix the login bug" → auto invokes /om:start');
107
154
  }
108
155
  if (failed > 0) {
109
156
  process.exit(1);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openmatrix",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
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/om.md ADDED
@@ -0,0 +1,124 @@
1
+ ---
2
+ name: om
3
+ description: OpenMatrix 默认入口 - 直接输入任务描述即可启动
4
+ ---
5
+
6
+ <NO-OTHER-SKILLS>
7
+ 执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
8
+ </NO-OTHER-SKILLS>
9
+
10
+ <objective>
11
+ OpenMatrix 的默认入口。用户可以直接输入任务描述，系统会自动启动 /om:start 执行任务编排。
12
+ </objective>
13
+
14
+ <process>
15
+ 1. **解析用户输入**
16
+
17
+ 用户输入 `$ARGUMENTS` 可能是：
18
+ - 任务描述 (如 "实现用户登录功能")
19
+ - 文件路径 (如 "docs/task.md")
20
+ - 空输入
21
+
22
+ 2. **判断输入类型**
23
+
24
+ **如果是任务描述或文件路径**:
25
+ → 直接调用 `/om:start` 并传递参数
26
+
27
+ **如果是空输入**:
28
+ → 显示帮助信息
29
+
30
+ 3. **自动启动 /om:start**
31
+
32
+ 无论用户输入什么，都自动转换为 `/om:start` 调用：
33
+
34
+ ```
35
+ 用户输入: "实现用户登录"
36
+ 系统执行: /om:start 实现用户登录
37
+
38
+ 用户输入: "docs/task.md"
39
+ 系统执行: /om:start docs/task.md
40
+
41
+ 用户输入: (空)
42
+ 系统显示: 帮助信息
43
+ ```
44
+
45
+ 4. **帮助信息**
46
+
47
+ 如果用户输入为空或输入 `--help`，显示：
48
+
49
+ ```
50
+ 📦 OpenMatrix - AI 任务编排系统
51
+
52
+ 用法:
53
+ /om <任务描述> 直接启动任务
54
+ /om:start <任务> 交互式启动 (可选质量级别)
55
+ /om:auto <任务> 全自动执行
56
+
57
+ 示例:
58
+ /om 实现用户登录功能
59
+ /om 修复登录页面的样式问题
60
+ /om 添加 API 接口
61
+
62
+ 质量级别:
63
+ 🚀 strict - TDD + 80%覆盖率 (生产代码)
64
+ ⚖️ balanced - 60%覆盖率 (日常开发)
65
+ ⚡ fast - 无质量门禁 (快速原型)
66
+
67
+ 其他命令:
68
+ /om:status - 查看状态
69
+ /om:meeting - 处理阻塞
70
+ /om:report - 生成报告
71
+ ```
72
+
73
+ </process>
74
+
75
+ <arguments>
76
+ $ARGUMENTS
77
+ </arguments>
78
+
79
+ <examples>
80
+ /om 实现用户登录功能 # 自动启动任务编排
81
+ /om 修复登录页面的样式问题 # 直接描述任务
82
+ /om docs/task.md # 从文件读取任务
83
+ /om # 显示帮助
84
+ </examples>
85
+
86
+ <notes>
87
+ ## 工作原理
88
+
89
+ ```
90
+ 用户输入: /om 实现登录
91
+ │
92
+ ▼
93
+ ┌─────────────────┐
94
+ │ 检测到任务描述 │
95
+ └────────┬────────┘
96
+ │
97
+ ▼
98
+ ┌─────────────────┐
99
+ │ 自动调用 │
100
+ │ /om:start │
101
+ │ 实现登录 │
102
+ └─────────────────┘
103
+ ```
104
+
105
+ ## 与 /om:start 的关系
106
+
107
+ `/om` 是 `/om:start` 的快捷方式：
108
+ - `/om <任务>` ≡ `/om:start <任务>`
109
+ - 用户体验更简洁
110
+ - 功能完全相同
111
+
112
+ ## 推荐用法
113
+
114
+ ```bash
115
+ # 快速启动 (推荐)
116
+ /om 实现用户登录
117
+
118
+ # 等价于
119
+ /om:start 实现用户登录
120
+
121
+ # 全自动模式
122
+ /om:auto 实现用户登录
123
+ ```
124
+ </notes>
package/skills/openmatrix-auto.md ADDED
@@ -0,0 +1,64 @@
1
+ ---
2
+ name: openmatrix-auto
3
+ description: Auto-detect task descriptions and invoke OpenMatrix skills
4
+ ---
5
+
6
+ <objective>
7
+ Automatically detect when user input is a development task and invoke /om:start without requiring explicit command.
8
+ </objective>
9
+
10
+ <rules>
11
+ ## When to Auto-Invoke /om:start
12
+
13
+ If the user's message matches ANY of these patterns, automatically invoke `/om:start` with the user's input:
14
+
15
+ ### Chinese Task Patterns
16
+ - `实现...功能` / `实现...` (implement)
17
+ - `添加...` / `新增...` (add/create)
18
+ - `修复...` / `修复...bug` (fix)
19
+ - `优化...` / `重构...` (optimize/refactor)
20
+ - `创建...` / `编写...` / `开发...` (create/write/develop)
21
+ - `构建...` / `部署...` (build/deploy)
22
+ - `更新...功能` / `改进...` (update/improve)
23
+ - Any sentence that clearly describes a development task
24
+
25
+ ### English Task Patterns
26
+ - `implement...` / `add...` / `create...`
27
+ - `fix...` / `bug...` / `issue...`
28
+ - `build...` / `develop...`
29
+ - `refactor...` / `optimize...`
30
+ - `update...` / `improve...`
31
+
32
+ ### File Path Patterns
33
+ - Input is a path to a `.md` file (e.g., `docs/task.md`)
34
+
35
+ ## When NOT to Auto-Invoke
36
+
37
+ Do NOT auto-invoke when:
38
+ - User explicitly uses `/om:*` commands
39
+ - User asks questions: "how do I...", "what is...", "why..."
40
+ - User requests info: "show me...", "list...", "read..."
41
+ - User navigates: "open folder", "go to..."
42
+ - User greets or chats: "hello", "thanks"
43
+
44
+ ## How It Works
45
+
46
+ ```
47
+ User: "实现用户登录功能"
48
+ ↓
49
+ Auto-detect: Task pattern matched
50
+ ↓
51
+ Action: Invoke /om:start 实现用户登录功能
52
+ ```
53
+
54
+ ## Examples
55
+
56
+ | User Input | Action |
57
+ |------------|--------|
58
+ | `实现用户登录功能` | → `/om:start 实现用户登录功能` |
59
+ | `fix the login bug` | → `/om:start fix the login bug` |
60
+ | `添加 API 接口` | → `/om:start 添加 API 接口` |
61
+ | `优化首页性能` | → `/om:start 优化首页性能` |
62
+ | `docs/task.md` | → `/om:start docs/task.md` |
63
+ | `how do I install this?` | → No auto-invoke (question) |
64
+ </rules>