mcp-probe-kit 1.8.0 → 1.8.1

package/docs/specs/fix-bug/design.md

@@ -1,259 +0,0 @@
-# 设计文档：fix_bug
-
-## 概述
-
-`fix_bug` 采用"提示词生成器"模式，返回完整的 Bug 修复流程指南，指导 AI 从问题定位到验证测试的全过程。
-
----
-
-## 技术方案
-
-### 设计理念
-
-与 `debug` 工具的区别：
-- `debug`: 分析错误，给出调试策略
-- `fix_bug`: 完整的修复流程，包含定位→分析→修复→验证
-
-### 修复流程模型
-
-```
-Bug 报告
-    ↓
-问题定位（Where）
-    ↓
-原因分析（Why）
-    ↓
-方案设计（How）
-    ↓
-代码修复（Fix）
-    ↓
-验证测试（Verify）
-    ↓
-修复完成
-```
-
----
-
-## 架构设计
-
-### 工具结构
-
-```
-src/tools/fix_bug.ts
-├── fixBug(args)                 # 主函数
-│   ├── 验证参数
-│   ├── 构建修复指南
-│   └── 返回结果
-└── 常量定义
-    └── PROMPT_TEMPLATE          # 提示词模板
-```
-
----
-
-## 提示词模板设计
-
-```markdown
-# Bug 修复指南
-
-## 🐛 Bug 信息
-
-**错误信息**: 
-\`\`\`
-{error_message}
-\`\`\`
-
-**堆栈跟踪**:
-\`\`\`
-{stack_trace}
-\`\`\`
-
-**复现步骤**: {steps_to_reproduce}
-
-**期望行为**: {expected_behavior}
-
-**实际行为**: {actual_behavior}
-
----
-
-## 📍 阶段 1: 问题定位
-
-### 步骤 1.1: 分析错误信息
-
-1. 识别错误类型（语法错误/运行时错误/逻辑错误）
-2. 提取关键信息：
-   - 错误名称
-   - 错误消息
-   - 发生位置
-
-### 步骤 1.2: 分析堆栈跟踪
-
-1. 找到错误发生的第一个项目文件
-2. 追踪调用链
-3. 记录相关文件列表
-
-### 步骤 1.3: 读取相关代码
-
-**操作**: 读取以下文件并分析：
-- [从堆栈中识别的文件]
-- [相关的配置文件]
-- [相关的测试文件]
-
-### 定位结论
-
-| 项目 | 内容 |
-|------|------|
-| 问题文件 | [文件路径] |
-| 问题位置 | 第 X 行 |
-| 问题代码 | [代码片段] |
-
----
-
-## 🔍 阶段 2: 原因分析
-
-### 步骤 2.1: 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. 检查数据流和状态变化
-
-### 分析结论
-
-| 项目 | 内容 |
-|------|------|
-| 直接原因 | [直接导致错误的原因] |
-| 根本原因 | [深层次的原因] |
-| 触发条件 | [什么情况下会触发] |
-
----
-
-## 🔧 阶段 3: 修复方案
-
-### 步骤 3.1: 设计修复方案
-
-**方案 A**: [方案描述]
-- 优点: [优点]
-- 缺点: [缺点]
-- 风险: [风险]
-
-**方案 B**: [方案描述]
-- 优点: [优点]
-- 缺点: [缺点]
-- 风险: [风险]
-
-**选择方案**: [选择的方案及理由]
-
-### 步骤 3.2: 影响范围评估
-
-| 影响项 | 说明 |
-|--------|------|
-| 修改文件 | [文件列表] |
-| 影响功能 | [功能列表] |
-| 需要测试 | [测试范围] |
-
-### 步骤 3.3: 实施修复
-
-**修改文件**: [文件路径]
-
-**修改前**:
-\`\`\`
-[原代码]
-\`\`\`
-
-**修改后**:
-\`\`\`
-[新代码]
-\`\`\`
-
-**修改说明**: [解释修改的原因和逻辑]
-
----
-
-## ✅ 阶段 4: 验证测试
-
-### 步骤 4.1: 单元测试
-
-为修复编写单元测试：
-
-\`\`\`typescript
-describe('[功能描述]', () => {
-  it('should [测试场景]', () => {
-    // 测试代码
-  });
-  
-  it('should handle [边界情况]', () => {
-    // 边界测试
-  });
-});
-\`\`\`
-
-### 步骤 4.2: 手动验证
-
-1. [ ] 按原复现步骤验证问题已修复
-2. [ ] 验证正常流程不受影响
-3. [ ] 验证边界情况处理正确
-
-### 步骤 4.3: 回归测试
-
-1. [ ] 运行相关模块的测试
-2. [ ] 运行全量测试（如有 CI）
-3. [ ] 检查是否引入新问题
-
----
-
-## 📋 修复检查清单
-
-- [ ] 问题已定位到具体代码
-- [ ] 根本原因已分析清楚
-- [ ] 修复方案已评估风险
-- [ ] 代码修改已完成
-- [ ] 单元测试已添加
-- [ ] 手动验证已通过
-- [ ] 回归测试已通过
-- [ ] 代码已提交（附带清晰的 commit message）
-
----
-
-## 📝 修复总结
-
-| 项目 | 内容 |
-|------|------|
-| Bug 描述 | [简述] |
-| 根本原因 | [原因] |
-| 修复方案 | [方案] |
-| 修改文件 | [文件列表] |
-| 测试覆盖 | [测试情况] |
-```
-
----
-
-## 接口设计
-
-```typescript
-interface FixBugArgs {
-  error_message: string;        // 必填
-  stack_trace?: string;         // 可选
-  steps_to_reproduce?: string;  // 可选
-  expected_behavior?: string;   // 可选
-  actual_behavior?: string;     // 可选
-}
-
-async function fixBug(args: FixBugArgs): Promise<MCPResponse>
-```
-
----
-
-*设计版本: 1.0.0*
-*创建时间: 2025-01-14*

