mcp-probe-kit 1.10.1 → 1.13.0

package/build/schemas/index.js

@@ -0,0 +1,22 @@
+/**
+ * 所有工具 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";
+import { interviewToolSchemas } from "./interview-tools.js";
+// 合并所有工具 schemas
+export const allToolSchemas = [
+    ...basicToolSchemas,
+    ...gitToolSchemas,
+    ...codeAnalysisToolSchemas,
+    ...codeGenToolSchemas,
+    ...docUtilToolSchemas,
+    ...projectToolSchemas,
+    ...orchestrationToolSchemas,
+    ...interviewToolSchemas,
+];

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

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

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

@@ -0,0 +1,244 @@
+/**
+ * 智能编排工具的 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;
+    };
+}, {
+    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

@@ -0,0 +1,255 @@
+/**
+ * 智能编排工具的 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,
+        },
+    },
+    {
+        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,
+        },
+    },
+];