mcp-probe-kit 3.6.10 → 3.6.11

package/build/tools/start_bugfix.js

@@ -9,6 +9,7 @@ import { buildBugfixGraphContext } from "../lib/gitnexus-bridge.js";
 import { buildMemoryPlanStep, loadMemoryInjectionContext, renderMemoryGuideSection, buildOrchestrationHandles, } from "../lib/memory-orchestration.js";
 import { resolveWorkspaceRoot, isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 import { layoutAbsPath, parseLayoutArgsFromRecord, resolveProjectContextLayout, } from "../lib/project-context-layout.js";
+import { resolveAnalysisMode, mergeBugfixOrchestrationPlan } from "../lib/src8-guidance.js";
 import { buildCheckSpecPlanStep, renderSpecGatePromptSection, resolveBugfixSpecGate, } from "../lib/spec-gate.js";
 function decideTemplateProfile(description) {
     const text = description || '';
@@ -48,235 +49,196 @@ function resolveTemplateProfile(rawProfile, description) {
         warning: `模板档位 "${rawProfile}" 不支持，已回退为 ${fallback}`,
     };
 }
-const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（TBP 8 步真因分析）
-
-## 🎯 目标
-
-修复以下 Bug：
-
-**错误信息**:
-\`\`\`
-{error_message}
-\`\`\`
-
-{stack_trace_section}
-
----
-
-## 📋 步骤 0: 项目上下文与取证基线（自动处理）
-
-**操作**:
-1. 检查 \`docs/project-context.md\` 是否存在
-2. 检查 \`docs/graph-insights/latest.md\` 和 \`docs/graph-insights/latest.json\` 是否存在
-3. **如果任一缺失**：
-   - 调用 \`init_project_context\` 工具
-   - 等待生成完成
-4. **读取** \`docs/project-context.md\` 与图谱文档
-5. 了解项目的技术栈、架构、测试框架和调用链
-6. 后续步骤参考此上下文
-
----
-
-## 🔍 步骤 1: 先做 TBP 1-7，再决定修复
-
-**调用工具**: \`fix_bug\`
-
-**参数**:
-\`\`\`json
-{
-  "error_message": "{error_message}",
-  "stack_trace": "{stack_trace}"
-}
-\`\`\`
-
-**执行要点**:
-1. 先定义现象，不能泛化
-2. 复盘时间线，尽量带时间/步骤/状态
-3. 明确排除错误方向，并说明为什么不是
-4. 对比成功/失败样本，找分叉点
-5. 定位问题边界（模型 / 状态机 / 工具 / 文件 / 环境）
-6. 用因果句陈述真因：A + B 在条件 D 下导致 C
-7. 闭合证据链后，才进入修复设计
-8. 修复必须说明风险与验证方式
-
-**产出**: 修复后的代码
-
----
-
-## 🧪 步骤 2: 生成回归测试
-
-**调用工具**: \`gentest\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[修复后的代码]",
-  "framework": "[根据项目上下文选择: jest/vitest/mocha]"
-}
-\`\`\`
-
-**执行要点**:
-1. 为修复的代码生成测试
-2. 包含 Bug 场景的测试用例
-3. 包含边界情况测试
-
-**产出**: 测试代码
-
-{spec_gate_section}
-
----
-
-## ✅ 完成检查
-
-- [ ] 项目上下文已读取
-- [ ] TBP-1~TBP-7 已闭合
-- [ ] 真因已写成因果句
-- [ ] 代码已修复
-- [ ] 测试已添加
-- [ ] 测试已通过
-
----
-
-## 📝 输出汇总
-
-完成后，向用户汇总：
-
-1. **TBP 现象**: [精确定义的问题]
-2. **TBP 时间线**: [关键事件顺序]
-3. **已排除方向**: [不是哪些原因]
-4. **问题边界**: [失控发生在哪一层]
-5. **Bug 真因**: [根本原因]
-6. **修复方案**: [修复说明]
-7. **修改文件**: [文件列表]
-8. **测试覆盖**: [测试情况]
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix*
+const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（SRC-8 真因分析）
+
+## 🎯 目标
+
+修复以下 Bug：
+
+**错误信息**:
+\`\`\`
+{error_message}
+\`\`\`
+
+{stack_trace_section}
+
+---
+
+## 📋 步骤 0: 项目上下文与取证基线（自动处理）
+
+**操作**:
+1. 检查 \`docs/project-context.md\` 是否存在
+2. 检查 \`docs/graph-insights/latest.md\` 和 \`docs/graph-insights/latest.json\` 是否存在
+3. **如果任一缺失**：
+   - 调用 \`init_project_context\` 工具
+   - 等待生成完成
+4. **读取** \`docs/project-context.md\` 与图谱文档
+5. 了解项目的技术栈、架构、测试框架和调用链
+6. 后续步骤参考此上下文
+
+---
+
+## 🔍 步骤 1~8: SRC-8（delegated plan）
+
+**执行方式**: 严格按 \`structuredContent.metadata.plan.steps\` 顺序执行（与 \`start_feature\` 相同模式）。
+
+**SRC 概要**:
+1. **src8-1** 明确差距 → \`BugAnalysis.tbp.phenomenon\`
+2. **src8-2** \`code_insight\` → 边界/时间线
+3. **src8-3** 验收契约 → \`BugAnalysis.testPlan\`
+4. **src8-4** 真因工作表 4a~4e → \`rootCauseAnalysis\`（闭合前禁止改代码）
+5. **src8-5** 制定对策 → \`BugAnalysis.fixPlan\`
+6. **src8-6** 贯彻修复 → 代码补丁
+7. **src8-7** \`gentest\` → 回归测试
+8. **src8-8** \`memorize_asset\` → 沉淀经验
+
+**Bug 上下文**:
+\`\`\`
+{error_message}
+\`\`\`
+
+{stack_trace_section}
+
+---
+
+## ✅ 完成检查
+
+- [ ] 项目上下文已读取
+- [ ] SRC-8 Step 1~3 已完成
+- [ ] **rootCauseWorksheet / rootCauseAnalysis 已闭合**
+- [ ] 真因已写成因果句
+- [ ] 代码已修复
+- [ ] 测试已添加
+- [ ] 测试已通过
+
+---
+
+## 📝 输出汇总
+
+完成后，向用户汇总：
+
+1. **SRC-1 差距**: [精确定义的问题]
+2. **SRC-2 时间线/边界**: [关键事件与归因层]
+3. **已排除方向**: [不是哪些原因]
+4. **问题边界**: [失控发生在哪一层]
+5. **Bug 真因**: [根本原因]
+6. **修复方案**: [修复说明]
+7. **修改文件**: [文件列表]
+8. **测试覆盖**: [测试情况]
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix*
 `;
-const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格 | TBP 8 步）
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-{stack_trace_section}
-
----
-
-## ✅ 执行计划（按顺序）
-
-1) 检查 \`docs/project-context.md\` 与 \`docs/graph-insights/latest.*\`，任一缺失则调用 \`init_project_context\`
-2) 调用 \`fix_bug\`
-\`\`\`json
-{
-  "error_message": "{error_message}",
-  "stack_trace": "{stack_trace}",
-  "analysis_mode": "{analysis_mode}"
-}
-\`\`\`
-3) 调用 \`gentest\`
-\`\`\`json
-{
-  "code": "[修复后的代码]",
-  "framework": "[根据项目上下文选择: jest/vitest/mocha]"
-}
-\`\`\`
-{spec_gate_section}
-
----
-
-## ✅ 输出汇总
-1. TBP 现象
-2. TBP 时间线
-3. 已排除方向
-4. 问题边界
-5. Bug 真因
-6. 修复方案
-7. 修改文件
-8. 测试覆盖
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix*
+const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格 | SRC-8）
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+{stack_trace_section}
+
+---
+
+## ✅ 执行计划
+
+严格按 \`structuredContent.metadata.plan.steps\` 顺序执行（context → src8-1 → … → src8-8）。
+
+**要点**: src8-4 闭合 \`rootCauseWorksheet\` 前禁止改代码；src8-6 前满足复现门禁。
+
+{spec_gate_section}
+
+---
+
+## ✅ 输出汇总
+1. SRC-1 差距
+2. SRC-2 时间线/边界
+3. 已排除方向
+4. 问题边界
+5. Bug 真因
+6. 修复方案
+7. 修改文件
+8. 测试覆盖
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix*
 `;
