openmatrix 0.1.55 → 0.1.57

package/skills/auto.md

@@ -126,23 +126,21 @@ CLI 返回的 JSON 中 `subagentTasks` 数组包含每个待执行任务:
 ❌ **禁止在还有未完成任务时停止** — 即使 Agent 返回了大段输出，也必须继续下一个
 ❌ **禁止询问"是否继续"** — 直接执行下一个任务
 ❌ **禁止输出"让我知道是否..."后停止** — 继续执行
-❌ **禁止因为上下文压缩而忘记剩余任务** — 每完成一个任务后，重新读取 state.json 确认剩余任务
+❌ **禁止因为上下文压缩而忘记剩余任务** — 通过 CLI 命令从磁盘获取真实状态
 
-**执行循环伪代码:**
-```
-remaining = subagentTasks 中 status !== 'completed' 的任务
-while (remaining.length > 0) {
-  task = remaining[0]
-  result = Agent(task)           // 执行
-  更新任务状态为 completed
-  remaining = 从 state.json 重新读取未完成任务
-}
+**文件持久化循环（防止上下文压缩丢失状态）:**
+```bash
+# 每个 Agent 完成后执行:
+openmatrix complete TASK-XXX --success       # 标记完成 + 更新统计
+openmatrix step --json                       # 获取下一个任务 + 检查是否全部完成
 ```
+`openmatrix step` 从磁盘读取真实状态，不依赖上下文记忆。
 
 **中断恢复:** 如果会话中断，再次执行 `/om:auto` 时:
-1. 读取 `.openmatrix/state.json`
-2. 如果 `status === 'running'`，读取所有任务，找到 status 不是 completed 的任务
-3. 从中断的任务继续执行，不需要重新开始
+1. 执行 `openmatrix step --json`
+2. 如果返回 `status: "next"` → 从返回的任务继续执行
+3. 如果返回 `status: "done"` → 所有任务已完成
+4. 如果返回 `status: "blocked"` → 有阻塞任务需要处理
 </LOOP-ENFORCEMENT>
 
 对 `subagentTasks` 列表中的每个任务，调用 Agent 工具执行:
@@ -176,8 +174,17 @@ Agent({
 - [下一个 Agent 应该注意什么]
 ```
 
-2. 更新任务状态
-3. **立即检查是否还有未完成任务** — 读取 `.openmatrix/state.json` 中的 statistics，如果 completed < totalTasks，继续执行下一个
+2. **标记完成并更新统计（必须执行）:**
+```bash
+openmatrix complete TASK-XXX --success
+```
+3. **获取下一个任务（防止上下文压缩丢失）:**
+```bash
+openmatrix step --json
+```
+如果返回 `status: "next"` → 继续执行返回的 task
+如果返回 `status: "done"` → 所有任务完成，进入最终提交
+如果返回 `status: "blocked"` → 有阻塞任务，处理 Meeting
 4. Git 自动提交（**必须使用 HEREDOC 格式**）:
 
 **Agent 上下文共享机制 (Agent Memory):**

package/skills/brainstorm.md

@@ -25,20 +25,37 @@ description: 头脑风暴 - 探索需求和设计后再执行任务
      "status": "brainstorming",
      "message": "开始头脑风暴",
      "taskTitle": "任务标题",
-     "questions": [
-       {
-         "id": "core_objective",
-         "question": "这个任务的核心目标是什么？",
-         "header": "核心目标",
-         "options": [...],
-         "multiSelect": false
-       }
-     ],
+     "questions": [...],
+     "suggestResearch": "游戏开发",
+     "researchHint": "检测到垂直领域「游戏开发」，建议先进行领域调研",
      "hint": "请逐一回答问题，完成后再调用 --complete"
    }
    ```
 
-2. **交互式问答**
+2. **检测垂直领域** (如果 suggestResearch 存在)
+
+   如果 CLI 返回了 `suggestResearch` 字段，说明检测到垂直领域:
+
+   ```typescript
+   if (result.suggestResearch) {
+     AskUserQuestion({
+       questions: [{
+         question: `检测到垂直领域「${result.suggestResearch}」，建议先进行领域调研。\n\n领域调研可以帮助您:\n• 了解行业最佳实践\n• 获取技术方案建议\n• 生成领域专属文档 (如 GDD/PRD)\n\n是否进入领域调研？`,
+         header: "领域调研",
+         options: [
+           { label: "进入调研 (推荐)", description: "启动 /om:research 进行深度调研" },
+           { label: "跳过调研", description: "直接进行头脑风暴问答" }
+         ],
+         multiSelect: false
+       }]
+     })
+   }
+   ```
+
+   - 如果用户选择"进入调研"，调用 `/om:research`，研究完成后自动返回 start
+   - 如果用户选择"跳过调研"，继续下面的问答流程
+
+3. **交互式问答**
 
    对每个问题使用 `AskUserQuestion` 进行提问:
 
@@ -58,7 +75,7 @@ description: 头脑风暴 - 探索需求和设计后再执行任务
    - 记录可能的设计决策
    - 识别潜在风险
 
-3. **深入追问** (可选)
+4. **深入追问** (可选)
 
    如果用户选择了"其他"或回答不够清晰，进行追问:
    ```typescript
