mta-mcp 1.0.0

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "mta-mcp",
+  "version": "1.0.0",
+  "description": "MTA - 智能项目分析与编码规范管理 MCP 服务器",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "mta": "./bin/mta.cjs",
+    "mta-mcp": "./bin/mta.cjs"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "standards/",
+    "agents/",
+    "common/",
+    "templates/",
+    "troubleshooting/",
+    "README.md"
+  ],
+  "scripts": {
+    "sync": "bash scripts/sync-resources.sh",
+    "build": "npm run sync && tsup",
+    "watch": "tsup --watch",
+    "start": "node bin/mta.js",
+    "dev": "tsup --watch",
+    "prepare": "npm run build",
+    "clean": "rm -rf dist build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run sync && npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "copilot",
+    "github-copilot",
+    "claude",
+    "ai",
+    "agents",
+    "coding-standards",
+    "project-analysis",
+    "typescript",
+    "vue",
+    "react"
+  ],
+  "author": "ForLear",
+  "license": "MIT",
+  "homepage": "https://github.com/ForLear/copilot-prompts#readme",
+  "bugs": {
+    "url": "https://github.com/ForLear/copilot-prompts/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.3",
+    "axios": "^1.6.5",
+    "fast-glob": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "tsup": "^8.5.1",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ForLear/copilot-prompts.git",
+    "directory": "mcp-server"
+  }
+}

package/standards/README.md

