mcp-probe-kit 1.11.0 → 1.15.0

package/docs/HOW_TO_TRIGGER.md

@@ -2,6 +2,8 @@
 
 > 实用的对话技巧，让 AI 准确理解你的意图并调用正确的工具
 
+**版本**: v1.14.0 | **工具总数**: 46 个
+
 ---
 
 ## 📖 目录
@@ -26,6 +28,113 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 ## 🔑 工具触发关键词
 
+### 🎨 0️⃣ UI/UX 设计 → `ui_design_system` / `ui_search` / `sync_ui_data` 🆕
+
+**触发关键词**：设计系统、配色、颜色、按钮、组件、UI、UX、图标、字体
+
+#### `ui_design_system` - 设计系统生成
+
+**✅ 推荐说法**
+```
+"帮我生成一个 React 设计系统"
+"为我的 Next.js 项目生成 Tailwind 配置"
+"生成一个蓝色主题的设计系统"
+"我需要一套完整的设计系统"
+"帮我配置项目的色彩和字体"
+```
+
+**❌ 不推荐说法**
+```
+"设计一下"（太模糊）
+"好看一点"（没有具体需求）
+```
+
+**使用场景**
+- 新项目启动，需要设计系统
+- 需要统一的色彩、字体、间距配置
+- 想要生成 Tailwind/React/Vue 配置
+- 需要完整的主题配置
+
+#### `ui_search` - UI/UX 智能搜索
+
+**✅ 推荐说法**
+```
+"我需要一个 React 的主按钮组件"
+"搜索一下蓝色主题的配色方案"
+"表单验证有什么 UX 最佳实践？"
+"给我推荐一些图标"
+"找一个加载动画组件"
+"有什么好的卡片设计？"
+```
+
+**❌ 不推荐说法**
+```
+"找个东西"（太模糊）
+"搜索"（没有说明搜索什么）
+```
+
+**使用场景**
+- 需要特定的 UI 组件实现
+- 寻找配色方案
+- 查找设计最佳实践
+- 需要图标、图表等设计元素
+
+#### `sync_ui_data` - 数据同步
+
+**✅ 推荐说法**
+```
+"检查一下 UI 数据有没有更新"
+"更新 UI/UX 数据"
+"同步最新的设计数据"
+"强制更新 UI 数据"
+```
+
+**使用场景**
+- 定期检查数据更新
+- 遇到搜索结果不准确
+- 需要最新的设计数据
+
+---
+
+### 🎯 1️⃣ 需求访谈 → `interview` / `ask_user`
+
+**触发关键词**：访谈、需求不明确、想清楚、澄清需求、提问、确认
+
+#### `interview` - 结构化访谈
+
+**✅ 推荐说法**
+```
+"我想做登录功能"（需求不明确时）
+"interview 用户认证功能"
+"帮我访谈一下这个需求"
+"先把需求想清楚再开发"
+"需求不太明确，先访谈一下"
+```
+
+**使用场景**
+- 需求描述简短、不明确
+- 复杂的业务功能
+- 涉及多方协作
+- 有较多技术约束
+
+#### `ask_user` - AI 主动提问
+
+**✅ AI 会自动调用**
+```
+当 AI 遇到不确定因素时会主动提问：
+"优化目标是性能还是可读性？"
+"是否需要向后兼容？"
+"你希望支持哪些支付方式？"
+```
+
+**用户也可以主动触发**
+```
+"有什么需要我确认的吗？"
+"问我几个问题吧"
+```
+
+---
+
 ### 1️⃣ 调试问题 → `debug`
 
 **触发关键词**：调试、debug、分析错误、为什么报错、bug、问题
@@ -232,26 +341,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 ---
 
-### 1️⃣1️⃣ 代码转换 → `convert`
-
-**触发关键词**：转换、改成、转为、迁移
-
-**✅ 推荐说法**
-```
-"把这个转成 TypeScript"
-"Class 组件改成 Hooks"
-"转换成 ES6 语法"
-"迁移到 Vue 3"
-```
-
-**❌ 不推荐说法**
-```
-"换一下"（没说换成什么）
-```
-
----
-
-### 1️⃣2️⃣ 生成 Mock 数据 → `gen_mock`
+### 1️⃣1️⃣ 生成 Mock 数据 → `gen_mock`
 
 **触发关键词**：Mock、模拟数据、假数据、测试数据
 
