mcp-probe-kit 1.15.0 → 2.0.0

package/docs/BEST_PRACTICES.md

@@ -1,1185 +0,0 @@
-# 📚 MCP Probe Kit 最佳实践
-
-> 完整的工具调用指南和使用技巧
-
-**版本**: v1.14.0 | **工具总数**: 46 个
-
----
-
-## 📖 目录
-
-- [工具调用写法指南](#工具调用写法指南)
-  - [UI/UX 工具调用](#uiux-工具调用) 🆕
-  - [访谈工具调用](#访谈工具调用)
-  - [基础工具调用](#基础工具调用)
-  - [智能编排调用](#智能编排调用)
-- [使用技巧](#使用技巧)
-- [进阶技巧](#进阶技巧)
-- [注意事项](#注意事项)
-
----
-
-## 🎯 工具调用写法指南
-
-### UI/UX 工具调用 🆕
-
-#### ui_design_system - 设计系统生成
-
-```
-# 方式 1：最简单（只指定技术栈）
-ui_design_system --stack react
-
-# 方式 2：指定主色调
-ui_design_system --stack react --primary-color "#3b82f6"
-
-# 方式 3：完整配置
-ui_design_system \
-  --stack nextjs \
-  --color-scheme light \
-  --primary-color "#3b82f6" \
-  --typography modern \
-  --spacing normal \
-  --border-radius medium
-
-# 方式 4：对话式
-"帮我生成一个 React 设计系统，主色调用蓝色"
-"为我的 Tailwind 项目生成配置"
-
-# 自动完成：
-# ✓ 生成完整的色彩系统（11 级色阶）
-# ✓ 生成字体系统（Sans/Serif/Mono）
-# ✓ 生成间距系统（基于 4px）
-# ✓ 生成组件样式（圆角、阴影、动画）
-# ✓ 输出可直接使用的代码
-```
-
-#### ui_search - UI/UX 智能搜索
-
-```
-# 方式 1：简单搜索
-ui_search "button primary"
-
-# 方式 2：指定类别
-ui_search "button" --category react
-
-# 方式 3：完整配置
-ui_search \
-  --query "button primary hover" \
-  --category react \
-  --limit 5 \
-  --min-score 1.0
-
-# 方式 4：对话式
-"我需要一个 React 的主按钮组件"
-"搜索一下蓝色主题的配色方案"
-"表单验证有什么 UX 最佳实践？"
-
-# 搜索技巧：
-# ✓ 使用具体关键词："primary button hover" 而不是 "button"
-# ✓ 指定类别：colors, icons, react, vue, ux-guidelines 等
-# ✓ 调整结果数量：--limit 3（快速预览）或 --limit 20（详细搜索）
-# ✓ 支持中英文：可以搜索 "按钮" 或 "button"
-```
-
-#### sync_ui_data - 数据同步
-
-```
-# 方式 1：检查更新
-sync_ui_data
-
-# 方式 2：强制同步
-sync_ui_data --force
-
-# 方式 3：详细日志
-sync_ui_data --force --verbose
-
-# 方式 4：对话式
-"检查一下 UI 数据有没有更新"
-"强制更新 UI 数据"
-
-# 数据位置：
-# ✓ 内嵌数据：npm 包内部（离线可用）
-# ✓ 缓存数据：~/.mcp-probe-kit/ui-ux-data/（自动更新）
-```
-
----
-
-### 访谈工具调用
-
-#### interview - 需求访谈
-
-```
-# 方式 1：直接调用
-interview "用户登录认证功能"
-
-# 方式 2：对话式
-interview
-然后 AI 会询问功能描述
-
-# 自动完成：
-# ✓ 生成 12-15 个结构化问题（4个阶段）
-# ✓ 保存访谈记录到 docs/interviews/
-# ✓ 可选：立即开发或稍后使用
-```
-
-#### ask_user - AI 主动提问
-
-```
-# AI 自动调用（遇到不确定因素时）
-ask_user "优化目标是性能还是可读性？"
-
-# 用户主动触发
-"有什么需要我确认的吗？"
-"问我几个问题吧"
-
-# 带选项的提问
-ask_user --options ["方案A: 性能优先", "方案B: 可读性优先"]
-```
-
----
-
-### 基础工具调用
-
-#### 代码质量工具
-
-```
-# 套壳检测
-detect_shell
-
-# 代码审查（审查当前文件）
-code_review
-
-# 代码审查（审查指定文件）
-code_review @src/utils/helper.ts
-
-# 安全扫描
-security_scan @api/user.ts
-
-# 调试助手（然后粘贴错误信息）
-debug
-
-# 生成测试
-gentest @src/components/Button.tsx
-
-# 重构建议
-refactor @legacy-code.js
-
-# 性能分析
-perf @slow-function.ts
-
-# 自动修复
-fix @file-with-errors.ts
-```
-
-#### 开发效率工具
-
-```
-# 生成 commit 消息
-gencommit
-
-# 生成 API 文档
-genapi @api/user.ts
-
-# 生成代码注释
-gendoc @utils/format.ts
-
-# 生成 PR 描述
-genpr
-
-# 生成 Changelog
-genchangelog v1.2.0
-
-# 生成 SQL
-gensql
-然后描述需求："查询最近30天注册的活跃用户"
-
-# 生成 UI 组件
-genui
-然后描述："创建一个带加载状态的 Button 组件"
-
-# 生成 Mock 数据
-gen_mock
-然后提供数据结构：
-interface User {
-  id: string;
-  name: string;
-  email: string;
-}
-
-# 设计稿转代码
-design2code
-然后提供设计稿图片URL、描述或HTML代码
-
-# 代码解释
-explain @complex-algorithm.ts
-
-# 代码转换
-convert @old-code.js
-然后说明："转为 TypeScript"
-
-# CSS 属性排序
-css_order
-
-# 生成 README
-genreadme
-
-# 文件拆分
-split @LargeComponent.tsx
-
-# Bug 修复流程
-fix_bug
-然后提供错误信息和堆栈
-
-# 工作量估算
-estimate
-然后描述任务："实现用户登录功能"
-
-# 生成 Agent Skills 文档
-gen_skill
-
-# 生成单个工具的技能文档
-gen_skill --tool_name code_review
-
-# 生成分析类工具的技能文档
-gen_skill --scope analysis
-```
-
-#### 项目管理工具
-
-```
-# 初始化 AI 配置
-init_setting
-
-# 初始化项目（Spec-Driven）
-init_project
-然后提供需求描述或 @requirements.md
-
-# 检查依赖健康度
-check_deps
-
-# 解决 Git 冲突
-resolve_conflict
-然后粘贴冲突内容或打开冲突文件
-
-# 分析项目结构
-analyze_project
-
-# 生成项目上下文
-init_project_context
-
-# 添加新功能
-add_feature user-auth "用户登录认证功能"
-```
-
----
-
-### 智能编排调用
-
-#### start_feature - 新功能开发（推荐）
-
-```
-# 方式 1：直接调用
-start_feature user-profile "用户个人资料管理"
-
-# 方式 2：对话式
-start_feature
-然后 AI 会询问功能名称和描述
-
-# 自动完成：
-# ✓ 检查/生成项目上下文
-# ✓ 生成功能规格（需求/设计/任务）
-# ✓ 工作量估算
-```
-
-#### start_bugfix - Bug 修复（推荐）
-
-```
-# 方式 1：提供错误信息
-start_bugfix
-然后粘贴错误信息和堆栈
-
-# 方式 2：简洁调用
-遇到 Bug 时直接说："start_bugfix 帮我修复这个错误"
-
-# 自动完成：
-# ✓ 检查/生成项目上下文
-# ✓ 问题定位和原因分析
-# ✓ 生成修复方案
-# ✓ 生成回归测试
-# ✓ 生成 commit 消息
-```
-
-#### start_review - 代码体检（推荐）
-
-```
-# 审查当前文件
-start_review
-
-# 审查指定文件
-start_review @src/api/payment.ts
-
-# 自动完成：
-# ✓ 检查/生成项目上下文
-# ✓ 代码质量审查
-# ✓ 安全漏洞扫描
-# ✓ 性能分析
-# ✓ 生成综合报告
-```
-
-#### start_release - 发布准备（推荐）
-
-```
-# 准备发布 v1.2.0
-start_release v1.2.0
-
-# 指定起始版本
-start_release v1.2.0 --from v1.1.0
-
-# 自动完成：
-# ✓ 检查/生成项目上下文
-# ✓ 生成 Changelog
-# ✓ 生成 PR 描述
-# ✓ 提供发布检查清单
-```
-
-#### start_refactor - 代码重构（推荐）
-
-```
-# 重构当前文件
-start_refactor
-
-# 重构指定文件
-start_refactor @legacy/old-module.js
-
-# 指定重构目标
-start_refactor @code.ts --goal reduce_complexity
-
-# 自动完成：
-# ✓ 检查/生成项目上下文
-# ✓ 代码审查发现问题
-# ✓ 生成重构方案
-# ✓ 生成保护测试
-```
-
-#### start_onboard - 快速上手项目（推荐）
-
-```
-# 分析当前项目
-start_onboard
-
-# 分析指定项目
-start_onboard /path/to/project
-
-# 自动完成：
-# ✓ 深度分析项目结构
-# ✓ 生成项目上下文文档
-# ✓ 提供项目概览和快速开始指南
-```
-
-#### start_api - API 开发（推荐）
-
-```
-# 为 API 生成完整资料
-start_api @api/user.ts
-
-# 自动完成：
-# ✓ 检查/生成项目上下文
-# ✓ 生成 API 文档
-# ✓ 生成 Mock 数据
-# ✓ 生成 API 测试
-```
-
-#### start_doc - 文档生成（推荐）
-
-```
-# 为项目生成完整文档
-start_doc
-
-# 为指定代码生成文档
-start_doc @src/
-
-# 自动完成：
-# ✓ 检查/生成项目上下文
-# ✓ 生成代码注释
-# ✓ 生成 README
-# ✓ 生成 API 文档
-```
-
-#### start_ralph - Ralph Loop 循环开发（推荐）🆕
-
-```
-# 启动循环开发
-start_ralph "实现用户登录功能"
-
-# 指定模式和参数
-start_ralph --goal "修复登录 bug" --mode safe --max_iterations 10
-
-# 自动完成：
-# ✓ 生成 .ralph/ 目录结构
-# ✓ 生成 PROMPT.md（循环 prompt）
-# ✓ 生成 @fix_plan.md（任务清单）
-# ✓ 生成 PROGRESS.md（迭代日志）
-# ✓ 生成安全模式脚本（多重保护）
-# ✓ 提供执行指南
-
-# 然后：
-cd .ralph
-chmod +x ralph_loop_safe.sh  # Linux/Mac
-./ralph_loop_safe.sh
-
-# Windows:
-# powershell -ExecutionPolicy Bypass -File ralph_loop_safe.ps1
-```
-
----
-
-## 💡 使用技巧
-
-### 0. Interview 模式最佳实践 🆕
-
-#### 何时使用 Interview 模式
-
-**✅ 推荐使用：**
-```
-- 需求描述简短、不明确
-- 复杂的业务功能
-- 涉及多方协作的功能
-- 有较多技术约束的功能
-- 第一次做某类功能
-```
-
-**❌ 不推荐使用：**
-```
-- 简单的 Bug 修复
-- 需求非常明确的功能
-- 紧急的小改动
-- 重复性的简单任务
-```
-
-#### Interview 工作流程
-
-**流程 1：立即开发**
-```
-1. interview "用户登录功能"
-   # 生成 12-15 个问题
-
-2. 回答所有问题
-   # AI 生成访谈记录
-
-3. start_feature --from-interview user-login
-   # 基于访谈生成规格文档
-
-4. 根据 tasks.md 开始编码
-```
-
-**流程 2：分步进行**
-```
-第1天:
-1. interview "用户登录功能"
-2. 回答问题
-3. AI 保存访谈记录
-
-第3天:
-1. "开始做登录功能"
-2. start_feature --from-interview user-login
-3. AI 读取之前的访谈，生成规格
-```
-
-**流程 3：仅生成规格**
-```
-1. interview "用户登录功能"
-2. 回答问题
-3. add_feature --from-interview user-login
-   # 只生成规格文档，不估算工作量
-```
-
-#### ask_user 使用场景
-
-```
-场景1: 技术方案选择
-AI: "可以用两种方案实现"
-调用: ask_user --options ["方案A: 性能优先", "方案B: 可读性优先"]
-
-场景2: 代码审查时
-AI: "发现了性能问题，但不确定优先级"
-调用: ask_user "这个性能问题的优先级如何？"
-
-场景3: Bug 修复时
-AI: "需要确认是否向后兼容"
-调用: ask_user "修复这个 Bug 是否需要保持向后兼容？"
-
-场景4: 功能开发时
-AI: "支付方式有多种选择"
-调用: ask_user "你希望支持哪些支付方式？"
-```
-
----
-
-### 1. 优先使用智能编排
-
-**❌ 不推荐（手动调用多个工具）**
-```
-1. init_project_context
-2. add_feature user-auth "用户登录"
-3. estimate "实现用户登录功能"
-```
-
-**✅ 推荐（使用智能编排）**
-```
-start_feature user-auth "用户登录认证功能"
-# 一键完成所有步骤
-```
-
----
-
-### 2. 善用文件引用
-
-**引用单个文件**
-```
-code_review @src/utils/helper.ts
-```
-
-**引用多个文件**
-```
-code_review @src/utils/helper.ts @src/utils/format.ts
-```
-
-**引用整个目录**
-```
-start_doc @src/components/
-```
-
----
-
-### 3. 对话式调用
-
-大多数工具支持对话式调用，AI 会引导你提供必要信息：
-
-```
-# 直接调用工具名
-gen_mock
-
-# AI 会询问：
-# "请提供数据结构定义（TypeScript interface 或 JSON Schema）"
-
-# 你提供：
-interface User {
-  id: string;
-  name: string;
-  email: string;
-}
-
-# AI 会继续询问其他可选参数
-```
-
----
-
-### 4. 组合使用工具
-
-#### 场景：Interview 模式开发新功能 🆕
-
-```
-1. interview "用户个人资料"
-   # 访谈澄清需求
-
-2. 回答 12-15 个问题
-
-3. start_feature --from-interview user-profile
-   # 生成规格文档和估算
-
-4. 根据 tasks.md 开始编码...
-
-5. start_review @src/profile/
-   # 代码体检
-
-6. gentest @src/profile/ProfileCard.tsx
-   # 补充测试
-
-7. gencommit
-   # 提交代码
-```
-
-#### 场景：传统方式开发新功能
-
-```
-1. start_feature user-profile "用户个人资料"
-   # 生成规格文档和估算
-
-2. 根据 tasks.md 开始编码...
-
-3. start_review @src/profile/
-   # 代码体检
-
-4. gentest @src/profile/ProfileCard.tsx
-   # 补充测试
-
-5. gencommit
-   # 提交代码
-```
-
-#### 场景：修复 Bug 的完整流程
-
-```
-1. start_bugfix
-   # 粘贴错误信息，自动完成分析、修复、测试
-
-2. 验证修复...
-
-3. gencommit
-   # 已在 start_bugfix 中生成，直接使用
-```
-
-#### 场景：代码重构
-
-```
-1. start_review @old-code.ts
-   # 先体检，发现问题
-
-2. start_refactor @old-code.ts
-   # 重构并生成测试
-
-3. gencommit
-   # 提交重构
-```
-
----
-
-### 5. 项目初始化最佳实践
-
-#### 新项目
-
-```
-1. init_project
-   # 提供需求，生成项目结构
-
-2. init_setting
-   # 配置 AI
-
-3. init_project_context
-   # 生成项目上下文
-
-4. 开始开发...
-```
-
-#### 接手老项目
-
-```
-1. start_onboard
-   # 快速了解项目（包含 analyze_project + init_project_context）
-
-2. check_deps
-   # 检查依赖健康度
-
-3. start_review @src/
-   # 代码质量评估
-
-4. 开始维护...
-```
-
----
-
-### 6. 安全开发最佳实践
-
-#### 开发阶段
-
-```
-1. 编写代码...
-
-2. security_scan @new-feature.ts
-   # 安全扫描
-
-3. start_review @new-feature.ts
-   # 全面体检（包含安全扫描）
-```
-
-#### 发布前
-
-```
-1. start_review @src/
-   # 全面代码体检
-
-2. check_deps
-   # 检查依赖漏洞
-
-3. start_release v1.2.0
-   # 准备发布
-```
-
----
-
-### 7. 文档维护最佳实践
-
-#### 代码文档
-
-```
-1. gendoc @src/utils/
-   # 生成代码注释
-
-2. genapi @api/
-   # 生成 API 文档
-
-3. start_doc @src/
-   # 生成完整文档（包含上述两步）
-```
-
-#### 项目文档
-
-```
-1. genreadme
-   # 生成/更新 README
-
-2. genchangelog v1.2.0
-   # 更新 Changelog
-
-3. init_project_context
-   # 更新项目上下文
-```
-
----
-
-### 8. 性能优化流程
-
-```
-1. perf @slow-function.ts
-   # 性能分析
-
-2. start_refactor @slow-function.ts --goal improve_performance
-   # 重构优化
-
-3. gentest @optimized-function.ts
-   # 性能测试
-
-4. 对比优化前后性能...
-
-5. gencommit
-   # 提交优化
-```
-
----
-
-## 🎓 进阶技巧
-
-### 批量操作
-
-```
-# 批量审查多个文件
-code_review @src/api/*.ts
-
-# 批量生成测试
-gentest @src/components/*.tsx
-
-# 批量生成文档
-start_doc @src/
-```
-
-### 自定义参数
-
-```
-# 指定测试框架
-gentest @component.tsx --framework vitest
-
-# 指定文档格式
-genapi @api.ts --format openapi
-
-# 指定 Mock 数据数量
-gen_mock --count 10
-
-# 指定重构目标
-start_refactor @code.ts --goal reduce_complexity
-```
-
-### 链式调用
-
-```
-# 一次对话完成多个操作
-"帮我审查 @user.ts，然后生成测试，最后生成 commit 消息"
-
-# AI 会依次调用：
-# 1. code_review @user.ts
-# 2. gentest @user.ts
-# 3. gencommit
-```
-
----
-
-## ⚠️ 注意事项
-
-### 1. 智能编排会自动处理项目上下文
-
-- 无需手动调用 `init_project_context`
-- 首次使用会自动生成
-- 后续调用会自动读取
-
-### 2. 文件引用使用 @ 符号
-
-- `@file.ts` - 引用文件
-- `@folder/` - 引用目录
-- `@*.ts` - 通配符匹配
-
-### 3. 大型项目建议分批处理
-
-- 不要一次审查整个项目
-- 按模块或功能分批进行
-- 避免超时或响应过长
-
-### 4. 定期更新项目上下文
-
-- 技术栈变更后重新运行 `init_project_context`
-- 保持上下文文档最新
-- 有助于 AI 生成更准确的代码
-
-### 5. 善用编排工具
-
-- 优先使用 `start_*` 编排工具
-- 减少手动调用多个工具的次数
-- 提高开发效率
-
----
-
-## 📊 工具选择决策树
-
-```
-需要做什么？
-│
-├─ 需求不明确？
-│  └─ interview ✅ → 访谈澄清 → start_feature
-│
-├─ 开发新功能（需求明确）
-│  └─ start_feature ✅
-│
-├─ 修复 Bug
-│  └─ start_bugfix ✅
-│
-├─ 代码审查
-│  ├─ 只看质量 → code_review
-│  ├─ 只看安全 → security_scan
-│  ├─ 只看性能 → perf
-│  └─ 全面体检 → start_review ✅
-│
-├─ 重构代码
-│  └─ start_refactor ✅
-│
-├─ 接手项目
-│  └─ start_onboard ✅
-│
-├─ 开发 API
-│  └─ start_api ✅
-│
-├─ 生成文档
-│  ├─ 只要 README → genreadme
-│  ├─ 只要 API 文档 → genapi
-│  └─ 完整文档 → start_doc ✅
-│
-├─ 准备发布
-│  └─ start_release ✅
-│
-└─ 其他单一任务
-   └─ 使用对应的基础工具
-```
-
----
-
-## 🚀 快速参考
-
-### 最常用的 10 个命令
-
-| 命令 | 用途 | 频率 |
-|------|------|------|
-| `interview` | 需求访谈 | ⭐⭐⭐⭐⭐ 🆕 |
-| `start_feature` | 开发新功能 | ⭐⭐⭐⭐⭐ |
-| `start_bugfix` | 修复 Bug | ⭐⭐⭐⭐⭐ |
-| `start_ralph` | 循环开发 | ⭐⭐⭐⭐ 🆕 |
-| `start_review` | 代码体检 | ⭐⭐⭐⭐ |
-| `gencommit` | 生成提交 | ⭐⭐⭐⭐ |
-| `gentest` | 生成测试 | ⭐⭐⭐⭐ |
-| `ask_user` | AI 提问 | ⭐⭐⭐ 🆕 |
-| `start_onboard` | 快速上手 | ⭐⭐⭐ |
-| `start_refactor` | 代码重构 | ⭐⭐⭐ |
-
----
-
-## 💬 实际对话示例
-
-### 示例 1：Interview 模式开发新功能 🆕
-
-```
-你: interview "用户设置页面"
-
-AI: 好的，我来帮你访谈这个需求。
-
-[阶段 1: 背景理解]
-Q1: 这个功能要解决什么问题或痛点？
-Q2: 主要用户是谁？他们的使用场景是什么？
-Q3: 这个功能的业务驱动是什么？
-
-[阶段 2: 功能边界]
-Q4: 这个功能的核心价值是什么？
-Q5: 功能范围包括哪些？不包括哪些？
-...
-
-你: [回答所有问题]
-
-AI: 好的，访谈完成。
-✓ 已生成 docs/interviews/user-settings-interview.md
-
-下一步：
-- 立即开发: start_feature --from-interview user-settings
-- 生成规格: add_feature --from-interview user-settings
-- 稍后开发: 访谈记录已保存，随时可用
-```
-
-### 示例 2：开发新功能（需求明确）
-
-```
-你: start_feature user-settings "用户设置页面"
-
-AI: 好的，我来帮你开发用户设置功能。
-
-[检查项目上下文...]
-✓ 已读取项目上下文
-
-[生成功能规格...]
-✓ 已生成 docs/specs/user-settings/requirements.md
-✓ 已生成 docs/specs/user-settings/design.md
-✓ 已生成 docs/specs/user-settings/tasks.md
-
-[工作量估算...]
-✓ 预估：5 故事点 / 1-2 天
-✓ 主要风险：需要集成第三方服务
-
-下一步：请按照 tasks.md 中的任务清单开始开发。
-```
-
-### 示例 2：修复 Bug
-
-```
-你: start_bugfix
-
-AI: 请提供错误信息和堆栈跟踪。
-
-你: [粘贴错误信息]
-TypeError: Cannot read property 'name' of undefined
-  at UserProfile.render (UserProfile.tsx:45)
-
-AI: 好的，我来帮你修复这个 Bug。
-
-[问题定位...]
-✓ 问题文件：UserProfile.tsx:45
-✓ 原因：user 对象可能为 null
-
-[生成修复方案...]
-✓ 修复方案：添加空值检查
-
-[生成测试...]
-✓ 已生成回归测试
-
-[生成 commit...]
-✓ Commit 消息：fix: 🐛 修复用户资料页面空指针异常
-
-修复完成！请验证后提交。
-```
-
-### 示例 3：代码体检
-
-```
-你: start_review @src/api/payment.ts
-
-AI: 好的，我来对支付 API 进行全面体检。
-
-[代码质量审查...]
-✓ 发现 3 个问题
-
-[安全扫描...]
-⚠️ 发现 1 个高危漏洞：硬编码 API 密钥
-
-[性能分析...]
-✓ 性能良好
-
-综合评分：6/10
-
-建议优先修复：
-1. [高危] 移除硬编码的 API 密钥
-2. [中] 添加错误处理
-3. [低] 改进命名规范
-```
-
----
-
-## 🎨 UI/UX 工具使用技巧 🆕
-
-### 设计系统生成技巧
-
-**1. 新项目启动**
-```
-# 步骤 1：生成基础设计系统
-ui_design_system --stack react
-
-# 步骤 2：根据需求调整
-ui_design_system --stack react --primary-color "#3b82f6" --border-radius large
-
-# 步骤 3：复制生成的代码到项目中
-```
-
-**2. 技术栈选择**
-```
-# React 项目
-ui_design_system --stack react
-
-# Next.js 项目
-ui_design_system --stack nextjs
-
-# Tailwind 项目（生成 tailwind.config.js）
-ui_design_system --stack tailwind
-
-# Vue 项目
-ui_design_system --stack vue
-```
-
-**3. 主题定制**
-```
-# 浅色主题
-ui_design_system --stack react --color-scheme light
-
-# 深色主题
-ui_design_system --stack react --color-scheme dark
-
-# 自适应主题
-ui_design_system --stack react --color-scheme auto
-```
-
-### UI 搜索技巧
-
-**1. 组件搜索**
-```
-# ❌ 不好：太模糊
-ui_search "button"
-
-# ✅ 好：具体明确
-ui_search "button primary hover effect" --category react
-
-# ✅ 更好：指定技术栈
-ui_search "button primary" --category react --limit 5
-```
-
-**2. 颜色搜索**
-```
-# 搜索配色方案
-ui_search "blue professional" --category colors
-
-# 搜索特定用途的颜色
-ui_search "saas tech primary color" --category colors
-
-# 搜索完整色阶
-ui_search "blue gradient" --category colors
-```
-
-**3. 最佳实践搜索**
-```
-# 搜索 UX 指南
-ui_search "form validation" --category ux-guidelines
-
-# 搜索性能优化
-ui_search "react performance" --category react-performance
-
-# 搜索设计模式
-ui_search "card layout" --category web-interface
-```
-
-**4. 调整搜索结果**
-```
-# 快速预览（3 个结果）
-ui_search "button" --limit 3
-
-# 详细搜索（20 个结果）
-ui_search "button" --limit 20
-
-# 过滤低相关性结果
-ui_search "button" --min-score 2.0
-```
-
-### 数据同步技巧
-
-**1. 定期检查**
-```
-# 每周检查一次（推荐）
-sync_ui_data
-
-# 如果已是最新版本，不会重复下载
-```
-
-**2. 遇到问题时**
-```
-# 搜索结果不准确？强制更新
-sync_ui_data --force --verbose
-
-# 查看详细日志
-sync_ui_data --verbose
-```
-
-**3. 数据位置**
-```
-# 内嵌数据（离线可用）
-位置：npm 包内部
-更新：重新安装 mcp-probe-kit
-
-# 缓存数据（自动更新）
-位置：~/.mcp-probe-kit/ui-ux-data/
-更新：首次使用时自动检查
-
-# 手动同步（立即更新）
-命令：sync_ui_data --force
-```
-
-### 组合使用技巧
-
-**场景 1：新项目完整流程**
-```
-# 步骤 1：生成设计系统
-ui_design_system --stack react --primary-color "#3b82f6"
-
-# 步骤 2：搜索需要的组件
-ui_search "button card form" --category react
-
-# 步骤 3：搜索配色方案
-ui_search "blue professional" --category colors
-
-# 步骤 4：应用到项目
-```
-
-**场景 2：优化现有项目**
-```
-# 步骤 1：搜索最佳实践
-ui_search "form validation ux" --category ux-guidelines
-
-# 步骤 2：搜索优化方案
-ui_search "react performance" --category react-performance
-
-# 步骤 3：搜索改进的组件
-ui_search "button loading state" --category react
-```
-
-**场景 3：设计系统迁移**
-```
-# 步骤 1：生成新的设计系统
-ui_design_system --stack tailwind
-
-# 步骤 2：搜索对应的组件
-ui_search "button" --category tailwind
-
-# 步骤 3：逐步替换旧组件
-```
-
----
-
-## 📚 相关文档
-
-- [README](../README.md) - 项目介绍和快速开始
-- [工具列表](../README.md#功能特性) - 所有工具的详细说明
-- [UI/UX 快速开始](../QUICK-START-UI-UX.md) - UI/UX 工具快速入门 🆕
-- [UI/UX 完整文档](./UI-UX-PRO-MAX-GUIDE.md) - UI/UX 工具详细文档 🆕
-- [UI/UX 使用演示](./UI-UX-DEMO.md) - UI/UX 工具使用示例 🆕
-- [常见问题](../README.md#常见问题) - FAQ
-
----
-
-**Made with ❤️ for AI-Powered Development**