mcp-probe-kit 1.11.0 → 1.15.0

package/build/schemas/interview-tools.js

@@ -0,0 +1,64 @@
+/**
+ * 访谈工具的 Schema 定义
+ */
+export const interviewToolSchemas = [
+    {
+        name: "interview",
+        description: "当用户需求不明确、需要澄清需求时使用。需求访谈工具，在开发前通过结构化提问澄清需求，避免理解偏差和返工；生成访谈记录文件供后续 start_feature/add_feature 使用；仅支持 feature 类型",
+        inputSchema: {
+            type: "object",
+            properties: {
+                description: {
+                    type: "string",
+                    description: "功能描述（如'实现用户登录功能'），用于开始访谈。可以是简短的自然语言描述",
+                },
+                feature_name: {
+                    type: "string",
+                    description: "功能名称（kebab-case 格式，如 user-login）。可选，会自动从描述中提取",
+                },
+                answers: {
+                    type: "object",
+                    description: "访谈问题的回答（JSON 对象，key 为问题 ID，value 为回答内容）。用于提交访谈结果",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+    {
+        name: "ask_user",
+        description: "当 AI 需要更多信息、遇到不确定因素时使用。向用户提问工具，AI 可主动向用户提问；支持单个或多个问题、提供选项、标注重要性；可在任何时候使用",
+        inputSchema: {
+            type: "object",
+            properties: {
+                question: {
+                    type: "string",
+                    description: "单个问题（如'你希望支持哪些支付方式？'）",
+                },
+                questions: {
+                    type: "array",
+                    description: "多个问题列表，每个问题可包含 question、context、options、required 字段",
+                    items: {
+                        type: "object",
+                        properties: {
+                            question: { type: "string" },
+                            context: { type: "string" },
+                            options: { type: "array", items: { type: "string" } },
+                            required: { type: "boolean" },
+                        },
+                    },
+                },
+                context: {
+                    type: "string",
+                    description: "问题的背景信息或上下文",
+                },
+                reason: {
+                    type: "string",
+                    description: "为什么要问这个问题（提问原因）",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
+];

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

@@ -183,4 +183,62 @@ export declare const orchestrationToolSchemas: readonly [{
         readonly required: readonly [];
         readonly additionalProperties: true;
     };
+}, {
+    readonly name: "start_ralph";
+    readonly description: "当用户需要启动 Ralph Wiggum Loop 循环开发时使用。生成 .ralph/ 目录结构、安全模式脚本和执行指南。默认启用多重安全保护，防止无人值守时费用失控";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly goal: {
+                readonly type: "string";
+                readonly description: "本次要完成的目标/需求描述。例如：'实现用户认证功能'、'修复登录 bug'";
+            };
+            readonly mode: {
+                readonly type: "string";
+                readonly description: "运行模式：safe（安全模式，默认）、normal（普通模式）。安全模式包含多重保护机制";
+            };
+            readonly completion_promise: {
+                readonly type: "string";
+                readonly description: "完成条件描述。默认：'tests passing + requirements met'";
+            };
+            readonly test_command: {
+                readonly type: "string";
+                readonly description: "每轮执行的测试命令。默认：'npm test'（会在首轮由 agent 识别正确命令）";
+            };
+            readonly cli_command: {
+                readonly type: "string";
+                readonly description: "Claude Code CLI 命令名。默认：'claude-code'（可能需要改为 'claude'）";
+            };
+            readonly max_iterations: {
+                readonly type: "number";
+                readonly description: "最大迭代轮数。safe 模式默认：8";
+            };
+            readonly max_minutes: {
+                readonly type: "number";
+                readonly description: "最大运行分钟数。safe 模式默认：25";
+            };
+            readonly confirm_every: {
+                readonly type: "number";
+                readonly description: "每几轮要求人工确认。safe 模式默认：1（每轮都确认）";
+            };
+            readonly confirm_timeout: {
+                readonly type: "number";
+                readonly description: "确认等待秒数，超时自动停止。safe 模式默认：20";
+            };
+            readonly max_same_output: {
+                readonly type: "number";
+                readonly description: "输出重复多少次停止（防卡死）。safe 模式默认：2";
+            };
+            readonly max_diff_lines: {
+                readonly type: "number";
+                readonly description: "git diff 变更行数超过此值停止（防失控）。safe 模式默认：300";
+            };
+            readonly cooldown_seconds: {
+                readonly type: "number";
+                readonly description: "每轮后冷却秒数。safe 模式默认：8";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
 }];

package/build/schemas/orchestration-tools.js

@@ -193,4 +193,63 @@ export const orchestrationToolSchemas = [
             additionalProperties: true,
         },
     },
+    {
+        name: "start_ralph",
+        description: "当用户需要启动 Ralph Wiggum Loop 循环开发时使用。生成 .ralph/ 目录结构、安全模式脚本和执行指南。默认启用多重安全保护，防止无人值守时费用失控",
+        inputSchema: {
+            type: "object",
+            properties: {
+                goal: {
+                    type: "string",
+                    description: "本次要完成的目标/需求描述。例如：'实现用户认证功能'、'修复登录 bug'",
+                },
+                mode: {
+                    type: "string",
+                    description: "运行模式：safe（安全模式，默认）、normal（普通模式）。安全模式包含多重保护机制",
+                },
+                completion_promise: {
+                    type: "string",
+                    description: "完成条件描述。默认：'tests passing + requirements met'",
+                },
+                test_command: {
+                    type: "string",
+                    description: "每轮执行的测试命令。默认：'npm test'（会在首轮由 agent 识别正确命令）",
+                },
+                cli_command: {
+                    type: "string",
+                    description: "Claude Code CLI 命令名。默认：'claude-code'（可能需要改为 'claude'）",
+                },
+                max_iterations: {
+                    type: "number",
+                    description: "最大迭代轮数。safe 模式默认：8",
+                },
+                max_minutes: {
+                    type: "number",
+                    description: "最大运行分钟数。safe 模式默认：25",
+                },
+                confirm_every: {
+                    type: "number",
+                    description: "每几轮要求人工确认。safe 模式默认：1（每轮都确认）",
+                },
+                confirm_timeout: {
+                    type: "number",
+                    description: "确认等待秒数，超时自动停止。safe 模式默认：20",
+                },
+                max_same_output: {
+                    type: "number",
+                    description: "输出重复多少次停止（防卡死）。safe 模式默认：2",
+                },
+                max_diff_lines: {
+                    type: "number",
+                    description: "git diff 变更行数超过此值停止（防失控）。safe 模式默认：300",
+                },
+                cooldown_seconds: {
+                    type: "number",
+                    description: "每轮后冷却秒数。safe 模式默认：8",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
 ];

package/build/schemas/ui-ux-schemas.d.ts

@@ -0,0 +1,248 @@
+/**
+ * UI/UX Pro Max 工具的 Schema 定义
+ */
+export declare const uiDesignSystemSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            product_type: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            stack: {
+                type: string;
+                description: string;
+            };
+            target_audience: {
+                type: string;
+                description: string;
+            };
+            keywords: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const initComponentCatalogSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+};
+export declare const uiSearchSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            mode: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+            };
+            stack: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            min_score: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+    };
+};
+export declare const syncUiDataSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            force: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            verbose: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+    };
+};
+export declare const renderUiSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            template: {
+                type: string;
+                description: string;
+            };
+            framework: {
+                type: string;
+                description: string;
+                default: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const startUiSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            description: {
+                type: string;
+                description: string;
+            };
+            framework: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            template: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const uiUxSchemas: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            product_type: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            stack: {
+                type: string;
+                description: string;
+            };
+            target_audience: {
+                type: string;
+                description: string;
+            };
+            keywords: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            mode: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+            };
+            stack: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            min_score: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            force: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            verbose: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            template: {
+                type: string;
+                description: string;
+            };
+            framework: {
+                type: string;
+                description: string;
+                default: string;
+            };
+        };
+        required: string[];
+    };
+})[];

