mcp-probe-kit 2.3.0 → 2.5.0

package/docs/index.html

@@ -448,7 +448,7 @@
         <div class="hero-container">
             <h1 class="hero-title">🚀 MCP Probe Kit</h1>
             <p class="hero-subtitle">AI 开发增强工具集 · 文档中心</p>
-            <div class="hero-version">v2.3.0</div>
+            <div class="hero-version">v2.5.0</div>
             <div class="hero-cta">
                 <a href="./pages/getting-started.html" class="btn btn-primary">快速开始</a>
                 <a href="https://www.bytezonex.com/" target="_blank" rel="noopener" class="btn btn-secondary">

package/docs/pages/all-tools.html

@@ -16,14 +16,14 @@
     <!-- Open Graph / Facebook -->
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://mcp-probe-kit.bytezonex.com/pages/all-tools.html">
-    <meta property="og:title" content="所有工具 - 42个AI研发工具完整列表 | MCP Probe Kit">
-    <meta property="og:description" content="浏览 MCP Probe Kit 全部 42 个工具，覆盖工作流编排、代码分析、Git 自动化、UI 生成、产品设计等 8 大类别。每个工具都有详细文档和示例。">
+    <meta property="og:title" content="所有工具 - 39个AI研发工具完整列表 | MCP Probe Kit">
+    <meta property="og:description" content="浏览 MCP Probe Kit 全部 39 个工具，覆盖工作流编排、代码分析、Git 自动化、UI 生成、产品设计等 8 大类别。每个工具都有详细文档和示例。">
     
     <!-- Twitter -->
     <meta property="twitter:card" content="summary_large_image">
     <meta property="twitter:url" content="https://mcp-probe-kit.bytezonex.com/pages/all-tools.html">
-    <meta property="twitter:title" content="所有工具 - 42个AI研发工具完整列表 | MCP Probe Kit">
-    <meta property="twitter:description" content="浏览 MCP Probe Kit 全部 42 个工具，覆盖开发全流程。">
+    <meta property="twitter:title" content="所有工具 - 39个AI研发工具完整列表 | MCP Probe Kit">
+    <meta property="twitter:description" content="浏览 MCP Probe Kit 全部 39 个工具，覆盖开发全流程。">
     
     <link rel="stylesheet" href="../styles/page.css">
     <style>
@@ -306,7 +306,7 @@
                             <span>所有工具</span>
                         </div>
                         <div style="display: flex; align-items: center; gap: 8px;">
-                            <span class="badge">42</span>
+                            <span class="badge">39</span>
                             <span class="toggle-icon">▶</span>
                         </div>
                     </div>
@@ -408,12 +408,16 @@
                 
                 <!-- Page Header -->
                 <h1 class="page-title">所有工具</h1>
-                <p class="page-description">MCP Probe Kit 提供 42 个实用工具，100% 支持结构化输出</p>
+                <p class="page-description">MCP Probe Kit 提供 39 个实用工具，核心与编排工具支持结构化输出</p>
                 <div class="page-meta">
-                    <span>📦 v2.3.0</span>
+                    <span>📦 v2.5.0</span>
                     <span>·</span>
                     <span>最后更新：2026-01-27</span>
                     <span>·</span>
+                    <span>协议：MCP 2025-11-25</span>
+                    <span>·</span>
+                    <span>SDK：@modelcontextprotocol/sdk 1.25.3</span>
+                    <span>·</span>
                     <a href="https://github.com/mybolide/mcp-probe-kit/edit/main/docs/pages/all-tools.html" target="_blank" rel="noopener">编辑此页 ↗</a>
                     <span>·</span>
                     <a href="https://github.com/mybolide/mcp-probe-kit/issues/new" target="_blank" rel="noopener">反馈问题 ↗</a>
@@ -430,6 +434,32 @@
                     />
                     <div id="searchResults" class="search-results"></div>
                 </div>