@@ -71,7 +88,7 @@ description: 头脑风暴 - 探索需求和设计后再执行任务
    })
    ```
 
-4. **总结头脑风暴结果**
+5. **总结头脑风暴结果**
 
    所有问题回答完成后，总结:
    - 核心目标
@@ -121,15 +138,64 @@ description: 头脑风暴 - 探索需求和设计后再执行任务
    })
    ```
 
-6. **自动执行 start**
+6. **智能检测 .openmatrix 状态后执行**
+
+   **先检测当前状态:**
+   ```bash
+   # 检查 .openmatrix 目录是否存在
+   ls .openmatrix/state.json 2>/dev/null
+   ```
+
+   **根据状态走不同路径:**
+
+   | .openmatrix 状态 | 处理方式 |
+   |-----------------|---------|
+   | 不存在 | 全新开始 → init → 写 tasks-input → CLI start |
+   | 存在，`status: completed` | 清理旧数据后重新开始 → 写 tasks-input → CLI start |
+   | 存在，`status: running` | 提示用户先完成或暂停当前任务 |
+   | 存在，`status: paused` | 询问用户：继续上次任务 还是 开始新任务 |
+   | 存在，`status: initialized` | 直接写 tasks-input → CLI start |
+
+   **路径 A: 全新开始 / 重新开始**
+   ```bash
+   # 初始化 (如果不存在)
+   openmatrix start --init-only
+
+   # 如果是重新开始，清理旧数据
+   # rm -rf .openmatrix/tasks/ .openmatrix/approvals/ .openmatrix/meetings/
+   ```
+
+   **将头脑风暴结论转换为 goals:**
+   ```json
+   {
+     "title": "任务标题",
+     "description": "基于头脑风暴的整体描述",
+     "goals": [
+       "目标1: 独立功能模块",
+       "目标2: 独立功能模块",
+       "..."
+     ],
+     "constraints": ["约束"],
+     "deliverables": ["交付物"],
+     "answers": { "问答答案" },
+     "quality": "strict/balanced/fast",
+     "mode": "auto",
+     "plan": "## 技术方案\n..."
+   }
+   ```
+
+   写入 `.openmatrix/tasks-input.json` 后执行:
+   ```bash
+   openmatrix start --tasks-json @.openmatrix/tasks-input.json --json
+   ```
+
+   **路径 B: 继续上次任务**
+   ```bash
+   openmatrix step --json
+   ```
+   从返回的 next task 继续执行。
 
-   如果用户选择"开始执行":
-   - 调用 CLI 标记头脑风暴完成:
-     ```bash
-     openmatrix brainstorm --complete --json
-     ```
-   - 自动调用 `/om:start` 开始执行任务
-   - 将头脑风暴收集的洞察传递给 start
+   **最终：从 CLI 返回的 `subagentTasks` 开始逐个执行 Agent**
 
 </process>
 

package/skills/om.md

@@ -1,21 +1,19 @@
 ---
 name: om
-description: "DEFAULT entry for OpenMatrix. Use for ANY task user wants done. Triggers on: 实现/添加/修复/重构/优化/写/做/开发. Example: '实现登录' → /om:start 实现登录. When in doubt, use this."
+description: "Use when starting any conversation - establishes OpenMatrix as the handler for development tasks. Routes /om:start automatically. Triggers on: implement, build, fix, create, refactor, 修复, 实现, 开发."
 priority: critical
 always_load: true
 ---
 
 <EXTREMELY-IMPORTANT>
-This is the DEFAULT action for ANY development task.
+## How to Use This Skill
 
-**Trigger immediately when user wants to:**
-- Build/create/implement something
-- Add new features or functionality
-- Fix bugs or resolve issues
-- Refactor or optimize code
-- Make changes to the codebase
+This is the DEFAULT entry when the user wants to produce code changes.
 
-**If you're unsure → USE `/om` anyway. It gracefully handles all task types.**
+**Analyze user INTENT:**
+- "实现X" / "implement X" / "build X" → Development task → This skill
+- "修复X" / "fix X" → Development task → This skill
+- "怎么实现?" / "how to?" → Question → NOT this skill (just answer)
 </EXTREMELY-IMPORTANT>
 
 <NO-OTHER-SKILLS>
@@ -23,79 +21,61 @@ This is the DEFAULT action for ANY development task.
 </NO-OTHER-SKILLS>
 
 <objective>