@@ -0,0 +1,194 @@
+# 规范目录索引
+
+## ⚠️ 编写新规范的强制要求
+
+**创建任何新的标准规范文件前，必须：**
+
+1. **加载现有规范** - 先查看同类规范的编写方式
+   ```
+   get_relevant_standards({ scenario: "规范编写" })
+   ```
+
+2. **确保每个规范文件包含强制工作流说明**
+   - 在文档开头添加 `## ⚠️ 强制工作流` 章节
+   - 说明何时必须先调用 `get_relevant_standards`
+   - 提供具体的调用示例
+
+3. **验证规范结构**
+   - 包含清晰的使用场景说明
+   - 提供正确/错误示例对比
+   - 标注 Token 大小和预计加载时间
+
+**示例模板：**
+```markdown
+# 新框架规范
+
+## ⚠️ 强制工作流
+**在使用此框架编写代码前，必须调用：**
+\`\`\`
+get_relevant_standards({ imports: ["framework-name"] })
+\`\`\`
+
+## 核心原则
+...
+```
+
+---
+
+## 📁 目录结构
+
+```
+standards/
+├── core/                    # 核心规范（总是包含）
+│   ├── code-style.md        # 代码风格规范
+│   └── typescript-base.md   # TypeScript 基础
+│
+├── frameworks/              # 框架规范（按需加载）
+│   ├── vue3-composition.md  # Vue 3 Composition API
+│   └── pinia.md             # Pinia 状态管理
+│
+├── libraries/               # 库规范（按需加载）
+│   ├── element-plus.md      # Element Plus
+│   └── i18n.md              # 国际化
+│
+├── patterns/                # 设计模式（智能推荐）
+│   ├── api-layer.md         # API 层设计
+│   └── component-design.md  # 组件设计模式
+│
+└── workflows/               # 工作流规范（场景触发）
+    └── large-project-split.md  # 大型项目文档拆分
+```
+
+## 🎯 规范分类
+
+### Core (核心规范)
+始终包含的基础规范
+
+| 文件 | 大小 | 说明 |
+|------|------|------|
+| code-style.md | ~2KB | 命名、注释、代码组织 |
+| typescript-base.md | ~3KB | TS 基础类型、函数、泛型 |
+| dart-base.md | ~5KB | Dart 基础、空安全、异步编程 |
+
+### Frameworks (框架规范)
+根据项目框架按需加载
+
+| 文件 | 技术栈 | 触发条件 |
+|------|--------|----------|
+| vue3-composition.md | Vue 3 | import vue |
+| pinia.md | Pinia | import pinia |
+| flutter.md | Flutter | import flutter, .dart 文件 |
+| wechat-miniprogram.md | 微信小程序 | import wx, .js/.wxml/.wxss 文件 |
+
+### Libraries (库规范)
+根据使用的库按需加载
+
+| 文件 | 库名称 | 触发条件 |
+|------|--------|----------|
+| element-plus.md | Element Plus | import element-plus |
+| i18n.md | Vue I18n | import vue-i18n |
+
+### Patterns (设计模式)
+根据任务类型智能推荐
+
+| 文件 | 场景 | 触发词 |
+|------|------|--------|
+| api-layer.md | API 调用 | API, axios, request |
+| component-design.md | 组件设计 | component, props, emit |
+| vue-css-nesting.md | Vue CSS 嵌套写法 | style, css, scoped |
+| vue-api-mock-layer.md | Vue API Mock 层 | mock, api |
+
+### Workflows (工作流规范)
+根据项目规模和场景触发
+
+| 文件 | 场景 | 触发条件 |
+|------|------|----------|
+| large-project-split.md | 大型项目文档拆分 | 页面数>30, 模块>5, 原型分析 |
+| problem-diagnosis.md | 问题诊断与修复 | 修复 Bug、样式问题、异常排查 |
+
+## 🔧 使用示例
+
+### 场景 1: 创建 Vue 3 组件
+**加载规范:**
+- core/code-style.md
+- core/typescript-base.md
+- frameworks/vue3-composition.md
+- patterns/component-design.md
+
+**预计 Token:** ~8KB (vs 传统 20KB)
+
+### 场景 2: Pinia Store
+**加载规范:**
+- core/typescript-base.md
+- frameworks/vue3-composition.md
+- frameworks/pinia.md
+
+**预计 Token:** ~6KB (vs 传统 20KB)
+
+### 场景 3: Element Plus 表单
+**加载规范:**
+- core/code-style.md
+- frameworks/vue3-composition.md
+- libraries/element-plus.md
+- libraries/i18n.md
+
+**预计 Token:** ~9KB (vs 传统 20KB)
+
+## 📊 Token 节省对比
+
+| 传统方式 | MCP 方案 | 节省 |
+|---------|---------|------|
+| 20KB (全量) | 6-10KB (按需) | 50-70% |
+
+## 🎨 匹配规则
+
+```typescript
+// 规范匹配配置
+export const standardsMapping = {
+  // 框架检测
+  frameworks: {
+    vue3: {
+      imports: ['vue', '@vue'],
+      files: ['.vue'],
+      standards: ['vue3-composition']
+    },
+    pinia: {
+      imports: ['pinia'],
+      standards: ['pinia']
+    }
+  },
+  
+  // 库检测
+  libraries: {
+    'element-plus': {
+      imports: ['element-plus'],
+      standards: ['element-plus']
+    },
+    'vue-i18n': {
+      imports: ['vue-i18n'],
+      standards: ['i18n']
+    }
+  },
+  
+  // 模式检测
+  patterns: {
+    api: {
+      keywords: ['api', 'axios', 'request', 'fetch'],
+      standards: ['api-layer']
+    },
+    component: {
+      keywords: ['component', 'props', 'emit'],
+      standards: ['component-design']
+    }
+  },
+  
+  // 工作流检测
+  workflows: {
+    'large-project': {
+      keywords: ['原型', '设计稿', '页面拆分', '模块规划', '开发计划', '大型项目'],
+      conditions: ['页面数>30', '模块>5'],
+      standards: ['large-project-split']
+    }
+  }
+}
+```

package/standards/core/code-generation.md

