mcp-probe-kit 1.4.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/README.md +794 -100
  2. package/build/index.js +379 -1
  3. package/build/tools/add_feature.d.ts +33 -0
  4. package/build/tools/add_feature.js +464 -0
  5. package/build/tools/analyze_project.js +58 -58
  6. package/build/tools/css_order.js +55 -55
  7. package/build/tools/design2code.d.ts +29 -0
  8. package/build/tools/design2code.js +400 -0
  9. package/build/tools/estimate.d.ts +22 -0
  10. package/build/tools/estimate.js +225 -0
  11. package/build/tools/fix_bug.d.ts +24 -0
  12. package/build/tools/fix_bug.js +298 -0
  13. package/build/tools/gen_mock.d.ts +22 -0
  14. package/build/tools/gen_mock.js +250 -0
  15. package/build/tools/index.d.ts +15 -0
  16. package/build/tools/index.js +16 -0
  17. package/build/tools/init_project.js +121 -76
  18. package/build/tools/init_project_context.d.ts +26 -0
  19. package/build/tools/init_project_context.js +331 -0
  20. package/build/tools/security_scan.d.ts +22 -0
  21. package/build/tools/security_scan.js +282 -0
  22. package/build/tools/start_api.d.ts +19 -0
  23. package/build/tools/start_api.js +178 -0
  24. package/build/tools/start_bugfix.d.ts +19 -0
  25. package/build/tools/start_bugfix.js +127 -0
  26. package/build/tools/start_doc.d.ts +19 -0
  27. package/build/tools/start_doc.js +190 -0
  28. package/build/tools/start_feature.d.ts +19 -0
  29. package/build/tools/start_feature.js +122 -0
  30. package/build/tools/start_onboard.d.ts +19 -0
  31. package/build/tools/start_onboard.js +146 -0
  32. package/build/tools/start_refactor.d.ts +19 -0
  33. package/build/tools/start_refactor.js +175 -0
  34. package/build/tools/start_release.d.ts +19 -0
  35. package/build/tools/start_release.js +152 -0
  36. package/build/tools/start_review.d.ts +19 -0
  37. package/build/tools/start_review.js +162 -0
  38. package/docs/BEST_PRACTICES.md +726 -0
  39. package/docs/HOW_TO_TRIGGER.html +188 -0
  40. package/docs/HOW_TO_TRIGGER.md +971 -0
  41. package/docs/specs/add-feature/design.md +608 -0
  42. package/docs/specs/add-feature/requirements.md +175 -0
  43. package/docs/specs/add-feature/tasks.md +111 -0
  44. package/docs/specs/design2code/README.md +0 -0
  45. package/docs/specs/design2code/requirements.md +0 -0
  46. package/docs/specs/estimate/design.md +209 -0
  47. package/docs/specs/estimate/requirements.md +140 -0
  48. package/docs/specs/estimate/tasks.md +66 -0
  49. package/docs/specs/fix-bug/design.md +259 -0
  50. package/docs/specs/fix-bug/requirements.md +132 -0
  51. package/docs/specs/fix-bug/tasks.md +66 -0
  52. package/docs/specs/gen-mock/design.md +241 -0
  53. package/docs/specs/gen-mock/requirements.md +137 -0
  54. package/docs/specs/gen-mock/tasks.md +66 -0
  55. package/docs/specs/init-project-context/design.md +515 -0
  56. package/docs/specs/init-project-context/requirements.md +144 -0
  57. package/docs/specs/init-project-context/tasks.md +93 -0
  58. package/docs/specs/security-scan/design.md +152 -0
  59. package/docs/specs/security-scan/requirements.md +150 -0
  60. package/docs/specs/security-scan/tasks.md +67 -0
  61. package/docs/specs/start-bugfix/design.md +42 -0
  62. package/docs/specs/start-bugfix/requirements.md +70 -0
  63. package/docs/specs/start-bugfix/tasks.md +21 -0
  64. package/docs/specs/start-feature/design.md +41 -0
  65. package/docs/specs/start-feature/requirements.md +90 -0
  66. package/docs/specs/start-feature/tasks.md +21 -0
  67. package/docs/specs/start-review/requirements.md +0 -0
  68. package/package.json +3 -2