@@ -270,97 +360,97 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 ---
 
-### 1️⃣3️⃣ Bug 修复流程 → `fix_bug`
+### 1️⃣2️⃣ 生成 Agent Skills → `gen_skill`
 
-**触发关键词**：修复 Bug、Bug 修复、解决问题、修这个错误
+**触发关键词**：Skills、技能文档、Agent Skills、SKILL.md
 
 **✅ 推荐说法**
 ```
-"修复这个 Bug"
-"帮我解决这个错误"
-"fix_bug 这个问题"
-"完整修复这个 Bug"
+"生成 Agent Skills 文档"
+"gen_skill"
+"生成技能文档"
+"为 code_review 生成 SKILL.md"
 ```
 
 **❌ 不推荐说法**
 ```
-"搞定这个"（意图不明）
+"生成文档"（太笼统，可能调用其他工具）
 ```
 
 ---
 
-### 1️⃣4️⃣ 工作量估算 → `estimate`
+### 1️⃣3️⃣ 代码转换 → `convert`
 
-**触发关键词**：估算、工作量、需要多久、故事点
+**触发关键词**：转换、改成、转为、迁移
 
 **✅ 推荐说法**
 ```
-"估算工作量"
-"这个任务需要多久"
-"评估开发时间"
-"给个故事点估算"
+"把这个转成 TypeScript"
+"Class 组件改成 Hooks"
+"转换成 ES6 语法"
+"迁移到 Vue 3"
 ```
 
 **❌ 不推荐说法**
 ```
-"要多久"（太简短）
+"换一下"（没说换成什么）
 ```
 
 ---
 
-### 1️⃣5️⃣ 生成 SQL → `gensql`
+### 1️⃣4️⃣ Bug 修复流程 → `fix_bug`
 
-**触发关键词**：SQL、查询、数据库、建表
+**触发关键词**：修复 Bug、Bug 修复、解决问题、修这个错误
 
 **✅ 推荐说法**
 ```
-"生成 SQL 查询"
-"写个查询语句"
-"创建数据库表"
-"查询最近30天的用户"
+"修复这个 Bug"
+"帮我解决这个错误"
+"fix_bug 这个问题"
+"完整修复这个 Bug"
 ```
 
 **❌ 不推荐说法**
 ```
-"查一下"（没说要生成 SQL）
+"搞定这个"（意图不明）
 ```
 
 ---
 
-### 1️⃣6️⃣ 生成 Agent Skills → `gen_skill`
+### 1️⃣5️⃣ 工作量估算 → `estimate`
 
-**触发关键词**：Skills、技能文档、Agent Skills、SKILL.md
+**触发关键词**：估算、工作量、需要多久、故事点
 
 **✅ 推荐说法**
 ```
-"生成 Agent Skills 文档"
-"gen_skill"
-"生成技能文档"
-"为 code_review 生成 SKILL.md"
+"估算工作量"
+"这个任务需要多久"
+"评估开发时间"
+"给个故事点估算"
 ```
 
 **❌ 不推荐说法**
 ```
-"生成文档"（太笼统，可能调用其他工具）
+"要多久"（太简短）
 ```
 
 ---
 
-### 1️⃣7️⃣ 生成 UI 组件 → `genui`
+### 1️⃣6️⃣ 生成 SQL → `gensql`
 
-**触发关键词**：组件、UI、界面、按钮、表单
+**触发关键词**：SQL、查询、数据库、建表
 
 **✅ 推荐说法**
 ```
-"生成一个 Button 组件"
-"创建登录表单"
-"写个 Modal 组件"
-"生成用户卡片 UI"
+"生成 SQL 查询"
+"写个查询语句"
+"创建数据库表"
+"查询最近30天的用户"
 ```
 
 **❌ 不推荐说法**
 ```
-"做个界面"（没说具体是什么）
+"查一下"（没说要生成 SQL）
 ```
 
 ---
@@ -405,8 +495,6 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 ---
 
----
-
 ## 🚀 智能编排工具触发
 
 > 智能编排工具自动组合多个基础工具，一键完成复杂工作流
@@ -415,7 +503,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 #### 🎯 开发流程类
 
