mcp-probe-kit 1.10.1 → 1.11.0

package/build/tools/start_feature.js

@@ -5,6 +5,46 @@ import { parseArgs, getString } from "../utils/parseArgs.js";
  * 场景：开发新功能
  * 编排：[检查上下文] → add_feature → estimate
  */
+/**
+ * 从自然语言输入中提取功能名和描述
+ * @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 = `# 🚀 新功能开发编排指南
 
 ## 🎯 目标
@@ -103,21 +143,38 @@ export async function startFeature(args) {
                 description: "",
                 docs_dir: "docs",
             },
-            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) || "docs";
-        if (!featureName) {
-            throw new Error("缺少必填参数: feature_name（功能名称）");
+        // 如果是纯自然语言输入（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;
+            }
         }
-        if (!description) {
-            throw new Error("缺少必填参数: 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)

package/build/utils/parseArgs.js

@@ -44,7 +44,18 @@ export function parseArgs(args, config = {}) {
     }
     // 3. 处理对象类型 - 标准 JSON 对象
     else if (typeof args === "object" && !Array.isArray(args)) {
-        parsedArgs = normalizeObjectKeys(args, fieldAliases);
+        // 3.1 检查是否有嵌套的 input 字段（MCP 常见格式）
+        // 例如: {"input": {"feature_name": "...", "description": "..."}}
+        if (args.input && typeof args.input === "object" && !Array.isArray(args.input)) {
+            // 展平嵌套结构，优先使用 input 内的字段
+            parsedArgs = { ...args, ...args.input };
+            delete parsedArgs.input; // 移除 input 字段避免冲突
+        }
+        else {
+            parsedArgs = args;
+        }
+        // 3.2 规范化字段名（处理别名）
+        parsedArgs = normalizeObjectKeys(parsedArgs, fieldAliases);
     }
     // 4. 其他类型
     else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "AI Development Enhancement Toolkit - MCP Server with 40 practical tools (32 basic + 8 orchestration) for code quality, development efficiency, and project management",
   "type": "module",
   "main": "build/index.js",