mcp-probe-kit 1.10.0 → 1.11.0

package/build/schemas/index.js

@@ -0,0 +1,20 @@
+/**
+ * 所有工具 Schema 的统一导出
+ */
+import { basicToolSchemas } from "./basic-tools.js";
+import { gitToolSchemas } from "./git-tools.js";
+import { codeAnalysisToolSchemas } from "./code-analysis-tools.js";
+import { codeGenToolSchemas } from "./code-gen-tools.js";
+import { docUtilToolSchemas } from "./doc-util-tools.js";
+import { projectToolSchemas } from "./project-tools.js";
+import { orchestrationToolSchemas } from "./orchestration-tools.js";
+// 合并所有工具 schemas
+export const allToolSchemas = [
+    ...basicToolSchemas,
+    ...gitToolSchemas,
+    ...codeAnalysisToolSchemas,
+    ...codeGenToolSchemas,
+    ...docUtilToolSchemas,
+    ...projectToolSchemas,
+    ...orchestrationToolSchemas,
+];

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

@@ -0,0 +1,186 @@
+/**
+ * 智能编排工具的 Schema 定义
+ */
+export declare const orchestrationToolSchemas: readonly [{
+    readonly name: "start_feature";
+    readonly description: "当用户需要完整的新功能开发流程时使用。编排：检查上下文→生成规格→估算工作量。若只需规格文档请用 add_feature";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly feature_name: {
+                readonly type: "string";
+                readonly description: "功能名称（kebab-case 格式，如 user-auth）。可选，如果不提供会从 description 自动提取";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly description: "功能详细描述。可以是简短的自然语言（如'开发用户认证功能'）或详细的需求说明";
+            };
+            readonly docs_dir: {
+                readonly type: "string";
+                readonly description: "文档输出目录，默认为 docs";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "start_bugfix";
+    readonly description: "当用户需要完整的 Bug 修复流程时使用。编排：检查上下文→分析定位→修复方案→生成测试。若只需定位请用 debug";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly error_message: {
+                readonly type: "string";
+                readonly description: "错误信息";
+            };
+            readonly stack_trace: {
+                readonly type: "string";
+                readonly description: "堆栈跟踪。可选";
+            };
+            readonly code_context: {
+                readonly type: "string";
+                readonly description: "相关代码。可选";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "start_review";
+    readonly description: "当用户需要全面审查代码时使用。编排：代码审查+安全扫描+性能分析，输出综合报告。若只需单项请用对应工具";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly code: {
+                readonly type: "string";
+                readonly description: "要审查的代码";
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly description: "编程语言。可选，会自动识别";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "start_release";
+    readonly description: "当用户需要准备版本发布时使用。编排：生成 Changelog→生成 PR 描述。若只需单项请用 genchangelog 或 genpr";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly version: {
+                readonly type: "string";
+                readonly description: "版本号（如 v1.2.0）";
+            };
+            readonly from_tag: {
+                readonly type: "string";
+                readonly description: "起始 tag。可选";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "start_refactor";
+    readonly description: "当用户需要完整的代码重构流程时使用。编排：审查现状→重构建议→生成测试。若只需建议请用 refactor";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly code: {
+                readonly type: "string";
+                readonly description: "要重构的代码";
+            };
+            readonly goal: {
+                readonly type: "string";
+                readonly description: "重构目标。可选";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "start_onboard";
+    readonly description: "当用户需要快速上手新项目时使用。编排：分析项目→生成上下文文档。若只需分析请用 analyze_project";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly project_path: {
+                readonly type: "string";
+                readonly description: "项目路径。可选，默认当前目录";
+            };
+            readonly docs_dir: {
+                readonly type: "string";
+                readonly description: "文档目录。可选，默认 docs";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "start_api";
+    readonly description: "当用户需要完整的 API 开发流程时使用。编排：生成文档→生成 Mock→生成测试。若只需单项请用对应生成工具";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly code: {
+                readonly type: "string";
+                readonly description: "API 代码";
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly description: "编程语言。可选，会自动识别";
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly description: "文档格式。可选，默认 openapi";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "start_doc";
+    readonly description: "当用户需要补全项目文档时使用。编排：注释→README→API 文档。若只需单项文档请用对应生成工具";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly code: {
+                readonly type: "string";
+                readonly description: "代码或项目信息";
+            };
+            readonly project_info: {
+                readonly type: "string";
+                readonly description: "项目信息。可选";
+            };
+            readonly style: {
+                readonly type: "string";
+                readonly description: "文档风格。可选，默认 jsdoc";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "gen_skill";
+    readonly description: "当用户需要生成 Agent Skills 文档时使用。为 MCP Probe Kit 工具生成符合开放标准的技能文档，输出到 skills/ 目录";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly scope: {
+                readonly type: "string";
+                readonly description: "生成范围：all（所有工具）、single（单个工具）。可选，默认 all";
+            };
+            readonly tool_name: {
+                readonly type: "string";
+                readonly description: "工具名称。当 scope 为 single 时必填";
+            };
+            readonly lang: {
+                readonly type: "string";
+                readonly description: "文档语言：zh（中文）、en（英文）。可选，默认 zh";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}];

package/build/schemas/orchestration-tools.js

@@ -0,0 +1,196 @@
+/**
+ * 智能编排工具的 Schema 定义
+ */
+export const orchestrationToolSchemas = [
+    {
+        name: "start_feature",
+        description: "当用户需要完整的新功能开发流程时使用。编排：检查上下文→生成规格→估算工作量。若只需规格文档请用 add_feature",
+        inputSchema: {
+            type: "object",
+            properties: {
+                feature_name: {
+                    type: "string",
+                    description: "功能名称（kebab-case 格式，如 user-auth）。可选，如果不提供会从 description 自动提取",
+                },
+                description: {
+                    type: "string",
+                    description: "功能详细描述。可以是简短的自然语言（如'开发用户认证功能'）或详细的需求说明",
+                },
+                docs_dir: {
+                    type: "string",
+                    description: "文档输出目录，默认为 docs",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "start_bugfix",
+        description: "当用户需要完整的 Bug 修复流程时使用。编排：检查上下文→分析定位→修复方案→生成测试。若只需定位请用 debug",
+        inputSchema: {
+            type: "object",
+            properties: {
+                error_message: {
+                    type: "string",
+                    description: "错误信息",
+                },
+                stack_trace: {
+                    type: "string",
+                    description: "堆栈跟踪。可选",
+                },
+                code_context: {
+                    type: "string",
+                    description: "相关代码。可选",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "start_review",
+        description: "当用户需要全面审查代码时使用。编排：代码审查+安全扫描+性能分析，输出综合报告。若只需单项请用对应工具",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "要审查的代码",
+                },
+                language: {
+                    type: "string",
+                    description: "编程语言。可选，会自动识别",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "start_release",
+        description: "当用户需要准备版本发布时使用。编排：生成 Changelog→生成 PR 描述。若只需单项请用 genchangelog 或 genpr",
+        inputSchema: {
+            type: "object",
+            properties: {
+                version: {
+                    type: "string",
+                    description: "版本号（如 v1.2.0）",
+                },
+                from_tag: {
+                    type: "string",
+                    description: "起始 tag。可选",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "start_refactor",
+        description: "当用户需要完整的代码重构流程时使用。编排：审查现状→重构建议→生成测试。若只需建议请用 refactor",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "要重构的代码",
+                },
+                goal: {
+                    type: "string",
+                    description: "重构目标。可选",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "start_onboard",
+        description: "当用户需要快速上手新项目时使用。编排：分析项目→生成上下文文档。若只需分析请用 analyze_project",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_path: {
+                    type: "string",
+                    description: "项目路径。可选，默认当前目录",
+                },
+                docs_dir: {
+                    type: "string",
+                    description: "文档目录。可选，默认 docs",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "start_api",
+        description: "当用户需要完整的 API 开发流程时使用。编排：生成文档→生成 Mock→生成测试。若只需单项请用对应生成工具",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "API 代码",
+                },
+                language: {
+                    type: "string",
+                    description: "编程语言。可选，会自动识别",
+                },
+                format: {
+                    type: "string",
+                    description: "文档格式。可选，默认 openapi",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "start_doc",
+        description: "当用户需要补全项目文档时使用。编排：注释→README→API 文档。若只需单项文档请用对应生成工具",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "代码或项目信息",
+                },
+                project_info: {
+                    type: "string",
+                    description: "项目信息。可选",
+                },
+                style: {
+                    type: "string",
+                    description: "文档风格。可选，默认 jsdoc",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "gen_skill",
+        description: "当用户需要生成 Agent Skills 文档时使用。为 MCP Probe Kit 工具生成符合开放标准的技能文档，输出到 skills/ 目录",
+        inputSchema: {
+            type: "object",
+            properties: {
+                scope: {
+                    type: "string",
+                    description: "生成范围：all（所有工具）、single（单个工具）。可选，默认 all",
+                },
+                tool_name: {
+                    type: "string",
+                    description: "工具名称。当 scope 为 single 时必填",
+                },
+                lang: {
+                    type: "string",
+                    description: "文档语言：zh（中文）、en（英文）。可选，默认 zh",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+];

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

@@ -0,0 +1,84 @@
+/**
+ * 项目管理工具的 Schema 定义
+ */
+export declare const projectToolSchemas: readonly [{
+    readonly name: "analyze_project";
+    readonly description: "当用户需要了解项目结构、分析项目技术栈时使用。分析项目结构、技术栈、架构模式，输出项目全景报告";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly project_path: {
+                readonly type: "string";
+                readonly description: "项目路径。可选，默认为当前目录";
+            };
+            readonly max_depth: {
+                readonly type: "number";
+                readonly description: "分析深度。可选，默认 5";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "init_project_context";
+    readonly description: "当用户需要生成项目上下文文档、帮助团队快速上手时使用。生成项目上下文文档（技术栈/架构/编码规范），供后续开发参考";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly docs_dir: {
+                readonly type: "string";
+                readonly description: "文档目录。可选，默认 docs";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "add_feature";
+    readonly description: "当用户需要添加新功能、生成功能规格文档时使用。生成新功能规格文档（需求/设计/任务清单），基于项目上下文";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly feature_name: {
+                readonly type: "string";
+                readonly description: "功能名称（kebab-case 格式，如 user-auth）。可选，如果不提供会从 description 自动提取";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly description: "功能详细描述。可以是简短的自然语言（如'添加用户认证功能'）或详细的需求说明";
+            };
+            readonly docs_dir: {
+                readonly type: "string";
+                readonly description: "文档输出目录，默认为 docs";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}, {
+    readonly name: "estimate";
+    readonly description: "当用户需要估算开发工作量、评估任务时间时使用。估算开发工作量，输出故事点、时间范围（乐观/正常/悲观）、风险点";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly task_description: {
+                readonly type: "string";
+                readonly description: "任务描述。可以是简短的自然语言（如'估算开发工作量'）或详细的任务说明";
+            };
+            readonly code_context: {
+                readonly type: "string";
+                readonly description: "相关代码或文件上下文。可选，有助于更准确的估算";
+            };
+            readonly team_size: {
+                readonly type: "number";
+                readonly description: "团队规模（人数）。可选，默认为 1";
+            };
+            readonly experience_level: {
+                readonly type: "string";
+                readonly description: "经验水平：junior（初级）、mid（中级）、senior（高级）。可选，默认为 mid";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
+}];

package/build/schemas/project-tools.js

@@ -0,0 +1,89 @@
+/**
+ * 项目管理工具的 Schema 定义
+ */
+export const projectToolSchemas = [
+    {
+        name: "analyze_project",
+        description: "当用户需要了解项目结构、分析项目技术栈时使用。分析项目结构、技术栈、架构模式，输出项目全景报告",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_path: {
+                    type: "string",
+                    description: "项目路径。可选，默认为当前目录",
+                },
+                max_depth: {
+                    type: "number",
+                    description: "分析深度。可选，默认 5",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "init_project_context",
+        description: "当用户需要生成项目上下文文档、帮助团队快速上手时使用。生成项目上下文文档（技术栈/架构/编码规范），供后续开发参考",
+        inputSchema: {
+            type: "object",
+            properties: {
+                docs_dir: {
+                    type: "string",
+                    description: "文档目录。可选，默认 docs",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "add_feature",
+        description: "当用户需要添加新功能、生成功能规格文档时使用。生成新功能规格文档（需求/设计/任务清单），基于项目上下文",
+        inputSchema: {
+            type: "object",
+            properties: {
+                feature_name: {
+                    type: "string",
+                    description: "功能名称（kebab-case 格式，如 user-auth）。可选，如果不提供会从 description 自动提取",
+                },
+                description: {
+                    type: "string",
+                    description: "功能详细描述。可以是简短的自然语言（如'添加用户认证功能'）或详细的需求说明",
+                },
+                docs_dir: {
+                    type: "string",
+                    description: "文档输出目录，默认为 docs",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "estimate",
+        description: "当用户需要估算开发工作量、评估任务时间时使用。估算开发工作量，输出故事点、时间范围（乐观/正常/悲观）、风险点",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_description: {
+                    type: "string",
+                    description: "任务描述。可以是简短的自然语言（如'估算开发工作量'）或详细的任务说明",
+                },
+                code_context: {
+                    type: "string",
+                    description: "相关代码或文件上下文。可选，有助于更准确的估算",
+                },
+                team_size: {
+                    type: "number",
+                    description: "团队规模（人数）。可选，默认为 1",
+                },
+                experience_level: {
+                    type: "string",
+                    description: "经验水平：junior（初级）、mid（中级）、senior（高级）。可选，默认为 mid",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+];

package/build/tools/add_feature.js

@@ -1,4 +1,4 @@
-import { parseArgs, getString, validateRequired } from "../utils/parseArgs.js";
+import { parseArgs, getString } from "../utils/parseArgs.js";
 /**
  * add_feature 工具
  *
@@ -12,6 +12,46 @@ import { parseArgs, getString, validateRequired } from "../utils/parseArgs.js";
  */
 // 默认文档目录
 const DEFAULT_DOCS_DIR = "docs";
+/**
+ * 从自然语言输入中提取功能名和描述
+ * @param input - 自然语言输入
+ * @returns 提取的功能名和描述
+ */
+function extractFeatureInfo(input) {
+    // 移除常见的引导词
+    let text = input
+        .replace(/^(添加|实现|开发|创建|新增|生成|构建|做|要|想要|需要|帮我|请|麻烦)/i, "")
+        .trim();
+    // 移除结尾的"功能"、"模块"等词
+    text = text.replace(/(功能|模块|特性|组件|系统|服务)$/i, "").trim();
+    // 如果文本很短（少于20个字符），直接作为功能名
+    if (text.length < 20) {
+        const name = text
+            .toLowerCase()
+            .replace(/[\s\u4e00-\u9fa5]+/g, "-") // 将空格和中文替换为连字符
+            .replace(/[^a-z0-9-]/g, "") // 移除非字母数字和连字符
+            .replace(/-+/g, "-") // 合并多个连字符
+            .replace(/^-|-$/g, ""); // 移除首尾连字符
+        return {
+            name: name || "new-feature",
+            description: input,
+        };
+    }
+    // 如果文本较长，尝试提取关键词作为功能名
+    // 提取前几个关键词
+    const words = text.split(/[\s,，、]+/).filter(w => w.length > 0);
+    const keyWords = words.slice(0, 3).join(" ");
+    const name = keyWords
+        .toLowerCase()
+        .replace(/[\s\u4e00-\u9fa5]+/g, "-")
+        .replace(/[^a-z0-9-]/g, "")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    return {
+        name: name || "new-feature",
+        description: input,
+    };
+}
 // 提示词模板
 const PROMPT_TEMPLATE = `# 添加新功能指南
 
@@ -431,18 +471,41 @@ export async function addFeature(args) {
                 description: "",
                 docs_dir: DEFAULT_DOCS_DIR,
             },
-            primaryField: "description", // 纯文本输入默认映射到 description 字段
+            primaryField: "input", // 纯文本输入默认映射到 input 字段
             fieldAliases: {
                 feature_name: ["name", "feature", "功能名", "功能名称"],
                 description: ["desc", "requirement", "描述", "需求"],
                 docs_dir: ["dir", "output", "目录", "文档目录"],
             },
         });
-        const featureName = getString(parsedArgs.feature_name);
-        const description = getString(parsedArgs.description);
+        let featureName = getString(parsedArgs.feature_name);
+        let description = getString(parsedArgs.description);
         const docsDir = getString(parsedArgs.docs_dir) || DEFAULT_DOCS_DIR;
+        // 如果是纯自然语言输入（input 字段有值但 feature_name 和 description 为空）
+        const input = getString(parsedArgs.input);
+        if (input && !featureName && !description) {
+            // 智能提取功能名和描述
+            // 尝试从自然语言中提取功能名（通常是关键词）
+            const extracted = extractFeatureInfo(input);
+            featureName = extracted.name;
+            description = extracted.description;
+        }
+        // 如果只有 description 没有 feature_name，尝试从 description 提取
+        if (!featureName && description) {
+            const extracted = extractFeatureInfo(description);
+            featureName = extracted.name;
+            if (!description || description === featureName) {
+                description = extracted.description;
+            }
+        }
         // 验证必填参数
-        validateRequired(parsedArgs, ["feature_name", "description"]);
+        if (!featureName || !description) {
+            throw new Error("请提供功能名称和描述。\n\n" +
+                "示例用法：\n" +
+                "- 自然语言：'添加用户认证功能'\n" +
+                "- 详细描述：'实现用户登录、注册和密码重置功能'\n" +
+                "- JSON格式：{\"feature_name\": \"user-auth\", \"description\": \"用户认证功能\"}");
+        }
         // 构建指南文本（替换占位符）
         const guide = PROMPT_TEMPLATE
             .replace(/{feature_name}/g, featureName)