openmatrix 0.2.11 → 0.2.12

package/package.json

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

package/skills/auto.md

@@ -209,13 +209,29 @@ Agent({
 ```bash
 openmatrix complete TASK-XXX --success
 ```
-3. **获取下一个任务（防止上下文压缩丢失）:**
+
+3. **获取下一个任务（必须执行，防止上下文压缩丢失）:**
 ```bash
 openmatrix step --json
 ```
-如果返回 `status: "next"` → 继续执行返回的 task
-如果返回 `status: "done"` → 所有任务完成，进入最终提交
-如果返回 `status: "blocked"` → 有阻塞任务，处理 Meeting
+
+**返回值解析：**
+
+| status | 含义 | 后续操作 |
+|--------|------|---------|
+| `next` | 有下一个任务 | 继续执行返回的 `subagent` 配置 |
+| `done` | 所有任务完成 | 进入最终提交 |
+| `blocked` | 无可执行任务 | `/om:auto` 直接跳过，继续执行其他任务 |
+
+**`next` 返回结构：**
+```json
+{
+  "status": "next",
+  "task": { "id": "TASK-XXX", "title": "...", "status": "in_progress" },
+  "subagent": { "subagent_type": "...", "description": "...", "prompt": "...", "timeout": 120000 },
+  "statistics": { "total": 5, "completed": 2, "remaining": 3, "failed": 0 }
+}
+```
 
 **Meeting 处理机制:**
  `/om:auto` 不创建 Meeting 记录，直接跳过阻塞任务，无障碍执行。

package/skills/start.md

@@ -419,13 +419,60 @@ openmatrix complete TASK-XXX --success --summary "关键决策: xxx; 创建文
    - 后续 Agent 可读取此文件了解前序任务的决策和发现
 
 3. Git 自动提交（必须使用下方统一提交格式）
-4. **获取下一个任务（防止上下文压缩丢失）:**
+
+4. **获取下一个任务（必须执行，防止上下文压缩丢失）:**
 ```bash
 openmatrix step --json
 ```
-如果返回 `status: "next"` → 继续执行返回的 task
-如果返回 `status: "done"` → 所有任务完成，进入最终提交
-如果返回 `status: "blocked"` → 有阻塞任务，处理 Meeting
+
+**返回值解析：**
+
+| status | 含义 | 后续操作 |
+|--------|------|---------|
+| `next` | 有下一个任务 | 继续执行返回的 `subagent` 配置 |
+| `done` | 所有任务完成 | 进入最终提交（Step 11） |
+| `blocked` | 无可执行任务 | 检查是否有 Meeting，用 `/om:meeting` 处理 |
+
+**`next` 返回结构：**
+```json
+{
+  "status": "next",
+  "task": {
+    "id": "TASK-XXX",
+    "title": "任务标题",
+    "status": "in_progress"
+  },
+  "subagent": {
+    "subagent_type": "general-purpose",
+    "description": "任务描述",
+    "prompt": "完整 prompt",
+    "isolation": "worktree",
+    "timeout": 120000
+  },
+  "statistics": {
+    "total": 5,
+    "completed": 2,
+    "remaining": 3,
+    "failed": 0
+  }
+}
+```
+
+**使用返回值执行下一个 Agent：**
+```typescript
+// 从 step 返回的 subagent 对象直接用于 Agent 工具
+const stepResult = JSON.parse(/* openmatrix step --json 输出 */);
+if (stepResult.status === 'next') {
+  Agent({
+    subagent_type: stepResult.subagent.subagent_type,
+    description: stepResult.subagent.description,
+    prompt: stepResult.subagent.prompt + "\n\n⚠️ ...",
+    isolation: stepResult.subagent.isolation,
+    run_in_background: true
+  })
+}
+```
+
 5. 检查审批点（auto 模式自动批准，其他模式按配置暂停）
 
 6. **审批点处理（根据执行模式）:**