openmatrix 0.1.49 → 0.1.50

package/package.json

@@ -1,56 +1,55 @@
-{
-  "name": "openmatrix",
-  "version": "0.1.49",
-  "description": "AI Agent task orchestration system with Claude Code Skills integration",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "openmatrix": "dist/cli/index.js"
-  },
-  "files": [
-    "dist",
-    "skills",
-    "scripts",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/cli/index.ts",
-    "test": "vitest",
-    "postinstall": "node scripts/install-skills.js"
-  },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "ai-agent",
-    "task-orchestration",
-    "automation",
-    "multi-agent"
-  ],
-  "author": "",
-  "license": "MIT",
-  "type": "commonjs",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/bigfish1913/openmatrix.git"
-  },
-  "homepage": "https://github.com/bigfish1913/openmatrix#readme",
-  "bugs": {
-    "url": "https://github.com/bigfish1913/openmatrix/issues"
-  },
-  "dependencies": {
-    "@types/node": "^22.0.0",
-    "chalk": "^5.6.2",
-    "chokidar": "^5.0.0",
-    "commander": "^14.0.3",
-    "openmatrix": "^0.1.42",
-    "typescript": "^5.3.3",
-    "winston": "^3.19.0"
-  },
-  "devDependencies": {
-    "vitest": "^1.6.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "openmatrix",
+  "version": "0.1.50",
+  "description": "AI Agent task orchestration system with Claude Code Skills integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openmatrix": "dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "scripts",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "test": "vitest",
+    "postinstall": "node scripts/install-skills.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai-agent",
+    "task-orchestration",
+    "automation",
+    "multi-agent"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "commonjs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bigfish1913/openmatrix.git"
+  },
+  "homepage": "https://github.com/bigfish1913/openmatrix#readme",
+  "bugs": {
+    "url": "https://github.com/bigfish1913/openmatrix/issues"
+  },
+  "dependencies": {
+    "@types/node": "^22.0.0",
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "typescript": "^5.3.3",
+    "winston": "^3.19.0"
+  },
+  "devDependencies": {
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/skills/brainstorm.md

@@ -1,105 +1,238 @@
----
-name: om:brainstorm
-description: 头脑风暴 - 探索需求和设计后再执行任务
-priority: high
----
-
-<NO-OTHER-SKILLS>
-执行此技能时，不得调用其他任务编排相关的技能。
-</NO-OTHER-SKILLS>
-
-<objective>
-任务执行前，先头脑风暴深入探索需求，理解完整后再开始执行。
-</objective>
-
-<process>
-## 1. 初始化
-
-检查断点:
-```bash
-cat .openmatrix/brainstorm/session.json 2>/dev/null
-```
-
-有未完成会话 → 询问继续或重新开始。
-
-`$ARGUMENTS` 为空则询问用户任务内容。
-
-创建会话:
-```bash
-openmatrix brainstorm "$ARGUMENTS" --json
-```
-
-CLI 返回问题列表:
-```json
-{
-  "taskTitle": "...",
-  "questions": [{ "id": "...", "question": "...", "header": "...", "options": [...], "multiSelect": false }]
-}
-```
-
----
-
-## 2. 交互式问答
-
-对每个问题逐一使用 `AskUserQuestion` 提问，收集答案到 `collectedAnswers` 对象。
-
-根据任务类型决定追问深度:
-- **0-1 项目**（新系统/新功能）→ 深度追问: 核心目标、用户价值、技术方案、风险
-- **迭代项目**（改进现有系统）→ 针对性: 痛点、影响范围、兼容性
-- **简单任务**（bugfix/小改动）→ 确认性: 根因、影响范围、测试方案
-
----
-
-## 3. 总结 + 确认
-
-展示头脑风暴总结:
-```
-任务: (标题)
-核心目标: (摘要)
-技术方案: (要点)
-风险: (要点)
-验收标准: (要点)
-```
-
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: "头脑风暴完成，下一步？",
-    header: "下一步",
-    options: [
-      { label: "开始执行", description: "进入 /om:start 流程" },
-      { label: "继续探索", description: "还有问题需要讨论" },
-      { label: "仅生成计划", description: "不执行" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
----
-
-## 4. 保存 + 启动 start
-
-选择"开始执行"后:
-
-```bash
-# 1. 保存答案
-openmatrix brainstorm --complete --results '{"answers":{...},"insights":[...],"designNotes":[...]}' --json
-
-# 2. 启动任务 (会自动加载 brainstorm 答案)
-openmatrix start "$TASK_INPUT" --title "$TASK_TITLE" --quality balanced --mode auto --brainstorm-answers '$RESULTS_JSON' --json
-```
-
-CLI 返回 SubagentTask 列表后，按 start.md Step 3 执行。
-
-</process>
-
-<arguments>
-$ARGUMENTS
-</arguments>
-
-<examples>
-/om:brainstorm                      # 交互式
-/om:brainstorm docs/task.md         # 基于文件
-/om:brainstorm "实现用户登录功能"    # 基于描述
-</examples>
+---
+name: om:brainstorm
+description: 头脑风暴 - 探索需求和设计后再执行任务
+---
+
+<NO-OTHER-SKILLS>
+执行此技能时，不得调用其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+</NO-OTHER-SKILLS>
+
+<objective>
+在进行任务执行前，先进行头脑风暴，深入探索需求、设计和技术方案，确保理解完整后再开始执行。
+</objective>
+
+<process>
+1. **初始化头脑风暴会话**
+
+   调用 CLI 创建头脑风暴会话:
+   ```bash
+   openmatrix brainstorm --json
+   ```
+
+   这会返回:
+   ```json
+   {
+     "status": "brainstorming",
+     "message": "开始头脑风暴",
+     "taskTitle": "任务标题",
+     "questions": [
+       {
+         "id": "core_objective",
+         "question": "这个任务的核心目标是什么？",
+         "header": "核心目标",
+         "options": [...],
+         "multiSelect": false
+       }
+     ],
+     "hint": "请逐一回答问题，完成后再调用 --complete"
+   }
+   ```
+
+2. **交互式问答**
+
+   对每个问题使用 `AskUserQuestion` 进行提问:
+
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: questions[0].question,
+       header: questions[0].header,
+       options: questions[0].options,
+       multiSelect: questions[0].multiSelect
+     }]
+   })
+   ```
+
+   **收集回答并记录洞察**:
+   - 每个回答后，思考其含义
+   - 记录可能的设计决策
+   - 识别潜在风险
+
+3. **深入追问** (可选)
+
+   如果用户选择了"其他"或回答不够清晰，进行追问:
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "请详细描述:",
+       header: "详情",
+       options: []
+     }]
+   })
+   ```
+
+4. **总结头脑风暴结果**
+
+   所有问题回答完成后，总结:
+   - 核心目标
+   - 用户价值
+   - 技术方案要点
+   - 风险和应对
+   - 验收标准
+
+   展示总结:
+   ```
+   🧠 头脑风暴总结
+
+   📋 任务: 实现登录功能
+
+   🎯 核心目标
+      - 实现用户登录功能，支持邮箱和密码
+
+   👥 用户价值
+      - 终端用户可以安全登录系统
+
+   🔧 技术方案
+      - 使用 JWT 进行身份验证
+      - 密码使用 bcrypt 加密
+
+   ⚠️ 风险评估
+      - 安全风险: 需要防止暴力破解
+
+   ✅ 验收标准
+      - 功能完整
+      - 测试覆盖
+   ```
+
+5. **确认并开始执行**
+
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "头脑风暴完成，是否开始执行任务？",
+       header: "下一步",
+       options: [
+         { label: "✅ 开始执行 (推荐)", description: "使用收集的信息开始执行任务" },
+         { label: "🔄 继续探索", description: "还有问题需要进一步讨论" },
+         { label: "📋 仅生成计划", description: "生成详细计划但不执行" }
+       ],
+       multiSelect: false
+     }]
+   })
+   ```
+
+6. **自动执行 start**
+
+   如果用户选择"开始执行":
+   - 调用 CLI 标记头脑风暴完成:
+     ```bash
+     openmatrix brainstorm --complete --json
+     ```
+   - 自动调用 `/om:start` 开始执行任务
+   - 将头脑风暴收集的洞察传递给 start
+
+</process>
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+<examples>
+/om:brainstorm                      # 交互式头脑风暴
+/om:brainstorm docs/task.md         # 基于任务文件头脑风暴
+/om:brainstorm "实现用户登录功能"    # 基于描述头脑风暴
+</examples>
+
+<notes>
+## 头脑风暴流程图
+
+```
+┌─────────────────┐
+│   开始头脑风暴   │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  CLI 初始化会话  │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ 获取问题列表     │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ 交互式问答       │◀─────┐
+│ (AskUserQuestion)│      │
+└────────┬────────┘       │
+         │                │
+    ┌────┴────┐           │
+    │         │           │
+  有下一题   无下一题      │
+    │         │           │
+    └────────┤           │
+             │           │
+             ▼           │
+┌─────────────────┐      │
+│ 总结头脑风暴结果 │      │
+└────────┬────────┘      │
+         │               │
+         ▼               │
+┌─────────────────┐      │
+│ 用户确认         │      │
+└────────┬────────┘      │
+         │               │
+    ┌────┴────┐          │
+    │         │          │
+  开始执行   继续探索 ────┘
+    │
+    ▼
+┌─────────────────┐
+│ 自动执行 start   │
+└─────────────────┘
+```
+
+## 问题类型
+
+| 问题 ID | 目的 | 为什么重要 |
+|---------|------|-----------|
+| core_objective | 明确核心目标 | 选择正确的实现策略 |
+| user_value | 了解用户价值 | 设计合适的接口 |
+| complexity | 评估复杂度 | 决定实施策略 |
+| tech_constraints | 技术约束 | 影响方案选择 |
+| risks | 风险评估 | 提前规划应对 |
+| acceptance | 验收标准 | 判断完成度 |
+| priority | 优先级 | 资源分配 |
+
+## 与 start 的集成
+
+头脑风暴完成后，收集的信息会传递给 start:
+
+```json
+{
+  "answers": {
+    "core_objective": "实现新功能",
+    "user_value": "终端用户",
+    "complexity": "中等",
+    "risks": ["技术风险", "兼容性风险"],
+    "acceptance": ["功能完整", "测试覆盖"],
+    "priority": "中优先级"
+  },
+  "insights": [
+    "需要考虑安全性",
+    "应该支持多种登录方式"
+  ],
+  "designNotes": [
+    "使用 JWT 认证",
+    "密码需要加密存储"
+  ]
+}
+```
+
+这些信息会影响:
+- 任务拆解策略
+- 质量级别选择
+- 技术栈确认
+- 风险应对措施
+</notes>