mcp-probe-kit 1.4.0 → 1.6.0

package/README.md

@@ -1,8 +1,10 @@
 # MCP Probe Kit
 
-> 🚀 Cursor 开发增强工具集 - 让 AI 更懂你的开发流程
+> 🚀 AI 开发增强工具集 - 让 AI 更懂你的开发流程
 
-一个强大的 MCP (Model Context Protocol) 服务器，提供 **24 个实用工具**，覆盖代码质量、开发效率、项目管理全流程。
+一个强大的 MCP (Model Context Protocol) 服务器，提供 **38 个实用工具**（30 个基础工具 + 8 个智能编排），覆盖代码质量、开发效率、项目管理全流程。
+
+**支持所有 MCP 客户端**：Cursor、Claude Desktop、Cline、Continue 等
 
 **作者**: [小墨 (Kyle)](https://www.bytezonex.com/) | **项目**: [GitHub](https://github.com/mybolide/mcp-probe-kit)
 
@@ -10,58 +12,98 @@
 
 ## ✨ 功能特性
 
-### 🔍 代码质量（7 个工具）
+### 🔍 代码质量（8 个工具）
 - **`detect_shell`** - AI 模型套壳检测
 - **`code_review`** - 代码审查助手
+- **`security_scan`** - 安全漏洞扫描 🆕
 - **`debug`** - 智能调试助手
 - **`gentest`** - 测试用例生成器
 - **`refactor`** - 重构建议
 - **`perf`** - 性能分析
-- **`fix`** - 自动修复代码问题 🆕
+- **`fix`** - 自动修复代码问题
 
-### 🛠️ 开发效率（12 个工具）
+### 🛠️ 开发效率（14 个工具）
 - **`gencommit`** - Git 提交消息生成
 - **`genapi`** - API 文档生成
 - **`gendoc`** - 代码注释生成
 - **`genpr`** - PR 描述生成
 - **`genchangelog`** - Changelog 生成
-- **`gensql`** - SQL 查询生成器 🆕
-- **`genui`** - UI 组件生成器（React + Vue） 🆕
-- **`explain`** - 代码解释器 🆕
-- **`convert`** - 代码转换器 🆕
-- **`css_order`** - CSS 属性顺序规范 🆕
-- **`genreadme`** - README 生成器 🆕
-- **`split`** - 文件拆分工具 🆕
-
-### 📦 项目管理（5 个工具）
+- **`gensql`** - SQL 查询生成器
+- **`genui`** - UI 组件生成器（React + Vue）
+- **`gen_mock`** - Mock 数据生成器 🆕
+- **`explain`** - 代码解释器
+- **`convert`** - 代码转换器
+- **`css_order`** - CSS 属性顺序规范
+- **`genreadme`** - README 生成器
+- **`split`** - 文件拆分工具
+- **`fix_bug`** - Bug 修复流程指南 🆕
+- **`estimate`** - 工作量估算 🆕
+
+### 📦 项目管理（8 个工具）
 - **`init_setting`** - Cursor AI 配置初始化
 - **`init_project`** - Spec-Driven 项目初始化
 - **`check_deps`** - 依赖健康度检查
-- **`resolve_conflict`** - Git 冲突解决助手 🆕
-- **`analyze_project`** - 项目分析工具，帮助AI快速理解老项目 🆕
+- **`resolve_conflict`** - Git 冲突解决助手
+- **`analyze_project`** - 项目分析工具，帮助AI快速理解老项目
+- **`init_project_context`** - 初始化项目上下文，生成技术栈和架构文档 🆕
+- **`add_feature`** - 添加新功能，生成需求/设计/任务文档 🆕
+- **`start_onboard`** - 快速上手项目（智能编排）🆕
+
+### 🚀 智能编排（8 个工具）
+
+智能编排工具自动组合多个基础工具，一键完成复杂工作流：
+
+- **`start_feature`** - 新功能开发：上下文 → 功能规格 → 工作量估算 🆕
+- **`start_bugfix`** - Bug 修复：上下文 → 分析修复 → 测试 → 提交 🆕
+- **`start_review`** - 代码体检：上下文 → 质量审查 → 安全扫描 → 性能分析 🆕
+- **`start_release`** - 发布准备：上下文 → Changelog → PR 描述 🆕
+- **`start_refactor`** - 代码重构：上下文 → 审查 → 重构 → 测试 🆕
+- **`start_onboard`** - 快速上手：项目分析 → 生成上下文文档 🆕
+- **`start_api`** - API 开发：上下文 → API 文档 → Mock 数据 → 测试 🆕
+- **`start_doc`** - 文档生成：上下文 → 代码注释 → README → API 文档 🆕
 
 ---
 
 ## 🚀 快速开始
 
+### 支持的 MCP 客户端
+
+本工具支持所有实现了 MCP 协议的客户端：
+
+| 客户端 | 配置文件位置 | 说明 |
+|--------|-------------|------|
+| **Cursor** | `cline_mcp_settings.json` | AI 代码编辑器 |
+| **Claude Desktop** | `claude_desktop_config.json` | Anthropic 官方桌面应用 |
+| **Cline** | `cline_mcp_settings.json` | VS Code 扩展 |
+| **Continue** | `config.json` | VS Code/JetBrains 扩展 |
+| **Zed** | `settings.json` | 现代代码编辑器 |
+| **其他** | 查看对应文档 | 任何支持 MCP 的工具 |
+
+---
+
 ### 📦 方式一：npx 直接使用（推荐）
 
 无需安装，直接使用：
 
-```bash
-# 在 Cursor 中配置 MCP 服务器
-```
+#### Cursor / Cline 配置
+
+**配置文件位置：**
 
-**Windows 配置路径：**
+**Windows:**
 ```
 %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
 ```
 
-**macOS/Linux 配置路径：**
+**macOS:**
 ```
 ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
 ```
 
+**Linux:**
+```
+~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+```
+
 **配置内容：**
 ```json
 {
@@ -75,17 +117,83 @@
 }
 ```
 
----
+#### Claude Desktop 配置
+
+**配置文件位置：**
+
+**Windows:**
+```
+%APPDATA%\Claude\claude_desktop_config.json
+```
+
+**macOS:**
+```
+~/Library/Application Support/Claude/claude_desktop_config.json
+```
+
+**Linux:**
+```
+~/.config/Claude/claude_desktop_config.json
+```
+
+**配置内容：**
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "npx",
+      "args": ["-y", "mcp-probe-kit@latest"]
+    }
+  }
+}
+```
+
+#### Continue 配置
+
+**配置文件位置：**
+```
+~/.continue/config.json
+```
+
+**配置内容：**
+```json
+{
+  "experimental": {
+    "modelContextProtocolServers": [
+      {
+        "transport": {
+          "type": "stdio",
+          "command": "npx",
+          "args": ["-y", "mcp-probe-kit@latest"]
+        }
+      }
+    ]
+  }
+}
+```
 
 ### 📦 方式二：全局安装
 
 ```bash
 # 全局安装
 npm install -g mcp-probe-kit
