openmatrix 0.1.56 → 0.1.57

package/skills/openmatrix.md

@@ -1,190 +1,97 @@
----
-name: openmatrix
-description: "TRIGGER for ANY implementation task. User wants to build/create/add/fix/implement/refactor something? This is the DEFAULT. Examples: 'add feature', 'fix bug', 'implement login', 'refactor code', 'create command'. ALWAYS prefer this over direct coding."
-priority: critical
-always_load: true
----
-
-<EXTREMELY-IMPORTANT>
-This skill MUST be invoked when the user describes ANY work to be done.
-
-**If you're unsure whether to invoke → INVOKE IT.**
-
-**If user mentions: add/create/implement/fix/build/make/write/develop/refactor/optimize/update/modify/change → INVOKE THIS SKILL.**
-
-**Direct coding without OpenMatrix is ONLY allowed for:**
-- Simple one-line fixes (typos, variable names)
-- Answering questions (no code changes needed)
-- Information retrieval (reading files, explaining code)
-
-Everything else → smart selection between `/om:brainstorm` and `/om:start`.
-</EXTREMELY-IMPORTANT>
-
-<objective>
-Automatically detect when user wants to accomplish a development task and intelligently choose between brainstorm (for complex tasks) or start (for simple tasks).
-</objective>
-
-<process>
-1. **询问是否启用智能选择**
-
-   使用 AskUserQuestion 询问用户:
-   ```
-   问题: 是否启用智能模式？
-   选项:
-   - 🧠 智能选择 (推荐) - 自动判断任务复杂度，选择 brainstorm 或 start
-   - 🚀 直接执行 - 跳过头脑风暴，直接开始任务
-   - 🧐 先探索需求 - 强制使用头脑风暴模式
-   ```
-
-2. **根据选择执行不同流程**
-
-   **选择"智能选择"**:
-   - 分析任务复杂度
-   - 展示推断结果，让用户确认或修改
-   - 执行选择的命令
-
-   **选择"直接执行"**:
-   - 直接调用 /om:start
-
-   **选择"先探索需求"**:
-   - 直接调用 /om:brainstorm
-
-3. **智能分析（如果启用）**
-
-   **复杂任务** (满足任一条件):
-   - 新功能开发: "实现用户登录" / "添加支付功能"
-   - 多模块改动: "重构用户系统" / "优化整体性能"
-   - 架构相关: "搭建框架" / "从零开始"
-   - 关键词: "系统" / "架构" / "模块" / "集成" / "完整"
-
-   **简单任务** (满足任一条件):
-   - Bug 修复: "修复登录bug" / "解决样式问题"
-   - 小改动: "修改文案" / "改变量名"
-   - 单一功能: "添加一个按钮" / "写个工具函数"
-   - 关键词: "修复" / "解决" / "改" / "调整" / "简单"
-
-4. **展示推断结果并确认**
-
-   使用 AskUserQuestion 展示推断结果:
-   ```
-   问题: 检测到这是一个【复杂/简单】任务，将使用【brainstorm/start】模式
-   选项:
-   - ✅ 确认执行 - 使用推荐的模式
-   - 🧠 改用头脑风暴 - 先探索需求再执行
-   - 🚀 改用直接执行 - 跳过探索直接开始
-   - ✏️ 自定义输入 - 输入其他指令
-   ```
-
-5. **执行选择的命令**
-</process>
-
-<trigger-conditions>
-## AUTO-INVOKE RULES (Mandatory)
-
-**Invoke IMMEDIATELY when user input contains ANY of these patterns:**
-
-### Action Verbs (触发词)
-| Chinese | English | Action |
-|---------|---------|--------|
-| 实现/开发/做/写 | implement/build/create/make/write | → Smart Select |
-| 添加/增加/加 | add/append | → Smart Select |
-| 修复/解决/改 | fix/resolve/repair | → Smart Select |
-| 重构/优化/改进 | refactor/optimize/improve | → Smart Select |
-| 更新/修改/改 | update/modify/change | → Smart Select |
-
-### Context Patterns (触发场景)
-- **Feature requests**: "用户登录" / "支付功能" / "API接口"
-- **Bug reports**: "报错" / "不工作" / "有问题" / "崩溃"
-- **Code changes**: "这段代码" / "这个文件" / "那个模块"
-- **Multi-step tasks**: "先做A" / "然后B" / "最后C"
-- **System building**: "做一个系统" / "搭建框架" / "从零开始"
-
-### The 3-Second Test
-```
-用户输入 → 能在3秒内判断是"要做事情"吗?
-  ↓ Yes                           ↓ No
-Smart Select                    直接回答
-```
-</trigger-conditions>
-
-<smart-selection>
-## 智能选择：Brainstorm vs Start
-
-**根据任务复杂度自动选择执行路径：**
-
-### 🧠 复杂任务 → `/om:brainstorm`
-**触发条件 (满足任一):**
-- 新功能开发: "实现用户登录" / "添加支付功能" / "开发 API"
-- 多模块改动: "重构用户系统" / "优化整体性能"
-- 架构相关: "搭建框架" / "从零开始" / "设计架构"
-- 不确定因素: 需要技术选型、涉及多种方案选择
-- 关键词: "系统" / "架构" / "模块" / "集成" / "完整" / "从零"
-
-### 🚀 简单任务 → `/om:start`
-**触发条件 (满足任一):**
-- Bug 修复: "修复登录bug" / "解决样式问题" / "改个报错"
-- 小改动: "修改文案" / "改变量名" / "调整配置"
-- 单一功能: "添加一个按钮" / "写个工具函数"
-- 明确需求: 需求清晰，无需额外探索
-- 关键词: "修复" / "解决" / "改" / "调整" / "小" / "简单"
-
-### 选择流程
-```
-用户输入任务描述
-       │
-       ▼
-┌─────────────────────┐
-│ 分析任务复杂度        │
-└──────────┬──────────┘
-           │
-     ┌─────┴─────┐
-     │           │
-  复杂任务     简单任务
-     │           │
-     ▼           ▼
-/om:brainstorm  /om:start
-```
-
-### 判断示例
-| 用户输入 | 复杂度 | 执行路径 |
-|---------|--------|---------|
-| "实现用户登录功能" | 复杂 | `/om:brainstorm` |
-| "做一个完整的支付系统" | 复杂 | `/om:brainstorm` |
-| "从零搭建后台管理" | 复杂 | `/om:brainstorm` |
-| "修复登录页面的样式问题" | 简单 | `/om:start` |
-| "改一下这个变量名" | 简单 | `/om:start` |
-| "添加一个测试用例" | 简单 | `/om:start` |
-| "重构这个模块" | 中等 | `/om:brainstorm` (保守选择) |
-| "优化性能" | 中等 | `/om:brainstorm` (保守选择) |
-
-**不确定时的默认选择: `/om:brainstorm`** (宁可多问，不可漏问)
-</smart-selection>
-
-<exclusions>
-## When NOT to Invoke (Rare Cases)
-
-**Do NOT invoke ONLY when:**
-- Pure question: "怎么实现?" / "如何配置?" / "what is..." / "为什么"
-- Information request: "显示配置" / "列出文件" / "show me..." / "看一下"
-- Status check: "状态" / "进度" / "status"
-- Casual chat: "你好" / "谢谢" / "hello"
-
-**Key Test:**
-```
-用户要我写代码/改代码/做东西吗?
-  ↓ Yes → Smart Select (brainstorm/start)
-  ↓ No  → 直接回答
-```
-
-**When in doubt → INVOKE. It handles both simple and complex tasks.**
-</exclusions>
-
-<examples>
-| User Input | Complexity | Action |
-|------------|------------|--------|
-| `实现用户登录功能` | 复杂 | → `/om:brainstorm` |
-| `做一个完整的订单系统` | 复杂 | → `/om:brainstorm` |
-| `修复登录页面的样式问题` | 简单 | → `/om:start` |
-| `改一下这个变量名` | 简单 | → `/om:start` |
-| `重构用户模块` | 中等 | → `/om:brainstorm` |
-| `怎么实现登录?` | - | ❌ Question, not task |
+---
+name: openmatrix
+description: "Use when starting any conversation where user wants development work done. Establishes how to detect development tasks and route to OpenMatrix workflow. Examples: 'implement X', 'build a game', 'fix bug', 'refactor module', 'add feature'."
+priority: critical
+always_load: true
+---
+
+<EXTREMELY-IMPORTANT>
+## How to Detect Development Tasks
+
+When the user's message indicates they want code produced or changed, this is a **development task** and OpenMatrix handles it.
+
+**The Development Task Detection Flow:**
+```
+User message received
+       │
+       ▼
+Is the user asking me to PRODUCE code changes?
+       │
+    YES ──→ OpenMatrix handles this
+       │     (has its own brainstorm + plan + execute)
+       │
+    NO ──→ Other skills or direct answer
+```
+
+**What counts as "produce code changes":**
+| Signal | Example |
+|--------|---------|
+| User describes a goal to implement | "实现这个游戏", "build a login page" |
+| User references a spec/doc and wants it built | "@docs/require.md 实现这个游戏" |
+| User reports a bug to fix | "修复登录bug", "fix the crash" |
+| User wants code refactored/optimized | "重构用户模块", "optimize performance" |
+| User wants a feature added | "添加API接口", "add dark mode" |
+
+**What does NOT count:**
+| Signal | Example | Route |
+|--------|---------|-------|
+| Asking how something works | "怎么实现?" / "how does X work?" | Direct answer |
+| Requesting information | "显示配置" / "show me the code" | Direct answer |
+| Checking status | "进度" / "status" | Direct answer |
+
+**IMPORTANT:** OpenMatrix includes its own brainstorm mode (`/om:brainstorm`).
+When a development task is complex (new feature, multi-module, from-scratch), use `/om:brainstorm`.
+When a development task is simple (bug fix, small change, clear requirement), use `/om:start`.
+</EXTREMELY-IMPORTANT>
+
+<NO-OTHER-SKILLS>
+执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+</NO-OTHER-SKILLS>
+
+<objective>
+Detect development task intent and route to OpenMatrix's internal workflow.
+</objective>
+
+<process>
+1. **Intent Analysis**
+
+   Determine if user wants to "do work" or "get information":
+
+   | User Intent | Behavioral Signal | Route |
+   |---------|---------|------|
+   | Build something | Describes goal, cites spec to implement | → OpenMatrix |
+   | Fix something | Reports problem, describes error | → OpenMatrix |
+   | Change something | Points to code to modify, proposes improvement | → OpenMatrix |
+   | Ask something | Question form, seeking explanation | → Direct answer |
+   | View something | Status check, info retrieval | → Direct answer |
+
+2. **Complexity Assessment**
+
+   **Complex → `/om:brainstorm`** (explore requirements first):
+   - New feature (from scratch)
+   - Multi-module changes (architecture involved)
+   - Unclear requirements (need to explore first)
+
+   **Simple → `/om:start`** (clear requirements):
+   - Bug fix
+   - Small change
+   - Single feature
+   - Clear requirement
+
+3. **Execute directly, no extra confirmation**
+
+   After assessment, invoke the command directly.
+</process>
+
+<examples>
+| User Input | Intent | Complexity | Action |
+|------------|--------|------------|--------|
+| `实现这个游戏` (with @file) | Build | Complex | → `/om:brainstorm` |
+| `实现用户登录功能` | Build | Complex | → `/om:brainstorm` |
+| `修复登录页面的样式问题` | Fix | Simple | → `/om:start` |
+| `改一下这个变量名` | Change | Simple | → `/om:start` |
+| `添加一个测试用例` | Build | Simple | → `/om:start` |
+| `重构用户模块` | Change | Medium | → `/om:brainstorm` |
+| `从零搭建后台管理` | Build | Complex | → `/om:brainstorm` |
+| `怎么实现登录?` | Ask | - | ❌ Direct answer |
+| `这个函数有什么问题?` | Ask | - | ❌ Direct answer |

