mcp-probe-kit 3.0.9 → 3.0.11

package/build/schemas/code-analysis-tools.d.ts

@@ -41,6 +41,10 @@ export declare const codeAnalysisToolSchemas: readonly [{
                 readonly type: "string";
                 readonly description: "仓库名称（多仓库场景可选）";
             };
+            readonly project_root: {
+                readonly type: "string";
+                readonly description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定";
+            };
             readonly goal: {
                 readonly type: "string";
                 readonly description: "分析目标（可选）";
@@ -85,7 +89,7 @@ export declare const codeAnalysisToolSchemas: readonly [{
     };
 }, {
     readonly name: "fix_bug";
-    readonly description: "当用户需要修复 Bug、获取修复指导时使用。提供 Bug 修复流程指导，包含根因分析、修复方案、验证步骤";
+    readonly description: "当用户需要找问题、修 bug、排查异常、定位回归、分析失败原因、分析为什么没生效、先分析再修时使用。默认采用 TBP 8 步法做真因分析，并输出修复方案与验证步骤";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -101,6 +105,10 @@ export declare const codeAnalysisToolSchemas: readonly [{
                 readonly type: "string";
                 readonly description: "相关代码。可选";
             };
+            readonly analysis_mode: {
+                readonly type: "string";
+                readonly description: "分析方法。默认 tbp8（丰田问题分析 8 步法）";
+            };
         };
         readonly required: readonly [];
         readonly additionalProperties: true;

package/build/schemas/code-analysis-tools.js

@@ -43,6 +43,10 @@ export const codeAnalysisToolSchemas = [
                     type: "string",
                     description: "仓库名称（多仓库场景可选）",
                 },
+                project_root: {
+                    type: "string",
+                    description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定",
+                },
                 goal: {
                     type: "string",
                     description: "分析目标（可选）",
@@ -89,7 +93,7 @@ export const codeAnalysisToolSchemas = [
     },
     {
         name: "fix_bug",
-        description: "当用户需要修复 Bug、获取修复指导时使用。提供 Bug 修复流程指导，包含根因分析、修复方案、验证步骤",
+        description: "当用户需要找问题、修 bug、排查异常、定位回归、分析失败原因、分析为什么没生效、先分析再修时使用。默认采用 TBP 8 步法做真因分析，并输出修复方案与验证步骤",
         inputSchema: {
             type: "object",
             properties: {
@@ -105,6 +109,10 @@ export const codeAnalysisToolSchemas = [
                     type: "string",
                     description: "相关代码。可选",
                 },
+                analysis_mode: {
+                    type: "string",
+                    description: "分析方法。默认 tbp8（丰田问题分析 8 步法）",
+                },
             },
             required: [],
             additionalProperties: true,

package/build/schemas/git-tools.d.ts

@@ -3,7 +3,7 @@
  */
 export declare const gitToolSchemas: readonly [{
     readonly name: "gencommit";
-    readonly description: "当用户需要生成 Git commit 消息时使用。返回 Conventional Commits 规范指南，AI 根据指南和变更内容生成符合规范的提交消息";
+    readonly description: "当用户需要生成 Git commit 消息时使用。返回 Conventional Commits 规范说明、步骤、输出模板和示例，供 AI 根据变更内容生成最终 commit message。它不直接代写最终消息，也不应被判定为空结果";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/build/schemas/git-tools.js

@@ -4,7 +4,7 @@
 export const gitToolSchemas = [
     {
         name: "gencommit",
-        description: "当用户需要生成 Git commit 消息时使用。返回 Conventional Commits 规范指南，AI 根据指南和变更内容生成符合规范的提交消息",
+        description: "当用户需要生成 Git commit 消息时使用。返回 Conventional Commits 规范说明、步骤、输出模板和示例，供 AI 根据变更内容生成最终 commit message。它不直接代写最终消息，也不应被判定为空结果",
         inputSchema: {
             type: "object",
             properties: {

package/build/schemas/index.d.ts

@@ -21,7 +21,7 @@ export declare const allToolSchemas: ({
     };
 } | {
     readonly name: "gencommit";
-    readonly description: "当用户需要生成 Git commit 消息时使用。返回 Conventional Commits 规范指南，AI 根据指南和变更内容生成符合规范的提交消息";
+    readonly description: "当用户需要生成 Git commit 消息时使用。返回 Conventional Commits 规范说明、步骤、输出模板和示例，供 AI 根据变更内容生成最终 commit message。它不直接代写最终消息，也不应被判定为空结果";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -103,6 +103,10 @@ export declare const allToolSchemas: ({
                 readonly type: "string";
                 readonly description: "仓库名称（多仓库场景可选）";
             };
+            readonly project_root: {
+                readonly type: "string";
+                readonly description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定";
+            };
             readonly goal: {
                 readonly type: "string";
                 readonly description: "分析目标（可选）";
@@ -147,7 +151,7 @@ export declare const allToolSchemas: ({
     };
 } | {
     readonly name: "fix_bug";
-    readonly description: "当用户需要修复 Bug、获取修复指导时使用。提供 Bug 修复流程指导，包含根因分析、修复方案、验证步骤";
+    readonly description: "当用户需要找问题、修 bug、排查异常、定位回归、分析失败原因、分析为什么没生效、先分析再修时使用。默认采用 TBP 8 步法做真因分析，并输出修复方案与验证步骤";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -163,6 +167,10 @@ export declare const allToolSchemas: ({
                 readonly type: "string";
                 readonly description: "相关代码。可选";
             };
+            readonly analysis_mode: {
+                readonly type: "string";
+                readonly description: "分析方法。默认 tbp8（丰田问题分析 8 步法）";
+            };
         };
         readonly required: readonly [];
         readonly additionalProperties: true;
@@ -269,6 +277,10 @@ export declare const allToolSchemas: ({
                 readonly type: "string";
                 readonly description: "文档输出目录，默认为 docs";
             };
+            readonly project_root: {
+                readonly type: "string";
+                readonly description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定";
+            };
             readonly template_profile: {
                 readonly type: "string";
                 readonly description: "模板档位：auto（默认，自动选择 guided/strict）、guided（普通模型友好）或 strict（结构更紧凑）";
@@ -295,7 +307,7 @@ export declare const allToolSchemas: ({
     };
 } | {
     readonly name: "start_bugfix";
-    readonly description: "当用户需要完整的 Bug 修复流程时使用。编排：检查上下文→分析定位→修复方案→生成测试。";
+    readonly description: "当用户需要找问题、修 bug、排查异常、定位回归、分析失败原因、分析为什么没生效、先分析再修时使用。默认按 TBP 8 步法编排：取证澄清→分析定位→修复方案→生成测试。";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -311,6 +323,14 @@ export declare const allToolSchemas: ({
                 readonly type: "string";
                 readonly description: "相关代码。可选";
             };
+            readonly project_root: {
+                readonly type: "string";
+                readonly description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定";
+            };
+            readonly analysis_mode: {
+                readonly type: "string";
+                readonly description: "分析方法。默认 tbp8（丰田问题分析 8 步法）";
+            };
             readonly template_profile: {
                 readonly type: "string";
                 readonly description: "模板档位：auto（默认，自动选择 guided/strict）、guided（普通模型友好）或 strict（结构更紧凑）";

package/build/schemas/orchestration-tools.d.ts

@@ -19,6 +19,10 @@ export declare const orchestrationToolSchemas: readonly [{
                 readonly type: "string";
                 readonly description: "文档输出目录，默认为 docs";
             };
+            readonly project_root: {
+                readonly type: "string";
+                readonly description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定";
+            };
             readonly template_profile: {
                 readonly type: "string";
                 readonly description: "模板档位：auto（默认，自动选择 guided/strict）、guided（普通模型友好）或 strict（结构更紧凑）";
@@ -45,7 +49,7 @@ export declare const orchestrationToolSchemas: readonly [{
     };
 }, {
     readonly name: "start_bugfix";
-    readonly description: "当用户需要完整的 Bug 修复流程时使用。编排：检查上下文→分析定位→修复方案→生成测试。";
+    readonly description: "当用户需要找问题、修 bug、排查异常、定位回归、分析失败原因、分析为什么没生效、先分析再修时使用。默认按 TBP 8 步法编排：取证澄清→分析定位→修复方案→生成测试。";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -61,6 +65,14 @@ export declare const orchestrationToolSchemas: readonly [{
                 readonly type: "string";
                 readonly description: "相关代码。可选";
             };
+            readonly project_root: {
+                readonly type: "string";
+                readonly description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定";
+            };
+            readonly analysis_mode: {
+                readonly type: "string";
+                readonly description: "分析方法。默认 tbp8（丰田问题分析 8 步法）";
+            };
             readonly template_profile: {
                 readonly type: "string";
                 readonly description: "模板档位：auto（默认，自动选择 guided/strict）、guided（普通模型友好）或 strict（结构更紧凑）";

package/build/schemas/orchestration-tools.js

@@ -20,6 +20,10 @@ export const orchestrationToolSchemas = [
                     type: "string",
                     description: "文档输出目录，默认为 docs",
                 },
+                project_root: {
+                    type: "string",
+                    description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定",
+                },
                 template_profile: {
                     type: "string",
                     description: "模板档位：auto（默认，自动选择 guided/strict）、guided（普通模型友好）或 strict（结构更紧凑）",
@@ -47,7 +51,7 @@ export const orchestrationToolSchemas = [
     },
     {
         name: "start_bugfix",
-        description: "当用户需要完整的 Bug 修复流程时使用。编排：检查上下文→分析定位→修复方案→生成测试。",
+        description: "当用户需要找问题、修 bug、排查异常、定位回归、分析失败原因、分析为什么没生效、先分析再修时使用。默认按 TBP 8 步法编排：取证澄清→分析定位→修复方案→生成测试。",
         inputSchema: {
             type: "object",
             properties: {
@@ -63,6 +67,14 @@ export const orchestrationToolSchemas = [
                     type: "string",
                     description: "相关代码。可选",
                 },
+                project_root: {
+                    type: "string",
+                    description: "项目根目录。当前客户端未把工作区作为进程 cwd 传进来时，建议显式指定",
+                },
+                analysis_mode: {
+                    type: "string",
+                    description: "分析方法。默认 tbp8（丰田问题分析 8 步法）",
+                },
                 template_profile: {
                     type: "string",
                     description: "模板档位：auto（默认，自动选择 guided/strict）、guided（普通模型友好）或 strict（结构更紧凑）",

package/build/schemas/output/core-tools.d.ts

@@ -110,6 +110,10 @@ export declare const BugAnalysisSchema: {
             readonly type: "string";
             readonly enum: readonly ["critical", "high", "medium", "low"];
         };
+        readonly analysisMode: {
+            readonly type: "string";
+            readonly enum: readonly ["tbp8"];
+        };
         readonly rootCause: {
             readonly type: "string";
         };
@@ -175,8 +179,109 @@ export declare const BugAnalysisSchema: {
                 readonly type: "string";
             };
         };
+        readonly tbp: {
+            readonly description: "TBP 8 步法分析结果";
+            readonly type: "object";
+            readonly properties: {
+                readonly phenomenon: {
+                    readonly type: "string";
+                    readonly description: "TBP-1 现象";
+                };
+                readonly timeline: {
+                    readonly type: "array";
+                    readonly description: "TBP-2 时间线";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly order: {
+                                readonly type: "number";
+                                readonly description: "时间线顺序";
+                            };
+                            readonly event: {
+                                readonly type: "string";
+                                readonly description: "事件描述";
+                            };
+                            readonly evidence: {
+                                readonly type: "string";
+                                readonly description: "对应证据";
+                            };
+                        };
+                        readonly required: readonly ["order", "event"];
+                    };
+                };
+                readonly ruledOut: {
+                    readonly type: "array";
+                    readonly description: "TBP-3 已排除方向";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly commonPattern: {
+                    readonly type: "string";
+                    readonly description: "TBP-4 共同模式";
+                };
+                readonly boundary: {
+                    readonly type: "string";
+                    readonly description: "TBP-5 问题边界";
+                };
+                readonly rootCauseStatement: {
+                    readonly type: "string";
+                    readonly description: "TBP-6 真因因果句";
+                };
+                readonly evidence: {
+                    readonly type: "array";
+                    readonly description: "TBP-7 证据链";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly type: {
+                                readonly type: "string";
+                                readonly enum: readonly ["symptom", "timeline", "stack", "code", "comparison", "environment", "graph"];
+                                readonly description: "证据类型";
+                            };
+                            readonly detail: {
+                                readonly type: "string";
+                                readonly description: "证据内容";
+                            };
+                            readonly source: {
+                                readonly type: "string";
+                                readonly description: "证据来源";
+                            };
+                        };
+                        readonly required: readonly ["type", "detail"];
+                    };
+                };
+                readonly repair: {
+                    readonly type: "array";
+                    readonly description: "TBP-8 修复设计";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly layer: {
+                                readonly type: "string";
+                                readonly description: "修复层";
+                            };
+                            readonly action: {
+                                readonly type: "string";
+                                readonly description: "修复动作";
+                            };
+                            readonly risk: {
+                                readonly type: "string";
+                                readonly description: "潜在风险";
+                            };
+                            readonly verification: {
+                                readonly type: "string";
+                                readonly description: "验证方法";
+                            };
+                        };
+                        readonly required: readonly ["layer", "action", "verification"];
+                    };
+                };
+            };
+            readonly required: readonly ["phenomenon", "timeline", "ruledOut", "commonPattern", "boundary", "rootCauseStatement", "evidence", "repair"];
+        };
     };
-    readonly required: readonly ["summary", "bugType", "severity", "rootCause", "fixPlan", "testPlan"];
+    readonly required: readonly ["summary", "bugType", "severity", "analysisMode", "rootCause", "fixPlan", "testPlan", "tbp"];
 };
 /**
  * Test Suite Schema
@@ -580,6 +685,7 @@ export interface BugAnalysis {
     summary: string;
     bugType: 'functional' | 'performance' | 'security' | 'ui' | 'data' | 'integration';
     severity: 'critical' | 'high' | 'medium' | 'low';
+    analysisMode: 'tbp8';
     rootCause: string;
     affectedComponents?: string[];
     affectedFiles?: string[];
@@ -594,6 +700,29 @@ export interface BugAnalysis {
         manualTests?: string[];
     };
     preventionMeasures?: string[];
+    tbp: {
+        phenomenon: string;
+        timeline: Array<{
+            order: number;
+            event: string;
+            evidence?: string;
+        }>;
+        ruledOut: string[];
+        commonPattern: string;
+        boundary: string;
+        rootCauseStatement: string;
+        evidence: Array<{
+            type: 'symptom' | 'timeline' | 'stack' | 'code' | 'comparison' | 'environment' | 'graph';
+            detail: string;
+            source?: string;
+        }>;
+        repair: Array<{
+            layer: string;
+            action: string;
+            risk?: string;
+            verification: string;
+        }>;
+    };
 }
 export interface TestSuite {
     summary: string;

package/build/schemas/output/core-tools.js

@@ -66,6 +66,68 @@ export const CodeReviewReportSchema = {
     },
     required: ['summary', 'overallScore', 'issues'],
 };
+const TbpTimelineEventSchema = {
+    type: 'object',
+    properties: {
+        order: { type: 'number', description: '时间线顺序' },
+        event: { type: 'string', description: '事件描述' },
+        evidence: { type: 'string', description: '对应证据' },
+    },
+    required: ['order', 'event'],
+};
+const TbpEvidenceItemSchema = {
+    type: 'object',
+    properties: {
+        type: {
+            type: 'string',
+            enum: ['symptom', 'timeline', 'stack', 'code', 'comparison', 'environment', 'graph'],
+            description: '证据类型',
+        },
+        detail: { type: 'string', description: '证据内容' },
+        source: { type: 'string', description: '证据来源' },
+    },
+    required: ['type', 'detail'],
+};
+const TbpRepairItemSchema = {
+    type: 'object',
+    properties: {
+        layer: { type: 'string', description: '修复层' },
+        action: { type: 'string', description: '修复动作' },
+        risk: { type: 'string', description: '潜在风险' },
+        verification: { type: 'string', description: '验证方法' },
+    },
+    required: ['layer', 'action', 'verification'],
+};
+const TbpAnalysisSchema = {
+    type: 'object',
+    properties: {
+        phenomenon: { type: 'string', description: 'TBP-1 现象' },
+        timeline: {
+            type: 'array',
+            description: 'TBP-2 时间线',
+            items: TbpTimelineEventSchema,
+        },
+        ruledOut: {
+            type: 'array',
+            description: 'TBP-3 已排除方向',
+            items: { type: 'string' },
+        },
+        commonPattern: { type: 'string', description: 'TBP-4 共同模式' },
+        boundary: { type: 'string', description: 'TBP-5 问题边界' },
+        rootCauseStatement: { type: 'string', description: 'TBP-6 真因因果句' },
+        evidence: {
+            type: 'array',
+            description: 'TBP-7 证据链',
+            items: TbpEvidenceItemSchema,
+        },
+        repair: {
+            type: 'array',
+            description: 'TBP-8 修复设计',
+            items: TbpRepairItemSchema,
+        },
+    },
+    required: ['phenomenon', 'timeline', 'ruledOut', 'commonPattern', 'boundary', 'rootCauseStatement', 'evidence', 'repair'],
+};
 /**
  * Bug Analysis Schema
  * 用于 fix_bug 工具的结构化输出
@@ -82,6 +144,10 @@ export const BugAnalysisSchema = {
             type: 'string',
             enum: ['critical', 'high', 'medium', 'low'],
         },
+        analysisMode: {
+            type: 'string',
+            enum: ['tbp8'],
+        },
         rootCause: { type: 'string' },
         affectedComponents: {
             type: 'array',
@@ -112,8 +178,12 @@ export const BugAnalysisSchema = {
             type: 'array',
             items: { type: 'string' },
         },
+        tbp: {
+            ...TbpAnalysisSchema,
+            description: 'TBP 8 步法分析结果',
+        },
     },
-    required: ['summary', 'bugType', 'severity', 'rootCause', 'fixPlan', 'testPlan'],
+    required: ['summary', 'bugType', 'severity', 'analysisMode', 'rootCause', 'fixPlan', 'testPlan', 'tbp'],
 };
 /**
  * Test Suite Schema

package/build/schemas/output/index.d.ts

@@ -8,7 +8,7 @@ export * from './project-tools.js';
 export * from './ui-ux-tools.js';
 export * from './product-design-tools.js';
 export * from './helper-tools.js';
-export { CommitMessageSchema, WorkflowReportSchema, BugFixReportSchema, FeatureReportSchema, UIReportSchema, OnboardingReportSchema, RalphLoopReportSchema, RequirementsLoopSchema, CommitMessage, WorkflowStep, Artifact, WorkflowReport, BugFixReport, FeatureReport, UIReport, OnboardingReport, RalphLoopReport, RequirementsLoopReport, } from '../structured-output.js';
+export { CommitMessageSchema, CommitGuidanceSchema, WorkflowReportSchema, BugFixReportSchema, FeatureReportSchema, UIReportSchema, OnboardingReportSchema, RalphLoopReportSchema, RequirementsLoopSchema, CommitMessage, CommitGuidance, WorkflowStep, Artifact, WorkflowReport, BugFixReport, FeatureReport, UIReport, OnboardingReport, RalphLoopReport, RequirementsLoopReport, } from '../structured-output.js';
 /**
  * Schema 映射表 (v3.0 - 20 个工具)
  * 工具名称 -> Schema 对象
@@ -20,7 +20,7 @@ export declare const SCHEMA_MAP: {
     readonly start_ui: "UIReportSchema";
     readonly start_product: "WorkflowReportSchema";
     readonly start_ralph: "RalphLoopReportSchema";
-    readonly gencommit: "CommitMessageSchema";
+    readonly gencommit: "CommitGuidanceSchema";
     readonly code_review: "CodeReviewReportSchema";
     readonly gentest: "TestSuiteSchema";
     readonly refactor: "RefactorPlanSchema";

package/build/schemas/output/index.js

@@ -15,7 +15,7 @@ export * from './product-design-tools.js';
 // 辅助工具
 export * from './helper-tools.js';
 // 从主 Schema 文件导出基础 Schema（P0 工具）
-export { CommitMessageSchema, WorkflowReportSchema, BugFixReportSchema, FeatureReportSchema, UIReportSchema, OnboardingReportSchema, RalphLoopReportSchema, RequirementsLoopSchema, } from '../structured-output.js';
+export { CommitMessageSchema, CommitGuidanceSchema, WorkflowReportSchema, BugFixReportSchema, FeatureReportSchema, UIReportSchema, OnboardingReportSchema, RalphLoopReportSchema, RequirementsLoopSchema, } from '../structured-output.js';
 /**
  * Schema 映射表 (v3.0 - 20 个工具)
  * 工具名称 -> Schema 对象
@@ -29,7 +29,7 @@ export const SCHEMA_MAP = {
     start_product: 'WorkflowReportSchema',
     start_ralph: 'RalphLoopReportSchema',
     // 日常工具（9 个）
-    gencommit: 'CommitMessageSchema',
+    gencommit: 'CommitGuidanceSchema',
     code_review: 'CodeReviewReportSchema',
     gentest: 'TestSuiteSchema',
     refactor: 'RefactorPlanSchema',

package/build/schemas/output/project-tools.d.ts

@@ -135,6 +135,17 @@ export declare const ProjectContextSchema: {
                 };
             };
         };
+        readonly nextSteps: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly description: "额外元数据（如 delegated plan、图谱文档路径）";
+            readonly additionalProperties: true;
+        };
     };
     readonly required: readonly ["summary", "projectOverview"];
 };
@@ -421,6 +432,8 @@ export interface ProjectContext {
         path?: string;
         purpose?: string;
     }>;
+    nextSteps?: string[];
+    metadata?: Record<string, any>;
 }
 export interface FeatureSpec {
     summary: string;

package/build/schemas/output/project-tools.js

@@ -85,6 +85,15 @@ export const ProjectContextSchema = {
                 },
             },
         },
+        nextSteps: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+        metadata: {
+            type: 'object',
+            description: '额外元数据（如 delegated plan、图谱文档路径）',
+            additionalProperties: true,
+        },
     },
     required: ['summary', 'projectOverview'],
 };