+```
+
+#### Cursor / Cline 配置
 
-# 在 Cursor 中配置
+**配置内容：**
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "mcp-probe-kit"
+    }
+  }
+}
 ```
 
+#### Claude Desktop 配置
+
 **配置内容：**
 ```json
 {
@@ -104,10 +212,24 @@ npm install -g mcp-probe-kit
 ```bash
 # 在项目中安装
 npm install mcp-probe-kit
+```
+
+#### Cursor / Cline 配置
 
-# 在 Cursor 中配置（使用项目路径）
+**配置内容：**
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "node",
+      "args": ["./node_modules/mcp-probe-kit/build/index.js"]
+    }
+  }
+}
 ```
 
+#### Claude Desktop 配置
+
 **配置内容：**
 ```json
 {
@@ -126,12 +248,14 @@ npm install mcp-probe-kit
 
 如果你在本地开发或修改工具：
 
+#### Cursor / Cline
+
 **Windows:**
 ```
 %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
 ```
 
-**macOS/Linux:**
+**macOS:**
 ```
 ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
 ```
@@ -150,9 +274,26 @@ npm install mcp-probe-kit
 
 ⚠️ **重要**：将路径修改为你的实际项目路径
 
-### 🔄 重启 Cursor
+#### Claude Desktop
+
+**配置内容：**
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "node",
+      "args": ["/path/to/your/mcp-probe-kit/build/index.js"]
+    }
+  }
+}
+```
+
+### 🔄 重启客户端
 