-OpenMatrix 的默认入口 - 自动启动任务编排。
-
-**核心价值：**
-- 用户无需记忆命令，直接描述任务即可
-- 自动识别任务类型并启动相应流程
-- 支持中英文混合输入
-
-**触发优先级：最高**
-- 任何"要做事情"的输入都应触发此技能
-- 系统会自动判断是执行任务还是回答问题
+OpenMatrix 默认入口 - 用户无需记忆命令，直接描述任务即可。
 </objective>
 
 <process>
-1. **解析用户输入**
+1. **Parse user input**
 
-   用户输入 `$ARGUMENTS` 可能是：
-   - 任务描述 (如 "实现用户登录功能")
-   - 文件路径 (如 "docs/task.md")
-   - 空输入
+   `$ARGUMENTS` can be:
+   - Task description: "实现用户登录功能"
+   - File path: "docs/task.md"
+   - Empty input
 
-2. **判断输入类型**
+2. **Route input**
 
-   **如果是任务描述或文件路径**:
-   → 直接调用 `/om:start` 并传递参数
+   **Task description or file path**:
+   → Invoke `/om:start` with arguments
 
-   **如果是空输入**:
-   → 显示帮助信息
+   **Empty input**:
+   → Show help
 
-3. **自动启动 /om:start**
-
-   无论用户输入什么，都自动转换为 `/om:start` 调用：
+3. **Auto-route to /om:start**
 
    ```
-   用户输入: "实现用户登录"
-   系统执行: /om:start 实现用户登录
-
-   用户输入: "docs/task.md"
-   系统执行: /om:start docs/task.md
-
-   用户输入: (空)
-   系统显示: 帮助信息
+   "实现用户登录"  → /om:start 实现用户登录
+   "docs/task.md"  → /om:start docs/task.md
+   (empty)         → Show help
    ```
 
-4. **帮助信息**
-
-   如果用户输入为空或输入 `--help`，显示：
+4. **Help**
 
+   If empty or `--help`:
    ```
-   📦 OpenMatrix - AI 任务编排系统
+   OpenMatrix - AI task orchestration
 
-   用法:
-     /om <任务描述>        直接启动任务
-     /om:brainstorm <任务> 先头脑风暴，再执行
-     /om:start <任务>      交互式启动 (可选质量级别)
-     /om:auto <任务>       全自动执行
+   Usage:
+     /om <task>           Start task
+     /om:brainstorm <task> Brainstorm first
+     /om:start <task>      Interactive start
+     /om:auto <task>       Full auto
 
-   示例:
+   Examples:
      /om 实现用户登录功能
      /om 修复登录页面的样式问题
      /om 添加 API 接口
 
-   质量级别:
-     🚀 strict   - TDD + 80%覆盖率 (生产代码)
-     ⚖️ balanced - 60%覆盖率 (日常开发)
-     ⚡ fast     - 无质量门禁 (快速原型)
+   Quality:
+     strict   - TDD + 80% coverage
+     balanced - 60% coverage
+     fast     - No gates
 
-   其他命令:
-     /om:brainstorm - 头脑风暴后再执行
-     /om:status     - 查看状态
-     /om:meeting    - 处理阻塞
-     /om:report     - 生成报告
+   Commands:
+     /om:brainstorm  - Brainstorm then execute
+     /om:status      - View status
+     /om:meeting     - Handle blockers
+     /om:report      - Generate report
    ```
-
 </process>
 
 <arguments>
@@ -103,48 +83,14 @@ $ARGUMENTS
 </arguments>
 
 <examples>
-/om 实现用户登录功能              # 自动启动任务编排
-/om 修复登录页面的样式问题        # 直接描述任务
-/om docs/task.md                 # 从文件读取任务
-/om                              # 显示帮助
+/om 实现用户登录功能              # Auto start
+/om 修复登录页面的样式问题        # Direct description
+/om docs/task.md                 # From file
+/om                              # Show help
 </examples>
 
 <notes>
-## 工作原理
-
-```
-用户输入: /om 实现登录
-     │
-     ▼
-┌─────────────────┐
-│ 检测到任务描述   │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ 自动调用        │
-│ /om:start       │
-│ 实现登录        │
-└─────────────────┘
-```
-
-## 与 /om:start 的关系
-
-`/om` 是 `/om:start` 的快捷方式：
-- `/om <任务>` ≡ `/om:start <任务>`
-- 用户体验更简洁
-- 功能完全相同
-
-## 推荐用法
-
-```bash
-# 快速启动 (推荐)
-/om 实现用户登录
-
-# 等价于
-/om:start 实现用户登录
-
-# 全自动模式
-/om:auto 实现用户登录
-```
+`/om` is a shortcut for `/om:start`:
+- `/om <task>` ≡ `/om:start <task>`
+- Same functionality, simpler UX
 </notes>