mcp-probe-kit 1.15.0 → 2.0.0

package/build/tools/start_release.js

@@ -1,131 +1,11 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 /**
  * start_release 智能编排工具
  *
  * 场景：发布准备
  * 编排：[检查上下文] → genchangelog → genpr
  */
-const PROMPT_TEMPLATE = `# 📦 发布准备编排指南
-
-## 🎯 目标
-
-准备发布版本：**{version}**
-
----
-
-## 📋 步骤 0: 项目上下文（自动处理）
-
-**操作**:
-1. 检查 \`docs/project-context.md\` 是否存在
-2. **如果不存在**：
-   - 调用 \`init_project_context\` 工具
-   - 等待生成完成
-3. **读取** \`docs/project-context.md\` 内容
-4. 了解项目的版本管理方式、发布流程
-
----
-
-## 📝 步骤 1: 生成 Changelog
-
-**调用工具**: \`genchangelog\`
-
-**参数**:
-\`\`\`json
-{
-  "version": "{version}",
-  "from": "{from_tag}",
-  "to": "HEAD"
-}
-\`\`\`
-
-**执行要点**:
-1. 分析从上个版本到现在的所有 commit
-2. 按类型分类（feat/fix/docs/refactor 等）
-3. 生成结构化的变更日志
-
-**产出**: CHANGELOG.md 内容
-
----
-
-## 📋 步骤 2: 生成 PR 描述
-
-**调用工具**: \`genpr\`
-
-**参数**:
-\`\`\`json
-{
-  "branch": "{branch}",
-  "commits": "[从 genchangelog 获取的 commit 信息]"
-}
-\`\`\`
-
-**执行要点**:
-1. 总结本次发布的主要变更
-2. 列出新功能、Bug 修复、破坏性变更
-3. 生成规范的 PR 描述
-
-**产出**: PR 描述
-
----
-
-## ✅ 完成检查
-
-- [ ] 项目上下文已读取
-- [ ] Changelog 已生成
-- [ ] PR 描述已生成
-- [ ] 版本号已确认
-
----
-
-## 📝 输出汇总
-
-完成后，向用户提供：
-
-### 1. CHANGELOG 内容
-
-\`\`\`markdown
-## [{version}] - {date}
-
-### ✨ 新功能
-- ...
-
-### 🐛 Bug 修复
-- ...
-
-### 📝 文档
-- ...
-
-### ♻️ 重构
-- ...
-\`\`\`
-
-### 2. PR 描述
-
-\`\`\`markdown
-## 发布 {version}
-
-### 变更摘要
-...
-
-### 详细变更
-...
-
-### 测试情况
-...
-\`\`\`
-
-### 3. 发布检查清单
-
-- [ ] 版本号已更新（package.json 等）
-- [ ] CHANGELOG.md 已更新
-- [ ] 测试全部通过
-- [ ] 文档已更新
-- [ ] PR 已创建
-
----
-
-*编排工具: MCP Probe Kit - start_release*
-`;
 export async function startRelease(args) {
     try {
         // 智能参数解析，支持自然语言输入
@@ -148,20 +28,65 @@ export async function startRelease(args) {
         if (!version) {
             throw new Error("缺少必填参数: version（版本号，如 v1.2.0）");
         }
-        const guide = PROMPT_TEMPLATE
-            .replace(/{version}/g, version)
-            .replace(/{from_tag}/g, fromTag)
-            .replace(/{branch}/g, branch)
-            .replace(/{date}/g, new Date().toISOString().split("T")[0]);
-        return {
-            content: [{ type: "text", text: guide }],
+        const message = `# 📦 发布准备编排
+
+准备发布版本：**${version}**
+
+---
+
+## 📋 执行步骤
+
+### 步骤 1: 生成 Changelog
+调用 \`genchangelog\` 工具，分析从 ${fromTag} 到现在的所有 commit，按类型分类生成变更日志。
+
+### 步骤 2: 生成 PR 描述
+调用 \`genpr\` 工具，总结本次发布的主要变更，生成规范的 PR 描述。
+
+---
+
+## 📝 输出内容
+
+完成后，提供：
+1. CHANGELOG.md 内容
+2. PR 描述
+3. 发布检查清单
+
+**重要**: 请使用结构化输出格式返回结果。`;
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: `发布 ${version} 准备`,
+            status: "pending",
+            steps: [
+                {
+                    name: "genchangelog",
+                    description: "生成 Changelog",
+                    status: "pending",
+                },
+                {
+                    name: "genpr",
+                    description: "生成 PR 描述",
+                    status: "pending",
+                },
+            ],
+            version: version,
+            changelog: {}, // AI 将填充实际的 Changelog
         };
+        return okStructured(message, structuredData, {
+            schema: (await import("../schemas/output/workflow-tools.js")).ReleaseWorkflowSchema,
+        });
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
-            isError: true,
+        const errorData = {
+            summary: "发布准备失败",
+            status: "failed",
+            steps: [],
+            version: "",
+            changelog: {},
+            warnings: [errorMsg],
         };
+        return okStructured(`❌ 编排执行失败: ${errorMsg}`, errorData, {
+            schema: (await import("../schemas/output/workflow-tools.js")).ReleaseWorkflowSchema,
+        });
     }
 }

package/build/tools/start_review.d.ts

@@ -1,13 +1,7 @@
-export declare function startReview(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+/**
+ * start_review 智能编排工具
+ *
+ * 场景：代码体检
+ * 编排：[检查上下文] → code_review → security_scan → perf
+ */
+export declare function startReview(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/start_review.js

@@ -1,144 +1,11 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 /**
  * start_review 智能编排工具
  *
  * 场景：代码体检
  * 编排：[检查上下文] → code_review → security_scan → perf
  */
-const PROMPT_TEMPLATE = `# 🔍 代码体检编排指南
-
-## 🎯 目标
-
-对以下代码进行全面体检：
-
-\`\`\`{language}
-{code}
-\`\`\`
-
----
-
-## 📋 步骤 0: 项目上下文（自动处理）
-
-**操作**:
-1. 检查 \`docs/project-context.md\` 是否存在
-2. **如果不存在**：
-   - 调用 \`init_project_context\` 工具
-   - 等待生成完成
-3. **读取** \`docs/project-context.md\` 内容
-4. 了解项目的编码规范、技术栈
-5. 后续审查要参考项目规范
-
----
-
-## 📝 步骤 1: 代码质量审查
-
-**调用工具**: \`code_review\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[待审查代码]",
-  "focus": "quality"
-}
-\`\`\`
-
-**审查要点**:
-- 代码可读性
-- 命名规范
-- 代码结构
-- 最佳实践
-- 潜在 Bug
-
-**产出**: 质量问题清单
-
----
-
-## 🔒 步骤 2: 安全漏洞扫描
-
-**调用工具**: \`security_scan\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[待审查代码]",
-  "scan_type": "all"
-}
-\`\`\`
-
-**扫描要点**:
-- 注入漏洞（SQL/XSS/命令注入）
-- 认证授权问题
-- 加密安全
-- 敏感数据泄露
-
-**产出**: 安全漏洞报告
-
----
-
-## ⚡ 步骤 3: 性能分析
-
-**调用工具**: \`perf\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[待审查代码]",
-  "type": "all"
-}
-\`\`\`
-
-**分析要点**:
-- 算法复杂度
-- 内存使用
-- 数据库查询
-- 渲染性能（如适用）
-
-**产出**: 性能优化建议
-
----
-
-## ✅ 完成检查
-
-- [ ] 项目上下文已读取
-- [ ] 代码质量已审查
-- [ ] 安全漏洞已扫描
-- [ ] 性能已分析
-
----
-
-## 📊 综合报告模板
-
-完成后，生成综合报告：
-
-### 代码体检报告
-
-#### 📈 总体评分
-
-| 维度 | 评分 | 问题数 |
-|------|------|--------|
-| 代码质量 | ?/10 | X 个 |
-| 安全性 | ?/10 | X 个 |
-| 性能 | ?/10 | X 个 |
-| **综合** | ?/10 | |
-
-#### 🔴 严重问题（需立即修复）
-[列出严重问题]
-
-#### 🟡 一般问题（建议修复）
-[列出一般问题]
-
-#### 🟢 优化建议
-[列出优化建议]
-
-#### 📋 修复优先级
-1. [最高优先级问题]
-2. [次优先级问题]
-...
-
----
-
-*编排工具: MCP Probe Kit - start_review*
-`;
 export async function startReview(args) {
     try {
         // 智能参数解析，支持自然语言输入
@@ -158,18 +25,79 @@ export async function startReview(args) {
         if (!code) {
             throw new Error("缺少必填参数: code（需要审查的代码）");
         }
-        const guide = PROMPT_TEMPLATE
-            .replace(/{code}/g, code)
-            .replace(/{language}/g, language);
-        return {
-            content: [{ type: "text", text: guide }],
+        const message = `# 🔍 代码体检编排
+
+对以下代码进行全面体检：
+
+\`\`\`${language}
+${code}
+\`\`\`
+
+---
+
+## 📋 执行步骤
+
+### 步骤 1: 代码质量审查
+调用 \`code_review\` 工具，审查代码可读性、命名规范、代码结构、最佳实践和潜在 Bug。
+
+### 步骤 2: 安全漏洞扫描
+调用 \`security_scan\` 工具，扫描注入漏洞、认证授权问题、加密安全和敏感数据泄露。
+
+### 步骤 3: 性能分析
+调用 \`perf\` 工具，分析算法复杂度、内存使用、数据库查询和渲染性能。
+
+---
+
+## 📊 综合报告
+
+完成后，生成包含以下内容的综合报告：
+- 总体评分（代码质量、安全性、性能）
+- 严重问题清单（需立即修复）
+- 一般问题清单（建议修复）
+- 优化建议
+- 修复优先级
+
+**重要**: 请使用结构化输出格式返回结果。`;
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: "代码体检编排",
+            status: "pending",
+            steps: [
+                {
+                    name: "code_review",
+                    description: "代码质量审查",
+                    status: "pending",
+                },
+                {
+                    name: "security_scan",
+                    description: "安全漏洞扫描",
+                    status: "pending",
+                },
+                {
+                    name: "perf",
+                    description: "性能分析",
+                    status: "pending",
+                },
+            ],
+            reviewResults: {},
+            overallScore: 0, // AI 将填充实际评分
         };
+        return okStructured(message, structuredData, {
+            schema: (await import("../schemas/output/workflow-tools.js")).ReviewWorkflowSchema,
+        });
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
-            isError: true,
+        const errorData = {
+            summary: "代码体检失败",
+            status: "failed",
+            steps: [],
+            reviewResults: {},
+            overallScore: 0,
+            warnings: [errorMsg],
         };
+        return okStructured(`❌ 编排执行失败: ${errorMsg}`, errorData, {
+            schema: (await import("../schemas/output/workflow-tools.js")).ReviewWorkflowSchema,
+        });
     }
 }

package/build/tools/start_ui.d.ts

@@ -10,16 +10,10 @@
 /**
  * 统一 UI 开发编排工具
  */
-export declare function startUi(args: any): Promise<{
+export declare function startUi(args: any): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;
     }[];
     isError: boolean;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
 }>;

package/build/tools/start_ui.js

@@ -9,6 +9,8 @@
  */
 import { parseArgs, getString } from "../utils/parseArgs.js";
 import { getReasoningEngine } from "./ui-ux-tools.js";
+import { okStructured } from "../lib/response.js";
+import { UIReportSchema } from "../schemas/structured-output.js";
 const PROMPT_TEMPLATE = `# 快速开始
 
 **职责说明**: 本工具仅提供执行指导，不执行实际操作。请按顺序调用以下 MCP 工具。
@@ -209,14 +211,58 @@ render_ui docs/ui/${templateName || 'template'}.json --framework="${inferredStac
 
 ${recommendation.reasoning}
 `;
-            return {
-                content: [
+            // Create structured UI report for auto mode
+            const uiReport = {
+                summary: `智能 UI 开发：${description}`,
+                status: 'pending',
+                steps: [
                     {
-                        type: "text",
-                        text: smartPlan,
+                        name: '生成设计系统',
+                        status: 'pending',
+                        description: `调用 ui_design_system 生成设计规范`,
+                    },
+                    {
+                        name: '生成组件目录',
+                        status: 'pending',
+                        description: '调用 init_component_catalog 生成组件目录',
+                    },
+                    {
+                        name: '搜索 UI 模板',
+                        status: 'pending',
+                        description: '调用 ui_search 搜索匹配的模板',
+                    },
+                    {
+                        name: '渲染最终代码',
+                        status: 'pending',
+                        description: '调用 render_ui 生成组件代码',
                     },
                 ],
+                artifacts: [],
+                nextSteps: [
+                    `调用 ui_design_system --product_type="${inferredProductType}" --stack="${inferredStack}"`,
+                    '调用 init_component_catalog',
+                    `调用 ui_search --mode=template --query="${description}"`,
+                    `调用 render_ui --framework="${inferredStack}"`,
+                ],
+                designSystem: {
+                    colors: {},
+                    typography: {},
+                    spacing: {},
+                },
+                renderedCode: {
+                    framework: inferredStack,
+                    code: '待生成',
+                },
+                consistencyRules: [
+                    '所有组件使用设计系统中定义的颜色',
+                    '所有组件使用设计系统中定义的字体',
+                    '所有组件使用设计系统中定义的间距',
+                ],
             };
+            return okStructured(smartPlan, uiReport, {
+                schema: UIReportSchema,
+                note: 'AI 应该按照智能计划执行步骤，并在每个步骤完成后更新 structuredContent',
+            });
         }
         // 如果没有提供模板名，从描述中生成
         if (!templateName && description) {
@@ -275,14 +321,58 @@ start_ui "设置页面" --framework=react
         guide = safeReplace(guide, '{description}', escapeJson(description));
         guide = safeReplace(guide, '{framework}', framework);
         guide = safeReplace(guide, '{templateName}', templateName || 'ui-template');
-        return {
-            content: [
+        // Create structured UI report for manual mode
+        const uiReport = {
+            summary: `UI 开发工作流：${description}`,
+            status: 'pending',
+            steps: [
                 {
-                    type: "text",
-                    text: guide,
+                    name: '检查设计系统',
+                    status: 'pending',
+                    description: '检查 docs/design-system.md 是否存在',
+                },
+                {
+                    name: '检查组件目录',
+                    status: 'pending',
+                    description: '检查 docs/component-catalog.json 是否存在',
                 },
+                {
+                    name: '搜索 UI 模板',
+                    status: 'pending',
+                    description: '调用 ui_search 搜索匹配的模板',
+                },
+                {
+                    name: '渲染最终代码',
+                    status: 'pending',
+                    description: '调用 render_ui 生成组件代码',
+                },
+            ],
+            artifacts: [],
+            nextSteps: [
+                '检查设计系统文件，如不存在则调用 ui_design_system',
+                '检查组件目录，如不存在则调用 init_component_catalog',
+                `调用 ui_search --mode=template --query="${description}"`,
+                `调用 render_ui --framework="${framework}"`,
+            ],
+            designSystem: {
+                colors: {},
+                typography: {},
+                spacing: {},
+            },
+            renderedCode: {
+                framework: framework,
+                code: '待生成',
+            },
+            consistencyRules: [
+                '所有组件使用设计系统中定义的颜色',
+                '所有组件使用设计系统中定义的字体',
+                '所有组件使用设计系统中定义的间距',
             ],
         };
+        return okStructured(guide, uiReport, {
+            schema: UIReportSchema,
+            note: 'AI 应该按照指南执行步骤，并在每个步骤完成后更新 structuredContent',
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);

package/build/tools/ui-ux-tools.d.ts

@@ -69,48 +69,12 @@ export declare function getReasoningEngine(): Promise<DesignReasoningEngine>;
  *
  * Requirements: 1.1, 1.2, 1.3, 1.4, 2.1, 2.2, 2.3, 2.5, 6.1-6.6
  */
-export declare function uiDesignSystem(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function uiDesignSystem(args: any): Promise<import("../lib/response.js").ToolResponse>;
 /**
  * UI 搜索工具（增强版）
  */
-export declare function uiSearch(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function uiSearch(args: any): Promise<import("../lib/response.js").ToolResponse>;
 /**
  * UI 数据同步工具
  */
-export declare function syncUiData(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function syncUiData(args: any): Promise<import("../lib/response.js").ToolResponse>;