openmatrix 0.1.56 → 0.1.57

package/dist/cli/commands/start.js

@@ -164,7 +164,11 @@ async function handleTasksJson(options, stateManager, state, omPath) {
     };
     // 解析质量配置
     const qualityLevel = tasksInput.quality || options.quality || 'balanced';
-    const qualityConfig = index_js_1.QUALITY_PRESETS[qualityLevel.toLowerCase()] || index_js_1.QUALITY_PRESETS.balanced;
+    const qualityConfig = { ...(index_js_1.QUALITY_PRESETS[qualityLevel.toLowerCase()] || index_js_1.QUALITY_PRESETS.balanced) };
+    // E2E 测试覆盖（用户在 Skill 问答中选择启用）
+    if (tasksInput.e2eTests) {
+        qualityConfig.e2eTests = true;
+    }
     if (!options.json) {
         console.log(`\n📋 任务: ${parsedTask.title}`);
         console.log(`   目标: ${parsedTask.goals.join(', ')}`);

package/dist/cli/index.js

@@ -15,6 +15,7 @@ const check_js_1 = require("./commands/check.js");
 const check_gitignore_js_1 = require("./commands/check-gitignore.js");
 const analyze_js_1 = require("./commands/analyze.js");
 const brainstorm_js_1 = require("./commands/brainstorm.js");
+const research_js_1 = require("./commands/research.js");
 const complete_js_1 = require("./commands/complete.js");
 const step_js_1 = require("./commands/step.js");
 const program = new commander_1.Command();
@@ -38,5 +39,6 @@ program.addCommand(check_js_1.checkCommand);
 program.addCommand(check_gitignore_js_1.checkGitignoreCommand);
 program.addCommand(analyze_js_1.analyzeCommand);
 program.addCommand(brainstorm_js_1.brainstormCommand);
+program.addCommand(research_js_1.researchCommand);
 // 默认帮助
 program.parse();

package/dist/orchestrator/phase-executor.js

@@ -702,6 +702,13 @@ ACCEPT_FAILED
                 updates.status = 'completed';
             }
             await this.stateManager.updateTask(task.id, updates);
+            // 持久化 Phase 结果到磁盘
+            await this.stateManager.savePhaseResult(task.id, phase, {
+                success: true,
+                output: result.output,
+                phaseStatus: 'completed',
+                completedAt: now
+            });
             // 自动提交代码
             if (this.runId) {
                 try {
@@ -740,6 +747,13 @@ ACCEPT_FAILED
                 status: 'failed',
                 error: result.error || `${phase} phase failed`
             });