-####### 1️⃣7️⃣ 新功能开发 → `start_feature`
+##### 1️⃣9️⃣ 新功能开发 → `start_feature`
 
 **触发关键词**：新功能、开发功能、添加功能、实现功能、feature
 
@@ -438,7 +526,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 ---
 
-##### 1️⃣8️⃣ Bug 修复编排 → `start_bugfix`
+##### 2️⃣0️⃣ Bug 修复编排 → `start_bugfix`
 
 **触发关键词**：修 Bug、Bug 修复、解决错误、完整修复、bugfix
 
@@ -460,7 +548,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 ---
 
-##### 2️⃣2️⃣ 快速上手 → `start_onboard`
+##### 2️⃣3️⃣ 快速上手 → `start_onboard`
 
 **触发关键词**：了解项目、快速上手、分析项目、onboard、接手项目
 
@@ -485,7 +573,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 #### 🔍 质量保障类
 
-##### 1️⃣9️⃣ 代码体检 → `start_review`
+##### 2️⃣1️⃣ 代码体检 → `start_review`
 
 **触发关键词**：全面审查、代码体检、完整检查、全面检查、review
 
@@ -532,7 +620,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 #### 📦 发布管理类
 
-##### 2️⃣0️⃣ 发布准备 → `start_release`
+##### 2️⃣4️⃣ 发布准备 → `start_release`
 
 **触发关键词**：发布、release、准备发布、版本发布
 
@@ -556,7 +644,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 #### 📝 文档生成类
 
-##### 2️⃣3️⃣ API 开发 → `start_api`
+##### 2️⃣5️⃣ API 开发 → `start_api`
 
 **触发关键词**：API 开发、接口开发、API 资料、接口文档
 
@@ -578,7 +666,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 ---
 
-##### 2️⃣4️⃣ 文档生成 → `start_doc`
+##### 2️⃣6️⃣ 文档生成 → `start_doc`
 
 **触发关键词**：生成完整文档、项目文档、全套文档
 
@@ -600,6 +688,41 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
 
 ---
 
+##### 2️⃣7️⃣ Ralph Loop 循环开发 → `start_ralph` 🆕
+
+**触发关键词**：Ralph Loop、循环开发、迭代开发、自动循环、多轮开发
+
+**自动执行**：生成 .ralph/ 目录 → 安全模式脚本 → 执行指南
+
+**✅ 推荐说法**
+```
+"start_ralph 实现用户登录功能"
+"用 Ralph Loop 开发这个功能"
+"启动循环开发模式"
+"ralph 模式修复这个 bug"
+"创建 Ralph Loop 环境"
+```
+
+**❌ 不推荐说法**
+```
+"循环一下"（意图不明）
+"自动开发"（太笼统）
+```
+
+**使用场景**
+- 需要多轮迭代的复杂功能
+- Bug 修复需要多次尝试
+- 代码重构需要小步快跑
+- 测试驱动开发（TDD）流程
+
+**安全特性**
+- 默认安全模式（多重保护）
+- 人工确认（每轮确认）
+- 紧急停止（STOP 文件）
+- 失控保护（重复检测、变更量检测）
+
+---
+
 ### 🎯 智能编排 vs 基础工具
 
 | 场景 | 基础工具 | 智能编排 | 推荐 |
@@ -908,6 +1031,7 @@ AI: [自动调用 start_review 编排]
 | 你想做什么 | 关键词 | 调用的工具 | 自动执行 |
 |-----------|--------|-----------|----------|
 | 准备发布 | 发布、release、版本发布 | `start_release` ⭐⭐⭐ | 上下文 → Changelog → PR |
+| Ralph Loop | 循环开发、迭代开发、ralph | `start_ralph` ⭐⭐⭐ 🆕 | 生成环境 → 安全脚本 → 多轮迭代 |
 
 #### 📝 文档生成类
 
@@ -995,6 +1119,13 @@ AI: [自动调用 start_review 编排]
 "全面检查这个模块的代码质量"
 ```
 
+### Ralph Loop 循环开发 🆕
+```
+"start_ralph 实现用户登录功能"
+"用 Ralph Loop 修复这个 bug"
+"启动循环开发模式"
+```
+
 ---
 
 ## 🎯 记住这些要点