openmatrix 0.2.16 → 0.2.17

package/dist/orchestrator/phase-executor.d.ts

@@ -93,6 +93,7 @@ export declare class PhaseExecutor {
      * 设置自动模式
      */
     setAutoMode(auto: boolean): void;
+    disableGitCommit(): void;
     /**
      * 获取自动模式状态
      */

package/dist/orchestrator/phase-executor.js

@@ -55,6 +55,9 @@ class PhaseExecutor {
     setAutoMode(auto) {
         this.isAutoMode = auto;
     }
+    disableGitCommit() {
+        this.gitCommitManager.setEnabled(false);
+    }
     /**
      * 获取自动模式状态
      */

package/dist/orchestrator/smart-question-analyzer.js

@@ -58,9 +58,14 @@ class SmartQuestionAnalyzer {
     async analyze(taskDescription, parsedTask) {
         // 1. 获取项目上下文
         const projectContext = await this.getProjectContext();
-        // 2. 执行推断
-        const inferences = this.inferAnswers(taskDescription, projectContext);
-        // 3. 筛选需要提问的问题
+        // 2. 如果 parsedTask 有 goalTypes，优先使用
+        let goalTypeOverride;
+        if (parsedTask?.goalTypes && parsedTask.goalTypes.length > 0) {
+            goalTypeOverride = parsedTask.goalTypes[0];
+        }
+        // 3. 执行推断
+        const inferences = this.inferAnswers(taskDescription, projectContext, goalTypeOverride);
+        // 4. 筛选需要提问的问题
         const questionsToAsk = inferences
             .filter(i => i.confidence === 'low' || !i.inferredAnswer)
             .map(i => i.questionId);
@@ -163,7 +168,7 @@ class SmartQuestionAnalyzer {
     /**
      * 推断问题答案
      */
-    inferAnswers(taskDescription, context) {
+    inferAnswers(taskDescription, context, goalTypeOverride) {
         const inferences = [];
         const desc = taskDescription.toLowerCase();
         // 1. 推断质量级别
@@ -180,6 +185,15 @@ class SmartQuestionAnalyzer {
         inferences.push(this.inferObjective(desc, context));
         // 7. 推断测试覆盖率级别
         inferences.push(this.inferTestCoverage(desc, context));
+        // 8. 如果有 goalTypeOverride，覆盖 objective 推断
+        if (goalTypeOverride) {
+            const objectiveInference = inferences.find(i => i.questionId === 'objective');
+            if (objectiveInference) {
+                objectiveInference.inferredAnswer = goalTypeOverride;
+                objectiveInference.confidence = 'high';
+                objectiveInference.reason = '来自 AI 任务解析的目标类型标注';
+            }
+        }
         return inferences;
     }
     /**
@@ -336,6 +350,13 @@ class SmartQuestionAnalyzer {
             confidence: 'low',
             reason: ''
         };
+        // 文档/skill 文件 -> 不需要 E2E
+        if (/(skill|\.md|文档|readme|document|说明|指南)/i.test(desc)) {
+            inference.inferredAnswer = 'false';
+            inference.confidence = 'high';
+            inference.reason = '文档或 skill 文件修改不需要 E2E 测试';
+            return inference;
+        }
         // CLI/后端 -> 不需要 E2E
         if (/(cli|api|backend|后端|命令行)/i.test(desc) && !context.hasFrontend) {
             inference.inferredAnswer = 'false';
@@ -397,23 +418,30 @@ class SmartQuestionAnalyzer {
             confidence: 'low',
             reason: ''
         };
+        // 文档类任务 -> documentation
+        if (/(文档|document|readme|skill|\.md|说明|指南)/i.test(desc)) {
+            inference.inferredAnswer = 'documentation';
+            inference.confidence = 'high';
+            inference.reason = '任务涉及文档或 skill 文件';
+            return inference;
+        }
         if (/(fix|bug|修复|hotfix|patch)/i.test(desc)) {
-            inference.inferredAnswer = 'bug_fix';
+            inference.inferredAnswer = 'development';
             inference.confidence = 'medium';
-            inference.reason = '任务描述包含修复关键词';
+            inference.reason = '任务描述包含修复关键词（bug 修复属于开发）';
         }
         else if (/(implement|add|新功能|实现|开发|feature|新增)/i.test(desc)) {
-            inference.inferredAnswer = 'new_feature';
+            inference.inferredAnswer = 'development';
             inference.confidence = 'medium';
             inference.reason = '任务描述包含新功能关键词';
         }
         else if (/(refactor|优化|重构|improve|性能)/i.test(desc)) {
-            inference.inferredAnswer = 'refactor';
+            inference.inferredAnswer = 'development';
             inference.confidence = 'medium';
-            inference.reason = '任务描述包含重构关键词';
+            inference.reason = '任务描述包含重构关键词（重构属于开发）';
         }
         else if (/(test|测试|coverage|覆盖)/i.test(desc)) {
-            inference.inferredAnswer = 'test';
+            inference.inferredAnswer = 'testing';
             inference.confidence = 'medium';
             inference.reason = '任务描述包含测试关键词';
         }

package/dist/orchestrator/task-planner.js

@@ -390,6 +390,8 @@ class TaskPlanner {
         }
         const coverageTarget = this.getCoverageTarget(qualityConfig, userContext);
         const globalContext = this.buildGlobalContext(parsedTask, userContext, plan);
+        // 提取 planMetadata 用于测试任务描述注入
+        const planMetadata = this.extractPlanMetadata(plan);
         // 1. 为每个模块创建开发 + 测试任务对
         const devTaskIds = [];
         const moduleIdToTaskIds = new Map();
@@ -434,7 +436,7 @@ class TaskPlanner {
             breakdowns.push({
                 taskId: testTaskId,
                 title: `测试: ${mod.name}`,
-                description: `## 测试目标\n为 "${mod.name}" 模块编写测试用例\n\n${globalContext}\n\n## 关联开发任务\n${modTaskId}\n\n## 测试要求\n- 单元测试覆盖率 >= ${coverageTarget}%\n- 测试正常流程\n- 测试边界情况\n- 测试异常处理\n\n## 输出\n- 测试文件\n- 测试报告\n- 覆盖率报告`,
+                description: this.buildTestDescription(mod.name, modTaskId, coverageTarget, globalContext, planMetadata),
                 priority: this.determineModulePriority(mod, parsedPlan.modules.indexOf(mod)),
                 dependencies: [modTaskId],
                 estimatedComplexity: 'medium',
@@ -757,7 +759,7 @@ ${globalContext}
                 breakdowns.push({
                     taskId: testTaskId,
                     title: `测试: ${goal}`,
-                    description: this.buildTestDescription(goal, devTaskId, coverageTarget, globalContext),
+                    description: this.buildTestDescription(goal, devTaskId, coverageTarget, globalContext, planMetadata),
                     priority: this.determinePriority(i),
                     dependencies: [devTaskId],
                     estimatedComplexity: 'medium',
@@ -1104,16 +1106,25 @@ ${userContext.documentationLevel}
 - 添加必要注释`;
         return desc;
     }
-    buildTestDescription(goal, devTaskId, coverageTarget, globalContext) {
-        return `## 测试目标
+    buildTestDescription(goal, devTaskId, coverageTarget, globalContext, planMetadata) {
+        let desc = `## 测试目标
 为 "${goal}" 编写测试用例
 
 ${globalContext}
 
 ## 关联开发任务
-${devTaskId}
-
-## 测试要求
+${devTaskId}`;
+        // 注入 plan 提取的关键信息（参考 buildTaskDescription）
+        if (planMetadata && planMetadata.interfaces.length > 0) {
+            desc += `\n\n## 相关接口/API\n${planMetadata.interfaces.slice(0, 10).map(i => `- ${i}`).join('\n')}`;
+        }
+        if (planMetadata && planMetadata.dataModels.length > 0) {
+            desc += `\n\n## 相关数据模型\n${planMetadata.dataModels.slice(0, 10).map(d => `- ${d}`).join('\n')}`;
+        }
+        if (planMetadata && planMetadata.keyDecisions.length > 0) {
+            desc += `\n\n## 关键决策参考\n${planMetadata.keyDecisions.slice(0, 5).map(d => `- ${d}`).join('\n')}`;
+        }
+        desc += `\n\n## 测试要求
 - 单元测试覆盖率 >= ${coverageTarget}%
 - 测试正常流程
 - 测试边界情况
@@ -1127,6 +1138,7 @@ ${devTaskId}
 - 测试文件
 - 测试报告
 - 覆盖率报告`;
+        return desc;
     }
     buildE2ETestDescription(e2eType, parsedTask, userContext) {
         const typeConfig = this.getE2ETypeConfig(e2eType);

package/dist/types/index.d.ts

@@ -376,3 +376,131 @@ export interface AmbiguityReport {
     /** 建议的问题列表 (用于 AskUserQuestion) */
     suggestedQuestions?: string[];
 }
+/**
+ * 构建工具类型
+ */
+export type BuildToolType = 'npm' | 'yarn' | 'pnpm' | 'make' | 'docker' | 'gradle' | 'maven' | 'cargo' | 'go' | 'pip' | 'poetry' | 'nuget' | 'msbuild' | 'webpack' | 'vite' | 'esbuild' | 'rollup' | 'turbo' | 'bazel' | 'unknown';
+/**
+ * 构建工具信息
+ */
+export interface BuildTool {
+    /** 工具类型 */
+    type: BuildToolType;
+    /** 可用命令列表 */
+    commands: string[];
+    /** 配置文件路径 */
+    configFile?: string;
+    /** 是否为默认构建工具 */
+    isDefault?: boolean;
+    /** 工具版本 */
+    version?: string;
+}
+/**
+ * 部署方式
+ */
+export type DeployMethod = 'docker' | 'docker-compose' | 'kubernetes' | 'helm' | 'npm' | 'make' | 'script' | 'github-pages' | 'vercel' | 'netlify' | 'aws' | 'gcp' | 'azure' | 'heroku' | 'unknown';
+/**
+ * 部署选项
+ */
+export interface DeployOption {
+    /** 部署方式 */
+    method: DeployMethod;
+    /** 部署命令 */
+    command?: string;
+    /** 配置文件路径 */
+    configFile?: string;
+    /** 部署环境 */
+    environment?: 'development' | 'staging' | 'production';
+    /** 是否推荐 */
+    recommended?: boolean;
+    /** 描述信息 */
+    description?: string;
+}
+/**
+ * CI 平台类型
+ */
+export type CIPlatform = 'github-actions' | 'gitlab-ci' | 'jenkins' | 'circleci' | 'travis-ci' | 'azure-pipelines' | 'bitbucket-pipelines' | 'drone' | 'teamcity' | 'unknown';
+/**
+ * CI 配置信息
+ */
+export interface CIConfig {
+    /** CI 平台 */
+    platform: CIPlatform;
+    /** 配置文件列表 */
+    configFiles: string[];
+    /** 可用的 workflow 名称 */
+    workflows?: string[];
+    /** 触发条件 */
+    triggers?: string[];
+}
+/**
+ * 开发命令信息
+ */
+export interface DevCommands {
+    /** 安装/设置命令 */
+    setup: string[];
+    /** 构建命令 */
+    build: string[];
+    /** 测试命令 */
+    test: string[];
+    /** 开发/调试命令 */
+    dev: string[];
+    /** 启动命令 */
+    start: string[];
+    /** 清理命令 */
+    clean?: string[];
+    /** Lint 命令 */
+    lint?: string[];
+    /** 格式化命令 */
+    format?: string[];
+}
+/**
+ * 项目环境检测结果
+ */
+export interface EnvironmentInfo {
+    /** 项目名称 */
+    projectName: string;
+    /** 项目类型 */
+    projectType: ProjectType;
+    /** 项目根目录 */
+    projectRoot: string;
+    /** 检测时间 */
+    timestamp: string;
+    /** 构建工具列表 */
+    buildTools: BuildTool[];
+    /** CI 配置 */
+    ciConfig?: CIConfig;
+    /** 部署选项 */
+    deployOptions: DeployOption[];
+    /** 开发命令 */
+    devCommands: DevCommands;
+    /** 检测摘要 */
+    summary: {
+        /** 是否有构建工具 */
+        hasBuildTool: boolean;
+        /** 是否有 CI 配置 */
+        hasCIConfig: boolean;
+        /** 是否有部署选项 */
+        hasDeployOption: boolean;
+        /** 构建工具数量 */
+        buildToolCount: number;
+        /** 部署选项数量 */
+        deployOptionCount: number;
+    };
+}
+/**
+ * 项目类型 (复用 UpgradeDetector 中的定义)
+ * 注意：如果 UpgradeDetector 的 ProjectType 发生变化，这里需要同步
+ */
+export type ProjectType = 'openmatrix' | 'ai-project' | 'nodejs' | 'typescript' | 'python' | 'go' | 'rust' | 'java' | 'csharp' | 'cpp' | 'php' | 'dart' | 'ruby' | 'swift' | 'kotlin' | 'scala' | 'flutter' | 'react' | 'vue' | 'angular' | 'nextjs' | 'nuxt' | 'svelte' | 'unknown';
+/**
+ * 环境检测器配置
+ */
+export interface EnvironmentDetectorConfig {
+    /** 扫描目录 */
+    scanDirs: string[];
+    /** 排除目录 */
+    excludeDirs: string[];
+    /** 最大建议数量 */
+    maxDeployOptions?: number;
+}

package/package.json

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

package/skills/debug.md

@@ -352,50 +352,130 @@ ${suggestedFix}
 2. 提交修复（如果文件有变更）
 3. 进入 Step 9 验证
 
-## Step 9: 验证修复
+## Step 9: 自动验证修复（循环机制）
 
-**根据问题类型选择验证方式：**
+**⛔ 自动验证流程 - 无需用户手动确认**
 
-| 问题类型 | 验证方式 |
+验证自动判断结果，失败时自动循环回修复步骤，直到通过或达到最大重试次数。
+
+### 9.1 执行验证命令（自动判断结果）
+
+根据问题类型执行验证：
+
+| 问题类型 | 验证命令 |
 |---------|---------|
-| task_failure | 重新运行失败任务或相关测试 |
-| project_bug | 运行相关测试或构建 |
+| task_failure | `npm test -- --run 2>&1` |
+| project_bug | `npm run build 2>&1` |
 | system_bug | 验证 CLI 功能 |
-| environment | 检查依赖安装状态 |
+| environment | `npm ls --depth=0 2>&1` |
+
+**自动判断验证结果：**
 
-**任务失败：**
 ```bash
-# 运行相关测试
-npm test -- --run 2>&1 | tail -20
+# 执行验证并捕获退出码
+VERIFY_RESULT=0
+npm test -- --run > /tmp/verify-output.txt 2>&1 || VERIFY_RESULT=1
+
+if [ $VERIFY_RESULT -eq 0 ]; then
+  echo "✅ 验证自动判定: 通过"
+else
+  echo "❌ 验证自动判定: 未通过"
+  cat /tmp/verify-output.txt | tail -30  # 展示失败详情
+fi
 ```
 
-**项目 bug：**
-```bash
-npm run build 2>&1 | tail -10
+### 9.2 验证失败自动循环（无需用户确认）
+
+**验证失败时自动处理：**
+
+```
+验证失败 → 重试计数 +1 → 检查重试次数 → 
+  ├─ < 3 次 → 自动回到 Step 8 重新修复（带新信息）
+  └─ >= 3 次 → 暂停，质疑架构，进入 Step 10
 ```
 
-**环境：**
-```bash
-npm ls --depth=0 2>&1 | tail -20
+**重试计数器更新：**
+- Skill 内部维护 `retryCount` 变量
+- 每次验证失败 +1
+- 验证通过后重置为 0
+
+### 9.3 自动循环回修复步骤
+
+**< 3 次验证失败 → 自动调用 Agent 重新修复：**
+
+```typescript
+// 自动重新修复，无需用户确认
+Agent({
+  subagent_type: "general-purpose",
+  description: `重新修复 (第 ${retryCount + 1} 次)`,
+  prompt: `根据验证失败结果重新分析并修复。
+
+## 铁律
+1. 只实施单一修复（不要做额外改动）
+2. 每次只改一个变量
+3. 不在诊断不清的情况下盲目尝试
+
+## 上次修复结果
+${previousFixSummary}
+
+## 验证失败详情
+${verifyFailureOutput}
+
+## 新分析
+- 上次修复为什么没生效？
+- 是否遗漏了某个根因？
+- 是否有其他影响因素？
+
+## 任务
+1. 重新分析验证失败原因
+2. 实施新的修复方案
+3. 确保修改范围最小化
+
+## 禁止行为
+❌ 重复上次失败的修复
+❌ 同时修复多个问题
+❌ 进行额外的重构`,
+  run_in_background: false
+})
 ```
 
-**验证结果判断：**
-- 测试全通过 / 构建成功 → 验证通过
-- 仍有失败 / 构建失败 → 验证未通过
+### 9.4 达到最大重试次数（>= 3 次）
 
-AskUserQuestion: `header: "验证结果"`, `multiSelect: false`
-**question:** 修复验证通过了吗？
+**输出警告并暂停：**
+
+```
+⚠️ 已尝试 3 次以上修复，验证仍未通过
+
+这可能指示架构问题：
+- 每次修复在其他地方产生新症状
+- 修复需要"大规模重构"
+- 根因分析不够深入
+
+建议：暂停并质疑根本问题，与用户讨论是否需要架构重构。
+```
+
+**此时进入 Step 10，输出 Debug Report 并询问用户下一步。**
+
+AskUserQuestion: `header: "架构问题"`, `multiSelect: false`
+**question:** 已尝试 3 次修复仍未通过，可能存在架构问题。下一步？
 
 | label | description |
 |-------|-------------|
-| 通过 | 修复成功，记录报告 |
-| 未通过 | 修复未生效，重新分析 |
-| 部分通过 | 部分修复，继续诊断 |
+| 深入重新诊断 | 从 Step 3 重新开始完整诊断 |
+| 架构重构讨论 | 讨论是否需要架构层面的改动 |
+| 接受当前状态 | 记录修复尝试，结束调试 |
+
+### 9.5 验证通过
 
-**如果验证未通过：**
-- 重试计数 +1
-- **< 3 次** → 回到 Step 3（带着新信息重新分析）
-- **>= 3 次** → 输出"已尝试 3 次以上修复，建议暂停并质疑架构"，进入 Step 10
+**验证通过 → 自动进入 Step 10**
+
+```
+✅ 验证通过
+
+修复成功，自动进入报告阶段。
+```
+
+无需用户确认，直接继续。
 
 ## Step 10: 写入 Debug Report
 
@@ -490,23 +570,72 @@ Step 7: AskUserQuestion 选择修复策略
     ↓
 Step 8: 实施修复
     ↓
-Step 9: 验证修复结果
-    ├─ 未通过 (< 3次) → 回到 Step 3
-    ├─ 未通过 (>= 3次) → Step 10
-    └─ 通过 ↓
+Step 9: ⛔ 自动验证修复（无需用户确认）
+    ├─ 执行验证命令 → 自动判断结果
+    ├─ 验证通过 → 自动进入 Step 10 ✅
+    └─ 验证失败 → 自动循环处理
+        ├─ < 3 次 → 自动回到 Step 8 重新修复
+        └─ >= 3 次 → 暂停，质疑架构，Step 10 ⚠️
 Step 10: 写入 Debug Report
 ```
 
+## 自动验证循环流程（Step 9 详细）
+
+```
+┌─────────────────────────────────────────┐
+│         Step 8: 实施修复                 │
+└─────────────────────┬───────────────────┘
+                      ↓
+┌─────────────────────────────────────────┐
+│     Step 9: 执行验证命令                 │
+│   (npm test / npm build / etc.)        │
+└─────────────────────┬───────────────────┘
+                      ↓
+              ┌───────┴───────┐
+              │ 自动判断结果   │
+              └───────┬───────┘
+        ┌─────────────┴─────────────┐
+        │                           │
+    退出码=0                    退出码≠0
+    (验证通过)                  (验证失败)
+        │                           │
+        ↓                           ↓
+┌───────────────┐          ┌───────────────────┐
+│ ✅ 进入 Step 10│          │ retryCount + 1    │
+└───────────────┘          └───────┬───────────┘
+                                    ↓
+                           ┌────────┴────────┐
+                           │ 检查重试次数     │
+                           └───────┬─────────┘
+                     ┌─────────────┴─────────────┐
+                     │                           │
+                 < 3 次                       >= 3 次
+                     │                           │
+                     ↓                           ↓
+           ┌─────────────────┐       ┌───────────────────┐
+           │ ⚡ 自动回到 Step 8 │       │ ⚠️ 暂停，质疑架构 │
+           │ (带验证失败信息)  │       │ 进入 Step 10      │
+           └─────────────────┘       └───────────────────┘
+```
+
 ## 铁律
 
 **不做根因调查，不许提修复方案**
 
+**验证失败自动循环，无需用户手动确认**
+
+**最大重试 3 次，超过必须暂停质疑架构**
+
 ## 红线
 
 - 3 次修复失败 → 暂停，质疑架构
 - 不修改未关联的文件
 - 单一修复原则
 - 修复前必须有验证方法
+- **验证必须自动判断，不得依赖用户手动确认**
+- **验证失败自动循环，不得跳过或手动绕过**
+- **达到 3 次重试必须暂停，不得继续修复**
+- 修复前必须有验证方法
 
 ## 红旗警告 - 停止并回归流程
 
@@ -522,8 +651,11 @@ Step 10: 写入 Debug Report
 - 提出解决方案前没有追踪数据流
 - **"再试一次修复"（已经试过 2+ 次）**
 - 每次修复揭示新地方的问题
+- **"验证失败，让用户确认一下吧" → 应自动循环**
+- **"重试超过 3 次了，继续试试" → 必须暂停质疑架构**
+- **"跳过自动验证，手动确认就行" → 必须执行自动验证**
 
-**所有这些意味着：停止。回到 Step 3。**
+**所有这些意味着：停止。回到 Step 3 或执行自动验证循环。**
 
 ## 常见借口 vs 真实情况
 
@@ -537,6 +669,9 @@ Step 10: 写入 Debug Report
 | "参考文档太长，我按模式改改" | 一知半解必然有 bug。完整阅读。 |
 | "我看到问题了，直接修吧" | 看到症状 ≠ 理解根因。 |
 | "再试一次修复"（失败 2+ 次后） | 3+ 次失败 = 架构问题。质疑模式，不要继续修。 |
+| "验证失败让用户确认" | 自动验证循环无需用户干预。执行自动流程。 |
+| "重试超过 3 次继续修" | 达到最大重试必须暂停。质疑架构。 |
+| "手动确认验证结果" | 必须使用自动验证判断。退出码决定一切。 |
 
 ## 3+ 次修复失败：质疑架构