-配置完成后，**完全退出 Cursor 再重新打开**（不是重新加载窗口）
+配置完成后，**重启你的 MCP 客户端**：
+- **Cursor**: 完全退出后重新打开（不是重新加载窗口）
+- **Claude Desktop**: 退出后重新打开
+- **VS Code (Cline/Continue)**: 重新加载窗口（Ctrl/Cmd + Shift + P → Reload Window）
 
 ---
 
@@ -212,7 +353,7 @@ npm install mcp-probe-kit
 
 ---
 
-#### `fix` - 自动修复 🆕
+#### `fix` - 自动修复
 自动修复代码问题（Lint 错误、TypeScript 类型错误、格式化问题）。
 
 **用法**：`fix @file.ts` 或 `fix`（修复所有文件）
@@ -228,6 +369,34 @@ npm install mcp-probe-kit
 
 ---
 
+#### `security_scan` - 安全扫描 🆕
+全面扫描代码安全漏洞，检测注入、认证、加密等问题。
+
+**用法**：`security_scan @file.ts`
+
+**扫描类型**：
+- **all**（默认）- 全面扫描
+- **injection** - 注入类漏洞（SQL注入、XSS、命令注入）
+- **auth** - 认证授权问题
+- **crypto** - 加密安全问题
+- **sensitive_data** - 敏感数据泄露
+
+**检测内容**：
+- SQL 注入、XSS、命令注入
+- 硬编码密码/密钥
+- 弱加密算法（MD5、SHA1）
+- 不安全随机数
+- 日志泄露敏感信息
+- 错误信息泄露
+
+**输出**：
+- 漏洞摘要（按严重程度分类）
+- 详细漏洞列表（含 CWE 编号）
+- 修复建议和示例代码
+- 安全最佳实践
+
+---
+
 ### 🛠️ 开发效率工具
 
 #### `gencommit` - 提交生成
@@ -294,7 +463,7 @@ feat: 🎸 添加用户登录功能
 
 ---
 
-#### `gensql` - SQL 生成器 🆕
+#### `gensql` - SQL 生成器
 根据自然语言描述生成 SQL 查询语句。
 
 **用法**：`gensql` 然后描述需求（如："查询购买金额超过平均值的用户"）
@@ -309,7 +478,7 @@ feat: 🎸 添加用户登录功能
 
 ---
 
-#### `genui` - UI 组件生成器（React + Vue） 🆕
+#### `genui` - UI 组件生成器（React + Vue）
 生成 React 或 Vue 3 UI 组件代码。
 
 **用法**：`genui` 然后描述组件（如："创建一个带加载状态的 Button 组件"）
@@ -329,7 +498,7 @@ feat: 🎸 添加用户登录功能
 
 ---
 
-#### `explain` - 代码解释器 🆕
+#### `explain` - 代码解释器
 详细解释代码逻辑和原理，帮助理解复杂代码。
 
 **用法**：`explain @complex-code.ts`
@@ -350,10 +519,10 @@ feat: 🎸 添加用户登录功能
 
 ---
 
-#### `convert` - 代码转换器 🆕
-转换代码格式或框架。
-
-**用法**：`convert @file.js` 然后说明转换类型（如："转为 TypeScript"）
+#### `convert` - 代码转换器
+转换代码格式或框架。
+
+**用法**：`convert @file.js` 然后说明转换类型（如："转为 TypeScript"）
 
 **支持转换**：
 - JavaScript → TypeScript
@@ -361,22 +530,22 @@ feat: 🎸 添加用户登录功能
 - Promises → Async/Await
 - CommonJS → ESM
 - CSS → Tailwind CSS
-- Vue 2 → Vue 3
-- JSON → TypeScript Interface
-
----
-
-#### `css_order` - CSS 顺序规范 🆕
-按规则书写或重排 CSS 属性顺序。
-
-**用法**：`css_order`
-
-**包含**：由外向内排序逻辑、五大类属性划分、常用属性示例、快速对比表、重排要求
-
----
-
-#### `genreadme` - README 生成器 🆕
-根据项目代码自动生成 README.md 文档。
+- Vue 2 → Vue 3
+- JSON → TypeScript Interface
+
+---
+
+#### `css_order` - CSS 顺序规范
+按规则书写或重排 CSS 属性顺序。
+
+**用法**：`css_order`
+
+**包含**：由外向内排序逻辑、五大类属性划分、常用属性示例、快速对比表、重排要求
+
+---
+
+#### `genreadme` - README 生成器
+根据项目代码自动生成 README.md 文档。
 
 **用法**：`genreadme` 或提供项目信息
 