package/build/schemas/ui-ux-schemas.js

@@ -0,0 +1,147 @@
+/**
+ * UI/UX Pro Max 工具的 Schema 定义
+ */
+export const uiDesignSystemSchema = {
+    name: "ui_design_system",
+    description: "智能设计系统生成器 - 基于产品类型和需求，使用 AI 推理引擎生成完整的设计系统推荐。包括 UI 风格、配色方案、字体配对、落地页模式、效果建议、反模式警告和交付检查清单。输出 Markdown 文档、JSON 配置和完整设计规范文档集。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            product_type: {
+                type: "string",
+                description: "产品类型（必填）：SaaS, E-commerce, Healthcare, Fintech, Government（政府）, Education（教育）, Portfolio, Agency 等。这是推理引擎的核心输入。",
+            },
+            description: {
+                type: "string",
+                description: "系统说明（推荐）：详细描述产品功能、特点、使用场景。例如：'政府类网站，需要权威、可信、易用的设计风格，面向公众提供政务服务'。这将帮助推理引擎生成更准确的设计方案。",
+            },
+            stack: {
+                type: "string",
+                description: "技术栈（推荐）：react, vue, nextjs, nuxtjs, tailwind, html, svelte, astro 等。用于生成特定技术栈的实现建议和配置代码。",
+            },
+            target_audience: {
+                type: "string",
+                description: "目标用户（可选）：如 'B2B企业', 'C端消费者', '政府公务员', '普通市民', '开发者' 等。帮助推理引擎选择合适的设计风格。",
+            },
+            keywords: {
+                type: "string",
+                description: "关键词（可选）：逗号分隔的关键词，如 'professional, modern, trustworthy, authoritative'（专业、现代、可信、权威）。用于辅助匹配设计风格。",
+            },
+        },
+        required: ["product_type"],
+    },
+};
+export const initComponentCatalogSchema = {
+    name: "init_component_catalog",
+    description: "初始化组件目录 - 基于设计系统规范（design-system.json）生成组件目录文件。定义可用的 UI 组件及其属性，组件定义包含占位符，渲染时自动替换为设计规范中的实际值，确保样式统一。",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+};
+export const uiSearchSchema = {
+    name: "ui_search",
+    description: "搜索 UI/UX 数据库，包括颜色、图标、图表、组件、设计模式等。支持三种模式：search（搜索数据）、catalog（查看组件目录）、template（搜索 UI 模板）。使用 BM25 算法进行智能搜索，支持按类别和技术栈过滤。数据来源：uipro-cli npm 包（v2.2.0+）。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            mode: {
+                type: "string",
+                description: "搜索模式：search（搜索 UI/UX 数据，默认）、catalog（查看组件目录）、template（搜索 UI 模板）",
+                default: "search",
+            },
+            query: {
+                type: "string",
+                description: "搜索关键词（支持中英文，如 'button'、'按钮'、'primary color'、'主色调'）。catalog 模式不需要此参数。",
+            },
+            category: {
+                type: "string",
+                description: "数据类别（仅 search 模式）：colors（颜色）、icons（图标）、charts（图表）、landing（落地页）、products（产品）、typography（字体）、styles（样式）、ux-guidelines（UX 指南）、web-interface（Web 界面）等",
+            },
+            stack: {
+                type: "string",
+                description: "技术栈过滤（仅 search 模式）：react、vue、nextjs、nuxtjs、svelte、astro、flutter、react-native、swiftui、jetpack-compose 等",
+            },
+            limit: {
+                type: "number",
+                description: "返回结果数量（默认 10，范围 1-50）",
+                default: 10,
+            },
+            min_score: {
+                type: "number",
+                description: "最小相关性得分（默认 0，范围 0-100）",
+                default: 0,
+            },
+        },
+    },
+};
+export const syncUiDataSchema = {
+    name: "sync_ui_data",
+    description: "同步 UI/UX 数据到本地缓存。从 npm 包 uipro-cli 下载最新数据，支持自动检查更新和强制同步。数据存储在 ~/.mcp-probe-kit/ui-ux-data/。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            force: {
+                type: "boolean",
+                description: "是否强制同步（忽略版本检查，默认 false）",
+                default: false,
+            },
+            verbose: {
+                type: "boolean",
+                description: "是否显示详细日志（默认 false）",
+                default: false,
+            },
+        },
+    },
+};
+export const renderUiSchema = {
+    name: "render_ui",
+    description: "UI 渲染引擎 - 将 JSON 模板渲染为最终代码。自动读取设计规范（design-system.json）和组件目录（component-catalog.json），替换占位符，生成完整的 React/Vue/HTML 代码。确保所有组件样式统一。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            template: {
+                type: "string",
+                description: "模板文件路径（JSON 格式，如 docs/ui/login-form.json）",
+            },
+            framework: {
+                type: "string",
+                description: "目标框架：react、vue、html（默认 react）",
+                default: "react",
+            },
+        },
+        required: ["template"],
+    },
+};
+export const startUiSchema = {
+    name: "start_ui",
+    description: "统一 UI 开发编排工具 - 一键完成整个 UI 开发流程。自动检查设计系统、生成组件目录、搜索/生成模板、渲染最终代码。适合快速原型开发，保证整个项目样式统一。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            description: {
+                type: "string",
+                description: "UI 需求描述（如 '登录页面'、'用户列表'、'设置页面'）",
+            },
+            framework: {
+                type: "string",
+                description: "目标框架：react、vue、html（默认 react）",
+                default: "react",
+            },
+            template: {
+                type: "string",
+                description: "模板名称（可选，不提供则自动生成）",
+            },
+        },
+        required: ["description"],
+    },
+};
+export const uiUxSchemas = [
+    uiDesignSystemSchema,
+    initComponentCatalogSchema,
+    uiSearchSchema,
+    syncUiDataSchema,
+    renderUiSchema,
+    startUiSchema,
+];

package/build/tools/__tests__/start_ui.integration.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 集成测试：start_ui 工具
+ *
+ * 测试完整的工作流程和端到端场景
+ */
+export {};