-const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（TBP RCA Loop）
-
-本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 TBP 8 步真因分析所需证据。
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-## ✅ 规则
-1. **不覆盖用户原始描述**
-2. **补全内容必须标注来源**（User / Derived / Assumption）
-3. **假设必须进入待确认列表**
-4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
-
----
-
-## 🔁 执行步骤（每轮）
-
-### 1) 生成待确认问题
-使用 \`ask_user\` 提问，问题来源于 TBP 清单（现象/时间线/对比样本/边界/验证）。
-
-**调用示例**:
-\`\`\`json
-{
-  "questions": [
-    { "question": "复现步骤是什么？", "context": "复现步骤", "required": true },
-    { "question": "期望行为是什么？", "context": "期望行为", "required": true }
-  ]
-}
-\`\`\`
-
-### 2) 更新结构化输出
-将回答补入 \`requirements\`，并标注来源：
-- User：用户明确回答
-- Derived：合理推导
-- Assumption：无法确认但补全（需确认）
-
-### 3) 自检与结束
-若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入 TBP-6/7/8 修复流程。
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，执行：
-1. 调用 \`fix_bug\` 完成 TBP 8 步分析与修复方案
-2. 调用 \`gentest\` 生成回归测试
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
+const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（SRC-8 RCA Loop）
+
+本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 SRC-8 真因分析（尤其 Step 4 工作表）所需证据。
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+## ✅ 规则
+1. **不覆盖用户原始描述**
+2. **补全内容必须标注来源**（User / Derived / Assumption）
+3. **假设必须进入待确认列表**
+4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
+
+---
+
+## 🔁 执行步骤（每轮）
+
+### 1) 生成待确认问题
+使用 \`ask_user\` 提问，问题来源于 SRC-8 清单（差距/边界/验收契约/对比样本/真因工作表）。
+
+**调用示例**:
+\`\`\`json
+{
+  "questions": [
+    { "question": "复现步骤是什么？", "context": "复现步骤", "required": true },
+    { "question": "期望行为是什么？", "context": "期望行为", "required": true }
+  ]
+}
+\`\`\`
+
+### 2) 更新结构化输出
+将回答补入 \`requirements\`，并标注来源：
+- User：用户明确回答
+- Derived：合理推导
+- Assumption：无法确认但补全（需确认）
+
+### 3) 自检与结束
+若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入 SRC-8 Step 5~8（对策→修复→评价→巩固）。
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，严格按 \`structuredContent.metadata.plan.steps\` 中 src8-1~8 执行（禁止跳步）。
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
 `;
