mcp-probe-kit 1.8.0 → 1.9.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 (88) hide show
  1. package/README.md +44 -2
  2. package/build/tools/add_feature.d.ts +0 -11
  3. package/build/tools/add_feature.js +19 -10
  4. package/build/tools/analyze_project.js +76 -61
  5. package/build/tools/check_deps.d.ts +1 -1
  6. package/build/tools/check_deps.js +2 -2
  7. package/build/tools/code_review.js +15 -2
  8. package/build/tools/convert.js +18 -3
  9. package/build/tools/css_order.js +55 -55
  10. package/build/tools/debug.js +14 -2
  11. package/build/tools/design2code.d.ts +2 -11
  12. package/build/tools/design2code.js +21 -4
  13. package/build/tools/detect_shell.js +15 -2
  14. package/build/tools/estimate.js +21 -4
  15. package/build/tools/explain.js +15 -2
  16. package/build/tools/fix.js +15 -2
  17. package/build/tools/fix_bug.js +24 -5
  18. package/build/tools/gen_mock.js +24 -5
  19. package/build/tools/gen_skill.d.ts +0 -3
  20. package/build/tools/gen_skill.js +21 -4
  21. package/build/tools/genapi.js +15 -2
  22. package/build/tools/genchangelog.js +18 -3
  23. package/build/tools/gencommit.js +16 -2
  24. package/build/tools/gendoc.js +18 -3
  25. package/build/tools/genpr.js +15 -2
  26. package/build/tools/genreadme.js +15 -2
  27. package/build/tools/gensql.js +15 -2
  28. package/build/tools/gentest.js +15 -2
  29. package/build/tools/genui.js +15 -2
  30. package/build/tools/init_project.js +15 -2
  31. package/build/tools/init_project_context.d.ts +0 -6
  32. package/build/tools/init_project_context.js +12 -2
  33. package/build/tools/perf.js +15 -2
  34. package/build/tools/refactor.js +15 -2
  35. package/build/tools/resolve_conflict.js +12 -1
  36. package/build/tools/security_scan.js +18 -3
  37. package/build/tools/split.js +15 -2
  38. package/build/tools/start_api.d.ts +0 -6
  39. package/build/tools/start_api.js +18 -3
  40. package/build/tools/start_bugfix.d.ts +0 -6
  41. package/build/tools/start_bugfix.js +15 -2
  42. package/build/tools/start_doc.d.ts +0 -6
  43. package/build/tools/start_doc.js +20 -3
  44. package/build/tools/start_feature.d.ts +0 -6
  45. package/build/tools/start_feature.js +18 -3
  46. package/build/tools/start_onboard.d.ts +0 -6
  47. package/build/tools/start_onboard.js +15 -2
  48. package/build/tools/start_refactor.d.ts +0 -6
  49. package/build/tools/start_refactor.js +15 -2
  50. package/build/tools/start_release.d.ts +0 -6
  51. package/build/tools/start_release.js +18 -3
  52. package/build/tools/start_review.d.ts +0 -6
  53. package/build/tools/start_review.js +15 -2
  54. package/build/utils/parseArgs.d.ts +39 -0
  55. package/build/utils/parseArgs.js +153 -0
  56. package/docs/BEST_PRACTICES.md +9 -0
  57. package/docs/HOW_TO_TRIGGER.html +124 -69
  58. package/docs/HOW_TO_TRIGGER.md +41 -2
  59. package/docs/MCP-Probe-Kit-/344/275/277/347/224/250/346/211/213/345/206/214.html +420 -0
  60. package/docs/MCP-Probe-Kit-/344/275/277/347/224/250/346/211/213/345/206/214.md +609 -0
  61. package/package.json +1 -1
  62. package/docs/specs/add-feature/design.md +0 -608
  63. package/docs/specs/add-feature/requirements.md +0 -175
  64. package/docs/specs/add-feature/tasks.md +0 -111
  65. package/docs/specs/design2code/README.md +0 -0
  66. package/docs/specs/design2code/requirements.md +0 -0
  67. package/docs/specs/estimate/design.md +0 -209
  68. package/docs/specs/estimate/requirements.md +0 -140
  69. package/docs/specs/estimate/tasks.md +0 -66
  70. package/docs/specs/fix-bug/design.md +0 -259
  71. package/docs/specs/fix-bug/requirements.md +0 -132
  72. package/docs/specs/fix-bug/tasks.md +0 -66
  73. package/docs/specs/gen-mock/design.md +0 -241
  74. package/docs/specs/gen-mock/requirements.md +0 -137
  75. package/docs/specs/gen-mock/tasks.md +0 -66
  76. package/docs/specs/init-project-context/design.md +0 -515
  77. package/docs/specs/init-project-context/requirements.md +0 -144
  78. package/docs/specs/init-project-context/tasks.md +0 -93
  79. package/docs/specs/security-scan/design.md +0 -152
  80. package/docs/specs/security-scan/requirements.md +0 -150
  81. package/docs/specs/security-scan/tasks.md +0 -67
  82. package/docs/specs/start-bugfix/design.md +0 -42
  83. package/docs/specs/start-bugfix/requirements.md +0 -70
  84. package/docs/specs/start-bugfix/tasks.md +0 -21
  85. package/docs/specs/start-feature/design.md +0 -41
  86. package/docs/specs/start-feature/requirements.md +0 -90
  87. package/docs/specs/start-feature/tasks.md +0 -21
  88. package/docs/specs/start-review/requirements.md +0 -0