+
+                <div class="callout info">
+                    <div class="callout-icon">🧭</div>
+                    <div class="callout-content">
+                        <p><strong>委托式编排：</strong>所有 <code>start_*</code> 工具会在 <code>structuredContent.metadata.plan</code> 返回执行计划。AI 需要按步骤调用工具并创建 <code>outputs</code> 指定的文件。</p>
+                        <p><strong>结构化输出关键字段：</strong><code>summary</code>、<code>status</code>、<code>steps</code>、<code>artifacts</code>、<code>metadata.plan</code>、<code>specArtifacts</code>、<code>estimate</code></p>
+                        <p><strong>需求澄清模式：</strong>使用 <code>requirements_mode=loop</code> 先澄清再执行（适用于 start_feature/start_bugfix/start_ui）。</p>
+                        <p><strong>模板档位：</strong><code>template_profile=auto</code> 自动选择 <code>guided</code>/<code>strict</code>。普通模型优先 guided，结构化输入可选 strict。</p>
+                        <div class="code-block">
+                            <div class="code-header">
+                                <span class="code-language">Plan 示例</span>
+                            </div>
+                            <pre><code>{
+  "mode": "delegated",
+  "steps": [
+    {
+      "id": "spec",
+      "tool": "add_feature",
+      "args": { "feature_name": "user-auth", "description": "用户认证功能" },
+      "outputs": ["docs/specs/user-auth/requirements.md"]
+    }
+  ]
+}</code></pre>
+                        </div>
+                    </div>
+                </div>
                 
                 <!-- 工具列表容器 -->
                 <div id="tools-container"></div>
@@ -498,7 +528,6 @@
             // 代码分析
             'code_review': '审查代码',
             'security_scan': '安全扫描',
-            'debug': '调试',
             'perf': '性能优化',
             'refactor': '重构建议',
             'fix_bug': '修复Bug',
@@ -517,14 +546,11 @@
             'gensql': '生成SQL',
             'genreadme': '生成说明',
             'gen_mock': '生成数据',
-            'genui': '生成UI',
             
             // 项目管理
             'init_project': '初始化',
-            'analyze_project': '分析项目',
             'init_project_context': '项目上下文',
             'add_feature': '添加功能',
-            'check_deps': '检查依赖',
             'interview': '需求访谈',
             'ask_user': '提问用户',
             
@@ -534,22 +560,11 @@
             'sync_ui_data': '同步数据',
             'init_component_catalog': '组件目录',
             'render_ui': '渲染UI',
-            'design2code': '设计转码',
             
             // 产品设计
             'gen_prd': '生成PRD',
             'gen_prototype': '生成原型',
             'start_product': '产品设计',
-            
-            // 其他工具
-            'fix': '修复',
-            'split': '拆分',
-            'convert': '转换',
-            'explain': '解释',
-            'css_order': 'CSS排序',
-            'detect_shell': '检测Shell',
-            'init_setting': '初始设置',
-            'gen_skill': '生成技能'
         };
         
         // 生成侧边栏工具列表

package/docs/pages/examples.html

@@ -78,7 +78,7 @@
                             <span class="icon">🛠️</span>
                             <span>所有工具</span>
                         </div>
-                        <span class="badge">42</span>
+                        <span class="badge">39</span>
                     </a>
                 </div>
                 
@@ -177,14 +177,18 @@
                 <h1 class="page-title">最佳实践</h1>
                 <p class="page-description">MCP Probe Kit 融合完整研发流程，从需求到上线的最佳实践指南</p>
                 <div class="page-meta">
-                    <span>📦 v2.3.0</span>
+                    <span>📦 v2.5.0</span>
                     <span>·</span>
                     <span>最后更新：2026-01-27</span>
+                    <span>·</span>
+                    <span>协议：MCP 2025-11-25</span>
+                    <span>·</span>
+                    <span>SDK：@modelcontextprotocol/sdk 1.25.3</span>
                 </div>
                 
                 <!-- 研发流程概览 -->
                 <h2>完整研发流程</h2>
