mcp-probe-kit 1.4.0 → 1.6.0

package/build/tools/gen_mock.js

@@ -0,0 +1,250 @@
+/**
+ * gen_mock 工具
+ *
+ * 功能：根据数据结构生成 Mock 数据
+ * 模式：指令生成器模式 - 返回生成指南，由 AI 执行实际生成
+ */
+const PROMPT_TEMPLATE = `# Mock 数据生成指南
+
+## 🎯 生成目标
+
+**数据结构**:
+\`\`\`
+{schema}
+\`\`\`
+
+**生成配置**:
+- 数量: {count} 条
+- 格式: {format}
+- 语言: {locale}
+{seed_section}
+
+---
+
+## 📋 生成步骤
+
+### 步骤 1: 解析数据结构
+
+分析输入的数据结构，识别：
+1. 字段名称和类型
+2. 必填/可选字段（?标记）
+3. 嵌套结构
+4. 数组类型
+
+### 步骤 2: 字段语义识别
+
+根据字段名自动匹配语义，生成符合语义的数据：
+
+| 字段名模式 | 生成规则 | 中文示例 | 英文示例 |
+|------------|----------|----------|----------|
+| id, _id | UUID/自增ID | uuid-xxx | uuid-xxx |
+| name, 姓名 | 人名 | 张三、李四 | John Doe |
+| email, 邮箱 | 邮箱格式 | zhangsan@example.com | john@example.com |
+| phone, mobile, 手机 | 手机号 | 138xxxx1234 | +1-xxx-xxx-xxxx |
+| avatar, 头像 | 图片URL | https://api.dicebear.com/... | |
+| address, 地址 | 地址 | 北京市朝阳区xxx | 123 Main St |
+| city, 城市 | 城市名 | 北京、上海 | New York |
+| country, 国家 | 国家名 | 中国 | United States |
+| date, 日期 | 日期 | 2024-01-15 | 2024-01-15 |
+| createdAt, created_at | 过去时间 | 2024-01-01T10:00:00Z | |
+| updatedAt, updated_at | 最近时间 | 2024-01-15T15:30:00Z | |
+| title, 标题 | 短句 | 这是一个标题 | A Sample Title |
+| description, desc, 描述 | 段落 | 这是描述内容... | Lorem ipsum... |
+| content, 内容 | 长文本 | 文章内容... | Article content... |
+| price, 价格 | 金额 | 99.00 | 99.00 |
+| amount, 数量 | 整数 | 10 | 10 |
+| status, 状态 | 枚举 | active/inactive | active/inactive |
+| type, 类型 | 枚举 | 根据上下文 | |
+| url, 链接 | URL | https://example.com | |
+| image, 图片 | 图片URL | https://picsum.photos/... | |
+| age, 年龄 | 18-60 | 25 | 25 |
+| gender, 性别 | 性别 | 男/女 | male/female |
+| username, 用户名 | 用户名 | user_123 | user_123 |
+| password, 密码 | 密码占位 | ******** | ******** |
+| token | Token | tok_xxx | tok_xxx |
+| code, 编码 | 编码 | CODE001 | CODE001 |
+| sort, order, 排序 | 序号 | 1, 2, 3 | 1, 2, 3 |
+| enabled, active | 布尔 | true/false | true/false |
+| tags, 标签 | 标签数组 | ["标签1", "标签2"] | ["tag1", "tag2"] |
+
+### 步骤 3: 类型映射
+
+基础类型的默认生成规则：
+
+| 类型 | 生成规则 |
+|------|----------|
+| string | 根据字段名语义，或随机字符串 |
+| number | 1-100 的随机整数 |
+| boolean | true/false 随机 |
+| Date | 最近30天内的随机时间 |
+| string[] | 3-5个随机字符串 |
+| number[] | 3-5个随机数字 |
+| enum | 从枚举值中随机选择 |
+| union | 从联合类型中随机选择 |
+
+### 步骤 4: 生成数据
+
+根据识别结果生成 {count} 条数据。
+
+**注意事项**:
+- 确保数据多样性，避免重复
+- 数值类型保持合理范围
+- 日期类型保持合理顺序（createdAt < updatedAt）
+- 关联字段保持一致性
+
+---
+
+## 📊 输出格式
+
+### JSON 格式
+\`\`\`json
+[
+  {
+    "field1": "value1",
+    "field2": 123
+  }
+]
+\`\`\`
+
+### TypeScript 格式
+\`\`\`typescript
+const mockData: YourType[] = [
+  {
+    field1: "value1",
+    field2: 123
+  }
+];
+
+export default mockData;
+\`\`\`
+
+### JavaScript 格式
+\`\`\`javascript
+const mockData = [
+  {
+    field1: "value1",
+    field2: 123
+  }
+];
+
+module.exports = mockData;
+\`\`\`
+
+### CSV 格式（仅扁平数据）
+\`\`\`csv
+field1,field2
+value1,123
+\`\`\`
+
+---
+
+## 🔧 高级功能
+
+### 自定义规则
+
+在 schema 注释中指定规则：
+
+\`\`\`typescript
+interface User {
+  id: string;           // UUID
+  age: number;          // range: 18-60
+  status: string;       // enum: active, inactive, pending
+  score: number;        // range: 0-100, decimal: 2
+  tags: string[];       // count: 3-5
+  level: number;        // enum: 1, 2, 3
+}
+\`\`\`
+
+### 关联数据
+
+生成有关联关系的数据：
+
+\`\`\`json
+// 先生成 users
+[
+  { "id": "user-1", "name": "张三" },
+  { "id": "user-2", "name": "李四" }
+]
+
+// 再生成 orders，引用 user_id
+[
+  { "id": "order-1", "user_id": "user-1", "amount": 100 },
+  { "id": "order-2", "user_id": "user-2", "amount": 200 }
+]
+\`\`\`
+
+### 固定值
+
+某些字段使用固定值：
+
+\`\`\`typescript
+interface Config {
+  version: string;      // fixed: "1.0.0"
+  env: string;          // fixed: "development"
+}
+\`\`\`
+
+---
+
+## ✅ 生成检查清单
+
+- [ ] 数据结构已正确解析
+- [ ] 字段语义已识别
+- [ ] 数据类型正确
+- [ ] 数量符合要求: {count} 条
+- [ ] 格式正确: {format}
+- [ ] 语言符合设置: {locale}
+- [ ] 数据具有多样性
+- [ ] 关联数据一致（如有）
+
+---
+
+*指南版本: 1.0.0*
+*工具: MCP Probe Kit - gen_mock*
+`;
+/**
+ * gen_mock 工具实现
+ */
+export async function genMock(args) {
+    try {
+        const schema = args?.schema;
+        if (!schema) {
+            throw new Error("缺少必填参数: schema（数据结构定义）");
+        }
+        const count = args?.count || 1;
+        const format = args?.format || "json";
+        const locale = args?.locale || "zh-CN";
+        const seed = args?.seed;
+        if (count < 1 || count > 1000) {
+            throw new Error("count 参数必须在 1-1000 之间");
+        }
+        const formatMap = {
+            json: "JSON",
+            typescript: "TypeScript",
+            javascript: "JavaScript",
+            csv: "CSV",
+        };
+        const localeMap = {
+            "zh-CN": "中文（简体）",
+            "en-US": "英文（美国）",
+            "ja-JP": "日文",
+        };
+        const seedSection = seed ? `- 随机种子: ${seed}（可重复生成）` : "";
+        const guide = PROMPT_TEMPLATE
+            .replace(/{schema}/g, schema)
+            .replace(/{count}/g, String(count))
+            .replace(/{format}/g, formatMap[format] || format)
+            .replace(/{locale}/g, localeMap[locale] || locale)
+            .replace(/{seed_section}/g, seedSection);
+        return {
+            content: [{ type: "text", text: guide }],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ Mock 数据生成失败: ${errorMsg}` }],
+            isError: true,
+        };
+    }
+}

package/build/tools/index.d.ts

@@ -22,3 +22,17 @@ export { cssOrder } from "./css_order.js";
 export { genreadme } from "./genreadme.js";
 export { split } from "./split.js";
 export { analyzeProject } from "./analyze_project.js";
+export { initProjectContext } from "./init_project_context.js";
+export { addFeature } from "./add_feature.js";
+export { securityScan } from "./security_scan.js";
+export { fixBug } from "./fix_bug.js";
+export { estimate } from "./estimate.js";
+export { genMock } from "./gen_mock.js";
+export { startFeature } from "./start_feature.js";
+export { startBugfix } from "./start_bugfix.js";
+export { startReview } from "./start_review.js";
+export { startRelease } from "./start_release.js";
+export { startRefactor } from "./start_refactor.js";
+export { startOnboard } from "./start_onboard.js";
+export { startApi } from "./start_api.js";
+export { startDoc } from "./start_doc.js";

package/build/tools/index.js

@@ -22,3 +22,18 @@ export { cssOrder } from "./css_order.js";
 export { genreadme } from "./genreadme.js";
 export { split } from "./split.js";
 export { analyzeProject } from "./analyze_project.js";
+export { initProjectContext } from "./init_project_context.js";
+export { addFeature } from "./add_feature.js";
+export { securityScan } from "./security_scan.js";
+export { fixBug } from "./fix_bug.js";
+export { estimate } from "./estimate.js";
+export { genMock } from "./gen_mock.js";
+// 智能编排工具
+export { startFeature } from "./start_feature.js";
+export { startBugfix } from "./start_bugfix.js";
+export { startReview } from "./start_review.js";
+export { startRelease } from "./start_release.js";
+export { startRefactor } from "./start_refactor.js";
+export { startOnboard } from "./start_onboard.js";
+export { startApi } from "./start_api.js";
+export { startDoc } from "./start_doc.js";

package/build/tools/init_project.js

@@ -3,6 +3,7 @@ export async function initProject(args) {
     try {
         const input = args?.input || "";
         const projectName = args?.project_name || "新项目";
+        const featureSlug = projectName.toLowerCase().replace(/\s+/g, '-');
         const message = `你需要按照 Spec-Driven Development（规范驱动开发）的方式初始化项目，参考 https://github.com/github/spec-kit 的工作流程。
 
 📋 **项目需求**：
@@ -15,106 +16,150 @@ ${input}
 
 \`\`\`
 .
-├── memory/
-│   └── constitution.md    # 项目宪法（核心原则和约束）
-├── specs/
-│   └── 001-${projectName.toLowerCase().replace(/\s+/g, '-')}/
-│       ├── spec.md        # 功能规格说明
-│       ├── plan.md        # 实现计划
-│       ├── tasks.md       # 任务分解
-│       └── research.md    # 技术调研
+├── docs/
+│   ├── project-context.md           # 项目上下文（技术栈、架构、规范）
+│   ├── constitution.md              # 项目宪法（核心原则和约束）
+│   └── specs/
+│       └── ${featureSlug}/
+│           ├── requirements.md      # 需求文档（EARS 格式）
+│           ├── design.md            # 设计文档
+│           ├── tasks.md             # 任务分解
+│           └── research.md          # 技术调研
 ├── scripts/
 │   ├── check-prerequisites.sh
 │   └── setup.sh
-└── templates/
-    ├── spec-template.md
-    ├── plan-template.md
-    └── tasks-template.md
+└── src/                             # 源代码目录
 \`\`\`
 
-**第二步：生成 constitution.md**
-在 \`memory/constitution.md\` 中定义项目的核心原则，包括：
+**第二步：生成 project-context.md**
+在 \`docs/project-context.md\` 中记录项目的核心信息：
+- 项目概览（名称、版本、类型、描述）
+- 技术栈（语言、框架、构建工具、测试框架）
+- 项目结构（目录说明、入口文件）
+- 架构模式（设计模式、模块划分）
+- 编码规范（代码风格、命名规范）
+- 依赖管理（主要依赖列表）
+- 开发流程（常用命令）
+
+**第三步：生成 constitution.md**
+在 \`docs/constitution.md\` 中定义项目的核心原则：
 - 代码风格规范
 - 架构原则
 - 安全准则
 - 测试要求
 - 文档标准
 
-**第三步：生成 spec.md（功能规格）**
-在 \`specs/001-${projectName.toLowerCase().replace(/\s+/g, '-')}/spec.md\` 中详细描述：
-- 项目背景和目标
-- 用户故事（User Stories）
-- 功能需求
-- 非功能需求
-- 约束条件
-- 验收标准
-
-**第四步：生成 plan.md（实现计划）**
-分析需求并生成实现计划，包括：
-- 技术栈选择（框架、数据库、部署方式等）
-- 系统架构设计
-- 模块划分
-- 数据模型设计
-- API 设计
-- 关键技术决策
-
-**第五步：生成 research.md（技术调研）**
-对选定的技术栈进行调研：
-- 确认版本兼容性
-- 识别潜在风险
-- 记录最佳实践
-- 列出参考文档
-
-**第六步：生成 tasks.md（任务分解）**
-将实现计划分解为可执行的任务，格式如下：
+**第四步：生成 requirements.md（需求文档）**
+在 \`docs/specs/${featureSlug}/requirements.md\` 中详细描述：
+- 功能概述
+- 术语定义
+- 需求列表（使用 EARS 格式）
+  - 用户故事（As a... I want... So that...）
+  - 验收标准（WHEN/WHILE/IF...THEN...SHALL）
+- 非功能需求（性能、安全、兼容性）
+- 依赖关系
+
+**EARS 格式说明**：
+| 模式 | 格式 | 适用场景 |
+|------|------|----------|
+| Ubiquitous | THE [system] SHALL [response] | 始终适用的需求 |
+| Event-driven | WHEN [trigger], THE [system] SHALL [response] | 事件触发的需求 |
+| State-driven | WHILE [condition], THE [system] SHALL [response] | 状态相关的需求 |
+| Unwanted | IF [condition], THEN THE [system] SHALL [response] | 异常处理需求 |
+
+**第五步：生成 design.md（设计文档）**
+在 \`docs/specs/${featureSlug}/design.md\` 中描述：
+- 技术方案（技术选型及理由）
+- 架构设计（系统架构图）
+- 数据模型（数据结构定义）
+- API 设计（接口定义）
+- 文件结构（新增/修改的文件）
+- 设计决策（重要决策及理由）
+- 风险评估
+
+**第六步：生成 research.md（技术调研）**
+在 \`docs/specs/${featureSlug}/research.md\` 中记录：
+- 技术栈调研结果
+- 版本兼容性确认
+- 潜在风险识别
+- 最佳实践记录
+- 参考文档链接
+
+**第七步：生成 tasks.md（任务分解）**
+在 \`docs/specs/${featureSlug}/tasks.md\` 中分解任务：
+
 \`\`\`markdown
-# 任务分解
-
-## 阶段 1：项目初始化
-- [ ] Task 1.1: 搭建项目骨架 (文件: ./setup.sh)
-- [ ] Task 1.2: 配置开发环境 (文件: ./devcontainer.json)
-- [ ] Task 1.3: [P] 初始化数据库 (文件: ./database/schema.sql)
-
-## 阶段 2：核心功能实现
-- [ ] Task 2.1: 实现数据模型 (文件: ./src/models/)
-- [ ] Task 2.2: [P] 实现用户认证 (文件: ./src/auth/)
-- [ ] Task 2.3: [P] 实现业务逻辑 (文件: ./src/services/)
-  依赖: Task 2.1
-
-## 阶段 3：API 开发
-- [ ] Task 3.1: 创建 REST API (文件: ./src/api/)
-  依赖: Task 2.2, Task 2.3
-- [ ] Task 3.2: [P] 编写 API 测试 (文件: ./tests/api/)
-
-## 阶段 4：前端开发
-- [ ] Task 4.1: 搭建前端框架 (文件: ./frontend/)
-- [ ] Task 4.2: [P] 实现 UI 组件 (文件: ./frontend/components/)
-- [ ] Task 4.3: [P] 集成 API (文件: ./frontend/services/)
-  依赖: Task 3.1
-
-## 阶段 5：测试与部署
-- [ ] Task 5.1: 集成测试 (文件: ./tests/integration/)
-- [ ] Task 5.2: 性能测试 (文件: ./tests/performance/)
-- [ ] Task 5.3: 部署配置 (文件: ./deploy/)
+# 任务清单：${projectName}
+
+## 概述
+实现 ${projectName} 的任务分解。
 
 ---
+
+## 任务列表
+
+### 阶段 1: 项目初始化
+- [ ] 1.1 搭建项目骨架
+  - 创建目录结构
+  - 初始化 package.json
+  - _需求: 1.1_
+
+- [ ] 1.2 配置开发环境
+  - 配置 TypeScript/ESLint/Prettier
+  - _需求: 1.1_
+
+### 阶段 2: 核心功能实现
+- [ ] 2.1 实现数据模型
+  - 定义数据结构
+  - _需求: 2.1_
+
+- [ ] 2.2 实现业务逻辑
+  - 核心功能开发
+  - 依赖: 任务 2.1
+  - _需求: 2.2_
+
+### 阶段 3: 集成测试
+- [ ] 3.1 编写测试用例
+  - 单元测试
+  - 集成测试
+  - _需求: 3.1_
+
+---
+
+## 检查点
+- [ ] 阶段 1 完成后：项目可运行
+- [ ] 阶段 2 完成后：核心功能可用
+- [ ] 阶段 3 完成后：测试通过
+
+---
+
+## 文件变更清单
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| src/index.ts | 新建 | 入口文件 |
+| package.json | 新建 | 项目配置 |
+
+---
+
 **标记说明**：
 - [P]: 可以并行执行的任务
 - 依赖: 必须在指定任务完成后才能开始
+- _需求: x.x_: 关联的需求编号
 \`\`\`
 
-**第七步：生成辅助脚本**
+**第八步：生成辅助脚本**
 创建项目管理脚本：
 - \`scripts/check-prerequisites.sh\`: 检查环境依赖
 - \`scripts/setup.sh\`: 自动化项目初始化
-- \`scripts/create-new-feature.sh\`: 创建新功能分支
 
 📝 **注意事项**：
-1. 所有文件使用 Markdown 格式，保持清晰的结构
-2. 遵循项目 constitution 中定义的原则
-3. 任务分解要足够细致，每个任务应该在 2-4 小时内完成
-4. 标记清楚任务之间的依赖关系
-5. 识别可以并行执行的任务以优化开发效率
+1. 所有文档统一放在 \`docs/\` 目录下
+2. 功能规格放在 \`docs/specs/{feature-name}/\` 目录
+3. 所有文件使用 Markdown 格式，保持清晰的结构
+4. 遵循项目 constitution 中定义的原则
+5. 任务分解要足够细致，每个任务应该在 2-4 小时内完成
+6. 标记清楚任务之间的依赖关系
+7. 识别可以并行执行的任务以优化开发效率
 
 🚀 **开始执行**：
 现在请按照上述步骤创建项目结构和所有必需的文档。`;

package/build/tools/init_project_context.d.ts

@@ -0,0 +1,26 @@
+/**
+ * init_project_context 工具
+ *
+ * 功能：生成项目上下文文档，帮助 AI 理解项目的技术栈、架构和规范
+ * 模式：指令生成器模式 - 返回详细的分析指南，由 AI 执行实际操作
+ */
+/**
+ * init_project_context 工具实现
+ *
+ * @param args - 工具参数
+ * @param args.docs_dir - 文档目录，默认 "docs"
+ * @returns MCP 响应，包含项目分析指南
+ */
+export declare function initProjectContext(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;