openmatrix 0.1.81 → 0.1.82

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openmatrix",
3
- "version": "0.1.81",
3
+ "version": "0.1.82",
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",
@@ -42,7 +42,9 @@ ls docs/ 2>/dev/null
42
42
  - 了解技术栈、项目结构、最近变更
43
43
  - 如果用户引用了文件(如 `docs/task.md`),读取该文件
44
44
 
45
- ## 步骤 2: 评估范围
45
+ ## 步骤 2: 评估范围与领域检测
46
+
47
+ **2.1 评估范围**
46
48
 
47
49
  **如果任务涉及多个独立子系统**(如"构建一个包含聊天、文件存储、计费和分析的平台"),立即提出分解:
48
50
 
@@ -61,6 +63,31 @@ AskUserQuestion({
61
63
  })
62
64
  ```
63
65
 
66
+ **2.2 领域检测与 Research 集成**
67
+
68
+ **如果任务涉及不熟悉的垂直领域**(如游戏开发、支付系统、区块链、AI 应用等),主动建议调用研究:
69
+
70
+ ```typescript
71
+ AskUserQuestion({
72
+ questions: [{
73
+ question: `这个任务涉及「${domain}」领域,建议先进行领域调研。\n研究可以帮助我们:\n• 了解行业标准和最佳实践\n• 识别关键技术选型\n• 发现常见陷阱和解决方案`,
74
+ header: "领域调研",
75
+ options: [
76
+ { label: "先调研 (推荐)", description: "调用 /om:research 深入了解领域" },
77
+ { label: "直接头脑风暴", description: "我对这个领域比较熟悉" }
78
+ ],
79
+ multiSelect: false
80
+ }]
81
+ })
82
+ ```
83
+
84
+ 用户选择「先调研」后:
85
+ ```
86
+ Skill 工具: skill = "om:research", args = "任务描述"
87
+ ```
88
+
89
+ 研究完成后,研究结论会作为头脑风暴的输入上下文,继续后续步骤。
90
+
64
91
  ## 步骤 3: 逐一澄清需求
65
92
 
66
93
  **核心原则:一次只问一个问题。每条消息只有一个问题。**
@@ -249,7 +276,69 @@ AskUserQuestion({
249
276
  })
250
277
  ```
251
278
 
252
- ## 步骤 7: 写入 tasks-input.json 并调用 /om:start
279
+ ## 步骤 7: 输出设计文档
280
+
281
+ 总结确认后,将设计写入文档,便于后续执行时参考:
282
+
283
+ ```bash
284
+ # 确保目录存在
285
+ mkdir -p docs/openmatrix
286
+ ```
287
+
288
+ **写入设计文档到 `docs/openmatrix/YYYY-MM-DD-<topic>-design.md`:**
289
+
290
+ ```markdown
291
+ # 设计方案: 任务标题
292
+
293
+ 日期: YYYY-MM-DD
294
+
295
+ ## 核心目标
296
+ - 目标 1
297
+ - 目标 2
298
+
299
+ ## 架构设计
300
+ (从步骤 5 确认的内容)
301
+
302
+ ## 数据模型 / 核心实体
303
+ (从步骤 5 确认的内容)
304
+
305
+ ## 关键接口 / API
306
+ (从步骤 5 确认的内容)
307
+
308
+ ## 技术方案
309
+ - 方案选择: 方案 X
310
+ - 理由: ...
311
+
312
+ ## 错误处理策略
313
+ (从步骤 5 确认的内容)
314
+
315
+ ## 测试策略
316
+ (从步骤 5 确认的内容)
317
+
318
+ ## 约束与风险
319
+ - 约束 1
320
+ - 风险 1 及应对
321
+
322
+ ## 验收标准
323
+ - 标准 1
324
+ - 标准 2
325
+ ```
326
+
327
+ ```typescript
328
+ AskUserQuestion({
329
+ questions: [{
330
+ question: `设计文档已写入 docs/openmatrix/${filename}\n\n下一步?`,
331
+ header: "下一步",
332
+ options: [
333
+ { label: "开始执行 (推荐)", description: "写入 tasks-input.json 并调用 /om:start" },
334
+ { label: "修改设计", description: "需要调整设计方案" }
335
+ ],
336
+ multiSelect: false
337
+ }]
338
+ })
339
+ ```
340
+
341
+ ## 步骤 8: 写入 tasks-input.json 并调用 /om:start
253
342
 
254
343
  用户选择"开始执行"后:
255
344
 
@@ -310,6 +399,20 @@ $ARGUMENTS
310
399
  - **问题要贴合任务** — 不问泛泛的问题,而是针对具体任务深入
311
400
  - **理解目的 > 理解实现** — 先搞清楚为什么做,再讨论怎么做
312
401
 
402
+ ## 领域调研集成
403
+
404
+ - 检测到垂直领域(游戏、支付、区块链等)时,主动建议 `/om:research`
405
+ - 研究完成后,研究结论作为后续提问和设计的输入上下文
406
+ - 如果用户对领域熟悉,可以跳过研究直接进入头脑风暴
407
+ - 研究产出的文档可引用在设计文档中
408
+
409
+ ## 设计文档
410
+
411
+ - 每次头脑风暴都会输出设计文档到 `docs/openmatrix/YYYY-MM-DD-<topic>-design.md`
412
+ - 文档包含:核心目标、架构、数据模型、接口、技术方案、错误处理、测试策略、风险、验收标准
413
+ - 设计文档是 `/om:start` 执行时的重要参考
414
+ - 文档内容来自步骤 5 逐节确认的设计
415
+
313
416
  ## 在已有代码库中工作
314
417
 
315
418
  - 提出变更前,先探索现有结构,遵循现有模式
@@ -342,6 +445,12 @@ $ARGUMENTS
342
445
 
343
446
 
344
447
  ┌─────────────────┐
448
+ │ 领域检测 │ YES → /om:research → 研究结论作为上下文
449
+ │ (是否需要调研) │──────────────────────────────────────────────┐
450
+ └────────┬────────┘ │
451
+ │ NO / 研究完成 │
452
+ ▼ ◀────────────────────────────────────────────────────┘
453
+ ┌─────────────────┐
345
454
  │ 逐一澄清需求 │◀─────┐
346
455
  │ (一次一个问题) │ │
347
456
  │ 深入理解目的/ │ │
@@ -367,6 +476,12 @@ $ARGUMENTS
367
476
 
368
477
  ┌─────────────────┐
369
478
  │ 总结 + 确认 │
479
+ └────────┬────────┘
480
+
481
+
482
+ ┌─────────────────┐
483
+ │ 写入设计文档 │
484
+ │ (docs/openmatrix/) │
370
485
  └────────┬────────┘
371
486
 
372
487
  开始执行