-                <p>MCP Probe Kit 的 42 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。</p>
+                <p>MCP Probe Kit 的 39 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。</p>
                 
                 <div class="callout info">
                     <div class="callout-icon">💡</div>
@@ -401,6 +405,61 @@ feature_name: "user-auth"
   ✓ 估算开发工作量
   ✓ 输出完整开发计划</code></pre>
                 </div>
+
+                <div class="callout info">
+                    <div class="callout-icon">🧭</div>
+                    <div class="callout-content">
+                        <p><strong>委托式编排：</strong><code>start_feature</code> 会在 <code>structuredContent.metadata.plan</code> 中返回执行计划，AI 需要按步骤调用工具并创建文件。</p>
+                        <div class="code-block">
+                            <div class="code-header">
+                                <span class="code-language">Plan 示例</span>
+                            </div>
+                            <pre><code>{
+  "mode": "delegated",
+  "steps": [
+    {
+      "id": "spec",
+      "tool": "add_feature",
+      "args": { "feature_name": "user-auth", "description": "用户认证功能" },
+      "outputs": ["docs/specs/user-auth/requirements.md"]
+    }
+  ]
+}</code></pre>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="callout info">
+                    <div class="callout-icon">🧭</div>
+                    <div class="callout-content">
+                        <p><strong>需求澄清模式：</strong>当需求不够明确时，使用 <code>requirements_mode=loop</code> 先澄清再进入规格生成。</p>
+                        <p><strong>模板档位：</strong><code>template_profile=auto</code> 自动选择指导强度，普通模型优先 guided。</p>
+                        <div class="code-block">
+                            <div class="code-header">
+                                <span class="code-language">示例</span>
+                            </div>
+                            <pre><code>AI: 使用 start_feature 工具
+feature_name: "user-auth"
+description: "用户认证功能"
+template_profile: "auto"
+requirements_mode: "loop"
+loop_max_rounds: 2
+loop_question_budget: 5</code></pre>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="callout info">
+                    <div class="callout-icon">🧩</div>
+                    <div class="callout-content">
+                        <p><strong>模板档位策略：</strong></p>
+                        <ul>
+                            <li><code>guided</code>：需求信息少/不完整，普通模型优先</li>
+                            <li><code>strict</code>：需求已结构化，指引更紧凑</li>
+                            <li><code>auto</code>：默认推荐，自动选择 guided/strict</li>
+                        </ul>
+                    </div>
+                </div>
                 
                 <h3>2.2 UI 开发流程</h3>
                 <p>使用 <code>start_ui</code> 工作流，从设计系统到代码一气呵成。</p>
@@ -413,6 +472,7 @@ feature_name: "user-auth"
 AI: 使用 start_ui 工具
 description: "登录页面，包含邮箱密码输入和 Google 登录按钮"
 framework: "react"
+template_profile: "auto"
 
 → 自动执行：
   ✓ 检查/生成设计系统
@@ -420,6 +480,24 @@ framework: "react"
   ✓ 搜索/生成 UI 模板
   ✓ 渲染最终 React 代码</code></pre>
                 </div>
+
+                <div class="callout info">
+                    <div class="callout-icon">🧭</div>
+                    <div class="callout-content">
+                        <p><strong>需求澄清模式：</strong>当 UI 需求不清晰时，先澄清再执行 UI 流程。</p>
+                        <p><strong>模板档位：</strong>需要更严格时可设为 <code>template_profile=strict</code>。</p>
+                        <div class="code-block">
+                            <div class="code-header">
+                                <span class="code-language">示例</span>
+                            </div>
+                            <pre><code>AI: 使用 start_ui 工具
+description: "登录页面"
+template_profile: "strict"
+requirements_mode: "loop"
+loop_max_rounds: 2</code></pre>
+                        </div>
+                    </div>
+                </div>
                 
                 <h3>2.3 代码生成</h3>
                 <p>根据需要使用各种生成工具：</p>