package/skills/research.md

@@ -0,0 +1,258 @@
+---
+name: om:research
+description: 领域调研和问题探索 - 为后续任务提供知识基础
+---
+
+<NO-OTHER-SKILLS>
+执行此技能时，不得调用其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+</NO-OTHER-SKILLS>
+
+<objective>
+在执行垂直领域任务前，由 AI 分析主题、识别领域、引导用户补全信息、生成领域专属文档，为后续 start 提供扎实的知识基础。
+</objective>
+
+<process>
+1. **初始化研究会话**
+
+   调用 CLI 创建研究会话:
+   ```bash
+   openmatrix research "$ARGUMENTS" --json
+   ```
+
+   返回:
+   ```json
+   {
+     "status": "initialized",
+     "message": "研究会话已创建，需要 AI 分析领域",
+     "topic": "做一个游戏",
+     "hint": "请使用 Agent 分析主题，识别领域和调研方向"
+   }
+   ```
+
+2. **AI 分析主题 (关键步骤)**
+
+   启动 Agent 分析用户主题，识别领域和调研方向:
+
+   ```
+   Agent (Explore): 分析主题 "${topic}"
+
+   分析要求:
+   1. 识别领域: 这属于什么行业/技术领域？
+   2. 调研方面: 这个领域有哪些核心方面需要了解？(5-10个)
+   3. 关键决策: 用户需要做出哪些重要选择？
+   4. 问题估算: 预计需要问多少个问题？
+
+   严格输出 JSON:
+   {
+     "domain": "领域名称",
+     "aspects": ["方面1", "方面2", ...],
+     "keyDecisions": ["决策1", "决策2", ...],
+     "estimatedQuestions": 数字
+   }
+   ```
+
+   Agent prompt:
+   ```
+   你是一个领域分析专家。请分析以下主题:
+
+   ## 用户主题
+   {topic}
+
+   ## 分析要求
+   1. 识别领域: 这属于什么行业/技术领域？要具体，如"游戏开发"而不是"软件开发"
+   2. 调研方面: 这个领域有哪些核心方面需要了解？列出 5-10 个
+   3. 关键决策: 用户需要做出哪些重要选择？如"技术选型"、"平台选择"
+   4. 问题估算: 预计需要问多少个问题才能收集足够信息？
+
+   ## 输出格式
+   请严格输出以下 JSON 格式，不要有其他内容:
+   ```json
+   {
+     "domain": "领域名称",
+     "aspects": ["方面1", "方面2", "方面3", ...],
+     "keyDecisions": ["决策1", "决策2", ...],
+     "estimatedQuestions": 数字
+   }
+   ```
+   ```
+
+3. **更新会话并展示预览**
+
+   Agent 返回分析结果后，更新会话文件:
+   ```bash
+   # 读取当前会话并更新
+   # 将 domain, aspects, estimatedQuestions 写入 .openmatrix/research/session.json
+   # status 改为 'preview'
+   ```
+
+   然后展示给用户确认:
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: `检测到「${domain}」领域，将调研以下方面:\n\n${aspects.map(a => `• ${a}`).join('\n')}\n\n预计 ${estimatedQuestions} 个问题，是否开始？`,
+       header: "确认研究",
+       options: [
+         { label: "开始研究", description: "启动并行 Agent 进行深度调研" },
+         { label: "跳过研究", description: "直接进入任务执行" },
+         { label: "调整范围", description: "修改研究方向" }
+       ],
+       multiSelect: false
+     }]
+   })
+   ```
+
+4. **确认后启动并行研究**
+
+   用户确认后，调用 CLI:
+   ```bash
+   openmatrix research --confirm --json
+   ```
+
+   返回:
+   ```json
+   {
+     "status": "researching",
+     "message": "开始深度研究",
+     "topic": "做一个游戏",
+     "domain": "游戏开发",
+     "aspects": [...],
+     "agents": [
+       { "role": "domain_researcher", "focus": "...", "status": "pending" },
+       { "role": "tech_explorer", "focus": "...", "status": "pending" },
+       { "role": "scenario_analyst", "focus": "...", "status": "pending" }
+     ],
+     "hint": "使用 Agent 工具并行执行研究"
+   }
+   ```
+
+5. **并行启动研究 Agent**
+
+   使用 Agent 工具并行启动 2-3 个研究 Agent:
+
+   ```
+   Agent 1 (domain_researcher): 用 WebSearch 搜索 {domain} 领域核心概念、行业标准
+   Agent 2 (tech_explorer): 用 WebSearch 搜索 {domain} 主流技术方案、架构模式
+   Agent 3 (scenario_analyst): 结合 "{topic}" 分析实际应用场景、常见挑战
+   ```
+
+6. **基于研究结果生成领域问卷**
+
+   研究完成后，从报告中提取关键决策点，转化为问题:
+
+   ```typescript
+   // 批量提问 (每次最多 4 个问题)
+   AskUserQuestion({ questions: domainQuestions.slice(0, 4) });
+   ```
+
+7. **生成领域专属文档**
+
+   基于研究结果和用户回答，生成领域文档:
+
+   | 领域 | 文档类型 |
+   |------|----------|
+   | 游戏开发 | GDD (游戏设计文档) |
+   | Web 网站 | PRD (产品需求文档) |
+   | 支付系统 | 技术方案文档 |
+   | 后台管理 | 功能规格文档 |
+   | 通用 | 研究报告 |
+
+8. **完成研究并接入 start**
+
+   ```bash
+   openmatrix research --complete --results '<json>' --json
+   ```
+
+   然后询问用户是否开始执行:
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: `研究完成！已生成「${domain}」领域文档。\n\n下一步？`,
+       header: "下一步",
+       options: [
+         { label: "开始执行 (推荐)", description: "自动接入 /om:start" },
+         { label: "查看报告", description: "先查看研究报告" },
+         { label: "继续研究", description: "深入某个方向" }
+       ],
+       multiSelect: false
+     }]
+   })
+   ```
+
+</process>
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+<examples>
+/om:research "做一个游戏"
+/om:research "开发一个支付系统"
+/om:research "构建一个电商网站"
+</examples>
+
+<notes>
+## 核心变化
+
+**AI 分析领域，而非关键词匹配**
+
+旧方式: CLI 内置关键词列表，硬编码领域检测
+新方式: Agent 分析主题，动态识别领域和调研方向
+
+## 流程图
+
+```
+┌──────────────────────┐
+│ /om:research "做游戏" │
+└──────────┬───────────┘
+           │
+           ▼
+┌──────────────────────┐
+│ CLI: 创建初始会话     │  status: "initialized"
+└──────────┬───────────┘
+           │
+           ▼
+┌──────────────────────┐
+│ Agent: 分析主题       │  识别领域、方面、决策
+└──────────┬───────────┘
+           │
+           ▼
+┌──────────────────────┐
+│ 更新会话 → preview    │
+│ 展示给用户确认        │
+└──────────┬───────────┘
+           │
+           ▼
+┌──────────────────────┐
+│ 用户确认 → --confirm  │
+│ 并行 Agent 研究       │
+└──────────┬───────────┘
+           │
+           ▼
+┌──────────────────────┐
+│ 问卷 → 领域文档       │
+│ → --complete          │
+└──────────┬───────────┘
+           │
+           ▼
+┌──────────────────────┐
+│ 接入 /om:start        │
+└──────────────────────┘
+```
+
+## 与 brainstorm 的集成
+
+brainstorm 检测到垂直领域时，返回 `suggestResearch`。
+brainstorm skill 询问用户是否进入 research，确认后调用 `/om:research`。
+
+## 输出文件
+
+```
+.openmatrix/research/
+├── session.json          # 研究会话状态
+├── RESEARCH.md           # 领域专属文档 (GDD/PRD/技术方案)
+├── knowledge/
+│   ├── finding-1.md      # 关键发现
+│   └── finding-2.md
+└── context.json          # → start 的任务上下文
+```
+</notes>

