openmatrix 0.1.99 → 0.2.1

package/dist/cli/commands/report.js

@@ -135,68 +135,68 @@ exports.reportCommand = new commander_1.Command('report')
 });
 function generateMarkdownReport(state, tasks, approvals, stats, efficiency, options) {
     const duration = Math.round(efficiency.totalDuration / 1000 / 60); // 转为分钟
-    let report = `
-# 📊 OpenMatrix 执行报告
-
-**Run ID:** ${state.runId}
-**时间:** ${state.startedAt}
-**状态:** ${state.status}
-
-## 统计概览
-
-| 状态 | 数量 | 占比 |
-|------|------|------|
-| ✅ 完成 | ${stats.completed} | ${stats.total > 0 ? Math.round(stats.completed / stats.total * 100) : 0}% |
-| ❌ 失败 | ${stats.failed} | ${stats.total > 0 ? Math.round(stats.failed / stats.total * 100) : 0}% |
-| 🔄 进行中 | ${stats.inProgress} | ${stats.total > 0 ? Math.round(stats.inProgress / stats.total * 100) : 0}% |
-| 🔴 阻塞 | ${stats.blocked} | ${stats.total > 0 ? Math.round(stats.blocked / stats.total * 100) : 0}% |
-| ⏳ 待处理 | ${stats.pending} | ${stats.total > 0 ? Math.round(stats.pending / stats.total * 100) : 0}% |
-
-## 任务详情
-
-### ✅ 已完成
+    let report = `
+# 📊 OpenMatrix 执行报告
+
+**Run ID:** ${state.runId}
+**时间:** ${state.startedAt}
+**状态:** ${state.status}
+
+## 统计概览
+
+| 状态 | 数量 | 占比 |
+|------|------|------|
+| ✅ 完成 | ${stats.completed} | ${stats.total > 0 ? Math.round(stats.completed / stats.total * 100) : 0}% |
+| ❌ 失败 | ${stats.failed} | ${stats.total > 0 ? Math.round(stats.failed / stats.total * 100) : 0}% |
+| 🔄 进行中 | ${stats.inProgress} | ${stats.total > 0 ? Math.round(stats.inProgress / stats.total * 100) : 0}% |
+| 🔴 阻塞 | ${stats.blocked} | ${stats.total > 0 ? Math.round(stats.blocked / stats.total * 100) : 0}% |
+| ⏳ 待处理 | ${stats.pending} | ${stats.total > 0 ? Math.round(stats.pending / stats.total * 100) : 0}% |
+
+## 任务详情
+
+### ✅ 已完成
 ${tasks
         .filter(t => t.status === 'completed')
         .map(t => `- ${t.id}: ${t.title}`)
-        .join('\n') || '_无_'}
-
-### ❌ 失败
+        .join('\n') || '_无_'}
+
+### ❌ 失败
 ${tasks
         .filter(t => t.status === 'failed')
         .map(t => `- ${t.id}: ${t.title}\n  原因: ${t.error || '未知'}`)
-        .join('\n') || '_无_'}
-
-### 🔴 阻塞
+        .join('\n') || '_无_'}
+
+### 🔴 阻塞
 ${tasks
         .filter(t => t.status === 'blocked')
         .map(t => `- ${t.id}: ${t.title}\n  原因: ${t.error || '未知'}`)
-        .join('\n') || '_无_'}
+        .join('\n') || '_无_'}
 `;
     // 效率分析
     if (options.efficiency) {
-        report += `
-## 🏆 效率分析
-
-| 指标 | 值 |
-|------|-----|
-| 总耗时 | ${duration} 分钟 |
-| Agent 调用 | ${efficiency.agentCalls} 次 |
-| 重试次数 | ${efficiency.retryCount} 次 |
-| 并行度 | ${efficiency.parallelism} / ${efficiency.targetParallelism} |
+        report += `
+## 🏆 效率分析
+
+| 指标 | 值 |
+|------|-----|
+| 总耗时 | ${duration} 分钟 |
+| Agent 调用 | ${efficiency.agentCalls} 次 |
+| 重试次数 | ${efficiency.retryCount} 次 |
+| 并行度 | ${efficiency.parallelism} / ${efficiency.targetParallelism} |
 `;
     }
     // 审批记录