@@ -474,6 +552,7 @@ code: "function login(user, pass) { ... }"
 AI: 使用 start_bugfix 工具
 error_message: "TypeError: Cannot read property 'token' of undefined"
 stack_trace: "at login.js:45:12"
+template_profile: "auto"
 
 → 自动执行：
   ✓ 检查项目上下文
@@ -482,21 +561,23 @@ stack_trace: "at login.js:45:12"
   ✓ 提供修复方案
   ✓ 生成测试用例</code></pre>
                 </div>
-                
-                <h3>4.2 快速调试</h3>
-                <p>使用 <code>debug</code> 工具快速定位问题。</p>
-                <div class="code-block">
-                    <div class="code-header">
-                        <span class="code-language">最佳实践</span>
-                    </div>
-                    <pre><code>AI: 使用 debug 工具
-error: "数据库连接超时"
-context: "await db.connect({ timeout: 1000 })"
 
-→ 输出：
-  - 根因：超时时间设置过短
-  - 调试策略：增加超时时间或优化连接池
-  - 解决方案：timeout: 5000</code></pre>
+                <div class="callout info">
+                    <div class="callout-icon">🧭</div>
+                    <div class="callout-content">
+                        <p><strong>需求澄清模式：</strong>当 Bug 信息不完整时，先澄清再进入修复。</p>
+                        <p><strong>模板档位：</strong>普通模型可用 <code>template_profile=guided</code>，结构化信息可用 <code>strict</code>。</p>
+                        <div class="code-block">
+                            <div class="code-header">
+                                <span class="code-language">示例</span>
+                            </div>
+                            <pre><code>AI: 使用 start_bugfix 工具
+error_message: "TypeError: token is undefined"
+template_profile: "guided"
+requirements_mode: "loop"
+loop_question_budget: 5</code></pre>
+                        </div>
+                    </div>
                 </div>
                 
                 <!-- 阶段 5：版本发布 -->
@@ -543,8 +624,6 @@ from_tag: "v1.9.0"
 AI: 使用 start_onboard 工具
 
 → 自动执行：
-  ✓ 分析项目结构
-  ✓ 识别技术栈
   ✓ 生成上下文文档
   ✓ 输出开发规范</code></pre>
                 </div>
@@ -565,20 +644,7 @@ code: "整个项目代码"
   ✓ 输出完整文档集</code></pre>
                 </div>
                 
-                <h3>6.3 依赖管理</h3>
-                <p>使用 <code>check_deps</code> 定期检查依赖健康度。</p>
-                <div class="code-block">
-                    <div class="code-header">
-                        <span class="code-language">最佳实践</span>
-                    </div>
-                    <pre><code>AI: 使用 check_deps 工具
-
-→ 输出：
-  - 过期依赖：react@17.0.0 → 18.2.0
-  - 安全漏洞：lodash@4.17.15 (CVE-2021-23337)
-  - 体积问题：moment.js 可替换为 date-fns
-  - 升级建议：优先级排序</code></pre>
-                </div>
+                
                 
                 <!-- 高级实践 -->
                 <h2>高级实践：Ralph Wiggum Loop</h2>
@@ -625,7 +691,6 @@ max_minutes: 25
                             <li>✓ 开发前使用 estimate - 合理规划时间</li>
                             <li>✓ 提交前使用 start_review - 保证代码质量</li>
                             <li>✓ 发布前使用 start_release - 规范发布流程</li>
-                            <li>✓ 定期使用 check_deps - 维护依赖健康</li>
                         </ul>
                     </div>
                 </div>
@@ -633,7 +698,7 @@ max_minutes: 25
                 <!-- 更多资源 -->
                 <h2>更多资源</h2>
                 <ul>