@@ -393,7 +562,7 @@ feat: 🎸 添加用户登录功能
 
 ---
 
-#### `split` - 文件拆分工具 🆕
+#### `split` - 文件拆分工具
 将大文件拆分成多个小文件或小组件，提高可维护性。
 
 **用法**：`split @LargeFile.tsx` 或提供文件内容
@@ -420,6 +589,94 @@ feat: 🎸 添加用户登录功能
 
 ---
 
+#### `fix_bug` - Bug 修复流程 🆕
+指导完整的 Bug 修复流程，从问题定位到验证测试。
+
+**用法**：`fix_bug` 然后提供错误信息
+
+**参数**：
+- `error_message` - 错误信息（必填）
+- `stack_trace` - 堆栈跟踪（可选）
+- `steps_to_reproduce` - 复现步骤（可选）
+- `expected_behavior` - 期望行为（可选）
+- `actual_behavior` - 实际行为（可选）
+
+**修复流程**：
+1. **问题定位** - 分析错误信息和堆栈，定位问题代码
+2. **原因分析** - 使用 5 Whys 方法分析根本原因
+3. **修复方案** - 设计修复方案，评估风险
+4. **验证测试** - 生成测试用例，确保修复有效
+
+**输出**：
+- 问题定位结论
+- 根本原因分析
+- 修复方案和代码
+- 测试用例
+- 修复检查清单
+
+---
+
+#### `estimate` - 工作量估算 🆕
+评估开发任务的工作量，提供故事点和时间估算。
+
+**用法**：`estimate` 然后描述任务
+
+**参数**：
+- `task_description` - 任务描述（必填）
+- `code_context` - 相关代码（可选）
+- `team_size` - 团队规模（可选，默认 1）
+- `experience_level` - 经验水平（可选，默认 mid）
+
+**估算维度**：
+- **代码量** - 预估新增/修改行数
+- **技术难度** - 1-5 级评分
+- **依赖复杂度** - 涉及的模块数
+- **测试复杂度** - 需要的测试类型
+
+**输出**：
+- 故事点估算（1/2/3/5/8/13）
+- 时间估算（乐观/正常/悲观）
+- 复杂度分析
+- 风险识别
+- 任务分解建议（如超过 8 小时）
+
+---
+
+#### `gen_mock` - Mock 数据生成 🆕
+根据数据结构生成符合语义的模拟数据。
+
+**用法**：`gen_mock` 然后提供数据结构
+
+**参数**：
+- `schema` - 数据结构（TypeScript interface 或 JSON Schema）
+- `count` - 生成数量（默认 1，最大 1000）
+- `format` - 输出格式（json/typescript/javascript/csv）
+- `locale` - 语言区域（zh-CN/en-US）
+- `seed` - 随机种子（可重复生成）
+
+**智能识别**：
+- 根据字段名自动识别语义（name→人名、email→邮箱）
+- 支持中英文数据生成
+- 自动处理关联数据
+
+**字段识别**：
+- id → UUID
+- name → 人名
+- email → 邮箱格式
+- phone → 手机号
+- address → 地址
+- date → 日期时间
+- price → 金额
+- status → 枚举值
+
+**输出格式**：
+- JSON - 标准 JSON 数组
+- TypeScript - 带类型定义
+- JavaScript - CommonJS/ESM
+- CSV - 表格数据（仅扁平结构）
+
+---
+
 ### 📦 项目管理工具
 
 #### `init_setting` - 配置初始化
@@ -451,7 +708,7 @@ feat: 🎸 添加用户登录功能
 
 ---
 
-#### `resolve_conflict` - Git 冲突解决 🆕
+#### `resolve_conflict` - Git 冲突解决
 分析并帮助解决 Git 合并冲突。
 
 **用法**：`resolve_conflict` 然后粘贴冲突内容，或直接打开冲突文件