package/skills/start.md

@@ -39,15 +39,24 @@ Step 10: 逐个执行 subagentTasks（调用 Agent 工具）    ← 只有这步
 
 ## === 准备阶段（此阶段不得写任何业务代码）===
 
-### Step 1: 初始化
+### Step 1: 智能检测状态
 
-检查 `.openmatrix/` 目录是否存在，不存在则初始化:
+检查 `.openmatrix/` 目录和 `state.json` 的状态:
+
+| 状态 | 处理方式 |
+|------|---------|
+| `.openmatrix/` 不存在 | 全新初始化: `openmatrix start --init-only` |
+| `status: initialized` | 正常继续（首次使用） |
+| `status: completed` | 提示用户：开始新任务会清理旧数据，确认后继续 |
+| `status: running` | 提示用户先完成或暂停当前任务，然后退出 |
+| `status: paused` | 询问用户：继续上次任务（→`/om:resume`）还是开始新任务 |
+| `status: failed` | 询问用户：重试失败任务（→`/om:retry`）还是开始新任务 |
+
+**如果是全新初始化:**
 ```bash
 openmatrix start --init-only
 ```
 
-读取 `.openmatrix/state.json`，如果 `status === 'running'`，提示用户先完成或暂停。
-
 检查 Git 仓库:
 - 无 `.git` → 询问用户是否初始化
 - 无远程仓库 → 提示用户添加