package/docs/HOW_TO_TRIGGER.html CHANGED
@@ -4,22 +4,20 @@
4
4
  <meta charset="UTF-8">
5
5
  <title>MCP 工具触发快速手册</title>
6
6
  <style>
7
- @page { size: A4; margin: 1.2cm 1cm; }
7
+ @page { size: A4; margin: 1cm; }
8
8
  * { margin: 0; padding: 0; box-sizing: border-box; }
9
- body { font-family: "Microsoft YaHei", Arial, sans-serif; line-height: 1.25; color: #333; font-size: 8.5pt; }
10
- h1 { font-size: 14pt; color: #2c3e50; margin-bottom: 0.2cm; border-bottom: 2px solid #3498db; padding-bottom: 0.1cm; }
11
- h2 { font-size: 11pt; color: #34495e; margin-top: 0.3cm; margin-bottom: 0.12cm; font-weight: bold; }
12
- h3 { font-size: 9pt; color: #555; margin-top: 0.18cm; margin-bottom: 0.06cm; font-weight: bold; }
13
- p { margin-bottom: 0.1cm; }
14
- code { background: #f4f4f4; padding: 1px 3px; border-radius: 2px; font-family: Consolas, monospace; font-size: 7.5pt; }
15
- .keyword { display: inline-block; background: #e8f4f8; color: #2980b9; padding: 1px 3px; border-radius: 2px; margin: 1px; font-size: 7.5pt; }
16
- .good { color: #27ae60; font-weight: bold; }
17
- .section { margin-bottom: 0.2cm; page-break-inside: avoid; }
18
- .divider { border-top: 1px solid #ddd; margin: 0.25cm 0; }
19
- table { width: 100%; border-collapse: collapse; margin-bottom: 0.2cm; font-size: 7.5pt; page-break-inside: avoid; }
20
- table th, table td { border: 1px solid #ddd; padding: 3px 4px; text-align: left; }
21
- table th { background-color: #3498db; color: white; font-weight: bold; }
22
- table tr:nth-child(even) { background-color: #f9f9f9; }
9
+ body { font-family: "Microsoft YaHei", Arial, sans-serif; line-height: 1.3; color: #000; font-size: 10pt; }
10
+ h1 { font-size: 16pt; margin-bottom: 0.3cm; border-bottom: 2px solid #000; padding-bottom: 0.1cm; }
11
+ h2 { font-size: 12pt; margin-top: 0.4cm; margin-bottom: 0.15cm; font-weight: bold; border-bottom: 1px solid #000; }
12
+ h3 { font-size: 10pt; margin-top: 0.2cm; margin-bottom: 0.1cm; font-weight: bold; }
13
+ p { margin-bottom: 0.12cm; }
14
+ code { background: #eee; padding: 1px 4px; border-radius: 2px; font-family: Consolas, monospace; font-size: 9pt; }
15
+ .keyword { display: inline-block; border: 1px solid #666; padding: 1px 4px; border-radius: 2px; margin: 1px; font-size: 8pt; }
16
+ .section { margin-bottom: 0.25cm; page-break-inside: avoid; }
17
+ .divider { border-top: 1px dashed #999; margin: 0.3cm 0; }
18
+ table { width: 100%; border-collapse: collapse; margin-bottom: 0.25cm; font-size: 9pt; page-break-inside: avoid; }
19
+ table th, table td { border: 1px solid #000; padding: 4px 6px; text-align: left; }
20
+ table th { background-color: #ddd; font-weight: bold; }
23
21
  @media print {
24
22
  body { background: white; }
25
23
  h1, h2, h3 { page-break-after: avoid; }
@@ -30,7 +28,7 @@ table tr:nth-child(even) { background-color: #f9f9f9; }
30
28
  <body>
31
29
  <h1>MCP 工具触发快速手册</h1>
32
30
 
33
- <h2>🔑 基础工具（31个）</h2>
31
+ <h2>基础工具（32个）</h2>
34
32
 
35
33
  <h3>代码质量（8个）</h3>
36
34
  <p><strong>detect_shell</strong> <span class="keyword">套壳</span><span class="keyword">检测</span> | "detect_shell"</p>
@@ -42,7 +40,7 @@ table tr:nth-child(even) { background-color: #f9f9f9; }
42
40
  <p><strong>perf</strong> <span class="keyword">性能</span><span class="keyword">优化</span><span class="keyword">慢</span><span class="keyword">瓶颈</span> | "分析性能" "有没有性能瓶颈"</p>
43
41
  <p><strong>fix</strong> <span class="keyword">修复</span><span class="keyword">fix</span><span class="keyword">lint错误</span> | "修复lint错误" "自动修复格式"</p>
44
42
 
45
- <h3>开发效率（15个）</h3>
43
+ <h3>开发效率（16个）</h3>
46
44
  <p><strong>gencommit</strong> <span class="keyword">commit</span><span class="keyword">提交</span> | "生成commit信息" "帮我写提交信息"</p>
47
45
  <p><strong>genapi</strong> <span class="keyword">API文档</span><span class="keyword">文档</span> | "生成API文档" "为这个方法添加文档"</p>
48
46
  <p><strong>gendoc</strong> <span class="keyword">注释</span><span class="keyword">JSDoc</span> | "添加注释" "生成JSDoc"</p>
@@ -51,55 +49,55 @@ table tr:nth-child(even) { background-color: #f9f9f9; }
51
49
  <p><strong>gensql</strong> <span class="keyword">SQL</span><span class="keyword">查询</span><span class="keyword">数据库</span> | "生成SQL查询" "写个查询语句"</p>
52
50
  <p><strong>genui</strong> <span class="keyword">组件</span><span class="keyword">UI</span><span class="keyword">界面</span> | "生成Button组件" "创建登录表单"</p>
53
51
  <p><strong>gen_mock</strong> <span class="keyword">Mock</span><span class="keyword">模拟数据</span> | "生成Mock数据" "创建测试数据"</p>
54
- <p><strong>design2code</strong> <span class="keyword">设计稿</span><span class="keyword">图片转代码</span><span class="keyword">HTML转Vue</span> | "把设计稿转成Vue" "图片转代码"</p>
52
+ <p><strong>gen_skill</strong> <span class="keyword">Skills</span><span class="keyword">技能文档</span> | "生成Agent Skills" "gen_skill code_review"</p>
53
+ <p><strong>design2code</strong> <span class="keyword">设计稿</span><span class="keyword">图片转代码</span> | "把设计稿转成Vue" "图片转代码"</p>
55
54
  <p><strong>explain</strong> <span class="keyword">解释</span><span class="keyword">说明</span><span class="keyword">理解</span> | "解释这段代码" "这个方法是干什么的"</p>
56
55
  <p><strong>convert</strong> <span class="keyword">转换</span><span class="keyword">改成</span><span class="keyword">迁移</span> | "转成TypeScript" "Class改Hooks"</p>
57
- <p><strong>css_order</strong> <span class="keyword">CSS顺序</span><span class="keyword">CSS规范</span> | "css_order"</p>
58
- <p><strong>genreadme</strong> <span class="keyword">README</span><span class="keyword">项目文档</span> | "生成README" "写个README"</p>
59
- <p><strong>split</strong> <span class="keyword">拆分</span><span class="keyword">文件拆分</span> | "拆分这个大文件" "split这个组件"</p>
56
+ <p><strong>css_order</strong> <span class="keyword">CSS顺序</span> | "css_order"</p>
57
+ <p><strong>genreadme</strong> <span class="keyword">README</span> | "生成README" "写个README"</p>
58
+ <p><strong>split</strong> <span class="keyword">拆分</span><span class="keyword">文件拆分</span> | "拆分这个大文件"</p>
60
59
  <p><strong>fix_bug</strong> <span class="keyword">修复Bug</span><span class="keyword">Bug修复流程</span> | "fix_bug 修复这个错误"</p>
61
60
  <p><strong>estimate</strong> <span class="keyword">估算</span><span class="keyword">工作量</span> | "估算工作量" "这个任务需要多久"</p>
62
61
 
63
62
  <h3>项目管理（8个）</h3>
64
63
  <p><strong>init_setting</strong> <span class="keyword">初始化配置</span> | "init_setting"</p>
65
- <p><strong>init_project</strong> <span class="keyword">初始化项目</span><span class="keyword">Spec-Driven</span> | "init_project 创建任务管理系统"</p>
66
- <p><strong>check_deps</strong> <span class="keyword">依赖检查</span><span class="keyword">依赖健康度</span> | "check_deps" "检查依赖"</p>
67
- <p><strong>resolve_conflict</strong> <span class="keyword">Git冲突</span><span class="keyword">冲突解决</span> | "resolve_conflict" "解决Git冲突"</p>
68
- <p><strong>analyze_project</strong> <span class="keyword">项目分析</span><span class="keyword">分析项目</span> | "analyze_project" "分析项目结构"</p>
69
- <p><strong>init_project_context</strong> <span class="keyword">项目上下文</span><span class="keyword">初始化上下文</span> | "init_project_context"</p>
70
- <p><strong>add_feature</strong> <span class="keyword">添加功能</span><span class="keyword">新功能规格</span> | "add_feature user-auth '用户认证'"</p>
64
+ <p><strong>init_project</strong> <span class="keyword">初始化项目</span> | "init_project 创建任务管理系统"</p>
65
+ <p><strong>check_deps</strong> <span class="keyword">依赖检查</span> | "check_deps" "检查依赖"</p>
66
+ <p><strong>resolve_conflict</strong> <span class="keyword">Git冲突</span> | "resolve_conflict" "解决Git冲突"</p>
67
+ <p><strong>analyze_project</strong> <span class="keyword">项目分析</span> | "analyze_project" "分析项目结构"</p>
68
+ <p><strong>init_project_context</strong> <span class="keyword">项目上下文</span> | "init_project_context"</p>
69
+ <p><strong>add_feature</strong> <span class="keyword">添加功能</span> | "add_feature user-auth '用户认证'"</p>
71
70
 
72
71
  <div class="divider"></div>
73
72
 
74
- <h2>🚀 智能编排工具（8个 - 推荐优先使用）</h2>
73
+ <h2>智能编排工具（8个）- 推荐优先使用</h2>
75
74
 
76
- <h3>🎯 开发流程类（3个）</h3>
77
- <p><strong>start_feature</strong> <span class="keyword">新功能</span><span class="keyword">开发功能</span><span class="keyword">feature</span> | "开发用户登录功能" "start_feature 用户设置" | 自动：上下文→规格→估算</p>
78
- <p><strong>start_bugfix</strong> <span class="keyword">修Bug</span><span class="keyword">Bug修复</span><span class="keyword">bugfix</span> | "start_bugfix 修复这个错误" "完整修复这个Bug" | 自动：上下文→定位→修复→测试</p>
79
- <p><strong>start_onboard</strong> <span class="keyword">了解项目</span><span class="keyword">快速上手</span><span class="keyword">onboard</span> | "快速了解这个项目" "start_onboard" | 自动：项目分析→生成上下文</p>
75
+ <h3>开发流程类（3个）</h3>
76
+ <p><strong>start_feature</strong> <span class="keyword">新功能</span><span class="keyword">feature</span> | "开发用户登录功能" | 自动：上下文-规格-估算</p>
77
+ <p><strong>start_bugfix</strong> <span class="keyword">修Bug</span><span class="keyword">bugfix</span> | "start_bugfix 修复这个错误" | 自动：上下文-定位-修复-测试</p>
78
+ <p><strong>start_onboard</strong> <span class="keyword">了解项目</span><span class="keyword">快速上手</span> | "快速了解这个项目" | 自动：项目分析-生成上下文</p>
80
79
 
81
- <h3>🔍 质量保障类（2个）</h3>
82
- <p><strong>start_review</strong> <span class="keyword">全面审查</span><span class="keyword">代码体检</span><span class="keyword">完整检查</span> | "全面审查这个文件" "代码体检" | 自动：上下文→审查→安全→性能</p>
83
- <p><strong>start_refactor</strong> <span class="keyword">完整重构</span><span class="keyword">重构流程</span> | "完整重构这个模块" "重构并生成测试" | 自动：上下文→审查→重构→测试</p>
80
+ <h3>质量保障类（2个）</h3>
81
+ <p><strong>start_review</strong> <span class="keyword">全面审查</span><span class="keyword">代码体检</span> | "全面审查这个文件" | 自动：上下文-审查-安全-性能</p>
82
+ <p><strong>start_refactor</strong> <span class="keyword">完整重构</span> | "完整重构这个模块" | 自动：上下文-审查-重构-测试</p>
84
83
 
85
- <h3>📦 发布管理类（1个）</h3>
86
- <p><strong>start_release</strong> <span class="keyword">发布</span><span class="keyword">release</span><span class="keyword">版本发布</span> | "准备发布 v1.2.0" "start_release v1.2.0" | 自动：上下文→Changelog→PR</p>
84
+ <h3>发布管理类（1个）</h3>
85
+ <p><strong>start_release</strong> <span class="keyword">发布</span><span class="keyword">release</span> | "准备发布 v1.2.0" | 自动：上下文-Changelog-PR</p>
87
86
 
88
- <h3>📝 文档生成类（2个）</h3>
89
- <p><strong>start_api</strong> <span class="keyword">API开发</span><span class="keyword">接口开发</span> | "为这个API生成完整资料" "start_api 用户接口" | 自动：上下文→文档→Mock→测试</p>
90
- <p><strong>start_doc</strong> <span class="keyword">生成完整文档</span><span class="keyword">项目文档</span> | "生成完整文档" "start_doc 这个项目" | 自动：上下文→注释→README→API</p>
87
+ <h3>文档生成类（2个）</h3>
88
+ <p><strong>start_api</strong> <span class="keyword">API开发</span><span class="keyword">接口开发</span> | "为这个API生成完整资料" | 自动：上下文-文档-Mock-测试</p>
89
+ <p><strong>start_doc</strong> <span class="keyword">完整文档</span> | "生成完整文档" | 自动：上下文-注释-README-API</p>
91
90
 
92
91
  <div class="divider"></div>
93
92
 
94
- <h2>🎯 快速触发技巧</h2>
93
+ <h2>快速触发技巧</h2>
95
94
  <p><strong>方式1：动词开头</strong> "审查 view.vue" "解释 handleClick" "调试弹窗问题"</p>
96
95
  <p><strong>方式2：指定工具</strong> "debug 这个问题" "code_review 这段代码" "start_feature 用户登录"</p>
97
96
  <p><strong>方式3：带文件引用</strong> "debug @LoginForm.tsx" "review @api/user.ts" "gentest @Button.tsx"</p>
98
97
 
99
-
100
98
  <div class="divider"></div>
101
99
 
102
- <h2>📊 工具选择决策表</h2>
100
+ <h2>工具选择决策表</h2>
103
101
 
104
102
  <table>
105
103
  <thead>
@@ -123,7 +121,8 @@ table tr:nth-child(even) { background-color: #f9f9f9; }
123
121
  <tr><td>SQL生成</td><td>SQL、查询、数据库</td><td><code>gensql</code></td></tr>
124
122
  <tr><td>UI组件</td><td>组件、UI、界面</td><td><code>genui</code></td></tr>
125
123
  <tr><td>Mock数据</td><td>Mock、模拟数据</td><td><code>gen_mock</code></td></tr>
126
- <tr><td>设计稿转代码</td><td>设计稿、图片转代码、HTML转Vue</td><td><code>design2code</code></td></tr>
124
+ <tr><td>Agent Skills</td><td>Skills、技能文档</td><td><code>gen_skill</code></td></tr>
125
+ <tr><td>设计稿转代码</td><td>设计稿、图片转代码</td><td><code>design2code</code></td></tr>
127
126
  <tr><td>代码转换</td><td>转换、改成、迁移</td><td><code>convert</code></td></tr>
128
127
  <tr><td>CSS规范</td><td>CSS顺序</td><td><code>css_order</code></td></tr>
129
128
  <tr><td>README</td><td>README、项目文档</td><td><code>genreadme</code></td></tr>
@@ -146,43 +145,99 @@ table tr:nth-child(even) { background-color: #f9f9f9; }
146
145
  <tr><th>场景</th><th>工具</th><th>自动执行</th></tr>
147
146
  </thead>
148
147
  <tbody>
149
- <tr><td>开发新功能</td><td><code>start_feature</code> ⭐⭐⭐</td><td>上下文→规格→估算</td></tr>
150
- <tr><td>完整Bug修复</td><td><code>start_bugfix</code> ⭐⭐⭐</td><td>上下文→定位→修复→测试</td></tr>
151
- <tr><td>快速上手项目</td><td><code>start_onboard</code> ⭐⭐⭐</td><td>项目分析→生成上下文</td></tr>
152
- <tr><td>代码体检</td><td><code>start_review</code> ⭐⭐⭐</td><td>上下文→审查→安全→性能</td></tr>
153
- <tr><td>完整重构</td><td><code>start_refactor</code> ⭐⭐⭐</td><td>上下文→审查→重构→测试</td></tr>
154
- <tr><td>准备发布</td><td><code>start_release</code> ⭐⭐⭐</td><td>上下文→Changelog→PR</td></tr>
155
- <tr><td>API开发</td><td><code>start_api</code> ⭐⭐</td><td>上下文→文档→Mock→测试</td></tr>
156
- <tr><td>生成文档</td><td><code>start_doc</code> ⭐⭐</td><td>上下文→注释→README→API</td></tr>
148
+ <tr><td>开发新功能</td><td><code>start_feature</code> ***</td><td>上下文-规格-估算</td></tr>
149
+ <tr><td>完整Bug修复</td><td><code>start_bugfix</code> ***</td><td>上下文-定位-修复-测试</td></tr>
150
+ <tr><td>快速上手项目</td><td><code>start_onboard</code> ***</td><td>项目分析-生成上下文</td></tr>
151
+ <tr><td>代码体检</td><td><code>start_review</code> ***</td><td>上下文-审查-安全-性能</td></tr>
152
+ <tr><td>完整重构</td><td><code>start_refactor</code> ***</td><td>上下文-审查-重构-测试</td></tr>
153
+ <tr><td>准备发布</td><td><code>start_release</code> ***</td><td>上下文-Changelog-PR</td></tr>
154
+ <tr><td>API开发</td><td><code>start_api</code> **</td><td>上下文-文档-Mock-测试</td></tr>
155
+ <tr><td>生成文档</td><td><code>start_doc</code> **</td><td>上下文-注释-README-API</td></tr>
157
156
  </tbody>
158
157
  </table>
159
158
 
160
159
  <div class="divider"></div>
161
160
 
162
- <h2>💡 最佳实践</h2>
163
- <p><span class="good">✅ 推荐：</span> "debug 这个登录逻辑有问题" "审查 view.vue 的代码质量" "解释 fetchDetail 方法" "生成这个组件的测试用例" "分析这个页面的性能" "扫描安全漏洞" "重构这段复杂代码" "生成Mock数据" "估算这个任务的工作量"</p>
164
- <p><strong style="color:#e74c3c;">❌ 不推荐：</strong> "看看这个" "帮我弄一下" "这里不对" "优化一下"（没说优化什么） "改改"（没说怎么改） "检查一下"（没说检查什么）</p>
161
+ <h2>最佳实践</h2>
162
+ <p><strong>推荐：</strong> "debug 这个登录逻辑有问题" "审查 view.vue 的代码质量" "解释 fetchDetail 方法" "生成这个组件的测试用例" "分析这个页面的性能" "扫描安全漏洞" "重构这段复杂代码" "生成Mock数据" "估算这个任务的工作量"</p>
163
+ <p><strong>不推荐：</strong> "看看这个" "帮我弄一下" "这里不对" "优化一下"（没说优化什么） "改改"（没说怎么改） "检查一下"（没说检查什么）</p>
164
+
165
+ <div class="divider"></div>
166
+
167
+ <h2>常见场景示例</h2>
168
+ <p><strong>遇到Bug：</strong> "debug 这个登录逻辑，点击登录按钮没反应"</p>
169
+ <p><strong>不理解代码：</strong> "解释一下 @utils/auth.ts 的 validateToken 方法"</p>
170
+ <p><strong>代码审查：</strong> "审查 @components/UserProfile.tsx 的代码质量"</p>
171
+ <p><strong>开发新功能：</strong> "start_feature user-settings '用户设置页面'"</p>
172
+ <p><strong>修复Bug：</strong> "start_bugfix 修复登录超时问题"</p>
173
+ <p><strong>代码体检：</strong> "start_review @feature.ts 全面体检"</p>
165
174
 
166
175
  <div class="divider"></div>
167
176
 
168
- <h2>📚 常见场景示例</h2>
169
- <p><strong>遇到Bug：</strong> "debug 这个登录逻辑，点击登录按钮没反应" ✅</p>
170
- <p><strong>不理解代码：</strong> "解释一下 @utils/auth.ts 的 validateToken 方法" ✅</p>
171
- <p><strong>代码审查：</strong> "审查 @components/UserProfile.tsx 的代码质量" ✅</p>
172
- <p><strong>开发新功能：</strong> "start_feature user-settings '用户设置页面'" ✅</p>
173
- <p><strong>修复Bug：</strong> "start_bugfix 修复登录超时问题" ✅</p>
174
- <p><strong>代码体检：</strong> "start_review @feature.ts 全面体检" ✅</p>
177
+ <h2>进阶技巧</h2>
178
+ <p><strong>1. 组合关键词：</strong> "审查并生成测试" - AI会依次调用 code_review 和 gentest</p>
179
+ <p><strong>2. 使用上下文：</strong> "这个方法性能不好，帮我优化" - AI会调用 perf 分析，然后 refactor</p>
180
+ <p><strong>3. 明确范围：</strong> "审查所有API文件" - code_review @api/*.ts</p>
175
181
 
176
182
  <div class="divider"></div>
177
183
 
178
- <h2>🎓 进阶技巧</h2>
179
- <p><strong>1. 组合关键词：</strong> "审查并生成测试" → AI会依次调用 code_review 和 gentest</p>
180
- <p><strong>2. 使用上下文：</strong> "这个方法性能不好，帮我优化" → AI会调用 perf 分析，然后 refactor</p>
181
- <p><strong>3. 明确范围：</strong> "审查所有API文件" → code_review @api/*.ts</p>
184
+ <h2>OpenCode / oh-my-opencode 使用</h2>
185
+
186
+ <h3>配置 MCP</h3>
187
+ <p>在 <code>~/.opencode/mcp.json</code> 中添加：</p>
188
+ <p><code>{ "mcpServers": { "mcp-probe-kit": { "command": "npx", "args": ["mcp-probe-kit@latest"] } } }</code></p>
189
+
190
+ <h3>命令行调用</h3>
191
+ <p><strong>/tool</strong> - 列出所有可用工具</p>
192
+ <p><strong>/tool code_review</strong> - 调用指定工具</p>
193
+ <p><strong>/mcp</strong> - 查看 MCP 服务器状态</p>
194
+
195
+ <h3>对话式调用（推荐）</h3>
196
+ <p>直接在对话中使用关键词，AI 会自动调用对应工具：</p>
197
+ <p>"审查这段代码" → code_review</p>
198
+ <p>"debug 这个错误" → debug</p>
199
+ <p>"生成测试" → gentest</p>
200
+ <p>"start_feature 用户登录" → start_feature</p>
201
+
202
+ <h3>oh-my-opencode 高级功能</h3>
203
+ <p><strong>关键词检测器</strong> - 自动检测提示中的关键词并激活专门模式：</p>
204
+ <table>
205
+ <thead>
206
+ <tr><th>关键词</th><th>模式</th><th>说明</th></tr>
207
+ </thead>
208
+ <tbody>
209
+ <tr><td><code>ultrawork</code> / <code>ulw</code></td><td>最大性能模式</td><td>并行智能体编排</td></tr>
210
+ <tr><td><code>search</code> / <code>find</code></td><td>搜索模式</td><td>并行 explore + librarian 智能体</td></tr>
211
+ <tr><td><code>analyze</code> / <code>investigate</code></td><td>深度分析模式</td><td>多阶段专家咨询</td></tr>
212
+ </tbody>
213
+ </table>
214
+
215
+ <p><strong>Ralph Loop</strong> - 自引用开发循环，持续运行直到任务完成：</p>
216
+ <p>使用 <code>/ralph-loop "构建一个 REST API"</code> 开始</p>
217
+ <p>结束条件：检测到 &lt;promise&gt;DONE&lt;/promise&gt;、达到最大迭代次数（默认100）或 <code>/cancel-ralph</code></p>
218
+ <p>配置：<code>oh-my-opencode.json</code> 中 <code>{ "ralph_loop": { "enabled": true, "default_max_iterations": 100 } }</code></p>
219
+
220
+ <h3>常用命令示例</h3>
221
+ <table>
222
+ <thead>
223
+ <tr><th>命令</th><th>说明</th></tr>
224
+ </thead>
225
+ <tbody>
226
+ <tr><td><code>/tool code_review</code></td><td>代码审查</td></tr>
227
+ <tr><td><code>/tool debug</code></td><td>调试分析</td></tr>
228
+ <tr><td><code>/tool gentest</code></td><td>生成测试</td></tr>
229
+ <tr><td><code>/tool gencommit</code></td><td>生成提交信息</td></tr>
230
+ <tr><td><code>/tool start_feature</code></td><td>新功能开发编排</td></tr>
231
+ <tr><td><code>/tool start_review</code></td><td>代码体检编排</td></tr>
232
+ <tr><td><code>/tool start_bugfix</code></td><td>Bug修复编排</td></tr>
233
+ <tr><td><code>ulw 重构这个模块</code></td><td>最大性能模式</td></tr>
234
+ <tr><td><code>/ralph-loop "任务描述"</code></td><td>自引用循环</td></tr>
235
+ </tbody>
236
+ </table>
182
237
 
183
- <div style="text-align:center;margin-top:0.3cm;padding:0.2cm;background:#f8f9fa;border-radius:3px;">
184
- <p style="font-size:9pt;"><strong>MCP Probe Kit - AI 开发增强工具集</strong></p>
238
+ <div style="text-align:center;margin-top:0.4cm;padding:0.2cm;border-top:1px solid #000;">
239
+ <p style="font-size:10pt;"><strong>MCP Probe Kit v1.8.1 - AI 开发增强工具集（40个工具）</strong></p>
185
240
  </div>
186
241
 
187
242
  </body>
188
- </html>
243
+ </html>
package/docs/HOW_TO_TRIGGER.md CHANGED
@@ -327,7 +327,45 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
327
327
 
328
328
  ---
329
329
 
330
- ### 1️⃣6️⃣ 生成 UI 组件 → `genui`
330
+ ### 1️⃣6️⃣ 生成 Agent Skills → `gen_skill`
331
+
332
+ **触发关键词**：Skills、技能文档、Agent Skills、SKILL.md
333
+
334
+ **✅ 推荐说法**
335
+ ```
336
+ "生成 Agent Skills 文档"
337
+ "gen_skill"
338
+ "生成技能文档"
339
+ "为 code_review 生成 SKILL.md"
340
+ ```
341
+
342
+ **❌ 不推荐说法**
343
+ ```
344
+ "生成文档"（太笼统，可能调用其他工具）
345
+ ```
346
+
347
+ ---
348
+
349
+ ### 1️⃣7️⃣ 生成 UI 组件 → `genui`
350
+
351
+ **触发关键词**：组件、UI、界面、按钮、表单
352
+
353
+ **✅ 推荐说法**
354
+ ```
355
+ "生成一个 Button 组件"
356
+ "创建登录表单"
357
+ "写个 Modal 组件"
358
+ "生成用户卡片 UI"
359
+ ```
360
+
361
+ **❌ 不推荐说法**
362
+ ```
363
+ "做个界面"（没说具体是什么）
364
+ ```
365
+
366
+ ---
367
+
368
+ ### 1️⃣7️⃣ 生成 UI 组件 → `genui`
331
369
 
332
370
  **触发关键词**：组件、UI、界面、按钮、表单
333
371
 
@@ -346,7 +384,7 @@ AI 需要理解你的意图才能调用正确的工具。使用明确的关键
346
384
 
347
385
  ---
348
386
 
349
- ### 1️⃣7️⃣ 设计稿转代码 → `design2code`
387
+ ### 1️⃣8️⃣ 设计稿转代码 → `design2code`
350
388
 
351
389
  **触发关键词**：设计稿、图片转代码、HTML转Vue、HTML转React、还原设计
352
390
 
@@ -843,6 +881,7 @@ AI: [自动调用 start_review 编排]
843
881
  | 提交代码 | commit、提交信息 | `gencommit` |
844
882
  | 代码转换 | 转换、改成、迁移 | `convert` |
845
883
  | Mock数据 | Mock、模拟数据 | `gen_mock` |
884
+ | Agent Skills | Skills、技能文档 | `gen_skill` |
846
885
  | 设计稿转代码 | 设计稿、图片转代码、HTML转Vue | `design2code` |
847
886
  | Bug修复流程 | 修复Bug、完整修复 | `fix_bug` |
848
887
  | 工作量估算 | 估算、工作量、需要多久 | `estimate` |