-const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 Bug 需求澄清与补全（TBP RCA Loop | 严格）
-
-本模式用于稳健补全关键信息，不改变用户意图。
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-## ✅ 规则
-1. 不覆盖用户原始描述
-2. 补全内容标注来源（User / Derived / Assumption）
-3. 假设进入待确认列表
-4. 每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}
-
----
-
-## 🔁 执行步骤（每轮）
-1) 使用 \`ask_user\` 提问补全关键信息
-2) 更新结构化输出并标注来源
-3) 若 \`openQuestions\` 为空且无高风险假设则结束
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，调用 \`fix_bug\` 与 \`gentest\`
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
+const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 Bug 需求澄清与补全（SRC-8 RCA Loop | 严格）
+
+本模式用于稳健补全关键信息，不改变用户意图。
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+## ✅ 规则
+1. 不覆盖用户原始描述
+2. 补全内容标注来源（User / Derived / Assumption）
+3. 假设进入待确认列表
+4. 每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}
+
+---
+
+## 🔁 执行步骤（每轮）
+1) 使用 \`ask_user\` 提问补全关键信息
+2) 更新结构化输出并标注来源
+3) 若 \`openQuestions\` 为空且无高风险假设则结束
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，按 \`metadata.plan\` 执行 src8-1~8。
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
 `;
 function buildBugfixQuestions(questionBudget) {
     const base = [
@@ -299,7 +261,7 @@ export async function startBugfix(args, context) {
                 error_message: "",
                 stack_trace: "",
                 code_context: "",
-                analysis_mode: "tbp8",
+                analysis_mode: "src8",
                 template_profile: "auto",
                 requirements_mode: "steady",
                 loop_max_rounds: 2,
@@ -308,7 +270,7 @@ export async function startBugfix(args, context) {
             },
             primaryField: "error_message", // 纯文本输入默认映射到 error_message 字段
             fieldAliases: {
-                error_message: ["error", "err", "message", "错误", "错误信息"],
+                error_message: ["error", "err", "message", "错误", "错误信息", "description", "desc", "summary", "问题", "bug", "issue"],
                 stack_trace: ["stack", "trace", "堆栈", "调用栈"],
                 code_context: ["code_context", "code", "context", "相关代码", "代码上下文"],
                 project_root: ["projectRoot", "project_path", "projectPath", "root", "project_root", "项目路径", "项目根目录"],
@@ -322,7 +284,7 @@ export async function startBugfix(args, context) {
                 loop_assumption_cap: ["assumption_cap", "假设上限"],
             },
         });
-        const errorMessage = getString(parsedArgs.error_message);
+        const errorMessage = getString(parsedArgs.error_message) || getString(parsedArgs.description);
         const stackTrace = getString(parsedArgs.stack_trace);
         const codeContext = getString(parsedArgs.code_context);
         const projectRoot = getString(parsedArgs.project_root);
@@ -342,9 +304,7 @@ export async function startBugfix(args, context) {
                 },
             };
         }