+            // 持久化失败结果
+            await this.stateManager.savePhaseResult(task.id, phase, {
+                success: false,
+                error: result.error || `${phase} phase failed`,
+                phaseStatus: 'failed',
+                failedAt: now
+            });
             return {
                 phase,
                 success: false,

package/dist/storage/state-manager.d.ts

@@ -17,6 +17,22 @@ export declare class StateManager {
     getTask(taskId: string): Promise<Task | null>;
     updateTask(taskId: string, updates: Partial<Task>): Promise<void>;
     listTasks(): Promise<Task[]>;
+    /**
+     * 保存 Phase 结果到任务子目录
+     */
+    savePhaseResult(taskId: string, phase: string, result: Record<string, unknown>): Promise<void>;
+    /**
+     * 读取 Phase 结果
+     */
+    getPhaseResult(taskId: string, phase: string): Promise<Record<string, unknown> | null>;
+    /**
+     * 保存 Agent 上下文到 context.md
+     */
+    saveTaskContext(taskId: string, content: string): Promise<void>;
+    /**
+     * 读取 Agent 上下文
+     */
+    getTaskContext(taskId: string): Promise<string | null>;
     private updateTaskStatistics;
     private generateRunId;
     private generateTaskId;

package/dist/storage/state-manager.js

@@ -74,7 +74,9 @@ class StateManager {
             createdAt: now,
             updatedAt: now
         };
-        await this.store.writeJson(`tasks/${taskId}.json`, task);
+        await this.store.writeJson(`tasks/${taskId}/task.json`, task);
+        // Create artifacts subdirectory
+        await this.store.ensureDir(`tasks/${taskId}/artifacts`);
         // Update statistics
         const state = await this.getState();
         await this.updateState({
@@ -87,7 +89,12 @@ class StateManager {
         return task;
     }
     async getTask(taskId) {
-        return await this.store.readJson(`tasks/${taskId}.json`);
+        // Try subdirectory structure first, fall back to flat file
+        let task = await this.store.readJson(`tasks/${taskId}/task.json`);
+        if (!task) {
+            task = await this.store.readJson(`tasks/${taskId}.json`);
+        }
+        return task;
     }
     async updateTask(taskId, updates) {
         const task = await this.getTask(taskId);
@@ -99,22 +106,67 @@ class StateManager {
             ...updates,
             updatedAt: new Date().toISOString()
         };
-        await this.store.writeJson(`tasks/${taskId}.json`, updatedTask);
+        // Always write to subdirectory structure
+        await this.store.writeJson(`tasks/${taskId}/task.json`, updatedTask);
         // Update statistics if status changed
         if (updates.status && updates.status !== oldStatus) {
             await this.updateTaskStatistics(oldStatus, updates.status);
         }
     }
     async listTasks() {
-        const files = await this.store.listFiles('tasks');
         const tasks = [];
-        for (const file of files) {
-            const task = await this.store.readJson(`tasks/${file}`);
+        // Read from subdirectory structure: tasks/TASK-XXX/task.json
+        const dirs = await this.store.listDirs('tasks');
+        for (const dir of dirs) {
+            const task = await this.store.readJson(`tasks/${dir}/task.json`);
             if (task)
                 tasks.push(task);
         }
+        // Also check flat files (backward compat)
+        const files = await this.store.listFiles('tasks');
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            const task = await this.store.readJson(`tasks/${file}`);
+            if (task) {
+                // Avoid duplicate if already found in subdirectory
+                if (!tasks.some(t => t.id === task.id)) {
+                    tasks.push(task);
+                }
+            }
+        }
         return tasks.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
     }
+    // ============ Task Artifact Methods ============
+    /**
+     * 保存 Phase 结果到任务子目录
+     */
+    async savePhaseResult(taskId, phase, result) {
+        await this.store.writeJson(`tasks/${taskId}/${phase}.json`, {
+            taskId,
+            phase,
+            timestamp: new Date().toISOString(),
+            ...result
+        });
+    }
+    /**
+     * 读取 Phase 结果
+     */
+    async getPhaseResult(taskId, phase) {
+        return await this.store.readJson(`tasks/${taskId}/${phase}.json`);
+    }
+    /**
+     * 保存 Agent 上下文到 context.md
+     */
+    async saveTaskContext(taskId, content) {
+        await this.store.writeMarkdown(`tasks/${taskId}/context.md`, content);
+    }
+    /**
+     * 读取 Agent 上下文
+     */
+    async getTaskContext(taskId) {
+        return await this.store.readMarkdown(`tasks/${taskId}/context.md`);
+    }
     async updateTaskStatistics(oldStatus, newStatus) {
         const state = await this.getState();
         const stats = { ...state.statistics };

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export type TaskStatus = 'pending' | 'scheduled' | 'in_progress' | 'blocked' | 'waiting' | 'verify' | 'accept' | 'completed' | 'failed' | 'retry_queue';
 export type TaskPriority = 'P0' | 'P1' | 'P2' | 'P3';
+export type ResearchMode = 'domain' | 'tech' | 'problem';
 export interface TaskPhase {
     status: TaskStatus;
     duration: number | null;
@@ -201,3 +202,38 @@ export interface ParsedTask {
     deliverables: string[];
     rawContent: string;
 }
+export interface ResearchAgentConfig {
+    role: string;
+    focus: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    result?: string;
+}
+export interface ResearchQuestion {
+    id: string;
+    question: string;
+    header: string;
+    options: Array<{
+        label: string;
+        description: string;
+    }>;
+    multiSelect: boolean;
+}
+export interface ResearchSession {
+    status: 'initialized' | 'preview' | 'researching' | 'questioning' | 'completed';
+    topic: string;
+    domain: string;
+    aspects: string[];
+    estimatedQuestions: number;
+    agents: ResearchAgentConfig[];
+    domainQuestions: ResearchQuestion[];
+    answers: Record<string, string | string[]>;
+    report?: string;
+    knowledge: string[];
+    context?: {
+        goals: string[];
+        constraints: string[];
+        deliverables: string[];
+    };
+    createdAt: string;
+    completedAt?: string;
+}

package/package.json

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

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>