@@ -87,6 +96,15 @@ AskUserQuestion({
         { label: "fast", description: "无质量门禁" }
       ],
       multiSelect: false
+    },
+    {
+      question: "是否启用 E2E 测试? (Web/Mobile/GUI 项目推荐)",
+      header: "E2E",
+      options: [
+        { label: "跳过 (推荐)", description: "E2E 测试耗时较长，大多数项目不需要" },
+        { label: "启用", description: "适合 Web 应用 (Playwright/Cypress)、Mobile (Appium/Detox)" }
+      ],
+      multiSelect: false
     }
   ]
 })
@@ -113,16 +131,16 @@ AskUserQuestion({
     question: "请选择执行模式:",
     header: "执行模式",
     options: [
-      { label: "每阶段确认", description: "每个阶段完成后暂停" },
-      { label: "关键节点确认", description: "plan/merge/deploy 时暂停" },
-      { label: "全自动执行", description: "无需确认，自动完成" }
+      { label: "全自动执行 (推荐)", description: "无需确认，自动完成" },
+      { label: "关键节点确认", description: "plan/merge 时暂停确认" },
+      { label: "每阶段确认", description: "每个阶段完成后暂停" }
     ],
     multiSelect: false
-  }]
+  ]
 })
 ```
 
-**如果用户选择"全自动执行"，进入 BYPASS 模式（所有操作自动批准）。**
+**默认进入 BYPASS 模式（全自动执行），用户可选其他模式。**
 
 ### Step 6: AI 提取 goals + 生成 plan
 
@@ -150,6 +168,12 @@ AskUserQuestion({
 }
 ```
 
+**E2E 测试:** 如果用户在 Step 4 选择了"启用 E2E"，在 quality 后面加上:
+```
+"e2eTests": true
+```
+这会让 CLI 的 TaskPlanner 在任务拆分时生成额外的 E2E 测试任务。
+
 ### Step 8: 调用 CLI 创建任务 ⚠️ 不可跳过
 
 **必须执行此命令，禁止跳过：**