mcp-probe-kit 1.11.0 → 1.15.0

package/build/tools/ask_user.js

@@ -0,0 +1,124 @@
+/**
+ * ask_user - 向用户提问工具
+ * 当 AI 需要更多信息时，可以主动向用户提问
+ */
+import { parseArgs } from "../utils/parseArgs.js";
+export async function askUser(args) {
+    try {
+        // 解析参数
+        const parsed = parseArgs(args, {
+            primaryField: "question",
+            fieldAliases: {
+                question: ["q", "ask"],
+            },
+        });
+        const question = parsed.question;
+        const questions = parsed.questions;
+        const context = parsed.context;
+        const reason = parsed.reason;
+        if (!question && !questions) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `# ❓ 向用户提问工具
+
+## 使用方法
+
+### 单个问题
+\`\`\`
+ask_user "你希望支持哪些支付方式？"
+\`\`\`
+
+### 多个问题
+\`\`\`
+ask_user --questions [
+  "目标用户是谁？",
+  "预期的并发量是多少？",
+  "有预算限制吗？"
+]
+\`\`\`
+
+### 带上下文的问题
+\`\`\`
+ask_user "是否需要支持移动端？" --context "当前只有 PC 端实现"
+\`\`\`
+
+## 使用场景
+
+- 需求不明确时主动澄清
+- 技术方案选择需要用户决策
+- 发现潜在风险需要确认
+- 需要补充业务背景信息
+
+## 最佳实践
+
+1. **问题要具体** - 避免过于宽泛的问题
+2. **提供上下文** - 说明为什么要问这个问题
+3. **给出选项** - 如果有明确的选项，列出来
+4. **标注重要性** - 区分必答和可选问题`,
+                    },
+                ],
+            };
+        }
+        const lines = [];
+        lines.push("# ❓ AI 需要向你确认一些信息");
+        lines.push("");
+        if (reason) {
+            lines.push(`**提问原因**: ${reason}`);
+            lines.push("");
+        }
+        if (context) {
+            lines.push("## 背景信息");
+            lines.push("");
+            lines.push(context);
+            lines.push("");
+        }
+        lines.push("## 问题");
+        lines.push("");
+        if (questions && questions.length > 0) {
+            // 多个问题
+            for (let i = 0; i < questions.length; i++) {
+                const q = questions[i];
+                const required = q.required !== false ? "**[必答]**" : "_[可选]_";
+                lines.push(`### ${i + 1}. ${q.question} ${required}`);
+                lines.push("");
+                if (q.context) {
+                    lines.push(`_${q.context}_`);
+                    lines.push("");
+                }
+                if (q.options && q.options.length > 0) {
+                    lines.push("**可选项**:");
+                    for (const option of q.options) {
+                        lines.push(`- ${option}`);
+                    }
+                    lines.push("");
+                }
+                lines.push("**你的回答**: ");
+                lines.push("");
+                lines.push("---");
+                lines.push("");
+            }
+        }
+        else if (question) {
+            // 单个问题
+            lines.push(`**${question}**`);
+            lines.push("");
+            lines.push("**你的回答**: ");
+            lines.push("");
+        }
+        lines.push("---");
+        lines.push("");
+        lines.push("💡 **提示**: 请回答上述问题，我会根据你的回答继续工作。");
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 提问失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/index.d.ts

@@ -38,3 +38,10 @@ export { startOnboard } from "./start_onboard.js";
 export { startApi } from "./start_api.js";
 export { startDoc } from "./start_doc.js";
 export { genSkill } from "./gen_skill.js";
+export { startRalph } from "./start_ralph.js";
+export { interview } from "./interview.js";
+export { askUser } from "./ask_user.js";
+export { uiDesignSystem, uiSearch, syncUiData } from "./ui-ux-tools.js";
+export { initComponentCatalog } from "./init_component_catalog.js";
+export { renderUi } from "./render_ui.js";
+export { startUi } from "./start_ui.js";

package/build/tools/index.js

@@ -39,3 +39,12 @@ export { startOnboard } from "./start_onboard.js";
 export { startApi } from "./start_api.js";
 export { startDoc } from "./start_doc.js";
 export { genSkill } from "./gen_skill.js";
+export { startRalph } from "./start_ralph.js";
+// 访谈工具
+export { interview } from "./interview.js";
+export { askUser } from "./ask_user.js";
+// UI/UX Pro Max 工具
+export { uiDesignSystem, uiSearch, syncUiData } from "./ui-ux-tools.js";
+export { initComponentCatalog } from "./init_component_catalog.js";
+export { renderUi } from "./render_ui.js";
+export { startUi } from "./start_ui.js";

package/build/tools/init_component_catalog.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 初始化组件目录工具
+ *
+ * 基于设计系统规范生成组件目录
+ * 组件定义包含占位符，渲染时自动替换为实际值
+ */
+/**
+ * 初始化组件目录工具
+ */
+export declare function initComponentCatalog(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+}>;