mcp-probe-kit 1.4.0 → 1.6.0

package/build/tools/start_onboard.js

@@ -0,0 +1,146 @@
+/**
+ * start_onboard 智能编排工具
+ *
+ * 场景：快速上手项目
+ * 编排：analyze_project → init_project_context
+ */
+const PROMPT_TEMPLATE = `# 📚 快速上手编排指南
+
+## 🎯 目标
+
+快速了解并上手当前项目
+
+---
+
+## 🔍 步骤 1: 项目分析
+
+**调用工具**: \`analyze_project\`
+
+**参数**:
+\`\`\`json
+{
+  "project_path": "{project_path}",
+  "max_depth": 5,
+  "include_content": true
+}
+\`\`\`
+
+**分析内容**:
+- 项目结构
+- 技术栈识别
+- 入口文件
+- 核心模块
+- 依赖关系
+
+**产出**: 项目分析报告
+
+---
+
+## 📝 步骤 2: 生成项目上下文
+
+**调用工具**: \`init_project_context\`
+
+**参数**:
+\`\`\`json
+{
+  "docs_dir": "{docs_dir}"
+}
+\`\`\`
+
+**生成内容**:
+- 技术栈文档
+- 架构说明
+- 编码规范
+- 开发指南
+
+**产出**: \`{docs_dir}/project-context.md\`
+
+---
+
+## ✅ 完成检查
+
+- [ ] 项目结构已分析
+- [ ] 技术栈已识别
+- [ ] 项目上下文已生成
+- [ ] 文档已保存
+
+---
+
+## 📊 输出汇总
+
+完成后，向用户提供：
+
+### 1. 项目概览
+
+| 项目 | 内容 |
+|------|------|
+| 项目名称 | [名称] |
+| 项目类型 | [前端/后端/全栈/库] |
+| 主要语言 | [语言] |
+| 框架 | [框架] |
+
+### 2. 技术栈
+
+| 类别 | 技术 |
+|------|------|
+| 语言 | [语言列表] |
+| 框架 | [框架列表] |
+| 构建工具 | [工具列表] |
+| 测试框架 | [框架列表] |
+
+### 3. 项目结构
+
+\`\`\`
+[目录树]
+\`\`\`
+
+### 4. 核心文件
+
+| 文件 | 用途 |
+|------|------|
+| [文件1] | [用途] |
+| [文件2] | [用途] |
+
+### 5. 快速开始
+
+\`\`\`bash
+# 安装依赖
+[安装命令]
+
+# 启动开发
+[启动命令]
+
+# 运行测试
+[测试命令]
+\`\`\`
+
+### 6. 下一步建议
+
+1. 阅读 \`{docs_dir}/project-context.md\` 了解详细信息
+2. 查看 README.md 了解项目背景
+3. 运行项目熟悉功能
+4. 阅读核心模块代码
+
+---
+
+*编排工具: MCP Probe Kit - start_onboard*
+`;
+export async function startOnboard(args) {
+    try {
+        const projectPath = args?.project_path || ".";
+        const docsDir = args?.docs_dir || "docs";
+        const guide = PROMPT_TEMPLATE
+            .replace(/{project_path}/g, projectPath)
+            .replace(/{docs_dir}/g, docsDir);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/start_refactor.d.ts

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

package/build/tools/start_refactor.js

@@ -0,0 +1,175 @@
+/**
+ * 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 {
+        const code = args?.code;
+        if (!code) {
+            throw new Error("缺少必填参数: code（需要重构的代码）");
+        }
+        const goal = args?.goal || "improve_readability";
+        const goalDesc = {
+            improve_readability: "提高可读性",
+            reduce_complexity: "降低复杂度",
+            extract_function: "提取函数",
+            remove_duplication: "消除重复",
+            improve_naming: "改进命名",
+        };
+        const guide = PROMPT_TEMPLATE
+            .replace(/{code}/g, code)
+            .replace(/{goal}/g, goalDesc[goal] || goal);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/start_release.d.ts

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

package/build/tools/start_release.js

@@ -0,0 +1,152 @@
+/**
+ * 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 {
+        const version = args?.version;
+        if (!version) {
+            throw new Error("缺少必填参数: version（版本号，如 v1.2.0）");
+        }
+        const fromTag = args?.from_tag || "上个版本 tag";
+        const branch = args?.branch || "release/" + version;
+        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 }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/start_review.d.ts

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

package/build/tools/start_review.js

@@ -0,0 +1,162 @@
+/**
+ * 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 {
+        const code = args?.code;
+        if (!code) {
+            throw new Error("缺少必填参数: code（需要审查的代码）");
+        }
+        const language = args?.language || "auto";
+        const guide = PROMPT_TEMPLATE
+            .replace(/{code}/g, code)
+            .replace(/{language}/g, language);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}