package/docs/specs/fix-bug/requirements.md

@@ -1,132 +0,0 @@
-# 需求文档：fix_bug
-
-## 功能概述
-
-`fix_bug` 是一个 MCP 工具，用于指导 AI 完成完整的 Bug 修复流程。从问题定位、原因分析、修复方案到验证测试，提供结构化的修复指南。
-
-## 术语定义
-
-- **Bug_Report**: Bug 报告，包含错误描述、复现步骤、堆栈信息等
-- **Root_Cause**: 根本原因，导致 Bug 的代码或逻辑问题
-- **Fix_Plan**: 修复方案，包含修改的文件、代码变更、影响范围
-- **Regression_Test**: 回归测试，验证修复不会引入新问题
-
----
-
-## 需求列表
-
-### 需求 1: 接收 Bug 信息
-
-**用户故事:** 作为开发者，我想要提供 Bug 的详细信息，以便工具能够分析问题。
-
-#### 验收标准
-
-1. THE 工具 SHALL 接受以下输入参数：
-   - error_message: 错误信息（必填）
-   - stack_trace: 堆栈跟踪（可选）
-   - steps_to_reproduce: 复现步骤（可选）
-   - expected_behavior: 期望行为（可选）
-   - actual_behavior: 实际行为（可选）
-2. WHEN 用户只提供 error_message THEN 工具 SHALL 正常工作
-3. WHEN 用户提供更多信息 THEN 工具 SHALL 生成更精准的修复指南
-
----
-
-### 需求 2: 生成问题定位指南
-
-**用户故事:** 作为开发者，我想要工具指导我定位问题，以便快速找到 Bug 所在。
-
-#### 验收标准
-
-1. THE 指南 SHALL 包含以下定位步骤：
-   - 分析错误信息和堆栈
-   - 识别相关文件和代码位置
-   - 确定问题触发条件
-2. THE 指南 SHALL 提供搜索关键词建议
-3. THE 指南 SHALL 指导 AI 读取相关代码文件
-
----
-
-### 需求 3: 生成原因分析指南
-
-**用户故事:** 作为开发者，我想要工具帮助分析根本原因，以便从根源解决问题。
-
-#### 验收标准
-
-1. THE 指南 SHALL 包含根因分析方法：
-   - 5 Whys 分析法
-   - 代码逻辑追踪
-   - 数据流分析
-2. THE 指南 SHALL 要求记录分析结论
-3. THE 指南 SHALL 区分直接原因和根本原因
-
----
-
-### 需求 4: 生成修复方案指南
-
-**用户故事:** 作为开发者，我想要工具生成修复方案，以便有计划地修复 Bug。
-
-#### 验收标准
-
-1. THE 指南 SHALL 包含修复方案模板：
-   - 修改的文件列表
-   - 具体的代码变更
-   - 影响范围评估
-2. THE 指南 SHALL 考虑多种修复方案并比较
-3. THE 指南 SHALL 评估修复的风险
-
----
-
-### 需求 5: 生成验证测试指南
-
-**用户故事:** 作为开发者，我想要工具指导我验证修复，以便确保 Bug 已解决且无回归。
-
-#### 验收标准
-
-1. THE 指南 SHALL 包含验证步骤：
-   - 单元测试用例
-   - 手动验证步骤
-   - 回归测试建议
-2. THE 指南 SHALL 生成针对该 Bug 的测试代码
-3. THE 指南 SHALL 提供验证检查清单
-
----
-
-## 非功能需求
-
-### 性能要求
-- 工具响应时间应小于 100ms
-
-### 兼容性要求
-- 支持多种编程语言的错误信息格式
-- 支持主流 AI 模型
-
----
-
-## 输入输出规格
-
-### 输入参数
-
-| 参数名 | 类型 | 必填 | 描述 |
-|--------|------|------|------|
-| error_message | string | 是 | 错误信息 |
-| stack_trace | string | 否 | 堆栈跟踪 |
-| steps_to_reproduce | string | 否 | 复现步骤 |
-| expected_behavior | string | 否 | 期望行为 |
-| actual_behavior | string | 否 | 实际行为 |
-
-### 输出格式
-
-```typescript
-{
-  content: [{
-    type: "text",
-    text: "Bug 修复指南（Markdown 格式）"
-  }]
-}
-```
-
----
-
-*文档版本: 1.0.0*
-*创建时间: 2025-01-14*