-    report += `
-## 🔔 审批记录
-
-| ID | 类型 | 决策 | 状态 |
-|----|------|------|------|
+    report += `
+## 🔔 审批记录
+
+| ID | 类型 | 决策 | 状态 |
+|----|------|------|------|
 ${approvals.length > 0
         ? approvals.map(a => `| ${a.id} | ${a.type} | ${a.decision || '-'} | ${a.status} |`).join('\n')
-        : '| _无_ | | | |'}
-
----
-*报告生成时间: ${new Date().toISOString()}*
+        : '| _无_ | | | |'}
+
+---
+*报告生成时间: ${new Date().toISOString()}*
 `;
     return report.trim();
 }

package/dist/cli/commands/start.js

@@ -59,6 +59,7 @@ exports.startCommand = new commander_1.Command('start')
     .option('--docs <level>', '文档级别 (full|basic|minimal|none)')
     .option('--tasks-json <json>', 'AI 已拆分的任务 JSON (跳过自动解析)')
     .option('--e2e-tests', '启用 E2E 测试')
+    .option('--research-context <path>', '研究上下文 JSON 路径 (来自 /om:research 的 context.json)')
     .action(async (input, options) => {
     const basePath = process.cwd();
     const omPath = path.join(basePath, '.openmatrix');
@@ -112,8 +113,91 @@ exports.startCommand = new commander_1.Command('start')
     // ============================
     // 路径 B: 自动解析 (fallback)
     // ============================
-    await handleAutoParse(input, options, stateManager, state);
+    await handleAutoParse(input, options, stateManager, state, basePath, omPath);
 });
+/**
+ * 加载研究上下文
+ */
+async function loadResearchContext(researchContextPath, basePath, omPath) {
+    let contextPath = researchContextPath;
+    if (!contextPath) {
+        // 自动检测默认路径
+        const defaultPath = path.join(omPath, 'research', 'context.json');
+        try {
+            await fs.access(defaultPath);
+            contextPath = `@${defaultPath}`;
+        }
+        catch {
+            return { context: null, report: null };
+        }
+    }
+    if (!contextPath) {
+        return { context: null, report: null };
+    }
+    try {
+        // 支持 @file 语法
+        let jsonStr = contextPath;
+        if (jsonStr.startsWith('@')) {
+            const filePath = jsonStr.slice(1);
+            const resolvedPath = path.isAbsolute(filePath) ? filePath : path.join(basePath, filePath);
+            jsonStr = await fs.readFile(resolvedPath, 'utf-8');
+        }
+        const context = JSON.parse(jsonStr);
+        // 读取研究报告
+        let report = null;
+        if (context.reportPath) {
+            const reportPath = path.isAbsolute(context.reportPath)
+                ? context.reportPath
+                : path.join(basePath, context.reportPath);
+            try {
+                report = await fs.readFile(reportPath, 'utf-8');
+            }
+            catch {
+                // 研究报告不存在不影响流程
+            }
+        }
+        return { context, report };
+    }
+    catch {
+        return { context: null, report: null };
+    }
+}
+/**
+ * 合并研究上下文到 AI 解析的输入
+ */
+function mergeResearchContext(tasksInput, researchContext, researchReport) {
+    const merged = { ...tasksInput };
+    // goals: 研究的基础 goals + AI 补充的 goals（去重）
+    const baseGoals = researchContext.goals || [];
+    const aiGoals = tasksInput.goals || [];
+    const mergedGoals = [...new Set([...baseGoals, ...aiGoals])];
+    if (mergedGoals.length > 0) {
+        merged.goals = mergedGoals;
+    }
+    // constraints: 合并
+    const baseConstraints = researchContext.constraints || [];
+    const aiConstraints = tasksInput.constraints || [];
+    const mergedConstraints = [...new Set([...baseConstraints, ...aiConstraints])];
+    if (mergedConstraints.length > 0) {
+        merged.constraints = mergedConstraints;
+    }
+    // deliverables: 合并
+    const baseDeliverables = researchContext.deliverables || [];
+    const aiDeliverables = tasksInput.deliverables || [];
+    const mergedDeliverables = [...new Set([...baseDeliverables, ...aiDeliverables])];
+    if (mergedDeliverables.length > 0) {
+        merged.deliverables = mergedDeliverables;
+    }
+    // plan: 如果 AI 未提供 plan，使用研究报告内容
+    if (!merged.plan && researchReport) {
+        merged.plan = `# 领域研究: ${researchContext.domain}\n\n## 研究主题\n${researchContext.topic}\n\n${researchReport}`;
+    }
+    else if (researchReport) {
+        // AI 已有 plan，将研究作为附录追加
+        merged.plan = `${merged.plan}\n\n---\n\n# 领域研究背景: ${researchContext.domain}\n\n## 研究主题\n${researchContext.topic}\n\n${researchReport}`;
+    }
+    return merged;
+}
 /**
  * 处理 AI 解析的任务 (--tasks-json)
  * AI 提供 ParsedTask 格式的结构化数据，仍由 TaskPlanner 做拆分
@@ -152,18 +236,27 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
         }
         return;
     }
+    // 加载并合并研究上下文
+    const { context: researchContext, report: researchReport } = await loadResearchContext(options.researchContext, basePath, omPath);
+    let resolvedInput = tasksInput;
+    if (researchContext) {
+        resolvedInput = mergeResearchContext(tasksInput, researchContext, researchReport);
+        if (!options.json) {
+            console.log(`🔬 已加载研究领域: ${researchContext.domain}`);
+        }
+    }
     // 保存 AI 生成的执行计划
-    if (tasksInput.plan) {
-        await fs.writeFile(path.join(omPath, 'plan.md'), tasksInput.plan, 'utf-8');
+    if (resolvedInput.plan) {
+        await fs.writeFile(path.join(omPath, 'plan.md'), resolvedInput.plan, 'utf-8');
     }
     // 构建 ParsedTask
     const parsedTask = {
-        title: tasksInput.title,
-        description: tasksInput.description || '',
-        goals: tasksInput.goals,
-        goalTypes: tasksInput.goalTypes,
-        constraints: tasksInput.constraints || [],
-        deliverables: tasksInput.deliverables || [],
+        title: resolvedInput.title || tasksInput.title,
+        description: resolvedInput.description || '',
+        goals: resolvedInput.goals,
+        goalTypes: resolvedInput.goalTypes,
+        constraints: resolvedInput.constraints || [],
+        deliverables: resolvedInput.deliverables || [],
         rawContent: ''
     };
     // 解析质量配置
@@ -179,9 +272,9 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
         console.log('\n🔧 拆解任务...');
     }
     // 使用 TaskPlanner 拆分（保持原有拆分逻辑）
-    const answers = tasksInput.answers || {};
+    const answers = resolvedInput.answers || {};
     const planner = new task_planner_js_1.TaskPlanner();
-    const subTasks = planner.breakdown(parsedTask, answers, qualityConfig, tasksInput.plan);
+    const subTasks = planner.breakdown(parsedTask, answers, qualityConfig, resolvedInput.plan);
     // 创建任务到状态管理器，并建立 ID 映射
     // TaskPlanner 生成的 taskId 和 StateManager 创建的 id 不同，
     // 需要映射后才能正确设置 dependencies
@@ -238,14 +331,15 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
                     assignedAgent: t.assignedAgent
                 })),
                 taskInfo: {
-                    title: tasksInput.title,
-                    description: tasksInput.description,
-                    quality: qualityLevel
+                    title: resolvedInput.title,
+                    description: resolvedInput.description,
+                    quality: qualityLevel,
+                    domain: researchContext?.domain
                 }
             }));
         }
         else {
-            console.log(`\n📋 ${tasksInput.title} - ${subTasks.length} 个子任务:\n`);
+            console.log(`\n📋 ${resolvedInput.title} - ${subTasks.length} 个子任务:\n`);
             subTasks.forEach((task, i) => {
                 console.log(`  ${i + 1}. ${task.title} (${task.priority}, ${task.assignedAgent})`);
             });
@@ -275,14 +369,15 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
             },
             subagentTasks,
             taskInfo: {
-                title: tasksInput.title,
-                description: tasksInput.description,
-                quality: qualityLevel
+                title: resolvedInput.title,
+                description: resolvedInput.description,
+                quality: qualityLevel,
+                domain: researchContext?.domain
             }
         }));
     }
     else {
-        console.log(`\n📋 ${tasksInput.title} - ${subTasks.length} 个子任务已创建`);
+        console.log(`\n📋 ${resolvedInput.title} - ${subTasks.length} 个子任务已创建`);
         console.log(`🎯 执行模式：${executionMode}`);
         console.log(`   质量级别：${qualityLevel}`);
         console.log('\n🚀 等待 Skill 执行任务...');
@@ -292,7 +387,7 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
 /**
  * 处理自动解析 (fallback，无 AI 时使用)
  */