-                    <li><a href="./all-tools.html">完整工具参考</a> - 查看所有 42 个工具的详细说明</li>
+                    <li><a href="./all-tools.html">完整工具参考</a> - 查看所有 39 个工具的详细说明</li>
                     <li><a href="./getting-started.html">安装配置</a> - 快速开始使用</li>
                     <li><a href="./migration.html">迁移指南</a> - 从 v1.x 迁移到 v2.0</li>
                     <li><a href="https://github.com/mybolide/mcp-probe-kit" target="_blank">GitHub 仓库</a> - 源代码和问题反馈</li>

package/docs/pages/getting-started.html

@@ -17,7 +17,7 @@
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://mcp-probe-kit.bytezonex.com/pages/getting-started.html">
     <meta property="og:title" content="快速开始 - 安装配置指南 | MCP Probe Kit">
-    <meta property="og:description" content="5分钟快速安装 MCP Probe Kit，支持 Cursor、Cline、Claude Desktop。详细配置教程，立即开始使用 42 个 AI 研发工具。">
+    <meta property="og:description" content="5分钟快速安装 MCP Probe Kit，支持 Cursor、Cline、Claude Desktop。详细配置教程，立即开始使用 39 个 AI 研发工具。">
     
     <!-- Twitter -->
     <meta property="twitter:card" content="summary_large_image">
@@ -79,7 +79,7 @@
                             <span class="icon">🛠️</span>
                             <span>所有工具</span>
                         </div>
-                        <span class="badge">42</span>
+                        <span class="badge">39</span>
                     </a>
                 </div>
                 
@@ -180,10 +180,14 @@
                 <h1 class="page-title">安装配置</h1>
                 <p class="page-description">5 分钟快速上手 MCP Probe Kit v2.0，支持 Cursor、Cline 和 Claude Desktop</p>
                 <div class="page-meta">
-                    <span>📦 v2.3.0</span>
+                    <span>📦 v2.5.0</span>
                     <span>·</span>
                     <span>最后更新：2026-01-27</span>
                     <span>·</span>
+                    <span>协议：MCP 2025-11-25</span>
+                    <span>·</span>
+                    <span>SDK：@modelcontextprotocol/sdk 1.25.3</span>
+                    <span>·</span>
                     <a href="https://github.com/mybolide/mcp-probe-kit/edit/main/docs/pages/getting-started.html" target="_blank" rel="noopener">编辑此页 ↗</a>
                     <span>·</span>
                     <a href="https://github.com/mybolide/mcp-probe-kit/issues/new" target="_blank" rel="noopener">反馈问题 ↗</a>
@@ -432,6 +436,42 @@ npm run build</code></pre>
                         </div>
                     </div>
                 </div>
+
+                <!-- Step 4: 委托式编排协议 -->
+                <div class="step-card">
+                    <div class="step-header">
+                        <div class="step-number">4</div>
+                        <h3 class="step-title">了解委托式编排（Delegated Plan）</h3>
+                    </div>
+                    <div class="step-content">
+                        <p><code>start_*</code> 编排工具不会直接执行操作，而是返回一个可执行计划。AI 需要按步骤调用工具并创建文件。</p>
+                        <p><strong>结构化输出关键字段：</strong><code>summary</code>、<code>status</code>、<code>steps</code>、<code>artifacts</code>、<code>metadata.plan</code>、<code>specArtifacts</code>、<code>estimate</code></p>
+                        <p><strong>需求澄清模式：</strong>当需求不完整时，可使用 <code>requirements_mode=loop</code> 先澄清再进入执行。</p>
+                        <p><strong>模板档位：</strong><code>template_profile=auto</code> 会自动选择 <code>guided</code>/<code>strict</code>。普通模型优先 <code>guided</code>，结构化需求可用 <code>strict</code>。</p>
+                        <div class="code-block">
+                            <div class="code-header">
+                                <span class="code-language">Plan 示例</span>
+                            </div>
+                            <pre><code>{
+  "mode": "delegated",
+  "steps": [
+    {
+      "id": "spec",
+      "tool": "add_feature",
+      "args": { "feature_name": "user-auth", "description": "用户认证功能" },
+      "outputs": ["docs/specs/user-auth/requirements.md"]
+    }
+  ]
+}</code></pre>
+                        </div>
+                        <div class="callout info">
+                            <div class="callout-icon">💡</div>
+                            <div class="callout-content">
+                                <p><strong>要点：</strong>按顺序执行 <code>steps</code>，并确保 <code>outputs</code> 所列文件真实落盘。</p>
+                            </div>
+                        </div>
+                    </div>
+                </div>
                 
                 <!-- Next Steps CTA -->
                 <div class="next-cta">