package/docs/specs/fix-bug/tasks.md

@@ -1,66 +0,0 @@
-# 任务清单：fix_bug
-
-## 概述
-
-实现 `fix_bug` MCP 工具，用于指导完整的 Bug 修复流程。
-
----
-
-## 任务列表
-
-### 阶段 1: 创建工具文件
-
-- [x] 1.1 创建 `src/tools/fix_bug.ts` 文件
-  - 创建文件结构
-  - 定义接口类型
-  - 实现参数验证
-  - 实现主函数框架
-  - _需求: 1.1-1.3_
-
-- [x] 1.2 编写提示词模板
-  - 实现 PROMPT_TEMPLATE 常量
-  - 包含问题定位指南
-  - 包含 5 Whys 分析法
-  - 包含修复方案模板
-  - 包含验证测试指南
-  - 包含修复检查清单
-  - _需求: 2.1-5.3_
-
----
-
-### 阶段 2: 注册工具
-
-- [x] 2.1 在 `src/tools/index.ts` 中导出工具
-  - 添加 export 语句
-
-- [x] 2.2 在 `src/index.ts` 中注册工具
-  - 添加工具定义（name, description, inputSchema）
-  - 添加工具处理逻辑（switch case）
-
----
-
-### 阶段 3: 测试验证
-
-- [x] 3.1 编译项目
-  - 运行 `npm run build`
-  - 确保无编译错误
-
-- [ ] 3.2 功能测试
-  - 测试只提供 error_message
-  - 测试提供完整 Bug 信息
-  - 验证生成的修复指南完整性
-
----
-
-## 文件变更清单
-
-| 文件 | 操作 | 说明 |
-|------|------|------|
-| src/tools/fix_bug.ts | 新建 | 工具实现 |
-| src/tools/index.ts | 修改 | 添加导出 |
-| src/index.ts | 修改 | 注册工具 |
-
----
-
-*任务版本: 1.0.0*
-*创建时间: 2025-01-14*

package/docs/specs/gen-mock/design.md