@@ -0,0 +1,971 @@
1
+ # 🎯 如何让 AI 正确调用工具
2
+
3
+ > 实用的对话技巧,让 AI 准确理解你的意图并调用正确的工具
4
+
5
+ ---
6
+
7
+ ## 📖 目录
8
+
9
+ - [为什么需要这个指南](#为什么需要这个指南)
10
+ - [工具触发关键词](#工具触发关键词)
11
+ - [最佳实践](#最佳实践)
12
+ - [常见场景对话示例](#常见场景对话示例)
13
+
14
+ ---
15
+
16
+ ## 🤔 为什么需要这个指南
17
+
18
+ AI 需要理解你的意图才能调用正确的工具。使用明确的关键词和清晰的表达,可以:
19
+
20
+ ✅ 提高工具调用准确率
21
+ ✅ 减少来回确认次数
22
+ ✅ 获得更快的响应
23
+ ✅ 避免调用错误的工具
24
+
25
+ ---
26
+
27
+ ## 🔑 工具触发关键词
28
+
29
+ ### 1️⃣ 调试问题 → `debug`
30
+
31
+ **触发关键词**:调试、debug、分析错误、为什么报错、bug、问题
32
+
33
+ **✅ 推荐说法**
34
+ ```
35
+ "debug 这个弹窗逻辑"
36
+ "调试一下为什么会报错"
37
+ "帮我分析这个 bug"
38
+ "这里有个问题,帮我看看"
39
+ "为什么这个方法不工作"
40
+ ```
41
+
42
+ **❌ 不推荐说法**
43
+ ```
44
+ "看看这个"(太模糊)
45
+ "有问题"(没说什么问题)
46
+ "不对"(没说哪里不对)
47
+ ```
48
+
49
+ ---
50
+
51
+ ### 2️⃣ 代码解释 → `explain`
52
+
53
+ **触发关键词**:解释、说明、理解、梳理、讲解、这是什么
54
+
55
+ **✅ 推荐说法**
56
+ ```
57
+ "解释一下这段代码"
58
+ "这个方法是干什么的"
59
+ "帮我理解这个逻辑"
60
+ "梳理一下这个流程"
61
+ "讲解一下这个算法"
62
+ ```
63
+
64
+ **❌ 不推荐说法**
65
+ ```
66
+ "这个"(没说要做什么)
67
+ "看不懂"(没说要解释)
68
+ ```
69
+
70
+ ---
71
+
72
+ ### 3️⃣ 代码审查 → `code_review`
73
+
74
+ **触发关键词**:审查、review、检查、质量、有没有问题
75
+
76
+ **✅ 推荐说法**
77
+ ```
78
+ "审查一下这个文件"
79
+ "review 这段代码"
80
+ "检查代码质量"
81
+ "有没有安全问题"
82
+ "帮我看看代码有什么问题"
83
+ ```
84
+
85
+ **❌ 不推荐说法**
86
+ ```
87
+ "看看"(没说要审查)
88
+ "帮我弄一下"(意图不明)
89
+ ```
90
+
91
+ ---
92
+
93
+ ### 4️⃣ 安全扫描 → `security_scan`
94
+
95
+ **触发关键词**:安全、漏洞、注入、XSS、SQL注入、安全扫描
96
+
97
+ **✅ 推荐说法**
98
+ ```
99
+ "扫描安全漏洞"
100
+ "检查有没有 SQL 注入"
101
+ "安全审查这段代码"
102
+ "有没有 XSS 风险"
103
+ "检查安全问题"
104
+ ```
105
+
106
+ **❌ 不推荐说法**
107
+ ```
108
+ "检查一下"(没说检查什么)
109
+ "有问题吗"(太笼统)
110
+ ```
111
+
112
+ ---
113
+
114
+ ### 5️⃣ 生成测试 → `gentest`
115
+
116
+ **触发关键词**:测试、test、单元测试、写测试
117
+
118
+ **✅ 推荐说法**
119
+ ```
120
+ "生成测试用例"
121
+ "写个测试"
122
+ "帮我测试这个方法"
123
+ "为这个组件生成测试"
124
+ "添加单元测试"
125
+ ```
126
+
127
+ **❌ 不推荐说法**
128
+ ```
129
+ "测一下"(没说要生成测试代码)
130
+ ```
131
+
132
+ ---
133
+
134
+ ### 6️⃣ 性能分析 → `perf`
135
+
136
+ **触发关键词**:性能、优化、慢、瓶颈、卡顿
137
+
138
+ **✅ 推荐说法**
139
+ ```
140
+ "分析性能"
141
+ "优化这段代码的性能"
142
+ "有没有性能瓶颈"
143
+ "这里会不会慢"
144
+ "为什么这么卡"
145
+ ```
146
+
147
+ **❌ 不推荐说法**
148
+ ```
149
+ "优化一下"(没说优化什么)
150
+ "改进"(太笼统)
151
+ ```
152
+
153
+ ---
154
+
155
+ ### 7️⃣ 重构建议 → `refactor`
156
+
157
+ **触发关键词**:重构、改进、简化、优化结构、代码太复杂
158
+
159
+ **✅ 推荐说法**
160
+ ```
161
+ "重构一下这段代码"
162
+ "怎么改进这个方法"
163
+ "代码太复杂了,简化一下"
164
+ "优化代码结构"
165
+ "这段代码可以怎么改"
166
+ ```
167
+
168
+ **❌ 不推荐说法**
169
+ ```
170
+ "改一下"(没说怎么改)
171
+ "弄好看点"(意图不明)
172
+ ```
173
+
174
+ ---
175
+
176
+ ### 8️⃣ 自动修复 → `fix`
177
+
178
+ **触发关键词**:修复、fix、lint错误、格式化、类型错误
179
+
180
+ **✅ 推荐说法**
181
+ ```
182
+ "修复这些 lint 错误"
183
+ "自动修复格式问题"
184
+ "修复类型错误"
185
+ "fix 这些警告"
186
+ "格式化代码"
187
+ ```
188
+
189
+ **❌ 不推荐说法**
190
+ ```
191
+ "弄好"(没说要修复什么)
192
+ ```
193
+
194
+ ---
195
+
196
+ ### 9️⃣ 生成文档 → `genapi` / `gendoc` / `genreadme`
197
+
198
+ **触发关键词**:文档、注释、API文档、README、JSDoc
199
+
200
+ **✅ 推荐说法**
201
+ ```
202
+ "生成 API 文档"
203
+ "添加注释"
204
+ "生成 JSDoc"
205
+ "写个 README"
206
+ "为这个方法添加文档"
207
+ ```
208
+
209
+ **❌ 不推荐说法**
210
+ ```
211
+ "写点东西"(没说写什么)
212
+ ```
213
+
214
+ ---
215
+
216
+ ### 🔟 生成 Commit → `gencommit`
217
+
218
+ **触发关键词**:commit、提交、提交信息、总结改动
219
+
220
+ **✅ 推荐说法**
221
+ ```
222
+ "生成 commit 信息"
223
+ "帮我写提交信息"
224
+ "总结这次改动"
225
+ "生成 git commit"
226
+ ```
227
+
228
+ **❌ 不推荐说法**
229
+ ```
230
+ "写个信息"(没说是 commit)
231
+ ```
232
+
233
+ ---
234
+
235
+ ### 1️⃣1️⃣ 代码转换 → `convert`
236
+
237
+ **触发关键词**:转换、改成、转为、迁移
238
+
239
+ **✅ 推荐说法**
240
+ ```
241
+ "把这个转成 TypeScript"
242
+ "Class 组件改成 Hooks"
243
+ "转换成 ES6 语法"
244
+ "迁移到 Vue 3"
245
+ ```
246
+
247
+ **❌ 不推荐说法**
248
+ ```
249
+ "换一下"(没说换成什么)
250
+ ```
251
+
252
+ ---
253
+
254
+ ### 1️⃣2️⃣ 生成 Mock 数据 → `gen_mock`
255
+
256
+ **触发关键词**:Mock、模拟数据、假数据、测试数据
257
+
258
+ **✅ 推荐说法**
259
+ ```
260
+ "生成 Mock 数据"
261
+ "创建测试数据"
262
+ "生成假数据"
263
+ "为这个接口生成模拟数据"
264
+ ```
265
+
266
+ **❌ 不推荐说法**
267
+ ```
268
+ "弄点数据"(没说是 Mock)
269
+ ```
270
+
271
+ ---
272
+
273
+ ### 1️⃣3️⃣ Bug 修复流程 → `fix_bug`
274
+
275
+ **触发关键词**:修复 Bug、Bug 修复、解决问题、修这个错误
276
+
277
+ **✅ 推荐说法**
278
+ ```
279
+ "修复这个 Bug"
280
+ "帮我解决这个错误"
281
+ "fix_bug 这个问题"
282
+ "完整修复这个 Bug"
283
+ ```
284
+
285
+ **❌ 不推荐说法**
286
+ ```
287
+ "搞定这个"(意图不明)
288
+ ```
289
+
290
+ ---
291
+
292
+ ### 1️⃣4️⃣ 工作量估算 → `estimate`
293
+
294
+ **触发关键词**:估算、工作量、需要多久、故事点
295
+
296
+ **✅ 推荐说法**
297
+ ```
298
+ "估算工作量"
299
+ "这个任务需要多久"
300
+ "评估开发时间"
301
+ "给个故事点估算"
302
+ ```
303
+
304
+ **❌ 不推荐说法**
305
+ ```
306
+ "要多久"(太简短)
307
+ ```
308
+
309
+ ---
310
+
311
+ ### 1️⃣5️⃣ 生成 SQL → `gensql`
312
+
313
+ **触发关键词**:SQL、查询、数据库、建表
314
+
315
+ **✅ 推荐说法**
316
+ ```
317
+ "生成 SQL 查询"
318
+ "写个查询语句"
319
+ "创建数据库表"
320
+ "查询最近30天的用户"
321
+ ```
322
+
323
+ **❌ 不推荐说法**
324
+ ```
325
+ "查一下"(没说要生成 SQL)
326
+ ```
327
+
328
+ ---
329
+
330
+ ### 1️⃣6️⃣ 生成 UI 组件 → `genui`
331
+
332
+ **触发关键词**:组件、UI、界面、按钮、表单
333
+
334
+ **✅ 推荐说法**
335
+ ```
336
+ "生成一个 Button 组件"
337
+ "创建登录表单"
338
+ "写个 Modal 组件"
339
+ "生成用户卡片 UI"
340
+ ```
341
+
342
+ **❌ 不推荐说法**
343
+ ```
344
+ "做个界面"(没说具体是什么)
345
+ ```
346
+
347
+ ---
348
+
349
+ ### 1️⃣7️⃣ 设计稿转代码 → `design2code`
350
+
351
+ **触发关键词**:设计稿、图片转代码、HTML转Vue、HTML转React、还原设计
352
+
353
+ **✅ 推荐说法**
354
+ ```
355
+ "把这个设计稿转成 Vue 代码"
356
+ "design2code https://example.com/design.png"
357
+ "将这个 HTML 转换为 React 组件"
358
+ "还原这个设计稿"
359
+ "图片转代码"
360
+ ```
361
+
362
+ **❌ 不推荐说法**
363
+ ```
364
+ "做个页面"(没说基于什么)
365
+ "转一下"(没说转什么)
366
+ ```
367
+
368
+ ---
369
+
370
+ ---
371
+
372
+ ## 🚀 智能编排工具触发
373
+
374
+ > 智能编排工具自动组合多个基础工具,一键完成复杂工作流
375
+
376
+ ### 📋 编排工具分类
377
+
378
+ #### 🎯 开发流程类
379
+
380
+ ####### 1️⃣7️⃣ 新功能开发 → `start_feature`
381
+
382
+ **触发关键词**:新功能、开发功能、添加功能、实现功能、feature
383
+
384
+ **自动执行**:检查上下文 → 生成功能规格 → 工作量估算
385
+
386
+ **✅ 推荐说法**
387
+ ```
388
+ "开发用户登录功能"
389
+ "添加个人资料功能"
390
+ "实现支付功能"
391
+ "start_feature 用户设置"
392
+ "新功能:消息通知"
393
+ ```
394
+
395
+ **❌ 不推荐说法**
396
+ ```
397
+ "做个功能"(没说什么功能)
398
+ "加个东西"(意图不明)
399
+ ```
400
+
401
+ ---
402
+
403
+ ##### 1️⃣8️⃣ Bug 修复编排 → `start_bugfix`
404
+
405
+ **触发关键词**:修 Bug、Bug 修复、解决错误、完整修复、bugfix
406
+
407
+ **自动执行**:检查上下文 → 问题定位 → 修复方案 → 生成测试
408
+
409
+ **✅ 推荐说法**
410
+ ```
411
+ "start_bugfix 修复这个错误"
412
+ "完整修复这个 Bug"
413
+ "帮我修复登录问题"
414
+ "Bug 修复:用户无法登出"
415
+ ```
416
+
417
+ **❌ 不推荐说法**
418
+ ```
419
+ "修一下"(没说要完整流程)
420
+ "有问题"(太模糊)
421
+ ```
422
+
423
+ ---
424
+
425
+ ##### 2️⃣2️⃣ 快速上手 → `start_onboard`
426
+
427
+ **触发关键词**:了解项目、快速上手、分析项目、onboard、接手项目
428
+
429
+ **自动执行**:项目分析 → 生成项目上下文文档
430
+
431
+ **✅ 推荐说法**
432
+ ```
433
+ "快速了解这个项目"
434
+ "start_onboard"
435
+ "帮我分析项目结构"
436
+ "接手这个项目"
437
+ "熟悉一下代码"
438
+ ```
439
+
440
+ **❌ 不推荐说法**
441
+ ```
442
+ "看看项目"(没说要生成文档)
443
+ "了解一下"(太笼统)
444
+ ```
445
+
446
+ ---
447
+
448
+ #### 🔍 质量保障类
449
+
450
+ ##### 1️⃣9️⃣ 代码体检 → `start_review`
451
+
452
+ **触发关键词**:全面审查、代码体检、完整检查、全面检查、review
453
+
454
+ **自动执行**:检查上下文 → 代码审查 → 安全扫描 → 性能分析
455
+
456
+ **✅ 推荐说法**
457
+ ```
458
+ "全面审查这个文件"
459
+ "代码体检"
460
+ "完整检查代码质量"
461
+ "start_review 这个模块"
462
+ "全面检查 @api/user.ts"
463
+ ```
464
+
465
+ **❌ 不推荐说法**
466
+ ```
467
+ "看看代码"(没说要全面检查)
468
+ "检查一下"(太简单)
469
+ ```
470
+
471
+ ---
472
+
473
+ ##### 2️⃣1️⃣ 代码重构编排 → `start_refactor`
474
+
475
+ **触发关键词**:完整重构、重构流程、重构并测试
476
+
477
+ **自动执行**:检查上下文 → 代码审查 → 重构方案 → 生成测试
478
+
479
+ **✅ 推荐说法**
480
+ ```
481
+ "完整重构这个模块"
482
+ "start_refactor 这段代码"
483
+ "重构并生成测试"
484
+ "重构 @legacy-code.js"
485
+ ```
486
+
487
+ **❌ 不推荐说法**
488
+ ```
489
+ "改改代码"(没说要完整流程)
490
+ "优化一下"(太笼统)
491
+ ```
492
+
493
+ ---
494
+
495
+ #### 📦 发布管理类
496
+
497
+ ##### 2️⃣0️⃣ 发布准备 → `start_release`
498
+
499
+ **触发关键词**:发布、release、准备发布、版本发布
500
+
501
+ **自动执行**:检查上下文 → 生成 Changelog → 生成 PR 描述
502
+
503
+ **✅ 推荐说法**
504
+ ```
505
+ "准备发布 v1.2.0"
506
+ "start_release v1.2.0"
507
+ "生成发布资料"
508
+ "发布版本 v1.2.0"
509
+ ```
510
+
511
+ **❌ 不推荐说法**
512
+ ```
513
+ "要发版了"(没说要准备什么)
514
+ "发布"(没说版本号)
515
+ ```
516
+
517
+ ---
518
+
519
+ #### 📝 文档生成类
520
+
521
+ ##### 2️⃣3️⃣ API 开发 → `start_api`
522
+
523
+ **触发关键词**:API 开发、接口开发、API 资料、接口文档
524
+
525
+ **自动执行**:检查上下文 → API 文档 → Mock 数据 → API 测试
526
+
527
+ **✅ 推荐说法**
528
+ ```
529
+ "为这个 API 生成完整资料"
530
+ "start_api 用户接口"
531
+ "开发用户 API"
532
+ "API 开发:订单接口"
533
+ ```
534
+
535
+ **❌ 不推荐说法**
536
+ ```
537
+ "写个接口"(没说要完整资料)
538
+ "做个 API"(太简单)
539
+ ```
540
+
541
+ ---
542
+
543
+ ##### 2️⃣4️⃣ 文档生成 → `start_doc`
544
+
545
+ **触发关键词**:生成完整文档、项目文档、全套文档
546
+
547
+ **自动执行**:检查上下文 → 代码注释 → README → API 文档
548
+
549
+ **✅ 推荐说法**
550
+ ```
551
+ "生成完整文档"
552
+ "start_doc 这个项目"
553
+ "为项目生成文档"
554
+ "生成全套文档"
555
+ ```
556
+
557
+ **❌ 不推荐说法**
558
+ ```
559
+ "写点文档"(没说要完整的)
560
+ "加个文档"(太笼统)
561
+ ```
562
+
563
+ ---
564
+
565
+ ### 🎯 智能编排 vs 基础工具
566
+
567
+ | 场景 | 基础工具 | 智能编排 | 推荐 |
568
+ |------|---------|---------|------|
569
+ | 开发新功能 | add_feature + estimate | start_feature | ⭐⭐⭐ |
570
+ | 修复 Bug | fix_bug + gentest + gencommit | start_bugfix | ⭐⭐⭐ |
571
+ | 代码审查 | code_review | start_review | ⭐⭐⭐ |
572
+ | 代码重构 | refactor + gentest | start_refactor | ⭐⭐⭐ |
573
+ | 准备发布 | genchangelog + genpr | start_release | ⭐⭐⭐ |
574
+ | 了解项目 | analyze_project + init_project_context | start_onboard | ⭐⭐⭐ |
575
+ | API 开发 | genapi + gen_mock + gentest | start_api | ⭐⭐ |
576
+ | 生成文档 | gendoc + genreadme + genapi | start_doc | ⭐⭐ |
577
+
578
+ **建议**:优先使用智能编排工具,它们会自动处理项目上下文并组合多个工具。
579
+
580
+ ---
581
+
582
+ ## 💡 最佳实践
583
+
584
+ ### ✅ 推荐的说法(明确意图)
585
+
586
+ ```
587
+ "debug 这个登录逻辑有问题"
588
+ "审查一下 view.vue 的代码质量"
589
+ "解释一下 fetchDetail 方法"
590
+ "生成这个组件的测试用例"
591
+ "分析一下这个页面的性能"
592
+ "扫描安全漏洞"
593
+ "重构这段复杂代码"
594
+ "生成 Mock 数据"
595
+ "估算这个任务的工作量"
596
+ ```
597
+
598
+ ### ❌ 不太好的说法(意图模糊)
599
+
600
+ ```
601
+ "看看这个"
602
+ "帮我弄一下"
603
+ "这里不对"
604
+ "优化一下"(没说优化什么)
605
+ "改改"(没说怎么改)
606
+ "检查一下"(没说检查什么)
607
+ ```
608
+
609
+ ---
610
+
611
+ ## 🎯 快速触发技巧
612
+
613
+ ### 方式 1:直接用动词开头
614
+
615
+ ```
616
+ "审查 view.vue"
617
+ "解释 handleExtractCodeConfirm"
618
+ "调试弹窗问题"
619
+ "生成测试"
620
+ "扫描安全问题"
621
+ "重构这段代码"
622
+ ```
623
+
624
+ ### 方式 2:明确指定工具
625
+
626
+ ```
627
+ "debug 这个问题"
628
+ "code_review 这段代码"
629
+ "explain 这个逻辑"
630
+ "security_scan 这个文件"
631
+ "gentest 这个方法"
632
+ "start_feature 用户登录"
633
+ ```
634
+
635
+ ### 方式 3:结合上下文
636
+
637
+ ```
638
+ "这个方法有 bug,帮我 debug"
639
+ "代码写完了,review 一下"
640
+ "不太懂这段,解释一下"
641
+ "检查一下有没有安全漏洞"
642
+ "这段代码太复杂,重构一下"
643
+ ```
644
+
645
+ ### 方式 4:带文件引用
646
+
647
+ ```
648
+ "debug @LoginForm.tsx"
649
+ "review @api/user.ts"
650
+ "explain @utils/format.ts"
651
+ "security_scan @payment.ts"
652
+ "gentest @Button.tsx"
653
+ ```
654
+
655
+ ---
656
+
657
+ ## 📚 常见场景对话示例
658
+
659
+ ### 场景 1:遇到 Bug
660
+
661
+ **❌ 不好的说法**
662
+ ```
663
+ 你: "这里有问题"
664
+ AI: "请问是什么问题?需要我做什么?"
665
+ ```
666
+
667
+ **✅ 好的说法**
668
+ ```
669
+ 你: "debug 这个登录逻辑,点击登录按钮没反应"
670
+ AI: [自动调用 debug 工具]
671
+ ```
672
+
673
+ ---
674
+
675
+ ### 场景 2:不理解代码
676
+
677
+ **❌ 不好的说法**
678
+ ```
679
+ 你: "看不懂"
680
+ AI: "请问哪里看不懂?"
681
+ ```
682
+
683
+ **✅ 好的说法**
684
+ ```
685
+ 你: "解释一下 @utils/auth.ts 的 validateToken 方法"
686
+ AI: [自动调用 explain 工具]
687
+ ```
688
+
689
+ ---
690
+
691
+ ### 场景 3:代码审查
692
+
693
+ **❌ 不好的说法**
694
+ ```
695
+ 你: "帮我看看"
696
+ AI: "请问要看什么?"
697
+ ```
698
+
699
+ **✅ 好的说法**
700
+ ```
701
+ 你: "审查 @components/UserProfile.tsx 的代码质量"
702
+ AI: [自动调用 code_review 工具]
703
+ ```
704
+
705
+ ---
706
+
707
+ ### 场景 4:安全检查
708
+
709
+ **❌ 不好的说法**
710
+ ```
711
+ 你: "检查一下"
712
+ AI: "请问要检查什么?"
713
+ ```
714
+
715
+ **✅ 好的说法**
716
+ ```
717
+ 你: "扫描 @api/payment.ts 的安全漏洞"
718
+ AI: [自动调用 security_scan 工具]
719
+ ```
720
+
721
+ ---
722
+
723
+ ### 场景 5:性能优化
724
+
725
+ **❌ 不好的说法**
726
+ ```
727
+ 你: "优化一下"
728
+ AI: "请问要优化什么?"
729
+ ```
730
+
731
+ **✅ 好的说法**
732
+ ```
733
+ 你: "分析 @pages/Dashboard.tsx 的性能瓶颈"
734
+ AI: [自动调用 perf 工具]
735
+ ```
736
+
737
+ ---
738
+
739
+ ### 场景 6:开发新功能
740
+
741
+ **❌ 不好的说法**
742
+ ```
743
+ 你: "做个功能"
744
+ AI: "请问要做什么功能?"
745
+ ```
746
+
747
+ **✅ 好的说法**
748
+ ```
749
+ 你: "start_feature user-settings '用户设置页面'"
750
+ AI: [自动调用 start_feature 编排]
751
+ ```
752
+
753
+ ---
754
+
755
+ ### 场景 7:修复 Bug
756
+
757
+ **❌ 不好的说法**
758
+ ```
759
+ 你: "修一下"
760
+ AI: "请问要修什么?"
761
+ ```
762
+
763
+ **✅ 好的说法**
764
+ ```
765
+ 你: "start_bugfix 修复登录超时问题"
766
+ 然后粘贴错误信息
767
+ AI: [自动调用 start_bugfix 编排]
768
+ ```
769
+
770
+ ---
771
+
772
+ ### 场景 8:代码体检
773
+
774
+ **❌ 不好的说法**
775
+ ```
776
+ 你: "检查代码"
777
+ AI: "请问要检查什么?"
778
+ ```
779
+
780
+ **✅ 好的说法**
781
+ ```
782
+ 你: "start_review @src/api/ 全面体检"
783
+ AI: [自动调用 start_review 编排]
784
+ ```
785
+
786
+ ---
787
+
788
+ ## 🎓 进阶技巧
789
+
790
+ ### 1. 组合关键词
791
+
792
+ ```
793
+ "审查并生成测试"
794
+ → AI 会依次调用 code_review 和 gentest
795
+
796
+ "解释这段代码,然后重构"
797
+ → AI 会依次调用 explain 和 refactor
798
+
799
+ "扫描安全问题并修复"
800
+ → AI 会依次调用 security_scan 和 fix
801
+ ```
802
+
803
+ ### 2. 使用上下文
804
+
805
+ ```
806
+ "这个方法性能不好,帮我优化"
807
+ → AI 会调用 perf 分析,然后调用 refactor
808
+
809
+ "代码写完了,帮我 review 并生成测试"
810
+ → AI 会调用 code_review 和 gentest
811
+ ```
812
+
813
+ ### 3. 明确范围
814
+
815
+ ```
816
+ "审查所有 API 文件"
817
+ → code_review @api/*.ts
818
+
819
+ "为所有组件生成测试"
820
+ → gentest @components/*.tsx
821
+
822
+ "扫描整个项目的安全问题"
823
+ → security_scan @src/
824
+ ```
825
+
826
+ ---
827
+
828
+ ## 📊 工具选择决策表
829
+
830
+ ### 基础工具
831
+
832
+ | 你想做什么 | 关键词 | 调用的工具 |
833
+ |-----------|--------|-----------|
834
+ | 调试问题 | debug、调试、分析错误 | `debug` |
835
+ | 理解代码 | 解释、说明、理解 | `explain` |
836
+ | 审查代码 | 审查、review、检查质量 | `code_review` |
837
+ | 安全检查 | 安全、漏洞、扫描 | `security_scan` |
838
+ | 生成测试 | 测试、test、单元测试 | `gentest` |
839
+ | 性能分析 | 性能、优化、慢、瓶颈 | `perf` |
840
+ | 重构代码 | 重构、改进、简化 | `refactor` |
841
+ | 修复错误 | 修复、fix、lint错误 | `fix` |
842
+ | 生成文档 | 文档、注释、API文档 | `genapi`/`gendoc` |
843
+ | 提交代码 | commit、提交信息 | `gencommit` |
844
+ | 代码转换 | 转换、改成、迁移 | `convert` |
845
+ | Mock数据 | Mock、模拟数据 | `gen_mock` |
846
+ | 设计稿转代码 | 设计稿、图片转代码、HTML转Vue | `design2code` |
847
+ | Bug修复流程 | 修复Bug、完整修复 | `fix_bug` |
848
+ | 工作量估算 | 估算、工作量、需要多久 | `estimate` |
849
+
850
+ ### 智能编排工具(推荐优先使用)
851
+
852
+ #### 🎯 开发流程类
853
+
854
+ | 你想做什么 | 关键词 | 调用的工具 | 自动执行 |
855
+ |-----------|--------|-----------|----------|
856
+ | 开发新功能 | 新功能、开发功能、feature | `start_feature` ⭐⭐⭐ | 上下文 → 规格 → 估算 |
857
+ | 完整Bug修复 | Bug修复编排、bugfix | `start_bugfix` ⭐⭐⭐ | 上下文 → 定位 → 修复 → 测试 |
858
+ | 快速上手 | 了解项目、快速上手、onboard | `start_onboard` ⭐⭐⭐ | 项目分析 → 生成上下文 |
859
+
860
+ #### 🔍 质量保障类
861
+
862
+ | 你想做什么 | 关键词 | 调用的工具 | 自动执行 |
863
+ |-----------|--------|-----------|----------|
864
+ | 代码体检 | 全面审查、体检、完整检查 | `start_review` ⭐⭐⭐ | 上下文 → 审查 → 安全 → 性能 |
865
+ | 完整重构 | 完整重构、重构流程 | `start_refactor` ⭐⭐⭐ | 上下文 → 审查 → 重构 → 测试 |
866
+
867
+ #### 📦 发布管理类
868
+
869
+ | 你想做什么 | 关键词 | 调用的工具 | 自动执行 |
870
+ |-----------|--------|-----------|----------|
871
+ | 准备发布 | 发布、release、版本发布 | `start_release` ⭐⭐⭐ | 上下文 → Changelog → PR |
872
+
873
+ #### 📝 文档生成类
874
+
875
+ | 你想做什么 | 关键词 | 调用的工具 | 自动执行 |
876
+ |-----------|--------|-----------|----------|
877
+ | API开发 | API开发、接口开发、API资料 | `start_api` ⭐⭐ | 上下文 → 文档 → Mock → 测试 |
878
+ | 生成文档 | 完整文档、项目文档、全套文档 | `start_doc` ⭐⭐ | 上下文 → 注释 → README → API |
879
+
880
+ ---
881
+
882
+ ## 💬 实际对话模板
883
+
884
+ ### 调试问题
885
+ ```
886
+ "debug @LoginForm.tsx 点击登录按钮没反应"
887
+ "调试一下为什么这个请求失败了"
888
+ "帮我分析这个 TypeError"
889
+ ```
890
+
891
+ ### 代码解释
892
+ ```
893
+ "解释 @utils/format.ts 的 formatDate 方法"
894
+ "这个 useEffect 是干什么的"
895
+ "梳理一下这个支付流程"
896
+ ```
897
+
898
+ ### 代码审查
899
+ ```
900
+ "review @api/user.ts 的代码质量"
901
+ "审查这个组件有没有问题"
902
+ "检查 @payment.ts 的安全性"
903
+ ```
904
+
905
+ ### 安全扫描
906
+ ```
907
+ "security_scan @api/payment.ts"
908
+ "扫描这个文件的安全漏洞"
909
+ "检查有没有 SQL 注入风险"
910
+ ```
911
+
912
+ ### 生成测试
913
+ ```
914
+ "gentest @Button.tsx"
915
+ "为这个方法生成单元测试"
916
+ "写个测试覆盖这个逻辑"
917
+ ```
918
+
919
+ ### 性能分析
920
+ ```
921
+ "perf @Dashboard.tsx"
922
+ "分析这个列表渲染的性能"
923
+ "这个查询会不会慢"
924
+ ```
925
+
926
+ ### 重构代码
927
+ ```
928
+ "refactor @legacy-code.js"
929
+ "这段代码太复杂,简化一下"
930
+ "重构这个方法,提高可读性"
931
+ ```
932
+
933
+ ### 设计稿转代码
934
+ ```
935
+ "design2code https://example.com/design.png"
936
+ "把这个设计稿转成 Vue 代码"
937
+ "将这个 HTML 转换为 React 组件"
938
+ "design2code" 然后提供设计稿描述
939
+ ```
940
+
941
+ ### 开发新功能
942
+ ```
943
+ "start_feature user-profile '用户个人资料管理'"
944
+ "开发一个消息通知功能"
945
+ ```
946
+
947
+ ### 修复 Bug
948
+ ```
949
+ "start_bugfix"
950
+ 然后粘贴错误信息
951
+ ```
952
+
953
+ ### 代码体检
954
+ ```
955
+ "start_review @src/api/"
956
+ "全面检查这个模块的代码质量"
957
+ ```
958
+
959
+ ---
960
+
961
+ ## 🎯 记住这些要点
962
+
963
+ 1. **明确意图** - 说清楚你想做什么
964
+ 2. **使用关键词** - 用工具相关的动词
965
+ 3. **指定范围** - 用 @ 引用具体文件
966
+ 4. **提供上下文** - 说明问题的背景
967
+ 5. **优先编排** - 复杂任务用 `start_*` 工具
968
+
969
+ ---
970
+
971
+ **让 AI 更懂你,从清晰表达开始!** 🚀