openmatrix 0.1.42 → 0.1.44

package/dist/orchestrator/task-planner.d.ts

@@ -8,7 +8,6 @@ export interface TaskBreakdown {
     estimatedComplexity: 'low' | 'medium' | 'high';
     assignedAgent: 'planner' | 'coder' | 'tester' | 'reviewer' | 'researcher' | 'executor';
     acceptanceCriteria?: string[];
-    testTaskId?: string;
     phase: 'design' | 'develop' | 'verify' | 'accept';
 }
 export interface UserAnswers {
@@ -17,71 +16,29 @@ export interface UserAnswers {
     testCoverage?: string;
     documentationLevel?: string;
     additionalContext?: Record<string, string>;
-    /** 是否启用 E2E 测试 */
-    e2eTests?: boolean;
-    /** E2E 测试类型 (web/mobile/gui) */
-    e2eType?: 'web' | 'mobile' | 'gui';
 }
 /**
  * TaskPlanner - 任务拆解器
  *
- * 增强版特性:
- * 1. 更细粒度的任务拆分 (每个目标拆分为设计+实现+测试)
- * 2. 测试任务配对 (每个开发任务自动生成对应测试任务)
- * 3. 验收标准注入 (从用户回答中提取)
- * 4. 用户上下文注入 (将用户回答注入任务描述)
- * 5. 依赖关系分析 (自动分析任务间依赖)
+ * 始终基于整体内容拆解，不依赖 goals 提取
+ * 流程: 规划(AI输出PLAN.md) → 开发(基于PLAN.md) → 验证
  */
 export declare class TaskPlanner {
-    private userAnswers;
-    constructor(userAnswers?: UserAnswers);
-    /**
-     * 设置用户回答
-     */
-    setUserAnswers(answers: UserAnswers): void;
     /**
      * Break down a parsed task into sub-tasks
      *
-     * 增强版: 生成更细粒度的任务，包含设计、开发、测试配对
+     * 始终基于整体内容拆解: 规划→开发→验证
      */
     breakdown(parsedTask: ParsedTask, answers: Record<string, string>): TaskBreakdown[];
     /**
-     * 提取用户上下文
+     * 基于 Plan 的任务序列
+     * 规划(AI分析需求→输出PLAN.md) → 开发(基于PLAN.md实现) → 验证
      */
-    private extractUserContext;
+    private createPlanBasedTasks;
     /**
-     * 解析数组类型的回答
+     * 提取用户上下文
      */
+    private extractUserContext;
     private parseArrayAnswer;
-    /**
-     * 构建任务描述 (注入用户上下文)
-     */
-    private buildTaskDescription;
-    /**
-     * 构建测试任务描述
-     */
-    private buildTestDescription;
-    /**
-     * 构建 E2E 测试任务描述
-     */
-    private buildE2ETestDescription;
-    /**
-     * 获取 E2E 测试类型配置
-     */
-    private getE2ETypeConfig;
-    /**
-     * 生成用户流程测试用例
-     */
-    private generateUserFlows;
-    /**
-     * 解析覆盖率数值
-     */
-    private parseCoverage;
-    /**
-     * 生成验收标准
-     */
-    private generateAcceptanceCriteria;
     private generateTaskId;
-    private determinePriority;
-    private estimateComplexity;
 }

package/dist/orchestrator/task-planner.js

@@ -4,441 +4,166 @@ exports.TaskPlanner = void 0;
 /**
  * TaskPlanner - 任务拆解器
  *
- * 增强版特性:
- * 1. 更细粒度的任务拆分 (每个目标拆分为设计+实现+测试)
- * 2. 测试任务配对 (每个开发任务自动生成对应测试任务)
- * 3. 验收标准注入 (从用户回答中提取)
- * 4. 用户上下文注入 (将用户回答注入任务描述)
- * 5. 依赖关系分析 (自动分析任务间依赖)
+ * 始终基于整体内容拆解，不依赖 goals 提取
+ * 流程: 规划(AI输出PLAN.md) → 开发(基于PLAN.md) → 验证
  */
 class TaskPlanner {
-    userAnswers;
-    constructor(userAnswers) {
-        this.userAnswers = userAnswers || {};
-    }
-    /**
-     * 设置用户回答
-     */
-    setUserAnswers(answers) {
-        this.userAnswers = answers;
-    }
     /**
      * Break down a parsed task into sub-tasks
      *
-     * 增强版: 生成更细粒度的任务，包含设计、开发、测试配对
+     * 始终基于整体内容拆解: 规划→开发→验证
      */
     breakdown(parsedTask, answers) {
-        const breakdowns = [];
-        const seenTitles = new Set();
         const userContext = this.extractUserContext(answers);
-        // 0. 设计阶段任务
-        if (parsedTask.goals.length > 1) {
-            breakdowns.push({
-                taskId: this.generateTaskId(),
-                title: '架构设计和任务规划',
-                description: `分析需求，设计整体架构，规划实现方案
-
-## 用户需求
-${userContext.objective || '未指定'}
-
-## 技术栈
-${userContext.techStack?.join(', ') || '未指定'}
-
-## 输出
-- 架构设计文档
-- 接口定义
-- 任务依赖图`,
+        return this.createPlanBasedTasks(parsedTask, userContext, answers);
+    }
+    /**
+     * 基于 Plan 的任务序列
+     * 规划(AI分析需求→输出PLAN.md) → 开发(基于PLAN.md实现) → 验证
+     */
+    createPlanBasedTasks(parsedTask, userContext, answers) {
+        const planTaskId = this.generateTaskId();
+        const devTaskId = this.generateTaskId();
+        const testTaskId = this.generateTaskId();
+        // 组装完整上下文
+        const contextParts = [];
+        contextParts.push(`## 原始需求\n${parsedTask.rawContent || parsedTask.description || parsedTask.title}`);
+        if (parsedTask.goals.length)
+            contextParts.push(`## 明确目标\n${parsedTask.goals.map(g => `- ${g}`).join('\n')}`);
+        if (userContext.objective)
+            contextParts.push(`## 核心目标\n${userContext.objective}`);
+        if (userContext.techStack?.length)
+            contextParts.push(`## 技术栈\n${userContext.techStack.join(', ')}`);
+        if (parsedTask.constraints.length)
+            contextParts.push(`## 约束\n${parsedTask.constraints.map(c => `- ${c}`).join('\n')}`);
+        // brainstorm 答案
+        const brainstormKeys = ['brainstormAnswers', 'insights', 'designNotes'];
+        for (const key of brainstormKeys) {
+            if (answers[key])
+                contextParts.push(`## ${key}\n${answers[key]}`);
+        }
+        const fullContext = contextParts.join('\n\n');
+        return [
+            // 1. 规划任务
+            {
+                taskId: planTaskId,
+                title: `${parsedTask.title} - 需求分析与规划`,
+                description: `分析需求并制定实现计划。
+
+${fullContext}
+
+## 你的任务
+1. 深入理解需求
+2. 设计实现方案
+3. 将需求拆解为具体步骤
+
+## 输出: PLAN.md
+在项目根目录创建 PLAN.md，格式如下:
+
+# 实现计划
+
+## 架构设计
+(整体方案描述)
+
+## 实现步骤
+### 步骤 1: (标题)
+- 描述: (具体做什么)
+- 文件: (涉及哪些文件)
+- 验收: (怎么判断完成)
+
+### 步骤 2: (标题)
+- 描述: ...
+- 文件: ...
+- 验收: ...
+
+## 注意事项
+- (风险、约束等)`,
                 priority: 'P0',
                 dependencies: [],
                 estimatedComplexity: 'high',
                 assignedAgent: 'planner',
                 phase: 'design',
                 acceptanceCriteria: [
-                    '架构设计文档完整',
-                    '所有模块接口已定义',
-                    '依赖关系明确',
-                    '技术方案可行'
+                    'PLAN.md 已创建',
+                    '实现步骤清晰可执行',
+                    '每步有明确的文件和验收标准'
                 ]
-            });
-        }
-        // 1. 为每个目标创建细粒度任务
-        const devTaskIds = [];
-        for (let i = 0; i < parsedTask.goals.length; i++) {
-            const goal = parsedTask.goals[i];
-            // 跳过重复项
-            if (seenTitles.has(goal)) {
-                continue;
-            }
-            seenTitles.add(goal);
-            // 创建开发任务
-            const devTaskId = this.generateTaskId();
-            devTaskIds.push(devTaskId);
-            const acceptanceCriteria = this.generateAcceptanceCriteria(goal, userContext);
-            breakdowns.push({
+            },
+            // 2. 开发任务
+            {
                 taskId: devTaskId,
-                title: `实现: ${goal}`,
-                description: this.buildTaskDescription(goal, userContext, answers),
-                priority: this.determinePriority(i),
-                dependencies: i === 0 && parsedTask.goals.length > 1
-                    ? [breakdowns[0].taskId] // 依赖设计任务
-                    : (i > 0 ? [devTaskIds[i - 1]] : []), // 依赖前一个开发任务
-                estimatedComplexity: this.estimateComplexity(goal),
-                assignedAgent: 'coder',
-                phase: 'develop',
-                acceptanceCriteria,
-                testTaskId: undefined // 稍后关联
-            });
-            // 为每个开发任务创建配对的测试任务
-            const testTaskId = this.generateTaskId();
-            breakdowns.push({
-                taskId: testTaskId,
-                title: `测试: ${goal}`,
-                description: this.buildTestDescription(goal, devTaskId, userContext),
-                priority: this.determinePriority(i),
-                dependencies: [devTaskId], // 测试依赖开发任务
-                estimatedComplexity: 'medium',
-                assignedAgent: 'tester',
-                phase: 'verify',
-                acceptanceCriteria: [
-                    `单元测试覆盖率 >= ${userContext.testCoverage || '60%'}`,
-                    '边界情况已测试',
-                    '异常处理已验证',
-                    '所有测试通过'
-                ]
-            });
-            // 关联测试任务 ID
-            breakdowns[breakdowns.length - 2].testTaskId = testTaskId;
-        }
-        // 2. 代码审查任务 (仅在有开发任务时创建)
-        if (devTaskIds.length > 0) {
-            breakdowns.push({
-                taskId: this.generateTaskId(),
-                title: '代码审查',
-                description: `对所有开发任务进行代码审查
+                title: `${parsedTask.title} - 开发实现`,
+                description: `根据 PLAN.md 实现功能。
+
+${fullContext}
 
-## 审查范围
-${devTaskIds.map(id => `- ${id}`).join('\n')}
+## 执行方式
+1. 先读取项目根目录的 PLAN.md
+2. 按照步骤逐一实现
+3. 每完成一个步骤，验证对应的验收标准
 
-## 审查要点
-- 代码质量
-- 安全性
-- 性能
-- 最佳实践`,
+## 输出
+- 完整的功能代码
+- 必要的配置文件`,
                 priority: 'P1',
-                dependencies: devTaskIds,
-                estimatedComplexity: 'medium',
-                assignedAgent: 'reviewer',
-                phase: 'verify',
+                dependencies: [planTaskId],
+                estimatedComplexity: 'high',
+                assignedAgent: 'coder',
+                phase: 'develop',
                 acceptanceCriteria: [
-                    '无严重代码问题',
-                    '无安全隐患',
-                    '代码符合规范',
-                    '审查报告已生成'
+                    'PLAN.md 中所有步骤已实现',
+                    '代码可编译运行',
+                    '无严重 bug'
                 ]
-            });
-        }
-        // 3. 集成测试任务 (如果有多个交付物)
-        if (parsedTask.deliverables.length > 1) {
-            breakdowns.push({
-                taskId: this.generateTaskId(),
-                title: '集成测试',
-                description: `验证所有交付物正确集成
+            },
+            // 3. 验证任务
+            {
+                taskId: testTaskId,
+                title: `${parsedTask.title} - 验证`,
+                description: `验证实现是否满足需求。
 
-## 交付物
-${parsedTask.deliverables.map(d => `- ${d}`).join('\n')}
+## 原始需求
+${parsedTask.rawContent || parsedTask.title}
 
-## 测试范围
-- 模块间接口
-- 端到端流程
-- 数据流验证`,
+## 验证方式
+1. 读取 PLAN.md 中的验收标准
+2. 逐一验证每个步骤
+3. 运行测试（如有）
+4. 检查代码质量`,
                 priority: 'P1',
-                dependencies: devTaskIds,
+                dependencies: [devTaskId],
                 estimatedComplexity: 'medium',
                 assignedAgent: 'tester',
                 phase: 'verify',
                 acceptanceCriteria: [
-                    '所有模块正确集成',
-                    '端到端流程通过',
-                    '接口兼容性验证',
-                    '集成测试报告完整'
-                ]
-            });
-        }
-        // 4. E2E 测试任务 (如果启用，作为 verify 阶段的一部分)
-        if (userContext.e2eTests) {
-            const e2eTaskId = this.generateTaskId();
-            const e2eType = userContext.e2eType || 'web';
-            // E2E 测试依赖所有开发任务和单元测试任务
-            const allTestDependencies = [...devTaskIds];
-            breakdowns.forEach(b => {
-                if (b.phase === 'verify' && b.title.startsWith('测试:')) {
-                    allTestDependencies.push(b.taskId);
-                }
-            });
-            breakdowns.push({
-                taskId: e2eTaskId,
-                title: '端到端(E2E)测试',
-                description: this.buildE2ETestDescription(e2eType, parsedTask, userContext),
-                priority: 'P0', // E2E 测试是关键任务
-                dependencies: allTestDependencies, // 依赖所有开发任务和单元测试
-                estimatedComplexity: 'high',
-                assignedAgent: 'tester',
-                phase: 'verify',
-                acceptanceCriteria: [
-                    '所有 E2E 测试用例通过',
-                    '关键用户流程验证完成',
-                    '跨浏览器/设备兼容性验证',
-                    'E2E 测试报告已生成',
-                    '无阻塞级别的缺陷'
-                ]
-            });
-        }
-        // 5. 文档任务 (如果需要)
-        if (userContext.documentationLevel && userContext.documentationLevel !== '无需文档') {
-            breakdowns.push({
-                taskId: this.generateTaskId(),
-                title: '文档编写',
-                description: `编写项目文档
-
-## 文档级别
-${userContext.documentationLevel}
-
-## 文档内容
-- README 更新
-- API 文档
-- 使用说明`,
-                priority: 'P2',
-                dependencies: devTaskIds,
-                estimatedComplexity: 'low',
-                assignedAgent: 'executor',
-                phase: 'accept',
-                acceptanceCriteria: [
-                    'README 已更新',
-                    'API 文档完整',
-                    '使用说明清晰'
+                    '所有功能正常运行',
+                    'PLAN.md 中验收标准全部通过',
+                    '无严重代码问题'
                 ]
-            });
-        }
-        return breakdowns;
+            }
+        ];
     }
     /**
      * 提取用户上下文
      */
     extractUserContext(answers) {
-        const e2eAnswer = answers['E2E测试'] || answers['e2eTests'] || answers['e2e'];
-        const e2eTypeAnswer = answers['E2E类型'] || answers['e2eType'];
         return {
             objective: answers['目标'] || answers['objective'],
             techStack: this.parseArrayAnswer(answers['技术栈'] || answers['techStack']),
             testCoverage: answers['测试'] || answers['testCoverage'],
             documentationLevel: answers['文档'] || answers['documentationLevel'],
-            e2eTests: e2eAnswer === 'true' || e2eAnswer === '✅ 启用 E2E 测试' || e2eAnswer === '是',
-            e2eType: e2eTypeAnswer || 'web',
             additionalContext: answers
         };
     }
-    /**
-     * 解析数组类型的回答
-     */
     parseArrayAnswer(answer) {
         if (!answer)
             return [];
-        // 处理逗号分隔或换行分隔的答案
         return answer.split(/[,，\n]/).map(s => s.trim()).filter(Boolean);
     }
-    /**
-     * 构建任务描述 (注入用户上下文)
-     */
-    buildTaskDescription(goal, userContext, answers) {
-        const parts = [];
-        parts.push(`## 任务目标\n${goal}\n`);
-        if (userContext.objective) {
-            parts.push(`## 整体目标\n${userContext.objective}\n`);
-        }
-        if (userContext.techStack && userContext.techStack.length > 0) {
-            parts.push(`## 技术栈要求\n${userContext.techStack.map(t => `- ${t}`).join('\n')}\n`);
-        }
-        // 注入所有用户回答
-        const relevantAnswers = Object.entries(answers).filter(([key]) => !['目标', '技术栈', '测试', '文档', 'objective', 'techStack', 'testCoverage', 'documentationLevel'].includes(key));
-        if (relevantAnswers.length > 0) {
-            parts.push(`## 其他要求\n${relevantAnswers.map(([k, v]) => `- ${k}: ${v}`).join('\n')}\n`);
-        }
-        parts.push(`## 输出要求
-- 完成功能实现
-- 代码可编译
-- 遵循项目规范
-- 添加必要注释`);
-        return parts.join('\n');
-    }
-    /**
-     * 构建测试任务描述
-     */
-    buildTestDescription(goal, devTaskId, userContext) {
-        const coverage = this.parseCoverage(userContext.testCoverage || '60%');
-        return `## 测试目标
-为 "${goal}" 编写测试用例
-
-## 关联开发任务
-${devTaskId}
-
-## 测试要求
-- 单元测试覆盖率 >= ${coverage}%
-- 测试正常流程
-- 测试边界情况
-- 测试异常处理
-
-## 测试文件
-- 创建 \`.test.ts\` 或 \`.spec.ts\` 文件
-- 放置在与源文件相同目录或 \`tests/\` 目录
-
-## 输出
-- 测试文件
-- 测试报告
-- 覆盖率报告`;
-    }
-    /**
-     * 构建 E2E 测试任务描述
-     */
-    buildE2ETestDescription(e2eType, parsedTask, userContext) {
-        const typeConfig = this.getE2ETypeConfig(e2eType);
-        return `## E2E 测试目标
-执行完整的端到端测试，验证关键用户流程
-
-## 应用类型
-${typeConfig.description}
-
-## 测试框架
-${typeConfig.frameworks.map(f => `- ${f}`).join('\n')}
-
-## 测试范围
-${parsedTask.goals.map((g, i) => `${i + 1}. ${g}`).join('\n')}
-
-## 关键用户流程
-根据应用功能，测试以下流程:
-${this.generateUserFlows(parsedTask, e2eType)}
-
-## 测试环境
-${typeConfig.environments.map(e => `- ${e}`).join('\n')}
-
-## 测试要求
-1. **关键路径覆盖**: 所有核心用户流程必须有 E2E 测试
-2. **断言完整**: 每个测试步骤必须有明确的断言
-3. **等待策略**: 使用合理的等待机制，避免硬编码延迟
-4. **数据隔离**: 测试数据独立，不影响其他测试
-5. **清理机制**: 测试后清理创建的数据
-
-## 输出要求
-- E2E 测试文件 (tests/e2e/*.spec.ts)
-- 测试执行报告
-- 截图/录像 (失败时)
-- 测试覆盖率报告 (如有)
-
-## 运行命令
-\`\`\`bash
-${typeConfig.runCommand}
-\`\`\`
-
-## 验收标准
-- [ ] 所有 E2E 测试用例通过
-- [ ] 关键用户流程验证完成
-- [ ] 跨浏览器/设备兼容性验证
-- [ ] E2E 测试报告已生成
-- [ ] 无阻塞级别的缺陷`;
-    }
-    /**
-     * 获取 E2E 测试类型配置
-     */
-    getE2ETypeConfig(type) {
-        const configs = {
-            web: {
-                description: 'Web 应用 (浏览器)',
-                frameworks: ['Playwright (推荐)', 'Cypress', 'Selenium WebDriver', 'Puppeteer'],
-                environments: ['Chrome', 'Firefox', 'Safari', 'Edge', 'Mobile Viewports'],
-                runCommand: 'npx playwright test --reporter=html'
-            },
-            mobile: {
-                description: '移动应用 (iOS/Android)',
-                frameworks: ['Appium', 'Detox (React Native)', 'XCUITest (iOS)', 'Espresso (Android)'],
-                environments: ['iOS Simulator', 'Android Emulator', 'Real Devices'],
-                runCommand: 'npx appium --base-path /wd/hub && npm run test:e2e'
-            },
-            gui: {
-                description: 'GUI 桌面应用 (Electron/Native)',
-                frameworks: ['Playwright for Electron', 'Spectron (Electron)', 'Robot Framework', 'PyAutoGUI'],
-                environments: ['Windows', 'macOS', 'Linux'],
-                runCommand: 'npm run test:e2e'
-            }
-        };
-        return configs[type];
-    }
-    /**
-     * 生成用户流程测试用例
-     */
-    generateUserFlows(parsedTask, type) {
-        const flows = [];
-        const goals = parsedTask.goals;
-        // 根据目标生成用户流程
-        goals.forEach((goal, i) => {
-            flows.push(`\n### 流程 ${i + 1}: ${goal}`);
-            flows.push('```gherkin');
-            flows.push(`Feature: ${goal}`);
-            flows.push('');
-            flows.push('  Scenario: 正常流程');
-            flows.push(`    Given 用户已启动应用`);
-            flows.push(`    When 用户执行 "${goal}" 操作`);
-            flows.push(`    Then 操作成功完成`);
-            flows.push('```');
-        });
-        return flows.join('\n');
-    }
-    /**
-     * 解析覆盖率数值
-     */
-    parseCoverage(coverageStr) {
-        const match = coverageStr.match(/(\d+)/);
-        return match ? parseInt(match[1], 10) : 60;
-    }
-    /**
-     * 生成验收标准
-     */
-    generateAcceptanceCriteria(goal, userContext) {
-        const criteria = [
-            `功能 "${goal}" 已实现`,
-            '代码可编译，无错误',
-            '代码符合项目规范',
-            '必要的注释已添加'
-        ];
-        if (userContext.testCoverage) {
-            criteria.push(`测试覆盖率 >= ${userContext.testCoverage}`);
-        }
-        if (userContext.techStack?.length) {
-            criteria.push(`使用指定技术栈: ${userContext.techStack.join(', ')}`);
-        }
-        criteria.push('无安全隐患');
-        criteria.push('边界情况已处理');
-        return criteria;
-    }
     generateTaskId() {
         const timestamp = Date.now().toString(36).toUpperCase();
         const rand = Math.random().toString(36).slice(2, 4).toUpperCase();
         return `TASK-${timestamp}${rand}`;
     }
-    determinePriority(goalIndex) {
-        // First goal is highest priority
-        if (goalIndex === 0)
-            return 'P1';
-        return 'P2';
-    }
-    estimateComplexity(goal) {
-        if (goal.includes('测试'))
-            return 'medium';
-        if (goal.includes('实现') || goal.includes('开发'))
-            return 'medium';
-        if (goal.includes('设计') || goal.includes('研究'))
-            return 'high';
-        if (goal.includes('文档') || goal.includes('说明'))
-            return 'low';
-        return 'medium';
-    }
 }
 exports.TaskPlanner = TaskPlanner;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,6 +43,7 @@
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
     "commander": "^14.0.3",
+    "openmatrix": "^0.1.42",
     "typescript": "^5.3.3",
     "winston": "^3.19.0"
   },