@@ -1,241 +0,0 @@
-# 设计文档：gen_mock
-
-## 概述
-
-`gen_mock` 采用"提示词生成器"模式，返回 Mock 数据生成指南，指导 AI 根据数据结构生成符合语义的模拟数据。
-
----
-
-## 技术方案
-
-### 字段语义识别
-
-根据字段名自动识别数据类型：
-
-```typescript
-const FIELD_PATTERNS = {
-  // 个人信息
-  name: { pattern: /name|姓名/i, generator: "faker.person.fullName()" },
-  email: { pattern: /email|邮箱/i, generator: "faker.internet.email()" },
-  phone: { pattern: /phone|mobile|手机|电话/i, generator: "faker.phone.number()" },
-  avatar: { pattern: /avatar|头像/i, generator: "faker.image.avatar()" },
-  
-  // 地址
-  address: { pattern: /address|地址/i, generator: "faker.location.streetAddress()" },
-  city: { pattern: /city|城市/i, generator: "faker.location.city()" },
-  country: { pattern: /country|国家/i, generator: "faker.location.country()" },
-  
-  // 时间
-  date: { pattern: /date|日期/i, generator: "faker.date.recent()" },
-  createdAt: { pattern: /created|创建/i, generator: "faker.date.past()" },
-  updatedAt: { pattern: /updated|更新/i, generator: "faker.date.recent()" },
-  
-  // 业务
-  id: { pattern: /^id$|_id$/i, generator: "faker.string.uuid()" },
-  title: { pattern: /title|标题/i, generator: "faker.lorem.sentence()" },
-  description: { pattern: /desc|description|描述/i, generator: "faker.lorem.paragraph()" },
-  price: { pattern: /price|价格/i, generator: "faker.commerce.price()" },
-  status: { pattern: /status|状态/i, generator: "['active', 'inactive', 'pending']" },
-  url: { pattern: /url|链接/i, generator: "faker.internet.url()" },
-};
-```
-
-### 类型映射
-
-```typescript
-const TYPE_GENERATORS = {
-  string: "faker.lorem.word()",
-  number: "faker.number.int({ min: 1, max: 100 })",
-  boolean: "faker.datatype.boolean()",
-  Date: "faker.date.recent()",
-  "string[]": "faker.lorem.words(3).split(' ')",
-  "number[]": "[1, 2, 3]",
-};
-```
-
----
-
-## 架构设计
-
-### 工具结构
-
-```
-src/tools/gen_mock.ts
-├── genMock(args)                # 主函数
-│   ├── 验证参数
-│   ├── 构建生成指南
-│   └── 返回结果
-└── 常量定义
-    ├── FIELD_PATTERNS           # 字段模式
-    ├── TYPE_GENERATORS          # 类型生成器
-    └── PROMPT_TEMPLATE          # 提示词模板
-```
-
----
-
-## 提示词模板设计
-
-```markdown
-# Mock 数据生成指南
-
-## 🎯 生成目标
-
-**数据结构**:
-\`\`\`
-{schema}
-\`\`\`
-
-**生成数量**: {count} 条
-**输出格式**: {format}
-**语言区域**: {locale}
-
----
-
-## 📋 生成步骤
-
-### 步骤 1: 解析数据结构
-
-分析输入的数据结构，识别：
-1. 字段名称和类型
-2. 必填/可选字段
-3. 嵌套结构
-4. 数组类型
-
-### 步骤 2: 字段语义识别
-
-根据字段名匹配语义：
-
-| 字段名模式 | 生成规则 |
-|------------|----------|
-| name, 姓名 | 人名 |
-| email, 邮箱 | 邮箱格式 |
-| phone, 手机 | 手机号格式 |
-| address, 地址 | 地址 |
-| date, 日期 | 日期时间 |
-| id, _id | UUID |
-| title, 标题 | 短句 |
-| description, 描述 | 段落 |
-| price, 价格 | 金额 |
-| url, 链接 | URL |
-| avatar, 头像 | 图片 URL |
-| status, 状态 | 枚举值 |
-
-### 步骤 3: 生成数据
-
-根据识别结果生成数据：
-
-**中文数据示例**:
-- 姓名: 张三、李四、王五
-- 手机: 138xxxx1234
-- 地址: xx省xx市xx区xx路xx号
-
-**英文数据示例**:
-- Name: John Doe
-- Phone: +1-xxx-xxx-xxxx
-- Address: 123 Main St
-
-### 步骤 4: 格式化输出
-
-根据 format 参数输出：
-
-**JSON 格式**:
-\`\`\`json
-[
-  { "field": "value" },
-  { "field": "value" }
-]
-\`\`\`
-
-**TypeScript 格式**:
-\`\`\`typescript
-const mockData: Type[] = [
-  { field: "value" },
-  { field: "value" }
-];
-\`\`\`
-
----
-
-## 📊 输出模板
-
-### 单条数据
-
-\`\`\`json
-{
-  // 根据 schema 生成
-}
-\`\`\`
-
-### 批量数据
-
-\`\`\`json
-[
-  // {count} 条数据
-]
-\`\`\`
-
----
-
-## 🔧 高级功能
-
-### 关联数据生成
-
-如果需要生成有关联的数据：
-
-\`\`\`json
-// users
-[
-  { "id": "user-1", "name": "张三" }
-]
-
-// orders (关联 user_id)
-[
-  { "id": "order-1", "user_id": "user-1", "amount": 100 }
-]
-\`\`\`
-
-### 自定义规则
-
-支持在 schema 中添加注释指定规则：
-
-\`\`\`typescript
-interface User {
-  id: string;           // UUID
-  age: number;          // 18-60
-  status: string;       // "active" | "inactive"
-  tags: string[];       // 3-5 个标签
-}
-\`\`\`
-
----
-
-## ✅ 检查清单
-
-- [ ] 数据结构已正确解析
-- [ ] 字段语义已识别
-- [ ] 数据类型正确
-- [ ] 数量符合要求
-- [ ] 格式正确
-- [ ] 中文/英文符合 locale 设置
-```
-
----
-
-## 接口设计
-
-```typescript
-interface GenMockArgs {
-  schema: string;       // 必填，TS interface 或 JSON Schema
-  count?: number;       // 可选，默认 1
-  format?: string;      // 可选，默认 json
-  locale?: string;      // 可选，默认 zh-CN
-  seed?: number;        // 可选，随机种子
-}
-
-async function genMock(args: GenMockArgs): Promise<MCPResponse>
-```
-
----
-
-*设计版本: 1.0.0*
-*创建时间: 2025-01-14*