mcp-probe-kit 1.4.0 → 1.7.0

package/build/tools/fix_bug.js

@@ -0,0 +1,298 @@
+/**
+ * fix_bug 工具
+ *
+ * 功能：指导完整的 Bug 修复流程
+ * 模式：指令生成器模式 - 返回详细的修复指南，由 AI 执行实际操作
+ *
+ * 流程：问题定位 → 原因分析 → 修复方案 → 验证测试
+ */
+const PROMPT_TEMPLATE = `# Bug 修复指南
+
+## 🐛 Bug 信息
+
+**错误信息**: 
+\`\`\`
+{error_message}
+\`\`\`
+
+{stack_trace_section}
+
+{reproduce_section}
+
+{behavior_section}
+
+---
+
+## 📍 阶段 1: 问题定位
+
+### 步骤 1.1: 分析错误信息
+
+1. **识别错误类型**:
+   - 语法错误（SyntaxError）
+   - 运行时错误（TypeError, ReferenceError, RangeError）
+   - 逻辑错误（结果不符合预期）
+   - 异步错误（Promise rejection, 回调异常）
+
+2. **提取关键信息**:
+   - 错误名称: [从错误信息中提取]
+   - 错误消息: [具体描述]
+   - 发生位置: [文件:行号]
+
+### 步骤 1.2: 分析堆栈跟踪
+
+**操作**:
+1. 找到堆栈中第一个项目文件（排除 node_modules）
+2. 追踪调用链，理解执行流程
+3. 记录所有相关的项目文件
+
+**相关文件列表**:
+| 文件 | 行号 | 函数/方法 |
+|------|------|-----------|
+| [文件路径] | [行号] | [函数名] |
+
+### 步骤 1.3: 读取相关代码
+
+**操作**: 读取以下文件并分析：
+- 错误发生的文件
+- 调用链上的文件
+- 相关的配置文件
+- 相关的测试文件（如有）
+
+### 📋 定位结论
+
+| 项目 | 内容 |
+|------|------|
+| 问题文件 | [文件路径] |
+| 问题位置 | 第 X 行 |
+| 问题代码 | \`[代码片段]\` |
+| 触发条件 | [什么情况下触发] |
+
+---
+
+## 🔍 阶段 2: 原因分析
+
+### 步骤 2.1: 5 Whys 分析
+
+使用 5 Whys 方法深入分析根本原因：
+
+1. **Why 1**: 为什么会出现这个错误？
+   - [答案]
+
+2. **Why 2**: 为什么会 [Why 1 的答案]？
+   - [答案]
+
+3. **Why 3**: 为什么会 [Why 2 的答案]？
+   - [答案]
+
+4. **Why 4**: 为什么会 [Why 3 的答案]？
+   - [答案]
+
+5. **Why 5**: 为什么会 [Why 4 的答案]？
+   - [答案]
+
+### 步骤 2.2: 代码逻辑分析
+
+1. **数据流分析**: 追踪数据从输入到出错位置的流动
+2. **状态分析**: 检查相关变量/状态在出错时的值
+3. **边界条件**: 检查是否处理了所有边界情况
+4. **异常处理**: 检查是否有适当的错误处理
+
+### 📋 分析结论
+
+| 项目 | 内容 |
+|------|------|
+| 直接原因 | [直接导致错误的原因] |
+| 根本原因 | [深层次的原因] |
+| 触发条件 | [什么情况下会触发] |
+| 影响范围 | [受影响的功能/模块] |
+
+---
+
+## 🔧 阶段 3: 修复方案
+
+### 步骤 3.1: 设计修复方案
+
+**方案 A**: [方案描述]
+- 修改内容: [具体修改]
+- 优点: [优点]
+- 缺点: [缺点]
+- 风险: [潜在风险]
+
+**方案 B**: [备选方案描述]
+- 修改内容: [具体修改]
+- 优点: [优点]
+- 缺点: [缺点]
+- 风险: [潜在风险]
+
+**选择方案**: [选择的方案]
+**选择理由**: [为什么选择这个方案]
+
+### 步骤 3.2: 影响范围评估
+
+| 影响项 | 说明 |
+|--------|------|
+| 修改文件 | [文件列表] |
+| 影响功能 | [功能列表] |
+| 需要测试 | [测试范围] |
+| 是否需要回归 | [是/否] |
+
+### 步骤 3.3: 实施修复
+
+**修改文件**: \`[文件路径]\`
+
+**修改前**:
+\`\`\`
+[原代码]
+\`\`\`
+
+**修改后**:
+\`\`\`
+[新代码]
+\`\`\`
+
+**修改说明**: [解释修改的原因和逻辑]
+
+---
+
+## ✅ 阶段 4: 验证测试
+
+### 步骤 4.1: 单元测试
+
+为修复编写针对性的单元测试：
+
+\`\`\`typescript
+describe('[功能描述]', () => {
+  // 测试正常情况
+  it('should [正常行为描述]', () => {
+    // 测试代码
+  });
+  
+  // 测试修复的 Bug 场景
+  it('should handle [Bug 场景]', () => {
+    // 测试代码 - 确保 Bug 已修复
+  });
+  
+  // 测试边界情况
+  it('should handle [边界情况]', () => {
+    // 边界测试
+  });
+});
+\`\`\`
+
+### 步骤 4.2: 手动验证
+
+1. [ ] 按原复现步骤验证问题已修复
+2. [ ] 验证正常流程不受影响
+3. [ ] 验证边界情况处理正确
+4. [ ] 验证错误处理正确
+
+### 步骤 4.3: 回归测试
+
+1. [ ] 运行相关模块的测试
+2. [ ] 运行全量测试（如有 CI）
+3. [ ] 检查是否引入新问题
+
+---
+
+## 📋 修复检查清单
+
+### 定位阶段
+- [ ] 错误类型已识别
+- [ ] 问题代码已定位
+- [ ] 相关文件已读取
+
+### 分析阶段
+- [ ] 5 Whys 分析已完成
+- [ ] 根本原因已确定
+- [ ] 影响范围已评估
+
+### 修复阶段
+- [ ] 修复方案已设计
+- [ ] 代码修改已完成
+- [ ] 修改已解释清楚
+
+### 验证阶段
+- [ ] 单元测试已添加
+- [ ] 手动验证已通过
+- [ ] 回归测试已通过
+
+### 提交阶段
+- [ ] 代码已提交
+- [ ] Commit message 清晰描述了修复内容
+
+---
+
+## 📝 修复总结
+
+完成修复后，填写以下总结：
+
+| 项目 | 内容 |
+|------|------|
+| Bug 描述 | [简述] |
+| 根本原因 | [原因] |
+| 修复方案 | [方案] |
+| 修改文件 | [文件列表] |
+| 测试覆盖 | [测试情况] |
+| 修复时间 | [耗时] |
+
+---
+
+## 💡 经验教训
+
+记录本次 Bug 的经验教训，避免类似问题：
+
+1. **代码层面**: [如何避免写出类似 Bug]
+2. **测试层面**: [应该增加什么测试]
+3. **流程层面**: [流程上如何改进]
+
+---
+
+*指南版本: 1.0.0*
+*工具: MCP Probe Kit - fix_bug*
+`;
+/**
+ * fix_bug 工具实现
+ */
+export async function fixBug(args) {
+    try {
+        const errorMessage = args?.error_message;
+        if (!errorMessage) {
+            throw new Error("缺少必填参数: error_message（错误信息）");
+        }
+        const stackTrace = args?.stack_trace || "";
+        const stepsToReproduce = args?.steps_to_reproduce || "";
+        const expectedBehavior = args?.expected_behavior || "";
+        const actualBehavior = args?.actual_behavior || "";
+        // 构建可选部分
+        const stackTraceSection = stackTrace
+            ? `**堆栈跟踪**:\n\`\`\`\n${stackTrace}\n\`\`\``
+            : "**堆栈跟踪**: 未提供（建议提供以便更准确定位）";
+        const reproduceSection = stepsToReproduce
+            ? `**复现步骤**:\n${stepsToReproduce}`
+            : "";
+        let behaviorSection = "";
+        if (expectedBehavior || actualBehavior) {
+            behaviorSection = [
+                expectedBehavior ? `**期望行为**: ${expectedBehavior}` : "",
+                actualBehavior ? `**实际行为**: ${actualBehavior}` : "",
+            ]
+                .filter(Boolean)
+                .join("\n\n");
+        }
+        const guide = PROMPT_TEMPLATE
+            .replace(/{error_message}/g, errorMessage)
+            .replace(/{stack_trace_section}/g, stackTraceSection)
+            .replace(/{reproduce_section}/g, reproduceSection)
+            .replace(/{behavior_section}/g, behaviorSection);
+        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/gen_mock.d.ts

@@ -0,0 +1,22 @@
+/**
+ * gen_mock 工具
+ *
+ * 功能：根据数据结构生成 Mock 数据
+ * 模式：指令生成器模式 - 返回生成指南，由 AI 执行实际生成
+ */
+/**
+ * gen_mock 工具实现
+ */
+export declare function genMock(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/gen_mock.js

@@ -0,0 +1,250 @@
+/**
+ * gen_mock 工具
+ *
+ * 功能：根据数据结构生成 Mock 数据
+ * 模式：指令生成器模式 - 返回生成指南，由 AI 执行实际生成
+ */
+const PROMPT_TEMPLATE = `# Mock 数据生成指南
+
+## 🎯 生成目标
+
+**数据结构**:
+\`\`\`
+{schema}
+\`\`\`
+
+**生成配置**:
+- 数量: {count} 条
+- 格式: {format}
+- 语言: {locale}
+{seed_section}
+
+---
+
+## 📋 生成步骤
+
+### 步骤 1: 解析数据结构
+
+分析输入的数据结构，识别：
+1. 字段名称和类型
+2. 必填/可选字段（?标记）
+3. 嵌套结构
+4. 数组类型
+
+### 步骤 2: 字段语义识别
+
+根据字段名自动匹配语义，生成符合语义的数据：
+
+| 字段名模式 | 生成规则 | 中文示例 | 英文示例 |
+|------------|----------|----------|----------|
+| id, _id | UUID/自增ID | uuid-xxx | uuid-xxx |
+| name, 姓名 | 人名 | 张三、李四 | John Doe |
+| email, 邮箱 | 邮箱格式 | zhangsan@example.com | john@example.com |
+| phone, mobile, 手机 | 手机号 | 138xxxx1234 | +1-xxx-xxx-xxxx |
+| avatar, 头像 | 图片URL | https://api.dicebear.com/... | |
+| address, 地址 | 地址 | 北京市朝阳区xxx | 123 Main St |
+| city, 城市 | 城市名 | 北京、上海 | New York |
+| country, 国家 | 国家名 | 中国 | United States |
+| date, 日期 | 日期 | 2024-01-15 | 2024-01-15 |
+| createdAt, created_at | 过去时间 | 2024-01-01T10:00:00Z | |
+| updatedAt, updated_at | 最近时间 | 2024-01-15T15:30:00Z | |
+| title, 标题 | 短句 | 这是一个标题 | A Sample Title |
+| description, desc, 描述 | 段落 | 这是描述内容... | Lorem ipsum... |
+| content, 内容 | 长文本 | 文章内容... | Article content... |
+| price, 价格 | 金额 | 99.00 | 99.00 |
+| amount, 数量 | 整数 | 10 | 10 |
+| status, 状态 | 枚举 | active/inactive | active/inactive |
+| type, 类型 | 枚举 | 根据上下文 | |
+| url, 链接 | URL | https://example.com | |
+| image, 图片 | 图片URL | https://picsum.photos/... | |
+| age, 年龄 | 18-60 | 25 | 25 |
+| gender, 性别 | 性别 | 男/女 | male/female |
+| username, 用户名 | 用户名 | user_123 | user_123 |
+| password, 密码 | 密码占位 | ******** | ******** |
+| token | Token | tok_xxx | tok_xxx |
+| code, 编码 | 编码 | CODE001 | CODE001 |
+| sort, order, 排序 | 序号 | 1, 2, 3 | 1, 2, 3 |
+| enabled, active | 布尔 | true/false | true/false |
+| tags, 标签 | 标签数组 | ["标签1", "标签2"] | ["tag1", "tag2"] |
+
+### 步骤 3: 类型映射
+
+基础类型的默认生成规则：
+
+| 类型 | 生成规则 |
+|------|----------|
+| string | 根据字段名语义，或随机字符串 |
+| number | 1-100 的随机整数 |
+| boolean | true/false 随机 |
+| Date | 最近30天内的随机时间 |
+| string[] | 3-5个随机字符串 |
+| number[] | 3-5个随机数字 |
+| enum | 从枚举值中随机选择 |
+| union | 从联合类型中随机选择 |
+
+### 步骤 4: 生成数据
+
+根据识别结果生成 {count} 条数据。
+
+**注意事项**:
+- 确保数据多样性，避免重复
+- 数值类型保持合理范围
+- 日期类型保持合理顺序（createdAt < updatedAt）
+- 关联字段保持一致性
+
+---
+
+## 📊 输出格式
+
+### JSON 格式
+\`\`\`json
+[
+  {
+    "field1": "value1",
+    "field2": 123
+  }
+]
+\`\`\`
+
+### TypeScript 格式
+\`\`\`typescript
+const mockData: YourType[] = [
+  {
+    field1: "value1",
+    field2: 123
+  }
+];
+
+export default mockData;
+\`\`\`
+
+### JavaScript 格式
+\`\`\`javascript
+const mockData = [
+  {
+    field1: "value1",
+    field2: 123
+  }
+];
+
+module.exports = mockData;
+\`\`\`
+
+### CSV 格式（仅扁平数据）
+\`\`\`csv
+field1,field2
+value1,123
+\`\`\`
+
+---
+
+## 🔧 高级功能
+
+### 自定义规则
+
+在 schema 注释中指定规则：
+
+\`\`\`typescript
+interface User {
+  id: string;           // UUID
+  age: number;          // range: 18-60
+  status: string;       // enum: active, inactive, pending
+  score: number;        // range: 0-100, decimal: 2
+  tags: string[];       // count: 3-5
+  level: number;        // enum: 1, 2, 3
+}
+\`\`\`
+
+### 关联数据
+
+生成有关联关系的数据：
+
+\`\`\`json
+// 先生成 users
+[
+  { "id": "user-1", "name": "张三" },
+  { "id": "user-2", "name": "李四" }
+]
+
+// 再生成 orders，引用 user_id
+[
+  { "id": "order-1", "user_id": "user-1", "amount": 100 },
+  { "id": "order-2", "user_id": "user-2", "amount": 200 }
+]
+\`\`\`
+
+### 固定值
+
+某些字段使用固定值：
+
+\`\`\`typescript
+interface Config {
+  version: string;      // fixed: "1.0.0"
+  env: string;          // fixed: "development"
+}
+\`\`\`
+
+---
+
+## ✅ 生成检查清单
+
+- [ ] 数据结构已正确解析
+- [ ] 字段语义已识别
+- [ ] 数据类型正确
+- [ ] 数量符合要求: {count} 条
+- [ ] 格式正确: {format}
+- [ ] 语言符合设置: {locale}
+- [ ] 数据具有多样性
+- [ ] 关联数据一致（如有）
+
+---
+
+*指南版本: 1.0.0*
+*工具: MCP Probe Kit - gen_mock*
+`;
+/**
+ * gen_mock 工具实现
+ */
+export async function genMock(args) {
+    try {
+        const schema = args?.schema;
+        if (!schema) {
+            throw new Error("缺少必填参数: schema（数据结构定义）");
+        }
+        const count = args?.count || 1;
+        const format = args?.format || "json";
+        const locale = args?.locale || "zh-CN";
+        const seed = args?.seed;
+        if (count < 1 || count > 1000) {
+            throw new Error("count 参数必须在 1-1000 之间");
+        }
+        const formatMap = {
+            json: "JSON",
+            typescript: "TypeScript",
+            javascript: "JavaScript",
+            csv: "CSV",
+        };
+        const localeMap = {
+            "zh-CN": "中文（简体）",
+            "en-US": "英文（美国）",
+            "ja-JP": "日文",
+        };
+        const seedSection = seed ? `- 随机种子: ${seed}（可重复生成）` : "";
+        const guide = PROMPT_TEMPLATE
+            .replace(/{schema}/g, schema)
+            .replace(/{count}/g, String(count))
+            .replace(/{format}/g, formatMap[format] || format)
+            .replace(/{locale}/g, localeMap[locale] || locale)
+            .replace(/{seed_section}/g, seedSection);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ Mock 数据生成失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/index.d.ts

@@ -22,3 +22,18 @@ export { cssOrder } from "./css_order.js";
 export { genreadme } from "./genreadme.js";
 export { split } from "./split.js";
 export { analyzeProject } from "./analyze_project.js";
+export { initProjectContext } from "./init_project_context.js";
+export { addFeature } from "./add_feature.js";
+export { securityScan } from "./security_scan.js";
+export { fixBug } from "./fix_bug.js";
+export { estimate } from "./estimate.js";
+export { genMock } from "./gen_mock.js";
+export { design2code } from "./design2code.js";
+export { startFeature } from "./start_feature.js";
+export { startBugfix } from "./start_bugfix.js";
+export { startReview } from "./start_review.js";
+export { startRelease } from "./start_release.js";
+export { startRefactor } from "./start_refactor.js";
+export { startOnboard } from "./start_onboard.js";
+export { startApi } from "./start_api.js";
+export { startDoc } from "./start_doc.js";

package/build/tools/index.js

@@ -22,3 +22,19 @@ export { cssOrder } from "./css_order.js";
 export { genreadme } from "./genreadme.js";
 export { split } from "./split.js";
 export { analyzeProject } from "./analyze_project.js";
+export { initProjectContext } from "./init_project_context.js";
+export { addFeature } from "./add_feature.js";
+export { securityScan } from "./security_scan.js";
+export { fixBug } from "./fix_bug.js";
+export { estimate } from "./estimate.js";
+export { genMock } from "./gen_mock.js";
+export { design2code } from "./design2code.js";
+// 智能编排工具
+export { startFeature } from "./start_feature.js";
+export { startBugfix } from "./start_bugfix.js";
+export { startReview } from "./start_review.js";
+export { startRelease } from "./start_release.js";
+export { startRefactor } from "./start_refactor.js";
+export { startOnboard } from "./start_onboard.js";
+export { startApi } from "./start_api.js";
+export { startDoc } from "./start_doc.js";