mcp-probe-kit 1.3.0 → 1.6.0

package/build/tools/start_api.js

@@ -0,0 +1,178 @@
+/**
+ * start_api 智能编排工具
+ *
+ * 场景：API 开发
+ * 编排：[检查上下文] → genapi → gen_mock → gentest
+ */
+const PROMPT_TEMPLATE = `# 🔌 API 开发编排指南
+
+## 🎯 目标
+
+为以下 API 代码生成完整的开发资料：
+
+\`\`\`{language}
+{code}
+\`\`\`
+
+---
+
+## 📋 步骤 0: 项目上下文（自动处理）
+
+**操作**:
+1. 检查 \`docs/project-context.md\` 是否存在
+2. **如果不存在**：
+   - 调用 \`init_project_context\` 工具
+   - 等待生成完成
+3. **读取** \`docs/project-context.md\` 内容
+4. 了解项目的 API 规范、测试框架
+
+---
+
+## 📝 步骤 1: 生成 API 文档
+
+**调用工具**: \`genapi\`
+
+**参数**:
+\`\`\`json
+{
+  "code": "[API 代码]",
+  "format": "{format}"
+}
+\`\`\`
+
+**生成内容**:
+- API 端点列表
+- 请求/响应格式
+- 参数说明
+- 示例
+
+**产出**: API 文档（Markdown/OpenAPI/JSDoc）
+
+---
+
+## 🎭 步骤 2: 生成 Mock 数据
+
+**调用工具**: \`gen_mock\`
+
+**参数**:
+\`\`\`json
+{
+  "schema": "[从 API 代码中提取的数据结构]",
+  "count": 5,
+  "format": "json",
+  "locale": "zh-CN"
+}
+\`\`\`
+
+**生成内容**:
+- 请求示例数据
+- 响应示例数据
+- 各种场景的测试数据
+
+**产出**: Mock 数据文件
+
+---
+
+## 🧪 步骤 3: 生成 API 测试
+
+**调用工具**: \`gentest\`
+
+**参数**:
+\`\`\`json
+{
+  "code": "[API 代码]",
+  "framework": "[根据项目上下文选择]"
+}
+\`\`\`
+
+**生成内容**:
+- 单元测试
+- 集成测试
+- 边界情况测试
+- 错误处理测试
+
+**产出**: 测试代码
+
+---
+
+## ✅ 完成检查
+
+- [ ] 项目上下文已读取
+- [ ] API 文档已生成
+- [ ] Mock 数据已生成
+- [ ] 测试代码已生成
+
+---
+
+## 📊 输出汇总
+
+完成后，向用户提供：
+
+### 1. API 文档
+
+\`\`\`markdown
+## API 端点
+
+### [METHOD] /path
+
+**描述**: ...
+
+**请求参数**:
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+
+**响应**:
+\`\`\`json
+{
+  "code": 0,
+  "data": {}
+}
+\`\`\`
+\`\`\`
+
+### 2. Mock 数据
+
+\`\`\`json
+[Mock 数据示例]
+\`\`\`
+
+### 3. 测试代码
+
+\`\`\`typescript
+[测试代码]
+\`\`\`
+
+### 4. 使用建议
+
+- Mock 数据可用于前端开发联调
+- 测试代码可直接运行验证 API
+- API 文档可分享给前端/调用方
+
+---
+
+*编排工具: MCP Probe Kit - start_api*
+`;
+export async function startApi(args) {
+    try {
+        const code = args?.code;
+        if (!code) {
+            throw new Error("缺少必填参数: code（API 代码）");
+        }
+        const language = args?.language || "typescript";
+        const format = args?.format || "markdown";
+        const guide = PROMPT_TEMPLATE
+            .replace(/{code}/g, code)
+            .replace(/{language}/g, language)
+            .replace(/{format}/g, format);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/start_bugfix.d.ts

@@ -0,0 +1,19 @@
+/**
+ * start_bugfix 智能编排工具
+ *
+ * 场景：修复 Bug
+ * 编排：[检查上下文] → fix_bug → gentest
+ */
+export declare function startBugfix(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/start_bugfix.js

@@ -0,0 +1,127 @@
+/**
+ * start_bugfix 智能编排工具
+ *
+ * 场景：修复 Bug
+ * 编排：[检查上下文] → fix_bug → gentest
+ */
+const PROMPT_TEMPLATE = `# 🐛 Bug 修复编排指南
+
+## 🎯 目标
+
+修复以下 Bug：
+
+**错误信息**:
+\`\`\`
+{error_message}
+\`\`\`
+
+{stack_trace_section}
+
+---
+
+## 📋 步骤 0: 项目上下文（自动处理）
+
+**操作**:
+1. 检查 \`docs/project-context.md\` 是否存在
+2. **如果不存在**：
+   - 调用 \`init_project_context\` 工具
+   - 等待生成完成
+3. **读取** \`docs/project-context.md\` 内容
+4. 了解项目的技术栈、架构、测试框架
+5. 后续步骤参考此上下文
+
+---
+
+## 🔍 步骤 1: Bug 分析与修复
+
+**调用工具**: \`fix_bug\`
+
+**参数**:
+\`\`\`json
+{
+  "error_message": "{error_message}",
+  "stack_trace": "{stack_trace}"
+}
+\`\`\`
+
+**执行要点**:
+1. 按指南完成问题定位
+2. 使用 5 Whys 分析根本原因
+3. 设计修复方案
+4. 实施代码修复
+
+**产出**: 修复后的代码
+
+---
+
+## 🧪 步骤 2: 生成回归测试
+
+**调用工具**: \`gentest\`
+
+**参数**:
+\`\`\`json
+{
+  "code": "[修复后的代码]",
+  "framework": "[根据项目上下文选择: jest/vitest/mocha]"
+}
+\`\`\`
+
+**执行要点**:
+1. 为修复的代码生成测试
+2. 包含 Bug 场景的测试用例
+3. 包含边界情况测试
+
+**产出**: 测试代码
+
+---
+
+## ✅ 完成检查
+
+- [ ] 项目上下文已读取
+- [ ] Bug 已定位
+- [ ] 根本原因已分析
+- [ ] 代码已修复
+- [ ] 测试已添加
+- [ ] 测试已通过
+
+---
+
+## 📝 输出汇总
+
+完成后，向用户汇总：
+
+1. **Bug 原因**: [根本原因]
+2. **修复方案**: [修复说明]
+3. **修改文件**: [文件列表]
+4. **测试覆盖**: [测试情况]
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix*
+`;
+export async function startBugfix(args) {
+    try {
+        const errorMessage = args?.error_message;
+        if (!errorMessage) {
+            throw new Error("缺少必填参数: error_message（错误信息）");
+        }
+        const stackTrace = args?.stack_trace || "";
+        const stackTraceSection = stackTrace
+            ? `**堆栈跟踪**:\n\`\`\`\n${stackTrace}\n\`\`\``
+            : "";
+        const guide = PROMPT_TEMPLATE
+            .replace(/{error_message}/g, errorMessage)
+            .replace(/{stack_trace}/g, stackTrace)
+            .replace(/{stack_trace_section}/g, stackTraceSection);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/start_doc.d.ts

@@ -0,0 +1,19 @@
+/**
+ * start_doc 智能编排工具
+ *
+ * 场景：文档生成
+ * 编排：[检查上下文] → gendoc → genreadme → genapi
+ */
+export declare function startDoc(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/start_doc.js

@@ -0,0 +1,190 @@
+/**
+ * start_doc 智能编排工具
+ *
+ * 场景：文档生成
+ * 编排：[检查上下文] → gendoc → genreadme → genapi
+ */
+const PROMPT_TEMPLATE = `# 📖 文档生成编排指南
+
+## 🎯 目标
+
+为项目/代码生成完整的文档
+
+**输入内容**:
+\`\`\`
+{code}
+\`\`\`
+
+---
+
+## 📋 步骤 0: 项目上下文（自动处理）
+
+**操作**:
+1. 检查 \`docs/project-context.md\` 是否存在
+2. **如果不存在**：
+   - 调用 \`init_project_context\` 工具
+   - 等待生成完成
+3. **读取** \`docs/project-context.md\` 内容
+4. 了解项目的文档风格、技术栈
+
+---
+
+## 📝 步骤 1: 生成代码注释
+
+**调用工具**: \`gendoc\`
+
+**参数**:
+\`\`\`json
+{
+  "code": "[代码内容]",
+  "style": "{style}",
+  "lang": "{lang}"
+}
+\`\`\`
+
+**生成内容**:
+- 函数/方法注释
+- 参数说明
+- 返回值说明
+- 使用示例
+
+**产出**: 带注释的代码
+
+---
+
+## 📄 步骤 2: 生成 README
+
+**调用工具**: \`genreadme\`
+
+**参数**:
+\`\`\`json
+{
+  "project_info": "[项目信息或代码]",
+  "style": "standard"
+}
+\`\`\`
+
+**生成内容**:
+- 项目简介
+- 功能特性
+- 安装使用
+- API 说明
+- 贡献指南
+
+**产出**: README.md
+
+---
+
+## 🔌 步骤 3: 生成 API 文档（如适用）
+
+**调用工具**: \`genapi\`
+
+**参数**:
+\`\`\`json
+{
+  "code": "[API 相关代码]",
+  "format": "markdown"
+}
+\`\`\`
+
+**生成内容**:
+- API 端点列表
+- 请求/响应格式
+- 参数说明
+
+**产出**: API 文档
+
+---
+
+## ✅ 完成检查
+
+- [ ] 项目上下文已读取
+- [ ] 代码注释已生成
+- [ ] README 已生成
+- [ ] API 文档已生成（如适用）
+
+---
+
+## 📊 输出汇总
+
+完成后，向用户提供：
+
+### 1. 代码注释
+
+\`\`\`typescript
+/**
+ * [函数描述]
+ * @param {Type} param - [参数说明]
+ * @returns {Type} [返回值说明]
+ * @example
+ * [使用示例]
+ */
+\`\`\`
+
+### 2. README.md
+
+\`\`\`markdown
+# 项目名称
+
+## 简介
+...
+
+## 功能特性
+...
+
+## 快速开始
+...
+
+## API 文档
+...
+
+## 贡献指南
+...
+
+## 许可证
+...
+\`\`\`
+
+### 3. API 文档（如适用）
+
+\`\`\`markdown
+## API 参考
+...
+\`\`\`
+
+### 4. 文档清单
+
+| 文档 | 状态 | 位置 |
+|------|------|------|
+| 代码注释 | ✅ | 源代码中 |
+| README | ✅ | README.md |
+| API 文档 | ✅/- | docs/api.md |
+
+---
+
+*编排工具: MCP Probe Kit - start_doc*
+`;
+export async function startDoc(args) {
+    try {
+        const code = args?.code || args?.project_info;
+        if (!code) {
+            throw new Error("缺少必填参数: code 或 project_info");
+        }
+        const style = args?.style || "jsdoc";
+        const lang = args?.lang || "zh";
+        const guide = PROMPT_TEMPLATE
+            .replace(/{code}/g, code)
+            .replace(/{style}/g, style)
+            .replace(/{lang}/g, lang);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/start_feature.d.ts

@@ -0,0 +1,19 @@
+/**
+ * start_feature 智能编排工具
+ *
+ * 场景：开发新功能
+ * 编排：[检查上下文] → add_feature → estimate
+ */
+export declare function startFeature(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/start_feature.js

@@ -0,0 +1,122 @@
+/**
+ * start_feature 智能编排工具
+ *
+ * 场景：开发新功能
+ * 编排：[检查上下文] → add_feature → estimate
+ */
+const PROMPT_TEMPLATE = `# 🚀 新功能开发编排指南
+
+## 🎯 目标
+
+开发新功能：**{feature_name}**
+
+**功能描述**: {description}
+
+---
+
+## 📋 步骤 0: 项目上下文（自动处理）
+
+**操作**:
+1. 检查 \`{docs_dir}/project-context.md\` 是否存在
+2. **如果不存在**：
+   - 调用 \`init_project_context\` 工具
+   - 参数: \`{ "docs_dir": "{docs_dir}" }\`
+   - 等待生成完成
+3. **读取** \`{docs_dir}/project-context.md\` 内容
+4. 提取关键信息：技术栈、架构模式、编码规范
+5. 后续所有步骤都要参考此上下文
+
+---
+
+## 🚀 步骤 1: 生成功能规格
+
+**调用工具**: \`add_feature\`
+
+**参数**:
+\`\`\`json
+{
+  "feature_name": "{feature_name}",
+  "description": "{description}",
+  "docs_dir": "{docs_dir}"
+}
+\`\`\`
+
+**预期输出**:
+- \`{docs_dir}/specs/{feature_name}/requirements.md\` - 需求文档
+- \`{docs_dir}/specs/{feature_name}/design.md\` - 设计文档
+- \`{docs_dir}/specs/{feature_name}/tasks.md\` - 任务清单
+
+**注意**: 生成文档时要参考项目上下文中的技术栈和架构模式
+
+---
+
+## 📊 步骤 2: 工作量估算
+
+**调用工具**: \`estimate\`
+
+**参数**:
+\`\`\`json
+{
+  "task_description": "实现 {feature_name} 功能：{description}",
+  "code_context": "参考生成的 tasks.md 中的任务列表"
+}
+\`\`\`
+
+**预期输出**:
+- 故事点估算
+- 时间估算（乐观/正常/悲观）
+- 复杂度分析
+- 风险识别
+
+---
+
+## ✅ 完成检查
+
+- [ ] 项目上下文已读取/生成
+- [ ] requirements.md 已生成
+- [ ] design.md 已生成
+- [ ] tasks.md 已生成
+- [ ] 工作量估算已完成
+
+---
+
+## 📝 输出汇总
+
+完成后，向用户汇总：
+
+1. **功能规格文档位置**: \`{docs_dir}/specs/{feature_name}/\`
+2. **预估工作量**: X 故事点 / X-X 天
+3. **主要风险**: [列出识别的风险]
+4. **下一步**: 按 tasks.md 开始开发
+
+---
+
+*编排工具: MCP Probe Kit - start_feature*
+`;
+export async function startFeature(args) {
+    try {
+        const featureName = args?.feature_name;
+        const description = args?.description;
+        if (!featureName) {
+            throw new Error("缺少必填参数: feature_name（功能名称）");
+        }
+        if (!description) {
+            throw new Error("缺少必填参数: description（功能描述）");
+        }
+        const docsDir = args?.docs_dir || "docs";
+        const guide = PROMPT_TEMPLATE
+            .replace(/{feature_name}/g, featureName)
+            .replace(/{description}/g, description)
+            .replace(/{docs_dir}/g, docsDir);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/start_onboard.d.ts

@@ -0,0 +1,19 @@
+/**
+ * start_onboard 智能编排工具
+ *
+ * 场景：快速上手项目
+ * 编排：analyze_project → init_project_context
+ */
+export declare function startOnboard(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;