-async function handleAutoParse(input, options, stateManager, state) {
+async function handleAutoParse(input, options, stateManager, state, basePath, omPath) {
     // 构建任务内容
     let taskContent = input;
     if (options.title || options.description) {
@@ -302,7 +397,46 @@ async function handleAutoParse(input, options, stateManager, state) {
         const docs = options.docs ? `\n文档要求: ${options.docs}` : '';
         taskContent = `# ${title}\n\n${description}${techStack}${docs}`;
     }
+    // 如果没有提供输入，先检测研究上下文，再检测 TASK.md
     if (!taskContent) {
+        // 优先检测研究上下文
+        const { context: researchContext, report: researchReport } = await loadResearchContext(options.researchContext, basePath, omPath);
+        if (researchContext) {
+            // 基于研究上下文构建 ParsedTask
+            const parsedTitle = researchContext.topic || researchContext.domain || '未命名任务';
+            const researchGoals = researchContext.goals || [];
+            if (!options.json) {
+                console.log(`\n🔬 检测到研究领域: ${researchContext.domain}`);
+                console.log(`   研究目标: ${researchGoals.length > 0 ? researchGoals.join(', ') : '待拆分'}`);
+                console.log('\n🔍 基于研究结果解析任务...');
+            }
+            const parsedTask = {
+                title: parsedTitle,
+                description: researchGoals.length > 0 ? researchGoals.join('\n') : '',
+                goals: researchGoals,
+                goalTypes: researchGoals.map(() => 'development'),
+                constraints: researchContext.constraints || [],
+                deliverables: researchContext.deliverables || [],
+                rawContent: researchReport || ''
+            };
+            if (!options.json) {
+                console.log(`\n📋 任务: ${parsedTask.title}`);
+                console.log(`   目标: ${parsedTask.goals.join(', ') || '(待 AI 补充)'}`);
+                console.log('\n🔧 拆解任务...');
+            }
+            let qualityConfig;
+            if (options.quality) {
+                const qualityLevel = options.quality.toLowerCase();
+                if (['strict', 'balanced', 'fast'].includes(qualityLevel)) {
+                    qualityConfig = index_js_1.QUALITY_PRESETS[qualityLevel];
+                }
+            }
+            const planner = new task_planner_js_1.TaskPlanner();
+            const subTasks = planner.breakdown(parsedTask, {}, qualityConfig, researchReport || undefined);
+            await finalizeAndOutput(subTasks, options, stateManager, state, qualityConfig, parsedTask.title);
+            return;
+        }
+        // 无研究上下文，回退到 TASK.md
         const defaultPath = path.join(process.cwd(), 'TASK.md');
         try {
             taskContent = await fs.readFile(defaultPath, 'utf-8');
@@ -355,6 +489,13 @@ async function handleAutoParse(input, options, stateManager, state) {
     }
     const planner = new task_planner_js_1.TaskPlanner();
     const subTasks = planner.breakdown(parsedTask, {}, qualityConfig);
+    await finalizeAndOutput(subTasks, options, stateManager, state, qualityConfig, parsedTask.title);
+}
+/**
+ * 公共函数：创建任务、更新状态、处理审批、输出结果
+ * 被 handleTasksJson 和 handleAutoParse 共用
+ */
+async function finalizeAndOutput(subTasks, options, stateManager, state, qualityConfig, taskTitle) {
     // 创建任务，并建立 TaskPlanner ID → StateManager ID 的映射
     const taskIdMap = new Map();
     for (const subTask of subTasks) {
@@ -401,13 +542,7 @@ async function handleAutoParse(input, options, stateManager, state) {
                 approvalType: 'plan',
                 message: '等待计划审批',
                 tasks: subTasks.map((t, i) => ({ index: i + 1, title: t.title, priority: t.priority })),
-                taskInfo: {
-                    title: options.title || parsedTask.title,
-                    description: options.description,
-                    quality: options.quality,
-                    techStack: options.techStack,
-                    docs: options.docs
-                }
+                taskInfo: { title: taskTitle, quality: options.quality }
             }));
         }
         else {
@@ -440,13 +575,7 @@ async function handleAutoParse(input, options, stateManager, state) {
                 pending: allTasks.filter(t => t.status === 'pending').length
             },
             subagentTasks,
-            taskInfo: {
-                title: options.title || parsedTask.title,
-                description: options.description,
-                quality: options.quality,
-                techStack: options.techStack,
-                docs: options.docs
-            }
+            taskInfo: { title: taskTitle, quality: options.quality }
         }));
     }
     else {

package/dist/cli/commands/step.js

@@ -38,9 +38,12 @@ exports.stepCommand = void 0;
 // 循环状态持久化 - 防止上下文压缩导致循环丢失
 const commander_1 = require("commander");
 const state_manager_js_1 = require("../../storage/state-manager.js");
+const scheduler_js_1 = require("../../orchestrator/scheduler.js");
+const agent_runner_js_1 = require("../../agents/agent-runner.js");
+const approval_manager_js_1 = require("../../orchestrator/approval-manager.js");
 const path = __importStar(require("path"));
 exports.stepCommand = new commander_1.Command('step')
-    .description('获取下一个待执行任务（持久化循环状态）')
+    .description('获取下一个待执行任务（自动转换状态并准备 Subagent 配置）')
     .option('--json', '输出 JSON 格式')
     .action(async (options) => {
     const basePath = process.cwd();
@@ -53,30 +56,15 @@ exports.stepCommand = new commander_1.Command('step')
         console.log(JSON.stringify({ status: 'done', message: '所有任务已完成' }));
         return;
     }
-    // 获取所有任务
-    const allTasks = await stateManager.listTasks();
-    const nextTask = allTasks.find(t => t.status === 'pending' ||
-        t.status === 'scheduled' ||
-        t.status === 'in_progress');
+    // 使用 Scheduler 获取下一个可执行任务（处理依赖、并发等）
+    const scheduler = new scheduler_js_1.Scheduler(stateManager, {
+        maxConcurrentTasks: state.config.maxConcurrentAgents || 3
+    });
+    const nextTask = await scheduler.getNextTask();
     if (!nextTask) {
-        // 所有任务都完成了或被阻塞
-        const completed = allTasks.filter(t => t.status === 'completed').length;
-        const total = allTasks.length;
-        // 自动更新统计
-        const stats = {
-            totalTasks: total,
-            completed: completed,
-            inProgress: allTasks.filter(t => t.status === 'in_progress').length,
-            failed: allTasks.filter(t => t.status === 'failed').length,
-            pending: allTasks.filter(t => t.status === 'pending').length,
-            scheduled: allTasks.filter(t => t.status === 'scheduled').length,
-            blocked: allTasks.filter(t => t.status === 'blocked').length,
-            waiting: allTasks.filter(t => t.status === 'waiting').length,
-            verify: allTasks.filter(t => t.status === 'verify').length,
-            accept: allTasks.filter(t => t.status === 'accept').length,
-            retry_queue: allTasks.filter(t => t.status === 'retry_queue').length
-        };
-        const allDone = completed + stats.failed === total;
+        // 所有任务都完成了或被阻塞 — 刷新统计后返回
+        const stats = await refreshStatistics(stateManager);
+        const allDone = stats.completed + stats.failed === stats.totalTasks;
         await stateManager.updateState({
             statistics: stats,
             status: allDone ? 'completed' : 'running',
@@ -86,30 +74,46 @@ exports.stepCommand = new commander_1.Command('step')
             status: allDone ? 'done' : 'blocked',
             statistics: stats,
             message: allDone
-                ? `所有任务已完成 (${completed}/${total})`
-                : `没有可执行任务 (${completed}/${total} 完成, ${stats.failed} 失败, ${stats.pending} 等待)`
+                ? `所有任务已完成 (${stats.completed}/${stats.totalTasks})`
+                : `没有可执行任务 (${stats.completed}/${stats.totalTasks} 完成, ${stats.failed} 失败, ${stats.pending} 等待)`
         }));
         return;
     }
-    // 输出下一个任务信息
+    // 转换任务状态为 in_progress（通过 Scheduler）
+    await scheduler.markTaskStarted(nextTask.id);
+    // 准备 Subagent 任务配置（包含完整的 prompt）
+    const approvalManager = new approval_manager_js_1.ApprovalManager(stateManager);
+    const agentRunner = new agent_runner_js_1.AgentRunner(stateManager, approvalManager, {
+        maxConcurrent: state.config.maxConcurrentAgents || 3,
+        taskTimeout: state.config.timeout * 1000 || 120000
+    });
+    const subagentTask = await agentRunner.prepareSubagentTask(nextTask);
+    // 重新读取统计信息
+    const stats = await refreshStatistics(stateManager);
     const result = {
         status: 'next',
         task: {
             id: nextTask.id,
             title: nextTask.title,
             description: nextTask.description,
-            status: nextTask.status,
+            status: 'in_progress',
             assignedAgent: nextTask.assignedAgent,
             dependencies: nextTask.dependencies,
             acceptanceCriteria: nextTask.acceptanceCriteria
         },
+        // 完整的 Subagent 配置（可直接用于 Agent 工具调用）
+        subagent: {
+            subagent_type: subagentTask.subagent_type,
+            description: subagentTask.description,
+            prompt: subagentTask.prompt,
+            isolation: subagentTask.isolation,
+            timeout: subagentTask.timeout
+        },
         statistics: {
-            total: allTasks.length,
-            completed: allTasks.filter(t => t.status === 'completed').length,
-            remaining: allTasks.filter(t => t.status === 'pending' ||
-                t.status === 'scheduled' ||
-                t.status === 'in_progress').length,
-            failed: allTasks.filter(t => t.status === 'failed').length
+            total: stats.totalTasks,
+            completed: stats.completed,
+            remaining: stats.pending + stats.inProgress + stats.scheduled + stats.verify + stats.accept,
+            failed: stats.failed
         }
     };
     if (options.json) {
@@ -117,6 +121,29 @@ exports.stepCommand = new commander_1.Command('step')
     }
     else {
         console.log(`📌 下一个任务: ${nextTask.id} - ${nextTask.title}`);
-        console.log(`   进度: ${result.statistics.completed}/${result.statistics.total} 完成, ${result.statistics.remaining} 剩余`);
+        console.log(`   状态已转换为 in_progress`);
+        console.log(`   Agent 类型: ${nextTask.assignedAgent}`);
+        console.log(`   进度: ${stats.completed}/${stats.totalTasks} 完成, ${result.statistics.remaining} 剩余`);
     }
 });