package/docs/pages/migration.html

@@ -78,7 +78,7 @@
                             <span class="icon">🛠️</span>
                             <span>所有工具</span>
                         </div>
-                        <span class="badge">42</span>
+                        <span class="badge">39</span>
                     </a>
                 </div>
                 
@@ -177,14 +177,18 @@
                 <h1 class="page-title">v2.0 迁移指南</h1>
                 <p class="page-description">从 v1.x 平滑迁移到 v2.0，了解重大变更和新特性</p>
                 <div class="page-meta">
-                    <span>📦 v2.3.0</span>
+                    <span>📦 v2.5.0</span>
                     <span>·</span>
                     <span>最后更新：2026-01-27</span>
+                    <span>·</span>
+                    <span>协议：MCP 2025-11-25</span>
+                    <span>·</span>
+                    <span>SDK：@modelcontextprotocol/sdk 1.25.3</span>
                 </div>
                 
                 <!-- Content -->
                 <h2>概述</h2>
-                <p>MCP Probe Kit v2.0 是一个重大版本更新，精简优化到 42 个核心工具，带来了更强大的功能和更好的开发体验。</p>
+                <p>MCP Probe Kit v2.0 是一个重大版本更新，精简优化到 39 个核心工具，带来了更强大的功能和更好的开发体验。</p>
                 
                 <div class="callout info">
                     <div class="callout-icon">💡</div>
@@ -196,14 +200,15 @@
                 <h2>主要变更</h2>
                 
                 <h3>1. 工具精简优化</h3>
-                <p>v1.x: 13 个工具 → v2.0: 42 个核心工具（移除低频工具，保留高价值工具）</p>
+                <p>v1.x: 13 个工具 → v2.0: 39 个核心工具（移除低频工具，保留高价值工具）</p>
                 
                 <h3>2. 新增工作流编排</h3>
-                <p>10 个 <code>start_*</code> 工作流编排工具，提供端到端的自动化开发流程：</p>
+                <p>11 个 <code>start_*</code> 工作流编排工具，提供端到端的自动化开发流程：</p>
                 <ul>
                     <li><code>start_feature</code> - 功能开发工作流</li>
                     <li><code>start_bugfix</code> - Bug 修复工作流</li>
                     <li><code>start_ui</code> - UI 开发工作流</li>
+                    <li><code>start_product</code> - 产品设计工作流</li>
                     <li><code>start_ralph</code> - Ralph Wiggum Loop 自动化开发</li>
                 </ul>
                 
@@ -212,12 +217,13 @@
                 <ul>
                     <li><code>ui_design_system</code> - 智能设计系统生成器</li>
                     <li><code>ui_search</code> - UI/UX 数据库搜索</li>
+                    <li><code>sync_ui_data</code> - UI/UX 数据同步</li>
+                    <li><code>init_component_catalog</code> - 组件目录初始化</li>
                     <li><code>render_ui</code> - UI 渲染引擎</li>
-                    <li><code>design2code</code> - 设计稿转代码</li>
                 </ul>
                 
-                <h3>4. 100% 结构化输出</h3>
-                <p>所有 42 个工具都支持结构化输出，确保输出格式一致、可预测。</p>
+                            <h3>4. 结构化输出覆盖升级</h3>
+                            <p>核心与编排工具优先支持结构化输出，输出格式一致、可预测，便于工具串联与状态追踪。</p>
                 
                 <h2>迁移步骤</h2>