-        const analysisMode = ((getString(parsedArgs.analysis_mode) || "tbp8").toLowerCase() === "tbp8"
-            ? "tbp8"
-            : "tbp8");
+        const analysisMode = resolveAnalysisMode(getString(parsedArgs.analysis_mode));
         const rawProfile = getString(parsedArgs.template_profile);
         const requirementsMode = getString(parsedArgs.requirements_mode) || "steady";
         const maxRounds = getNumber(parsedArgs.loop_max_rounds, 2);
@@ -430,22 +390,21 @@ export async function startBugfix(args, context) {
         ]
             .filter(Boolean)
             .join("\n\n");
-        const graphGuideSection = `
-
-## 🧠 代码图谱上下文
-- 基线入口: ${graphDocs.latestMarkdownPath}
-- 基线结构化副本: ${graphDocs.latestJsonPath}
-- 基线状态: ${graphDocsMissing ? "缺失（需要补初始化）" : "可用"}
-- 任务级收敛: ${graphContext.available ? "可用" : "降级"}
-- 任务级摘要: ${graphContext.summary}
+        const graphGuideSection = `
+
+## 🧠 代码图谱上下文
+- 基线入口: ${graphDocs.latestMarkdownPath}
+- 基线结构化副本: ${graphDocs.latestJsonPath}
+- 基线状态: ${graphDocsMissing ? "缺失（需要补初始化）" : "可用"}
+- 任务级收敛: ${graphContext.available ? "可用" : "降级"}
+- 任务级摘要: ${graphContext.summary}
 ${graphContext.highlights.length > 0
             ? `- 任务级线索:\n${graphContext.highlights.slice(0, 3).map((item) => `  - ${item}`).join("\n")}`
-            : "- 任务级线索: 无"}
-- 使用方式: 先读取基线图谱，再用本次任务图谱做 TBP-4 / TBP-5 / TBP-6 的边界与真因收敛
+            : "- 任务级线索: 无"}
+- 使用方式: 先读取基线图谱，再用本次任务图谱做 SRC-2/4 的边界与真因收敛
 `;
         const memoryContext = await loadMemoryInjectionContext([errorMessage, stackTrace, codeContext].filter(Boolean).join("\n"), "bugfix");
         const memoryGuideSection = renderMemoryGuideSection(memoryContext);
-        // 记忆优先：先消化历史同类 Bug 的根因/修复（坑），再做 TBP 真因分析
         const memoryRecallStep = memoryContext.enabled
             ? [{
                     id: 'recall-memory',
@@ -453,9 +412,45 @@ ${graphContext.highlights.length > 0
                     when: '开干前（下方「历史经验与坑」已自动注入相似历史修复；需要更多同类案例时再调）',
                     args: { query: errorMessage, limit: 5 },
                     outputs: [],
-                    note: '先看历史同类 Bug 的根因与已验证修复，优先复用其修复路径并规避同类坑；据此收敛 TBP-4/5/6 的真因方向',
+                    note: '先看历史同类 Bug 的根因与已验证修复，优先复用其修复路径并规避同类坑；据此收敛 SRC-4 真因方向',
                 }]
             : [];
+        const buildOrchestrationPlan = (options) => {
+            const contextStep = {
+                id: 'context',
+                tool: 'init_project_context',
+                when: `缺少 ${layout.indexPath} 或 ${graphDocs.latestMarkdownPath} / ${graphDocs.latestJsonPath}`,
+                args: {
+                    docs_dir: layout.contextRoot,
+                    ...(projectRoot ? { project_root: projectRoot } : {}),
+                },
+                outputs: [layout.indexPath, graphDocs.latestMarkdownPath, graphDocs.latestJsonPath],
+                note: `兼容老项目：如果旧项目没有 graph-insights/latest.*，先补齐图谱初始化再进入 bug 收敛`,
+            };
+            const src8Plan = mergeBugfixOrchestrationPlan({
+                src8Input: {
+                    error_message: errorMessage,
+                    stack_trace: stackTrace || undefined,
+                    analysis_mode: analysisMode,
+                    code_context: graphCodeContext || undefined,
+                    project_root: resolvedProjectRoot,
+                    includeMemorize: !memoryContext.enabled,
+                },
+                preambleSteps: [...memoryRecallStep, contextStep, ...(options?.loopSteps ?? [])],
+                deferMemorize: memoryContext.enabled,
+                appendSteps: [
+                    ...(specGate ? [buildCheckSpecPlanStep(specGate.featureName, specGate.docsDir)] : []),
+                    ...(memoryContext.enabled ? [buildMemoryPlanStep('bugfix')] : []),
+                ],
+            });
+            if (options?.src8When) {
+                const firstSrc8 = src8Plan.steps.find((step) => step.id.startsWith('src8-'));
+                if (firstSrc8) {
+                    firstSrc8.when = options.src8When;
+                }
+            }
+            return src8Plan;
+        };
         if (requirementsMode === "loop") {
             throwIfAborted(context?.signal, "start_bugfix(loop) 已取消");
             await reportToolProgress(context, 70, "start_bugfix: 生成 loop 计划");
@@ -478,21 +473,9 @@ ${graphContext.highlights.length > 0
             const assumptions = [];
             const missingFields = openQuestions.map((q) => q.context || q.question);
             const stopReady = openQuestions.length === 0 && assumptions.length === 0;
-            const plan = {
-                mode: 'delegated',
-                steps: [
-                    ...memoryRecallStep,
-                    {
-                        id: 'context',
-                        tool: 'init_project_context',
-                        when: `缺少 ${layout.indexPath} 或 ${graphDocs.latestMarkdownPath} / ${graphDocs.latestJsonPath}`,
-                        args: {
-                            docs_dir: 'docs',
-                            ...(projectRoot ? { project_root: projectRoot } : {}),
-                        },
-                        outputs: [layout.indexPath, graphDocs.latestMarkdownPath, graphDocs.latestJsonPath],
-                        note: `兼容老项目：如果旧项目没有 graph-insights/latest.*，先补齐图谱初始化再进入 bug 收敛`,
-                    },
+            const plan = buildOrchestrationPlan({
+                src8When: 'stopConditions.ready=true',
+                loopSteps: [
                     {
                         id: 'loop-1',
                         tool: 'ask_user',
@@ -500,41 +483,16 @@ ${graphContext.highlights.length > 0
                         outputs: [],
                     },
                     ...(maxRounds > 1
-                        ? [
-                            {
+                        ? [{
                                 id: 'loop-2',
                                 tool: 'ask_user',
                                 when: '仍存在 openQuestions 或 assumptions',
                                 args: { questions: '[根据上一轮补全结果生成问题]' },
                                 outputs: [],
-                            },
-                        ]
+                            }]
                         : []),
-                    {
-                        id: 'fix',
-                        tool: 'fix_bug',
-                        when: 'stopConditions.ready=true',
-                        args: {
-                            error_message: errorMessage,
-                            ...(stackTrace ? { stack_trace: stackTrace } : {}),
-                            analysis_mode: analysisMode,
-                            ...(graphCodeContext ? { code_context: graphCodeContext } : {}),
-                        },
-                        outputs: [],
-                    },
-                    {
-                        id: 'test',
-                        tool: 'gentest',
-                        when: 'stopConditions.ready=true',
-                        args: {
-                            code: '[修复后的代码]',
-                            framework: '[根据项目上下文选择: jest/vitest/mocha]',
-                        },
-                        outputs: [],
-                    },
-                    ...(memoryContext.enabled ? [buildMemoryPlanStep('bugfix')] : []),
                 ],
-            };
+            });
             const header = renderOrchestrationHeader({
                 tool: 'start_bugfix',
                 goal: `修复 Bug：${errorMessage}`,
@@ -603,8 +561,8 @@ ${graphContext.highlights.length > 0
             tool: 'start_bugfix',
             goal: `修复 Bug：${errorMessage}`,
             tasks: [
-                '按 delegated plan 顺序调用工具',
-                '完成修复并生成回归测试',
+                '按 delegated plan 顺序执行 metadata.plan.steps（src8-1~8）',
+                '完成修复、回归测试与记忆沉淀',
             ],
             notes: [
                 ...headerNotes,
@@ -621,45 +579,7 @@ ${graphContext.highlights.length > 0
             .replace(/{stack_trace_section}/g, stackTraceSection)
             .replace(/{spec_gate_section}/g, specGateSection);
         const guide = header + memoryGuideSection + renderedPrompt + graphGuideSection;
-        const plan = {
-            mode: 'delegated',
-            steps: [
-                ...memoryRecallStep,
-                {
-                    id: 'context',
-                    tool: 'init_project_context',
-                    when: `缺少 ${layout.indexPath} 或 ${graphDocs.latestMarkdownPath} / ${graphDocs.latestJsonPath}`,
-                    args: {
-                        docs_dir: layout.contextRoot,
-                        ...(projectRoot ? { project_root: projectRoot } : {}),
-                    },
-                    outputs: [layout.indexPath, graphDocs.latestMarkdownPath, graphDocs.latestJsonPath],
-                    note: `兼容老项目：如果旧项目没有 graph-insights/latest.*，先补齐图谱初始化再进入 bug 收敛`,
-                },
-                {
-                    id: 'fix',
-                    tool: 'fix_bug',
-                    args: {
-                        error_message: errorMessage,
-                        ...(stackTrace ? { stack_trace: stackTrace } : {}),
-                        analysis_mode: analysisMode,
-                        ...(graphCodeContext ? { code_context: graphCodeContext } : {}),
-                    },
-                    outputs: [],
-                },
-                {
-                    id: 'test',
-                    tool: 'gentest',
-                    args: {
-                        code: '[修复后的代码]',
-                        framework: '[根据项目上下文选择: jest/vitest/mocha]',
-                    },
-                    outputs: [],
-                },
-                ...(specGate ? [buildCheckSpecPlanStep(specGate.featureName, specGate.docsDir)] : []),
-                ...(memoryContext.enabled ? [buildMemoryPlanStep('bugfix')] : []),
-            ],
-        };
+        const plan = buildOrchestrationPlan();
         // 创建结构化的 Bug 修复报告
         const bugfixReport = {
             summary: `Bug 修复工作流：${errorMessage.substring(0, 50)}${errorMessage.length > 50 ? '...' : ''}`,
@@ -672,14 +592,9 @@ ${graphContext.highlights.length > 0
                     description: `检查 ${layout.indexPath} 与 graph-insights/latest.* 是否存在，缺失则调用 init_project_context`,
                 },
                 {
-                    name: 'Bug 分析与修复',
-                    status: 'pending',
-                    description: '调用 fix_bug 工具进行问题定位和修复',
-                },
-                {
-                    name: '生成回归测试',
+                    name: 'SRC-8 真因分析与修复',
                     status: 'pending',
-                    description: '调用 gentest 工具生成测试用例',
+                    description: '按 metadata.plan 执行 src8-1~8（src8-4 闭合前禁止改代码）',
                 },
                 ...(specGate
                     ? [{
@@ -694,18 +609,17 @@ ${graphContext.highlights.length > 0
                 '检查并读取项目上下文文档',
                 `如果缺少 ${graphDocs.latestMarkdownPath} / ${graphDocs.latestJsonPath}，先调用 init_project_context 补齐图谱初始化`,
                 `优先读取 ${graphDocs.latestMarkdownPath} 获取调用链、依赖和影响面摘要`,
-                '结合本次任务图谱线索收敛问题边界，避免扩大改动面',
-                '按 TBP-1~TBP-7 完成真因分析',
-                '调用 fix_bug 工具分析问题并形成因果句真因',
-                '调用 gentest 工具生成回归测试',
-                '运行测试验证修复',
+                '严格按 metadata.plan 执行 src8-1~8，禁止从 src8-4 跳起',
+                'src8-4 完成 rootCauseWorksheet 与 rootCauseAnalysis 后再改代码',
+                'src8-7 gentest 生成回归测试并验证',
                 ...(specGate
                     ? [`修复后调用 check_spec 校验 ${specGate.specDir}/，未通过先补规格再重跑`]
                     : []),
+                ...(memoryContext.enabled ? ['src8-8 或 memorize-bugfix 沉淀 bugfix 记忆'] : []),
             ],
-            rootCause: '待分析（需要调用 fix_bug 工具）',
-            fixPlan: '待制定（需要调用 fix_bug 工具）',
-            testPlan: '待生成（需要调用 gentest 工具）',
+            rootCause: '待分析（src8-4 rootCauseAnalysis）',
+            fixPlan: '待制定（src8-5）',
+            testPlan: '待定义（src8-3 验收契约 + src8-7 gentest）',
             affectedFiles: [],
             tbp: {
                 phenomenon: `待确认：${errorMessage}`,
@@ -725,7 +639,7 @@ ${graphContext.highlights.length > 0
                 repair: [
                     {
                         layer: 'analysis',
-                        action: '先完成 TBP 1-7 取证与真因闭合，再进入修复',
+                        action: '先按 metadata.plan 完成 src8-1~4 真因工作表闭合，再进入修复',
                         risk: '若直接改代码，容易补症状而非修真因',
                         verification: '检查真因是否能解释全部关键现象并排除竞争假设',
                     },