openmatrix 0.1.39 → 0.1.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/start.md

@@ -202,6 +202,66 @@ openmatrix start "$TASK_INPUT" \
 3. 创建任务文件到 `.openmatrix/tasks/`
 4. 返回待执行的 SubagentTask 列表
 
+### 🚨 关键：必须读取并执行 CLI 返回的任务
+
+**CLI 调用后会返回 JSON，必须解析并执行！**
+
+```typescript
+// 1. 调用 CLI (使用 Bash 工具)
+const cliOutput = await Bash({
+  command: `openmatrix start "${taskInput}" --title "${taskTitle}" --quality ${quality} --mode ${mode} --json`,
+  description: "Start task and get subagent tasks"
+});
+
+// 2. 解析 CLI 输出 (关键步骤!)
+let result;
+try {
+  result = JSON.parse(cliOutput);
+} catch (e) {
+  console.error("Failed to parse CLI output:", cliOutput);
+  throw new Error("CLI 返回了无效的 JSON");
+}
+
+// 3. 检查状态
+if (result.status !== 'continue') {
+  console.log(`状态: ${result.status}`);
+  console.log(`消息: ${result.message}`);
+  // 如果是 waiting_approval，需要处理审批
+  // 如果是 completed，任务已完成
+  // 如果是 failed，需要重试
+  return;
+}
+
+// 4. 获取 SubagentTask 列表 (关键!)
+const subagentTasks = result.subagentTasks || [];
+console.log(`获取到 ${subagentTasks.length} 个待执行任务`);
+
+// 5. 执行每个 SubagentTask (关键!)
+for (const task of subagentTasks) {
+  console.log(`\n📍 执行任务: ${task.description}`);
+
+  // 使用 Agent 工具执行
+  const agentResult = await Agent({
+    subagent_type: task.subagent_type,  // 如 'general-purpose'
+    description: task.description,        // 如 'develop: 实现登录功能'
+    prompt: task.prompt,                  // 完整的任务提示
+    isolation: task.isolation             // 如 'worktree' 或 undefined
+  });
+
+  // 标记任务完成
+  await Bash({
+    command: `openmatrix complete ${task.taskId} --${agentResult.success ? 'success' : 'failed'}`,
+    description: `Mark task ${task.taskId} as ${agentResult.success ? 'success' : 'failed'}`
+  });
+}
+```
+
+**常见错误:**
+- ❌ 调用 CLI 后没有解析输出
+- ❌ 解析后没有读取 `subagentTasks` 字段
+- ❌ 读取后没有用 Agent 工具执行
+- ❌ 执行后没有调用 `openmatrix complete`
+
 ---
 
 **📍 Step 2 完成 → 下一步: Step 3 执行**