mcp-probe-kit 2.5.0 → 3.0.1

package/README.md

@@ -7,157 +7,159 @@
 
 > 🚀 AI 驱动的完整研发工具集 - 覆盖开发全流程
 
-一个强大的 MCP (Model Context Protocol) 服务器，提供 **39 个实用工具**，覆盖从产品分析到最终发布的全流程（需求 → 设计 → 开发 → 质量 → 发布），核心与编排工具支持**结构化输出**。
+一个强大的 MCP (Model Context Protocol) 服务器，提供 **20 个精简工具**，覆盖从产品分析到最终发布的全流程（需求 → 设计 → 开发 → 质量 → 发布），所有工具支持**结构化输出**。
 
-**🎉 v2.5 特性**：委托式编排协议、需求澄清 Loop、模板档位（auto/guided/strict）、产品设计工作流（PRD → 原型 → HTML）、结构化输出
-
-**支持所有 MCP 客户端**：Cursor、Claude Desktop、Cline、Continue 等
-
-**协议版本**：MCP 2025-11-25 · **SDK**：@modelcontextprotocol/sdk 1.25.3
-
----
+**🎉 v3.0 重大更新**：精简工具数量，专注核心竞争力，消除选择困难，让 AI 做更多原生工作
+
+**支持所有 MCP 客户端**：Cursor、Claude Desktop、Cline、Continue 等
+
+**协议版本**：MCP 2025-11-25 · **SDK**：@modelcontextprotocol/sdk 1.25.3
+
+---
 
 ## 📚 完整文档
 
 **👉 [https://mcp-probe-kit.bytezonex.com](https://mcp-probe-kit.bytezonex.com/)**
 
 - [快速开始](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html) - 5分钟完成安装配置
-- [所有工具](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - 39个工具完整列表
+- [所有工具](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - 20个工具完整列表
 - [最佳实践](https://mcp-probe-kit.bytezonex.com/pages/examples.html) - 完整研发流程实战指南
-- [迁移指南](https://mcp-probe-kit.bytezonex.com/pages/migration.html) - 版本升级指南
+- [v3.0 迁移指南](https://mcp-probe-kit.bytezonex.com/pages/migration.html) - v2.x → v3.0 升级指南
 
 ---
 
 ## ✨ 核心特性
 
-### 📦 39 个实用工具
-
-- **🔄 工作流编排** (11个) - 一键完成复杂开发流程
-- **🔍 代码分析** (5个) - 代码审查、安全扫描、性能优化
-- **🌿 Git 工具** (4个) - 自动生成 commit、PR、changelog
-- **✨ 生成工具** (6个) - 文档、测试、Mock 数据生成
-- **📋 项目管理** (6个) - 项目上下文、需求访谈、工作量估算
-- **🎨 UI/UX 工具** (5个) - 设计系统、组件目录、模板搜索与渲染
-- **🚀 产品设计** (2个) - PRD、原型设计
-
-### 🎯 结构化输出
-
-核心与编排工具支持**结构化输出**，返回机器可读的 JSON 数据，提高 AI 解析准确性，支持工具串联和状态追踪。
-
-### 🧭 委托式编排协议（Delegated Plan）
-
-所有 `start_*` 编排工具会在 `structuredContent.metadata.plan` 中返回**执行计划**。  
-AI 需要**按步骤调用工具并落盘文件**，而不是由工具内部直接执行。
-
-**Plan Schema（核心字段）**:
-```json
-{
-  "mode": "delegated",
-  "steps": [
-    {
-      "id": "spec",
-      "tool": "add_feature",
-      "args": { "feature_name": "user-auth", "description": "用户认证功能" },
-      "outputs": ["docs/specs/user-auth/requirements.md"]
-    }
-  ]
-}
-```
-
-**字段说明**:
-- `mode`: 固定为 `delegated`
-- `steps`: 执行步骤数组
-- `tool`: 工具名称（如 `add_feature`）
-- `action`: 无工具时的手动动作描述（如 `update_project_context`）
-- `args`: 工具参数
-- `outputs`: 预期产物
-- `when/dependsOn/note`: 可选的条件与说明
-
-### 🧩 结构化输出字段规范（关键字段）
-
-编排与原子工具都会返回 `structuredContent`，常用字段约定如下：
-- `summary`: 一句话摘要
-- `status`: 状态（pending/success/failed/partial）
-- `steps`: 执行步骤（编排工具）
-- `artifacts`: 产物列表（路径 + 用途）
-- `metadata.plan`: 委托式执行计划（仅 start_*）
-- `specArtifacts`: 规格文档产物（start_feature）
-- `estimate`: 估算结果（start_feature / estimate）
-
-### 🧠 需求澄清模式（Requirements Loop）
-
-当需求不够清晰时，可在 `start_feature / start_bugfix / start_ui` 中使用 `requirements_mode=loop`。  
-该模式会先进行 1-2 轮结构化澄清，再进入规格/修复/UI 执行流程。
-
-**示例：**
-```json
-{
-  "feature_name": "user-auth",
-  "description": "用户认证功能",
-  "requirements_mode": "loop",
-  "loop_max_rounds": 2,
-  "loop_question_budget": 5
-}
-```
-
-### 🧩 模板系统（普通模型友好）
-
-`add_feature` 支持模板档位，默认 `auto` 自动选择：需求不完整时偏向 `guided`（包含更详细的填写规则与检查清单），需求较完整时选择 `strict`（结构更紧凑，适合高能力模型或归档场景）。
-
-**示例：**
-```json
-{
-  "description": "添加用户认证功能",
-  "template_profile": "auto"
-}
-```
-
-**适用工具**：
-- `start_feature` 会透传 `template_profile` 给 `add_feature`
-- `start_bugfix` / `start_ui` 也支持 `template_profile`，用于控制指导强度（auto/guided/strict）
-
-**模板档位策略**：
-- `guided`：需求信息少/不完整、普通模型优先
-- `strict`：需求已结构化、希望指引更紧凑
-- `auto`：默认推荐，自动选择 guided/strict
-
-### 🔄 工作流编排
-
-11 个智能编排工具，自动组合多个基础工具，一键完成复杂开发流程：
+### 📦 20 个精简工具
+
+- **🔄 工作流编排** (6个) - 一键完成复杂开发流程
+  - `start_feature`, `start_bugfix`, `start_onboard`, `start_ui`, `start_product`, `start_ralph`
+- **🔍 代码分析** (3个) - 代码质量与重构
+  - `code_review`, `fix_bug`, `refactor`
+- **� Git 工具** (1个) - 提交消息生成
+  - `gencommit`
+- **⚡ 代码生成** (1个) - 测试生成
+  - `gentest`
+- **📦 项目管理** (7个) - 项目初始化与需求管理
+  - `init_project`, `init_project_context`, `add_feature`, `estimate`, `interview`, `ask_user`
+- **🎨 UI/UX 工具** (3个) - 设计系统与数据同步
+  - `ui_design_system`, `ui_search`, `sync_ui_data`
+
+### 🎯 结构化输出
+
+核心与编排工具支持**结构化输出**，返回机器可读的 JSON 数据，提高 AI 解析准确性，支持工具串联和状态追踪。
+
+### 🧭 委托式编排协议（Delegated Plan）
+
+所有 `start_*` 编排工具会在 `structuredContent.metadata.plan` 中返回**执行计划**。  
+AI 需要**按步骤调用工具并落盘文件**，而不是由工具内部直接执行。
+
+**Plan Schema（核心字段）**:
+```json
+{
+  "mode": "delegated",
+  "steps": [
+    {
+      "id": "spec",
+      "tool": "add_feature",
+      "args": { "feature_name": "user-auth", "description": "用户认证功能" },
+      "outputs": ["docs/specs/user-auth/requirements.md"]
+    }
+  ]
+}
+```
+
+**字段说明**:
+- `mode`: 固定为 `delegated`
+- `steps`: 执行步骤数组
+- `tool`: 工具名称（如 `add_feature`）
+- `action`: 无工具时的手动动作描述（如 `update_project_context`）
+- `args`: 工具参数
+- `outputs`: 预期产物
+- `when/dependsOn/note`: 可选的条件与说明
+
+### 🧩 结构化输出字段规范（关键字段）
+
+编排与原子工具都会返回 `structuredContent`，常用字段约定如下：
+- `summary`: 一句话摘要
+- `status`: 状态（pending/success/failed/partial）
+- `steps`: 执行步骤（编排工具）
+- `artifacts`: 产物列表（路径 + 用途）
+- `metadata.plan`: 委托式执行计划（仅 start_*）
+- `specArtifacts`: 规格文档产物（start_feature）
+- `estimate`: 估算结果（start_feature / estimate）
+
+### 🧠 需求澄清模式（Requirements Loop）
+
+当需求不够清晰时，可在 `start_feature / start_bugfix / start_ui` 中使用 `requirements_mode=loop`。  
+该模式会先进行 1-2 轮结构化澄清，再进入规格/修复/UI 执行流程。
+
+**示例：**
+```json
+{
+  "feature_name": "user-auth",
+  "description": "用户认证功能",
+  "requirements_mode": "loop",
+  "loop_max_rounds": 2,
+  "loop_question_budget": 5
+}
+```
+
+### 🧩 模板系统（普通模型友好）
+
+`add_feature` 支持模板档位，默认 `auto` 自动选择：需求不完整时偏向 `guided`（包含更详细的填写规则与检查清单），需求较完整时选择 `strict`（结构更紧凑，适合高能力模型或归档场景）。
+
+**示例：**
+```json
+{
+  "description": "添加用户认证功能",
+  "template_profile": "auto"
+}
+```
+
+**适用工具**：
+- `start_feature` 会透传 `template_profile` 给 `add_feature`
+- `start_bugfix` / `start_ui` 也支持 `template_profile`，用于控制指导强度（auto/guided/strict）
+
+**模板档位策略**：
+- `guided`：需求信息少/不完整、普通模型优先
+- `strict`：需求已结构化、希望指引更紧凑
+- `auto`：默认推荐，自动选择 guided/strict
+
+### 🔄 工作流编排
+
+6 个智能编排工具，自动组合多个基础工具，一键完成复杂开发流程：
 - `start_feature` - 新功能开发（需求 → 设计 → 估算）
-- `start_bugfix` - Bug 修复（分析 → 修复 → 测试）
-- `start_review` - 代码体检（质量 → 安全 → 性能）
-- `start_ui` - UI 开发（设计系统 → 组件 → 代码）
-- `start_product` - 产品设计（PRD → 原型 → 设计系统 → HTML）
-- 更多...
-
-### 🚀 产品设计工作流
-
-3 个相关工具（2 个原子 + 1 个编排），从需求到可交互原型：
-- `gen_prd` - 生成产品需求文档（PRD）
-- `gen_prototype` - 生成原型设计文档
-- `start_product` - 完整产品设计流程（PRD → 原型 → 设计系统 → HTML 原型）
-
-**结构化输出补充**：
-- `gen_prd.structuredContent.filePath`：PRD 目标路径（默认 `docs/prd/product-requirements.md`）
-- `gen_prototype.structuredContent.indexPath`：原型索引路径（默认 `docs/prototype/prototype-index.md`）
-- `interview.structuredContent.mode`：`usage` / `questions` / `record`
-
-**工作流程：**
-1. **需求分析** - 生成标准 PRD 文档（产品概述、功能需求、页面清单）
-2. **原型设计** - 为每个页面生成详细的原型文档
+- `start_bugfix` - Bug 修复（分析 → 修复 → 测试）
+- `start_onboard` - 项目上手（生成项目上下文文档）
+- `start_ui` - UI 开发（设计系统 → 组件 → 代码）
+- `start_product` - 产品设计（PRD → 原型 → 设计系统 → HTML）
+- `start_ralph` - Ralph Loop（循环开发直到目标完成）
+
+### 🚀 产品设计工作流
+
+`start_product` 是一个完整的产品设计编排工具，从需求到可交互原型：
+
+**工作流程：**
+1. **需求分析** - 生成标准 PRD 文档（产品概述、功能需求、页面清单）
+2. **原型设计** - 为每个页面生成详细的原型文档
 3. **设计系统** - 基于产品类型生成设计规范
 4. **HTML 原型** - 生成可直接在浏览器中查看的交互原型
 5. **项目上下文** - 自动更新项目文档
 
+**结构化输出补充**：
+- `start_product.structuredContent.artifacts`：产出物列表（PRD、原型、设计系统等）
+- `interview.structuredContent.mode`：`usage` / `questions` / `record`
+
 ### 🎨 UI/UX Pro Max
 
-5 个 UI/UX 工具，`start_ui` 作为统一入口：
-- `start_ui` - 一键 UI 开发（支持智能模式）
-- `ui_design_system` - 智能设计系统生成
-- `ui_search` - UI/UX 数据搜索（BM25 算法）
-- `sync_ui_data` - 同步最新 UI/UX 数据到本地
-- `init_component_catalog` / `render_ui` - 内部渲染工具（full 模式可用）
+3 个 UI/UX 工具，`start_ui` 作为统一入口：
+- `start_ui` - 一键 UI 开发（支持智能模式）（编排工具）
+- `ui_design_system` - 智能设计系统生成
+- `ui_search` - UI/UX 数据搜索（BM25 算法）
+- `sync_ui_data` - 同步最新 UI/UX 数据到本地
+
+**注意**：`start_ui` 会自动调用 `ui_design_system` 和 `ui_search`，您无需单独调用它们。
 
 **灵感来源：**
 - [ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) - UI/UX 设计系统理念
@@ -187,6 +189,36 @@ AI 需要**按步骤调用工具并落盘文件**，而不是由工具内部直
 
 ---
 
+## 🧭 工具选择指南
+
+### 何时使用编排工具 vs 单独工具？
+
+**使用编排工具（start_*）当：**
+- ✅ 需要完整的工作流程（多个步骤）
+- ✅ 希望自动化执行多个任务
+- ✅ 需要生成多个产物（文档、代码、测试等）
+
+**使用单独工具当：**
+- ✅ 只需要某个特定功能
+- ✅ 已经有了项目上下文文档
+- ✅ 需要更精细的控制
+
+### 常见场景选择
+
+| 场景 | 推荐工具 | 原因 |
+|------|---------|------|
+| 开发新功能（完整流程） | `start_feature` | 自动完成：规格→估算 |
+| 只需要功能规格文档 | `add_feature` | 更轻量，只生成文档 |
+| 修复 Bug（完整流程） | `start_bugfix` | 自动完成：分析→修复→测试 |
+| 只需要 Bug 分析 | `fix_bug` | 更快速，只分析问题 |
+| 生成设计系统 | `ui_design_system` | 直接生成设计规范 |
+| 开发 UI 组件 | `start_ui` | 完整流程：设计→组件→代码 |
+| 产品设计（从需求到原型） | `start_product` | 一键完成：PRD→原型→HTML |
+| 一句话需求分析 | `init_project` | 生成完整项目规格文档 |
+| 项目上手文档 | `init_project_context` | 生成技术栈/架构/规范 |
+
+---
+
 ## 🚀 快速开始
 
 ### 方式一：npx 直接使用（推荐）
@@ -256,7 +288,7 @@ npm install -g mcp-probe-kit
 
 ---
 
-## 💡 使用示例
+## 💡 使用示例
 
 ### 日常开发
 ```bash

package/build/index.js

@@ -2,7 +2,7 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { initProject, gencommit, genapi, codeReview, gentest, genpr, gendoc, genchangelog, refactor, perf, gensql, resolveConflict, genreadme, initProjectContext, addFeature, securityScan, fixBug, estimate, genMock, startFeature, startBugfix, startReview, startRelease, startRefactor, startOnboard, startApi, startDoc, startRalph, interview, askUser, uiDesignSystem, initComponentCatalog, uiSearch, syncUiData, renderUi, startUi, genPrd, genPrototype, startProduct } from "./tools/index.js";
+import { initProject, gencommit, codeReview, gentest, refactor, initProjectContext, addFeature, fixBug, estimate, startFeature, startBugfix, startOnboard, startRalph, interview, askUser, uiDesignSystem, uiSearch, syncUiData, startUi, startProduct } from "./tools/index.js";
 import { VERSION, NAME } from "./version.js";
 import { allToolSchemas } from "./schemas/index.js";
 import { filterTools, getToolsetFromEnv } from "./lib/toolset-manager.js";
@@ -34,57 +34,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return await initProject(args);
             case "gencommit":
                 return await gencommit(args);
-            case "genapi":
-                return await genapi(args);
             case "code_review":
                 return await codeReview(args);
             case "gentest":
                 return await gentest(args);
-            case "genpr":
-                return await genpr(args);
-            case "gendoc":
-                return await gendoc(args);
-            case "genchangelog":
-                return await genchangelog(args);
             case "refactor":
                 return await refactor(args);
-            case "perf":
-                return await perf(args);
-            case "gensql":
-                return await gensql(args);
-            case "resolve_conflict":
-                return await resolveConflict(args);
-            case "genreadme":
-                return await genreadme(args);
             case "init_project_context":
                 return await initProjectContext(args);
             case "add_feature":
                 return await addFeature(args);
-            case "security_scan":
-                return await securityScan(args);
             case "fix_bug":
                 return await fixBug(args);
             case "estimate":
                 return await estimate(args);
-            case "gen_mock":
-                return await genMock(args);
             // 智能编排工具
             case "start_feature":
                 return await startFeature(args);
             case "start_bugfix":
                 return await startBugfix(args);
-            case "start_review":
-                return await startReview(args);
-            case "start_release":
-                return await startRelease(args);
-            case "start_refactor":
-                return await startRefactor(args);
             case "start_onboard":
                 return await startOnboard(args);
-            case "start_api":
-                return await startApi(args);
-            case "start_doc":
-                return await startDoc(args);
             case "start_ralph":
                 return await startRalph(args);
             // 访谈工具
@@ -95,21 +65,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             // UI/UX Pro Max 工具
             case "ui_design_system":
                 return await uiDesignSystem(args);
-            case "init_component_catalog":
-                return await initComponentCatalog(args);
             case "ui_search":
                 return await uiSearch(args);
             case "sync_ui_data":
                 return await syncUiData(args);
-            case "render_ui":
-                return await renderUi(args);
             case "start_ui":
                 return await startUi(args);
             // 产品设计工作流
-            case "gen_prd":
-                return await genPrd(args || {});
-            case "gen_prototype":
-                return await genPrototype(args || {});
             case "start_product":
                 return await startProduct(args || {});
             default:

package/build/lib/response.d.ts

@@ -30,3 +30,12 @@ export interface ToolResponse {
  * @returns 标准工具响应
  */
 export declare function okStructured(text: string, structuredContent: any, meta?: Record<string, any>): ToolResponse;
+/**
+ * 返回纯文本响应（guidance-only 工具）
+ * 用于只返回指南而不返回结构化数据的工具
+ *
+ * @param text - 人类可读的文本内容（通常是 guidance）
+ * @param meta - 可选的元数据
+ * @returns 标准工具响应
+ */
+export declare function okText(text: string, meta?: Record<string, any>): ToolResponse;

package/build/lib/response.js

@@ -27,3 +27,26 @@ export function okStructured(text, structuredContent, meta) {
     }
     return response;
 }
+/**
+ * 返回纯文本响应（guidance-only 工具）
+ * 用于只返回指南而不返回结构化数据的工具
+ *
+ * @param text - 人类可读的文本内容（通常是 guidance）
+ * @param meta - 可选的元数据
+ * @returns 标准工具响应
+ */
+export function okText(text, meta) {
+    const response = {
+        content: [
+            {
+                type: 'text',
+                text,
+            },
+        ],
+        isError: false,
+    };
+    if (meta) {
+        response._meta = meta;
+    }
+    return response;
+}

package/build/lib/toolset-manager.d.ts

@@ -4,9 +4,9 @@
  */
 export type ToolsetType = 'core' | 'ui' | 'workflow' | 'full';
 /**
- * 工具集定义
+ * 工具集定义 (v3.0 精简版 - 20 个工具)
  *
- * - core: 核心工具（高频使用）
+ * - core: 核心工具（日常高频）
  * - ui: UI/UX 工具（推荐使用 start_ui 统一入口）
  * - workflow: 工作流工具（包含 core + 编排工具）
  * - full: 所有工具（默认）

package/build/lib/toolset-manager.js

@@ -4,68 +4,61 @@
  */
 import { allToolSchemas } from '../schemas/index.js';
 /**
- * 工具集定义
+ * 工具集定义 (v3.0 精简版 - 20 个工具)
  *
- * - core: 核心工具（高频使用）
+ * - core: 核心工具（日常高频）
  * - ui: UI/UX 工具（推荐使用 start_ui 统一入口）
  * - workflow: 工作流工具（包含 core + 编排工具）
  * - full: 所有工具（默认）
  */
 export const TOOLSET_DEFINITIONS = {
-    // 核心工具集 - 最常用的基础工具
+    // 核心工具集 - 日常高频工具（9 个）
     core: [
         'gencommit',
         'code_review',
         'gentest',
-        'gendoc',
         'refactor',
-        'perf',
-        'security_scan',
         'fix_bug',
-        'genapi',
-        'gensql',
-        'genreadme',
-        'gen_mock',
+        'add_feature',
+        'init_project',
+        'init_project_context',
+        'estimate',
     ],
-    // UI/UX 工具集 - 对外工具，推荐使用 start_ui 统一入口
+    // UI/UX 工具集 - 包含统一入口（4 个）
     ui: [
         'start_ui', // ⭐ 统一入口（编排工具）
-        'ui_search', // 搜索 UI/UX 数据库
         'ui_design_system', // 生成设计系统
+        'ui_search', // 搜索 UI/UX 数据库
         'sync_ui_data', // 同步 UI 数据
-        // 注意：不包含内部工具 init_component_catalog 和 render_ui
     ],
-    // 工作流工具集 - 包含核心工具 + 编排工具
+    // 工作流工具集 - 包含核心 + 编排 + 交互（20 个）
     workflow: [
-        // 核心工具（复用）
+        // 核心工具（9 个）
         'gencommit',
         'code_review',
         'gentest',
-        'gendoc',
         'refactor',
-        'perf',
-        'security_scan',
         'fix_bug',
-        'genapi',
-        'gensql',
-        'genreadme',
-        'gen_mock',
-        // 编排工具（10 个）
+        'add_feature',
+        'init_project',
+        'init_project_context',
+        'estimate',
+        // 编排工具（6 个）
         'start_feature',
         'start_bugfix',
-        'start_review',
-        'start_release',
-        'start_refactor',
         'start_onboard',
-        'start_api',
-        'start_doc',
-        'start_ralph',
         'start_ui',
+        'start_product',
+        'start_ralph',
         // 交互工具（2 个）
         'interview',
         'ask_user',
+        // UI/UX 工具（3 个）
+        'ui_design_system',
+        'ui_search',
+        'sync_ui_data',
     ],
-    // 完整工具集 - 包含所有工具（包括内部工具）
+    // 完整工具集 - 所有 20 个工具
     full: 'all',
 };
 /**

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

@@ -3,13 +3,13 @@
  */
 export declare const basicToolSchemas: readonly [{
     readonly name: "init_project";
-    readonly description: "当用户需要创建新项目、生成项目结构时使用。按 Spec-Driven Development 方式生成需求/设计/任务文档";
+    readonly description: "当用户提供一句话需求时使用。基于 Spec-Driven Development 理念，分析需求并生成完整的项目规格文档（需求分析/技术设计/任务拆解）。适合项目初期的需求澄清和规划";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
             readonly input: {
                 readonly type: "string";
-                readonly description: "项目需求描述。可以是简短描述（如'创建电商网站'）或详细的功能需求文档";
+                readonly description: "项目需求描述。可以是一句话需求（如'创建电商网站'）或简短的功能描述，工具会自动分析并生成详细的规格文档";
             };
             readonly project_name: {
                 readonly type: "string";

package/build/schemas/basic-tools.js

@@ -4,13 +4,13 @@
 export const basicToolSchemas = [
     {
         name: "init_project",
-        description: "当用户需要创建新项目、生成项目结构时使用。按 Spec-Driven Development 方式生成需求/设计/任务文档",
+        description: "当用户提供一句话需求时使用。基于 Spec-Driven Development 理念，分析需求并生成完整的项目规格文档（需求分析/技术设计/任务拆解）。适合项目初期的需求澄清和规划",
         inputSchema: {
             type: "object",
             properties: {
                 input: {
                     type: "string",
-                    description: "项目需求描述。可以是简短描述（如'创建电商网站'）或详细的功能需求文档",
+                    description: "项目需求描述。可以是一句话需求（如'创建电商网站'）或简短的功能描述，工具会自动分析并生成详细的规格文档",
                 },
                 project_name: {
                     type: "string",

package/build/schemas/code-analysis-tools.d.ts

@@ -19,46 +19,6 @@ export declare const codeAnalysisToolSchemas: readonly [{
         readonly required: readonly [];
         readonly additionalProperties: true;
     };
-}, {
-    readonly name: "perf";
-    readonly description: "当用户关注代码性能、需要优化性能时使用。分析性能瓶颈（算法/内存/数据库/React渲染），输出瓶颈清单和优化建议";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly code: {
-                readonly type: "string";
-                readonly description: "要分析性能的代码";
-            };
-            readonly type: {
-                readonly type: "string";
-                readonly description: "分析类型：algorithm（算法）、memory（内存）、database（数据库）、react（React渲染）。可选，会自动识别";
-            };
-        };
-        readonly required: readonly [];
-        readonly additionalProperties: true;
-    };
-}, {
-    readonly name: "security_scan";
-    readonly description: "当用户关注代码安全、需要检查安全漏洞时使用。扫描安全漏洞（注入/认证/加密/敏感数据），输出风险清单和修复建议";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly code: {
-                readonly type: "string";
-                readonly description: "要扫描的代码";
-            };
-            readonly language: {
-                readonly type: "string";
-                readonly description: "编程语言。可选，会自动识别";
-            };
-            readonly scan_type: {
-                readonly type: "string";
-                readonly description: "扫描类型：injection（注入）、auth（认证）、crypto（加密）、all（全部）。可选，默认 all";
-            };
-        };
-        readonly required: readonly [];
-        readonly additionalProperties: true;
-    };
 }, {
     readonly name: "refactor";
     readonly description: "当用户需要重构代码、改善代码结构时使用。分析代码结构，提供重构建议、重构步骤和风险评估";