mcp-probe-kit 1.15.0 → 2.0.0

package/build/tools/start_feature.js

@@ -1,4 +1,6 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
+import { FeatureReportSchema } from "../schemas/structured-output.js";
 /**
  * start_feature 智能编排工具
  *
@@ -180,9 +182,59 @@ export async function startFeature(args) {
             .replace(/{feature_name}/g, featureName)
             .replace(/{description}/g, description)
             .replace(/{docs_dir}/g, docsDir);
-        return {
-            content: [{ type: "text", text: guide }],
+        // 创建结构化的功能开发报告
+        const featureReport = {
+            summary: `新功能开发工作流：${featureName}`,
+            status: 'pending',
+            steps: [
+                {
+                    name: '检查项目上下文',
+                    status: 'pending',
+                    description: `检查 ${docsDir}/project-context.md 是否存在，如不存在则调用 init_project_context`,
+                },
+                {
+                    name: '生成功能规格',
+                    status: 'pending',
+                    description: '调用 add_feature 工具生成需求、设计和任务文档',
+                },
+                {
+                    name: '工作量估算',
+                    status: 'pending',
+                    description: '调用 estimate 工具进行工作量估算',
+                },
+            ],
+            artifacts: [],
+            nextSteps: [
+                '检查并读取项目上下文文档',
+                '调用 add_feature 工具生成功能规格文档',
+                '调用 estimate 工具进行工作量估算',
+                '按照 tasks.md 开始开发',
+            ],
+            specArtifacts: [
+                {
+                    path: `${docsDir}/specs/${featureName}/requirements.md`,
+                    type: 'requirements',
+                },
+                {
+                    path: `${docsDir}/specs/${featureName}/design.md`,
+                    type: 'design',
+                },
+                {
+                    path: `${docsDir}/specs/${featureName}/tasks.md`,
+                    type: 'tasks',
+                },
+            ],
+            estimate: {
+                optimistic: '待估算',
+                normal: '待估算',
+                pessimistic: '待估算',
+            },
+            dependencies: [],
         };
+        return okStructured(guide, featureReport, {
+            schema: FeatureReportSchema,
+            note: 'AI 应该按照指南执行步骤，并在每个步骤完成后更新 structuredContent 中的状态和估算信息',
+        });
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);

package/build/tools/start_onboard.d.ts

@@ -1,10 +1,4 @@
-export declare function startOnboard(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
+export declare function startOnboard(args: any): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;

package/build/tools/start_onboard.js

@@ -1,4 +1,6 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
+import { OnboardingReportSchema } from "../schemas/structured-output.js";
 /**
  * start_onboard 智能编排工具
  *
@@ -145,9 +147,45 @@ export async function startOnboard(args) {
         const guide = PROMPT_TEMPLATE
             .replace(/{project_path}/g, projectPath)
             .replace(/{docs_dir}/g, docsDir);
-        return {
-            content: [{ type: "text", text: guide }],
+        // Create structured onboarding report
+        const onboardingReport = {
+            summary: `项目上手工作流：${projectPath}`,
+            status: 'pending',
+            steps: [
+                {
+                    name: '项目分析',
+                    status: 'pending',
+                    description: '调用 analyze_project 分析项目结构和技术栈',
+                },
+                {
+                    name: '生成项目上下文',
+                    status: 'pending',
+                    description: '调用 init_project_context 生成项目文档',
+                },
+            ],
+            artifacts: [],
+            nextSteps: [
+                '调用 analyze_project 分析项目',
+                '调用 init_project_context 生成文档',
+                `阅读 ${docsDir}/project-context.md`,
+                '查看 README.md 了解项目背景',
+            ],
+            projectSummary: {
+                name: '待分析',
+                description: '待分析',
+                techStack: [],
+                architecture: '待分析',
+            },
+            quickstart: {
+                setup: ['待分析'],
+                commonTasks: [],
+            },
+            keyFiles: [],
         };
+        return okStructured(guide, onboardingReport, {
+            schema: OnboardingReportSchema,
+            note: 'AI 应该按照指南执行步骤，并在分析完成后更新 structuredContent 中的项目信息',
+        });
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);

package/build/tools/start_ralph.d.ts

@@ -1,13 +1,7 @@
 /**
  * start_ralph 主函数
  */