+/**
+ * 从当前任务状态重新计算统计信息（保证准确性）
+ */
+async function refreshStatistics(stateManager) {
+    const tasks = await stateManager.listTasks();
+    const stats = {
+        totalTasks: tasks.length,
+        completed: tasks.filter(t => t.status === 'completed').length,
+        inProgress: tasks.filter(t => t.status === 'in_progress').length,
+        failed: tasks.filter(t => t.status === 'failed').length,
+        pending: tasks.filter(t => t.status === 'pending').length,
+        scheduled: tasks.filter(t => t.status === 'scheduled').length,
+        blocked: tasks.filter(t => t.status === 'blocked').length,
+        waiting: tasks.filter(t => t.status === 'waiting').length,
+        verify: tasks.filter(t => t.status === 'verify').length,
+        accept: tasks.filter(t => t.status === 'accept').length,
+        retry_queue: tasks.filter(t => t.status === 'retry_queue').length
+    };
+    await stateManager.updateState({ statistics: stats });
+    return stats;
+}

package/dist/orchestrator/ai-reviewer.d.ts

@@ -1,4 +1,4 @@
-import type { Task } from '../types/index.js';
+import type { Task, TaskPriority, AgentType } from '../types/index.js';
 /**
  * AI Reviewer 验收报告
  */