@@ -0,0 +1,421 @@
+# 代码生成规范（v1.3.0 更新）
+
+## 核心原则
+
+生成代码时必须遵循以下原则：
+
+### 1. 禁止创建 Markdown 文档（v1.3.0 强制规则）
+
+**⚠️ 除非用户明确要求，否则不要创建任何 .md 文件**
+
+```
+❌ 禁止自动创建：
+- USAGE.md
+- GUIDE.md
+- CHANGES.md
+- CHANGELOG.md
+- API.md
+- NOTES.md
+- INSTRUCTIONS.md
+- SETUP.md
+- 任何其他文档文件
+
+✅ 允许创建（仅在明确要求时）：
+- README.md（项目初始化时或用户明确要求）
+- 用户明确说"生成文档"、"创建说明"、"写一个配置文档"
+- 修改现有的文档文件
+```
+
+**原因：**
+- 代码注释已经足够说明用途
+- 避免文档与代码不同步
+- 减少维护负担
+- 保持项目目录清洁
+
+**正确做法：**
+```typescript
+// ✅ 在代码中添加详细注释
+/**
+ * 用户服务类
+ * 
+ * 使用方法：
+ * 1. 导入：import { UserService } from './userService'
+ * 2. 创建实例：const service = new UserService()
+ * 3. 调用方法：await service.getUser(userId)
+ */
+class UserService {
+  // 实现...
+}
+```
+
+### 2. 注释格式规范（v1.3.0 强制规则）
+
+**⚠️ TypeScript/JavaScript 中单行注释必须使用 `//`**
+
+```typescript
+// ✅ 正确：单行注释使用 //
+// 使用缓存避免重复请求
+const cachedData = cache.get(key)
+
+// ✅ 正确：多行文档注释使用 /** */
+/**
+ * 获取用户信息
+ * @param userId 用户ID
+ * @returns 用户信息对象
+ */
+function getUserInfo(userId: number) {}
+
+// ❌ 错误：单行注释不要使用 /** */
+/** 使用缓存避免重复请求 */
+const cachedData = cache.get(key)
+```
+
+**注释必须清晰且有意义：**
+```typescript
+// ✅ 好：说明为什么
+// 使用 WeakMap 避免内存泄漏
+const cache = new WeakMap()
+
+// ❌ 坏：重复代码
+// 创建 WeakMap
+const cache = new WeakMap()
+
+// ❌ 坏：无意义的注释
+// 定义变量
+const count = 0
+```
+
+### 3. 重要代码必须添加注释
+
+所有重要代码部分都需要注释：
+
+#### 必须注释的场景
+
+```typescript
+// 1. 复杂算法
+// 使用快速排序算法，平均时间复杂度 O(n log n)
+function quickSort(arr: number[]): number[] {
+  if (arr.length <= 1) return arr
+  
+  const pivot = arr[0]
+  const left = arr.slice(1).filter(x => x <= pivot)
+  const right = arr.slice(1).filter(x => x > pivot)
+  
+  return [...quickSort(left), pivot, ...quickSort(right)]
+}
+
+// 2. 业务规则
+// 新用户享有 7 天免费试用期
+function getTrialEndDate(user: User): Date {
+  const createdDate = new Date(user.createdAt)
+  createdDate.setDate(createdDate.getDate() + 7)
+  return createdDate
+}
+
+// 3. 性能优化
+// 使用节流避免频繁触发搜索请求
+const throttledSearch = throttle((keyword: string) => {
+  searchAPI(keyword)
+}, 300)
+
+// 4. 边界条件处理
+function divide(a: number, b: number): number {
+  // 防止除零错误
+  if (b === 0) {
+    throw new Error('除数不能为零')
+  }
+  return a / b
+}
+
+// 5. 重要状态变更
+// 标记订单为已完成，触发后续流程
+function completeOrder(orderId: string) {
+  updateOrderStatus(orderId, 'completed')
+  notifyUser(orderId)
+  updateInventory(orderId)
+}
+
+// 6. API 集成
+// 调用第三方支付接口，超时时间 30 秒
+async function processPayment(order: Order): Promise<PaymentResult> {
+  return await paymentGateway.charge({
+    amount: order.total,
+    timeout: 30000
+  })
+}
+
+// 7. 数据转换
+// 将后端返回的下划线命名转换为驼峰命名
+function transformResponse(data: any) {
+  return Object.keys(data).reduce((acc, key) => {
+    const camelKey = key.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase())
+    acc[camelKey] = data[key]
+    return acc
+  }, {})
+}
+```
+
+#### 可选注释的场景
+
+```typescript
+// 简单明了的代码可以不注释
+function add(a: number, b: number): number {
+  return a + b
+}
+
+// getter/setter 通常不需要注释
+get fullName(): string {
+  return `${this.firstName} ${this.lastName}`
+}
+
+// 自解释的变量名不需要注释
+const isUserLoggedIn = checkLoginStatus()
+const hasPermission = user.role === 'admin'
+```
+
+### 3. 注释风格：去 AI 化
+
+#### 禁止使用
+
+```typescript
+// ❌ 表情符号
+// 🎉 欢迎使用这个超棒的函数！
+// ✨ 神奇的代码来了～
+// 🔥 超级厉害的实现！
+// ⚠️ 请注意这里哦～
+
+// ❌ 过度热情的语气
+// 哇！这个功能太酷了！
+// 太棒了！让我们开始吧～
+// 注意啦！这里超级重要！
+
+// ❌ 口语化表达
+// 这里稍微有点复杂哈
+// 大家注意下这个地方～
+// 这块儿需要好好看看
+
+// ❌ AI 式套话
+// 让我来帮你实现这个功能
+// 我将为您创建一个...
+// 下面是一个很好的例子
+```
+
+#### 正确使用
+
+```typescript
+// ✅ 专业简洁
+// 验证用户输入
+// 处理异步请求
+// 更新缓存数据
+
+// ✅ 说明原因
+// 使用 Map 提高查询性能
+// 避免循环依赖
+// 兼容 IE11
+
+// ✅ 描述技术细节
+// 实现深拷贝，避免引用共享
+// 使用二进制搜索，时间复杂度 O(log n)
+// 采用观察者模式解耦组件
+
+// ✅ 警告潜在问题
+// 注意：此操作会修改原数组
+// 仅在开发环境使用
+// 依赖外部配置文件
+```
+
+### 4. 注释的数量和质量
+
+#### 平衡注释密度
+
+```typescript
+// ❌ 过少注释
+function processData(data) {
+  const filtered = data.filter(x => x.status === 'active')
+  const sorted = filtered.sort((a, b) => b.priority - a.priority)
+  const grouped = sorted.reduce((acc, item) => {
+    const key = item.category
+    if (!acc[key]) acc[key] = []
+    acc[key].push(item)
+    return acc
+  }, {})
+  return Object.entries(grouped).map(([category, items]) => ({
+    category,
+    items,
+    total: items.reduce((sum, i) => sum + i.value, 0)
+  }))
+}
+
+// ✅ 适当注释
+function processData(data: Item[]): CategorySummary[] {
+  // 只处理激活状态的数据
+  const filtered = data.filter(x => x.status === 'active')
+  
+  // 按优先级降序排序
+  const sorted = filtered.sort((a, b) => b.priority - a.priority)
+  
+  // 按类别分组
+  const grouped = sorted.reduce((acc, item) => {
+    const key = item.category
+    if (!acc[key]) acc[key] = []
+    acc[key].push(item)
+    return acc
+  }, {} as Record<string, Item[]>)
+  
+  // 生成每个类别的汇总信息
+  return Object.entries(grouped).map(([category, items]) => ({
+    category,
+    items,
+    total: items.reduce((sum, i) => sum + i.value, 0)
+  }))
+}
+
+// ❌ 过度注释（废话）
+function calculateTotal(items: Item[]): number {
+  // 初始化总和为 0
+  let total = 0
+  
+  // 遍历每个项目
+  for (const item of items) {
+    // 将项目的价格加到总和
+    total += item.price
+  }
+  
+  // 返回计算出的总和
+  return total
+}
+
+// ✅ 简洁明了
+function calculateTotal(items: Item[]): number {
+  return items.reduce((sum, item) => sum + item.price, 0)
+}
+```
+
+## 实践指南
+
+### 代码生成工作流
+
+1. **分析需求** - 理解用户要求
+2. **编写代码** - 实现功能逻辑
+3. **添加注释** - 为重要部分添加说明
+4. **自查** - 确认没有创建不必要的文档文件
+5. **去 AI 化** - 检查注释风格是否专业
+
+### 检查清单
+
+生成代码前检查：
+
+- [ ] 是否只创建了必要的代码文件？
+- [ ] 是否避免了创建 .md 文档？
+- [ ] 重要逻辑是否有注释说明？
+- [ ] 注释是否去除了表情符号？
+- [ ] 注释是否使用专业简洁的语言？
+- [ ] 注释是否说明了"为什么"而非"是什么"？
+
+### 示例对比
+
+#### 错误示例
+
+```typescript
+// 生成了不必要的文档
+文件结构：
+├── UserService.ts
+├── USAGE.md          ❌ 不要创建
+└── API_GUIDE.md      ❌ 不要创建
+
+// UserService.ts
+// 🎉 用户服务类来啦～
+class UserService {
+  // 超级厉害的登录方法！
+  login() {}
+}
+```
+
+#### 正确示例
+
+```typescript
+// 只生成必要的代码文件
+文件结构：
+└── UserService.ts
+
+// UserService.ts
+/**
+ * 用户服务类
+ * 处理用户认证、信息管理等核心业务逻辑
+ */
+class UserService {
+  /**
+   * 用户登录
+   * @param credentials 登录凭证
+   * @returns 登录结果，包含用户信息和 token
+   * @throws 当凭证无效时抛出 AuthenticationError
+   */
+  async login(credentials: Credentials): Promise<LoginResult> {
+    // 验证凭证格式
+    this.validateCredentials(credentials)
+    
+    // 调用认证服务
+    const result = await authService.authenticate(credentials)
+    
+    // 缓存用户信息
+    this.cacheUserInfo(result.user)
+    
+    return result
+  }
+  
+  // 验证登录凭证格式
+  private validateCredentials(credentials: Credentials): void {
+    if (!credentials.username || !credentials.password) {
+      throw new ValidationError('用户名和密码不能为空')
+    }
+  }
+  
+  // 缓存用户信息到本地存储
+  private cacheUserInfo(user: User): void {
+    localStorage.setItem('user', JSON.stringify(user))
+  }
+}
+```
+
+## 常见问题
+
+### Q: 什么时候可以创建文档？
+
+A: 仅在以下情况：
+- 用户明确说"创建一个 README"
+- 项目初始化需要项目说明
+- 修改现有的文档文件
+
+### Q: 简单的代码也要注释吗？
+
+A: 不需要。如果代码本身就很清晰，不要添加废话注释。
+
+### Q: 如何判断注释是否"AI 化"？
+
+A: 检查是否包含：
+- 表情符号（🎉 ✨ 🔥 ⚠️ 等）
+- 过度热情的语气（"太棒了"、"超级"、"哇"）
+- AI 式套话（"让我来"、"我将为您"）
+
+### Q: 英文项目的注释也要遵循这些规则吗？
+
+A: 是的。无论中英文，都要保持专业简洁的风格。
+
+```typescript
+// ✅ 英文注释示例
+// Cache results to improve performance
+// Handle edge case when array is empty
+// Validate input before processing
+
+// ❌ 避免
+// 🎉 Awesome function here!
+// Let me help you with this amazing feature!
+```
+
+## 总结
+
+核心要点：
+1. **不要创建文档** - 除非明确要求
+2. **充分注释** - 重要代码必须说明
+3. **专业风格** - 去除表情符号和 AI 化语气
+4. **简洁明了** - 说明原因而非重复代码