-export declare function startRalph(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
+export declare function startRalph(args: any): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;

package/build/tools/start_ralph.js

@@ -1,4 +1,6 @@
 import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
+import { RalphLoopReportSchema } from "../schemas/structured-output.js";
 // 默认值（保守安全）
 const DEFAULTS = {
     mode: "safe",
@@ -765,9 +767,93 @@ ${normalScript}
 
 **Happy coding! 🚀**
 `;
-        return {
-            content: [{ type: "text", text: output }],
+        // Create structured Ralph Loop report
+        const ralphReport = {
+            summary: `Ralph Loop 循环开发：${params.goal}`,
+            status: 'pending',
+            steps: [
+                {
+                    name: '创建 .ralph 目录',
+                    status: 'pending',
+                    description: '创建 .ralph/ 目录结构',
+                },
+                {
+                    name: '复制配置文件',
+                    status: 'pending',
+                    description: '复制 PROMPT.md, @fix_plan.md, PROGRESS.md 和脚本文件',
+                },
+                {
+                    name: '配置脚本权限',
+                    status: 'pending',
+                    description: '使脚本可执行（Linux/Mac）',
+                },
+                {
+                    name: '启动循环',
+                    status: 'pending',
+                    description: '运行 ralph_loop_safe 脚本',
+                },
+            ],
+            artifacts: [
+                {
+                    path: '.ralph/PROMPT.md',
+                    type: 'doc',
+                    purpose: '循环提示词和规则',
+                },
+                {
+                    path: '.ralph/@fix_plan.md',
+                    type: 'doc',
+                    purpose: '任务分解和优先级',
+                },
+                {
+                    path: '.ralph/PROGRESS.md',
+                    type: 'doc',
+                    purpose: '迭代日志',
+                },
+                {
+                    path: `.ralph/ralph_loop_safe.${isWindows ? 'ps1' : 'sh'}`,
+                    type: 'config',
+                    purpose: '安全模式脚本',
+                },
+            ],
+            nextSteps: [
+                '创建 .ralph/ 目录',
+                '复制文件内容到对应文件',
+                '使脚本可执行',
+                '运行 ralph_loop_safe 脚本',
+            ],
+            loopPolicy: {
+                maxIterations: params.max_iterations,
+                maxMinutes: params.max_minutes,
+                confirmEvery: params.confirm_every,
+                cooldownSeconds: params.cooldown_seconds,
+            },
+            iterations: [],
+            stopConditions: {
+                reason: '未启动',
+                metConditions: [],
+            },
+            safetyChecks: [
+                {
+                    check: 'Max iterations limit',
+                    passed: true,
+                    message: `设置为 ${params.max_iterations} 次`,
+                },
+                {
+                    check: 'Max time limit',
+                    passed: true,
+                    message: `设置为 ${params.max_minutes} 分钟`,
+                },
+                {
+                    check: 'Confirmation required',
+                    passed: true,
+                    message: `每 ${params.confirm_every} 轮确认一次`,
+                },
+            ],
         };
+        return okStructured(output, ralphReport, {
+            schema: RalphLoopReportSchema,
+            note: 'AI 应该帮助用户创建 .ralph/ 目录并复制文件，然后指导用户启动循环',
+        });
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);

package/build/tools/start_refactor.d.ts

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

package/build/tools/start_refactor.js

@@ -1,150 +1,11 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 /**
  * start_refactor 智能编排工具
  *
  * 场景：代码重构
  * 编排：[检查上下文] → code_review → refactor → gentest
  */
-const PROMPT_TEMPLATE = `# ♻️ 代码重构编排指南
-
-## 🎯 目标
-
-重构以下代码：
-
-\`\`\`
-{code}
-\`\`\`
-
-**重构目标**: {goal}
-
----
-
-## 📋 步骤 0: 项目上下文（自动处理）
-
-**操作**:
-1. 检查 \`docs/project-context.md\` 是否存在
-2. **如果不存在**：
-   - 调用 \`init_project_context\` 工具
-   - 等待生成完成
-3. **读取** \`docs/project-context.md\` 内容
-4. 了解项目的架构模式、编码规范
-5. 重构要符合项目规范
-
----
-
-## 🔍 步骤 1: 代码审查（发现问题）
-
-**调用工具**: \`code_review\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[待重构代码]",
-  "focus": "quality"
-}
-\`\`\`
-
-**目的**:
-- 识别代码坏味道
-- 发现可改进点
-- 评估当前代码质量
-
-**产出**: 问题清单
-
----
-
-## ♻️ 步骤 2: 生成重构方案
-
-**调用工具**: \`refactor\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[待重构代码]",
-  "goal": "{goal}"
-}
-\`\`\`
-
-**重构方向**:
-- improve_readability: 提高可读性
-- reduce_complexity: 降低复杂度
-- extract_function: 提取函数
-- remove_duplication: 消除重复
-- improve_naming: 改进命名
-
-**产出**: 重构后的代码 + 重构说明
-
----
-
-## 🧪 步骤 3: 生成保护测试
-
-**调用工具**: \`gentest\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[重构后的代码]",
-  "framework": "[根据项目上下文选择]"
-}
-\`\`\`
-
-**目的**:
-- 确保重构不改变行为
-- 为重构后的代码提供测试保护
-- 覆盖主要功能和边界情况
-
-**产出**: 测试代码
-
----
-
-## ✅ 完成检查
-
-- [ ] 项目上下文已读取
-- [ ] 代码问题已识别
-- [ ] 重构方案已生成
-- [ ] 代码已重构
-- [ ] 测试已添加
-- [ ] 测试已通过
-
----
-
-## 📝 输出汇总
-
-完成后，向用户提供：
-
-### 1. 重构前后对比
-
-**重构前**:
-\`\`\`
-[原代码]
-\`\`\`
-
-**重构后**:
-\`\`\`
-[新代码]
-\`\`\`
-
-### 2. 改进说明
-
-| 改进项 | 说明 |
-|--------|------|
-| [改进1] | [说明] |
-| [改进2] | [说明] |
-
-### 3. 测试覆盖
-
-- 测试用例数: X
-- 覆盖场景: [列出]
-
-### 4. 注意事项
-
-- [重构可能影响的地方]
-- [需要同步修改的地方]
-
----
-
-*编排工具: MCP Probe Kit - start_refactor*
-`;
 export async function startRefactor(args) {
     try {
         // 智能参数解析，支持自然语言输入
@@ -171,18 +32,84 @@ export async function startRefactor(args) {
             remove_duplication: "消除重复",
             improve_naming: "改进命名",
         };
-        const guide = PROMPT_TEMPLATE
-            .replace(/{code}/g, code)
-            .replace(/{goal}/g, goalDesc[goal] || goal);
-        return {
-            content: [{ type: "text", text: guide }],
+        const message = `# ♻️ 代码重构编排
+
+重构以下代码：
+
+\`\`\`
+${code}
+\`\`\`
+
+**重构目标**: ${goalDesc[goal] || goal}
+
+---
+
+## 📋 执行步骤
+
+### 步骤 1: 代码审查（发现问题）
+调用 \`code_review\` 工具，识别代码坏味道、发现可改进点、评估当前代码质量。
+
+### 步骤 2: 生成重构方案
+调用 \`refactor\` 工具，根据重构目标生成重构后的代码和重构说明。
+
+### 步骤 3: 生成保护测试
+调用 \`gentest\` 工具，为重构后的代码生成测试，确保重构不改变行为。
+
+---
+
+## 📝 输出内容
+
+完成后，提供：
+1. 重构前后对比
+2. 改进说明
+3. 测试覆盖
+4. 注意事项
+
+**重要**: 请使用结构化输出格式返回结果。`;
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: `代码重构 - ${goalDesc[goal] || goal}`,
+            status: "pending",
+            steps: [
+                {
+                    name: "code_review",
+                    description: "代码审查",
+                    status: "pending",
+                },
+                {
+                    name: "refactor",
+                    description: "生成重构方案",
+                    status: "pending",
+                },
+                {
+                    name: "gentest",
+                    description: "生成保护测试",
+                    status: "pending",
+                },
+            ],
+            refactorPlan: {}, // AI 将填充实际的重构计划
+            riskAssessment: {
+                level: "medium",
+            },
         };
+        return okStructured(message, structuredData, {
+            schema: (await import("../schemas/output/workflow-tools.js")).RefactorWorkflowSchema,
+        });
     }
     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: [],
+            refactorPlan: {},
+            riskAssessment: {
+                level: "high",
+            },
+            warnings: [errorMsg],
         };
+        return okStructured(`❌ 编排执行失败: ${errorMsg}`, errorData, {
+            schema: (await import("../schemas/output/workflow-tools.js")).RefactorWorkflowSchema,
+        });
     }
 }

package/build/tools/start_release.d.ts

@@ -1,13 +1,7 @@
-export declare function startRelease(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+/**
+ * start_release 智能编排工具
+ *
+ * 场景：发布准备
+ * 编排：[检查上下文] → genchangelog → genpr
+ */
+export declare function startRelease(args: any): Promise<import("../lib/response.js").ToolResponse>;