@@ -24,6 +24,18 @@ export interface ReviewIssue {
     description: string;
     suggestion?: string;
 }
+/**
+ * Review 修复任务配置
+ */
+export interface ReviewFixTask {
+    taskId: string;
+    title: string;
+    description: string;
+    priority: TaskPriority;
+    assignedAgent: AgentType;
+    dependencies: string[];
+    timeout: number;
+}
 /**
  * AIReviewer - AI 代码审查器
  *
@@ -47,4 +59,20 @@ export declare class AIReviewer {
      * 生成验收阶段提示词 (包含 AI Review)
      */
     buildAcceptPrompt(task: Task): string;
+    /**
+     * 根据 Review 报告生成修复任务
+     *
+     * 对每个 critical/major 问题生成独立的修复任务，
+     * 这些任务会被加入执行队列并自动执行。
+     *
+     * @param originalTask 被审查的原始任务
+     * @param report Review 报告
+     * @param reviewTaskId 审查任务本身的 ID（用于依赖）
+     * @returns 修复任务列表
+     */
+    generateFixTasks(originalTask: Task, report: ReviewReport, reviewTaskId: string): ReviewFixTask[];
+    /**
+     * 判断 Review 报告是否需要自动修复
+     */
+    needsAutoFix(report: ReviewReport): boolean;
 }