@@ -470,7 +727,7 @@ feat: 🎸 添加用户登录功能
 
 ---
 
-#### `analyze_project` - 项目分析工具 🆕
+#### `analyze_project` - 项目分析工具
 深度分析项目结构、代码质量和架构，帮助AI快速理解老项目。
 
 **用法**：`analyze_project` 或 `analyze_project @project-path`
@@ -496,6 +753,301 @@ feat: 🎸 添加用户登录功能
 - 📚 项目文档生成
 - 🤖 AI助手更好地理解项目上下文
 
+---
+
+#### `init_project_context` - 初始化项目上下文 🆕
+生成项目上下文文档，记录技术栈、架构和规范，供后续功能开发参考。
+
+**用法**：`init_project_context`
+
+**参数**：
+- `docs_dir` - 文档目录（默认 docs）
+
+**生成内容**：
+- 项目概览（名称、版本、类型）
+- 技术栈（语言、框架、构建工具）
+- 项目结构（目录树、入口文件）
+- 架构模式（设计模式、模块划分）
+- 编码规范（ESLint、Prettier、命名规范）
+- 依赖管理（主要依赖列表）
+- 开发流程（常用命令）
+
+**输出文件**：`docs/project-context.md`
+
+**适用场景**：
+- 🆕 新项目初始化后记录项目信息
+- 📚 为 AI 提供项目上下文
+- 🔄 功能开发前了解项目规范
+
+---
+
+#### `add_feature` - 添加新功能 🆕
+为已有项目生成新功能的规格文档（需求、设计、任务清单）。
+
+**用法**：`add_feature` 然后提供功能名称和描述
+
+**参数**：
+- `feature_name` - 功能名称（必填，kebab-case 格式，如 user-auth）
+- `description` - 功能描述（必填）
+- `docs_dir` - 文档目录（默认 docs）
+
+**生成文件**：
+- `docs/specs/{feature_name}/requirements.md` - 需求文档（EARS 格式）
+- `docs/specs/{feature_name}/design.md` - 设计文档
+- `docs/specs/{feature_name}/tasks.md` - 任务清单
+
+**适用场景**：
+- 🎯 规范化功能开发流程
+- 📋 Spec-Driven Development
+- 🤖 AI 辅助功能实现
+
+---
+
+### 🚀 智能编排工具
+
+智能编排工具自动组合多个基础工具，一键完成复杂工作流。所有编排工具都会自动检查并生成项目上下文。
+
+#### `start_feature` - 新功能开发 🆕
+一键完成新功能开发的完整流程。
+
+**用法**：`start_feature user-auth "用户登录认证功能"`
+
+**参数**：
+- `feature_name` - 功能名称（必填）
+- `description` - 功能描述（必填）
+- `docs_dir` - 文档目录（可选）
+
+**编排流程**：
+```
+检查/生成项目上下文
+    ↓
+调用 add_feature 生成功能规格
+    ↓
+调用 estimate 进行工作量估算
+    ↓
+输出完整报告
+```
+
+**输出**：
+- 完整的功能规格文档（需求/设计/任务）
+- 工作量估算（故事点 + 时间）
+- 风险识别
+- 下一步建议
+
+---
+
+#### `start_bugfix` - Bug 修复 🆕
+一键完成 Bug 修复的完整流程。
+
+**用法**：`start_bugfix` 然后提供错误信息
+
+**参数**：
+- `error_message` - 错误信息（必填）
+- `stack_trace` - 堆栈跟踪（可选）
+
+**编排流程**：
+```
+检查/生成项目上下文
+    ↓
+调用 fix_bug 分析修复
+    ↓
+调用 gentest 生成测试
+    ↓
+输出完整报告
+```
+
+**输出**：
+- Bug 原因分析
+- 修复方案和代码
+- 回归测试代码
+
+---
+
+#### `start_review` - 代码体检 🆕
+一键完成代码全面体检。
+
+**用法**：`start_review @file.ts`
+
+**参数**：
+- `code` - 需要审查的代码（必填）
+- `language` - 编程语言（可选）
+
+**编排流程**：
+```
+检查/生成项目上下文
+    ↓
+调用 code_review 质量审查
+    ↓
+调用 security_scan 安全扫描
+    ↓
+调用 perf 性能分析
+    ↓
+生成综合报告
+```
+
+**输出**：
+- 代码质量评分
+- 安全漏洞报告
+- 性能优化建议
+- 综合修复优先级
+
+---
+
+#### `start_release` - 发布准备 🆕
+一键完成版本发布准备。
+
+**用法**：`start_release v1.2.0`
+
+**参数**：
+- `version` - 版本号（必填，如 v1.2.0）
+- `from_tag` - 起始 tag（可选）
+- `branch` - 分支名称（可选）
+
+**编排流程**：
+```
+检查/生成项目上下文
+    ↓
+调用 genchangelog 生成变更日志
+    ↓
+调用 genpr 生成 PR 描述
+    ↓
+输出发布清单
+```
+
+**输出**：
+- CHANGELOG.md 内容
+- PR 描述
+- 发布检查清单
+
+---
+
+#### `start_refactor` - 代码重构 🆕
+一键完成代码重构流程。
+
+**用法**：`start_refactor @legacy-code.ts`
+
+**参数**：
+- `code` - 需要重构的代码（必填）
+- `goal` - 重构目标（可选）
+
+**编排流程**：
+```
+检查/生成项目上下文
+    ↓
+调用 code_review 发现问题
+    ↓
+调用 refactor 生成重构方案
+    ↓
+调用 gentest 生成保护测试
+    ↓
+输出重构报告
+```
+
+**输出**：
+- 问题清单
+- 重构前后对比
+- 改进说明
+- 测试代码
+
+---
+
+#### `start_onboard` - 快速上手 🆕
+一键快速了解项目。
+
+**用法**：`start_onboard`
+
+**参数**：
+- `project_path` - 项目路径（可选）
+- `docs_dir` - 文档目录（可选）
+
+**编排流程**：
+```
+调用 analyze_project 分析项目
+    ↓
+调用 init_project_context 生成上下文
+    ↓
+输出项目概览
+```
+
+**输出**：
+- 项目概览（类型、技术栈）
+- 项目结构
+- 核心文件说明
+- 快速开始指南
+- 项目上下文文档
+
+---
+
+#### `start_api` - API 开发 🆕
+一键完成 API 开发资料生成。
+
+**用法**：`start_api @api/user.ts`
+
+**参数**：
+- `code` - API 代码（必填）
+- `language` - 编程语言（可选）
+- `format` - 文档格式（可选）
+
+**编排流程**：
+```
+检查/生成项目上下文
+    ↓
+调用 genapi 生成 API 文档
+    ↓
+调用 gen_mock 生成 Mock 数据
+    ↓
+调用 gentest 生成 API 测试
+    ↓
+输出完整资料
+```
+
+**输出**：
+- API 文档
+- Mock 数据
+- 测试代码
+- 使用建议
+
+---
+
+#### `start_doc` - 文档生成 🆕
+一键生成完整的项目文档。
+
+**用法**：`start_doc @src/`
+
+**参数**：
+- `code` - 代码或项目信息（必填）
+- `style` - 注释风格（可选）
+- `lang` - 语言（可选）
+
+**编排流程**：
+```
+检查/生成项目上下文
+    ↓
+调用 gendoc 生成代码注释
+    ↓
+调用 genreadme 生成 README
+    ↓
+调用 genapi 生成 API 文档
+    ↓
+输出文档清单
+```
+
+**输出**：
+- 带注释的代码
+- README.md
+- API 文档
+- 文档清单
+
+---
+
+---
+
+## 📚 文档
+
+- **[如何让 AI 正确调用工具](docs/HOW_TO_TRIGGER.md)** ⭐ 推荐阅读 - 实用的对话技巧
+- **[最佳实践](docs/BEST_PRACTICES.md)** - 完整的工具调用指南和使用技巧
+- **[工具列表](#功能特性)** - 所有工具的详细说明
+- **[常见问题](#常见问题)** - FAQ
 
 ---
 
@@ -528,9 +1080,19 @@ feat: 🎸 添加用户登录功能
 ### 🔍 接手老项目
 ```
 1. analyze_project                # 深度分析项目结构
-2. check_deps                     # 检查依赖健康度
-3. code_review                    # 代码质量审查
-4. 开始维护和开发...
+2. init_project_context           # 生成项目上下文文档
+3. check_deps                     # 检查依赖健康度
+4. code_review                    # 代码质量审查
+5. 开始维护和开发...
+```
+
+### 🎯 添加新功能（Spec-Driven）
+```
+1. init_project_context           # 确保项目上下文存在
+2. add_feature user-auth "用户登录认证功能"  # 生成功能规格
+3. 根据 tasks.md 逐步实现
+4. gentest @feature.ts            # 生成测试
+5. gencommit                      # 提交代码
 ```
 
 ### 📦 版本发布
@@ -549,6 +1111,45 @@ feat: 🎸 添加用户登录功能
 4. gencommit                    # 提交优化
 ```
 
+### 🚀 使用智能编排（推荐）
+
+#### 新功能开发
+```
+start_feature user-auth "用户登录认证功能"
+# 自动完成：检查上下文 → 生成规格 → 工作量估算
+```
+
+#### Bug 修复
+```
+start_bugfix
+# 然后粘贴错误信息
+# 自动完成：分析 → 修复 → 测试 → 提交消息
+```
+
+#### 代码体检
+```
+start_review @feature.ts
+# 自动完成：质量审查 → 安全扫描 → 性能分析
+```
+
+#### 快速上手项目
+```
+start_onboard
+# 自动完成：项目分析 → 生成上下文文档
+```
+
+#### API 开发
+```
+start_api @api/user.ts
+# 自动完成：API 文档 → Mock 数据 → 测试代码
+```
+
+#### 发布准备
+```
+start_release v1.2.0
+# 自动完成：Changelog → PR 描述 → 发布清单
+```
+
 ---
 
 ## 🛠️ 开发指南
@@ -558,10 +1159,11 @@ feat: 🎸 添加用户登录功能
 mcp-probe-kit/
 ├── src/
 │   ├── index.ts              # MCP 服务器主入口
-│   └── tools/                # 工具实现（24 个）
+│   └── tools/                # 工具实现（38 个）
 │       ├── index.ts             # 工具导出
 │       ├── detect_shell.ts      # 套壳检测
 │       ├── code_review.ts       # 代码审查
+│       ├── security_scan.ts     # 安全扫描 🆕
 │       ├── debug.ts             # 调试助手
 │       ├── gentest.ts           # 测试生成
 │       ├── refactor.ts          # 重构建议
@@ -574,16 +1176,29 @@ mcp-probe-kit/
 │       ├── genchangelog.ts      # Changelog 生成
 │       ├── gensql.ts            # SQL 生成器
 │       ├── genui.ts             # UI 组件生成器
-│       ├── explain.ts           # 代码解释器
-│       ├── convert.ts           # 代码转换器
-│       ├── css_order.ts         # CSS 顺序规范
-│       ├── genreadme.ts         # README 生成器
+│       ├── gen_mock.ts          # Mock 数据生成 🆕
+│       ├── explain.ts           # 代码解释器
+│       ├── convert.ts           # 代码转换器
+│       ├── css_order.ts         # CSS 顺序规范
+│       ├── genreadme.ts         # README 生成器
 │       ├── split.ts             # 文件拆分工具
+│       ├── fix_bug.ts           # Bug 修复流程 🆕
+│       ├── estimate.ts          # 工作量估算 🆕
 │       ├── init_setting.ts      # 配置初始化
 │       ├── init_project.ts      # 项目初始化
 │       ├── check_deps.ts        # 依赖检查
 │       ├── resolve_conflict.ts  # Git 冲突解决
-│       └── analyze_project.ts   # 项目分析
+│       ├── analyze_project.ts   # 项目分析
+│       ├── init_project_context.ts  # 项目上下文初始化
+│       ├── add_feature.ts       # 添加新功能
+│       ├── start_feature.ts     # 智能编排：新功能开发 🆕
+│       ├── start_bugfix.ts      # 智能编排：Bug 修复 🆕
+│       ├── start_review.ts      # 智能编排：代码体检 🆕
+│       ├── start_release.ts     # 智能编排：发布准备 🆕
+│       ├── start_refactor.ts    # 智能编排：代码重构 🆕
+│       ├── start_onboard.ts     # 智能编排：快速上手 🆕
+│       ├── start_api.ts         # 智能编排：API 开发 🆕
+│       └── start_doc.ts         # 智能编排：文档生成 🆕
 ├── build/                    # 编译输出
 ├── package.json
 ├── tsconfig.json
@@ -682,14 +1297,15 @@ npx -y mcp-probe-kit@latest 2>&1 | tee ./mcp-probe-kit.log
 
 这会将错误信息保存到 `mcp-probe-kit.log` 文件中，方便排查问题或提交 Issue。
 
-### Q2: 配置后 Cursor 无法识别工具？
+### Q2: 配置后客户端无法识别工具？
 
-1. **完全退出 Cursor** 并重新打开（不是重新加载窗口）
+1. **重启客户端**（完全退出后重新打开）
 2. 检查配置文件路径是否正确：
-   - Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
-   - macOS/Linux: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+   - **Cursor/Cline**: 查看上方配置路径
+   - **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
+   - **Continue**: `~/.continue/config.json`
 3. 确认 JSON 格式正确，没有语法错误
-4. 查看 Cursor 的开发者工具（Help → Toggle Developer Tools）中的控制台日志
+4. 查看客户端的开发者工具或日志中的错误信息
 
 ### Q3: npx 方式每次都很慢？
 
@@ -787,40 +1403,57 @@ MIT License
 ### 为什么叫 Probe Kit？
 
 - **Probe（探针）**：探测代码质量、性能瓶颈、依赖健康度
-- **Kit（工具集）**：24 个工具覆盖开发全流程
+- **Kit（工具集）**：24 个工具覆盖开发全流程
 
 ### 工具分类
 
 ```
-代码质量 (7)
-├── detect_shell  套壳检测
-├── code_review   代码审查
-├── debug         调试助手
-├── gentest       测试生成
-├── refactor      重构建议
-├── perf          性能分析
-└── fix           自动修复
-
-开发效率 (12)
-├── gencommit     提交生成
-├── genapi        文档生成
-├── gendoc        注释生成
-├── genpr         PR 生成
-├── genchangelog  Changelog 生成
-├── gensql        SQL 生成器
-├── genui         UI 组件生成器
-├── explain       代码解释器
-├── convert       代码转换器
-├── css_order     CSS 顺序规范
-├── genreadme     README 生成器
-└── split         文件拆分工具
-
-项目管理 (5)
-├── init_setting     配置初始化
-├── init_project     项目初始化
-├── check_deps       依赖检查
-├── resolve_conflict Git 冲突解决
-└── analyze_project  项目分析工具
+代码质量 (8)
+├── detect_shell     套壳检测
+├── code_review      代码审查
+├── security_scan    安全扫描 🆕
+├── debug            调试助手
+├── gentest          测试生成
+├── refactor         重构建议
+├── perf             性能分析
+└── fix              自动修复
+
+开发效率 (14)
+├── gencommit        提交生成
+├── genapi           文档生成
+├── gendoc           注释生成
+├── genpr            PR 生成
+├── genchangelog     Changelog 生成
+├── gensql           SQL 生成器
+├── genui            UI 组件生成器
+├── gen_mock         Mock 数据生成 🆕
+├── explain          代码解释器
+├── convert          代码转换器
+├── css_order        CSS 顺序规范
+├── genreadme        README 生成器
+├── split            文件拆分工具
+├── fix_bug          Bug 修复流程 🆕
+└── estimate         工作量估算 🆕
+
+项目管理 (8)
+├── init_setting         配置初始化
+├── init_project         项目初始化
+├── check_deps           依赖检查
+├── resolve_conflict     Git 冲突解决
+├── analyze_project      项目分析工具
+├── init_project_context 项目上下文初始化
+├── add_feature          添加新功能
+└── start_onboard        快速上手（编排）🆕
+
+智能编排 (8)
+├── start_feature    新功能开发 🆕
+├── start_bugfix     Bug 修复 🆕
+├── start_review     代码体检 🆕
+├── start_release    发布准备 🆕
+├── start_refactor   代码重构 🆕
+├── start_onboard    快速上手 🆕
+├── start_api        API 开发 🆕
+└── start_doc        文档生成 🆕
 ```
 
 ---