mta-mcp 3.0.0 → 3.1.0

package/agents/flutter.agent.md

@@ -128,5 +128,22 @@ get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
 
 ---
 
+## 🚀 Skills 工具（扩展能力）
+
+MTA 已集成以下 Skills，可直接调用：
+
+| 工具 | 用途 | 调用示例 |
+|------|------|----------|
+| `http_request` | 发送 HTTP 请求（API 测试） | `http_request({ url: "https://api.example.com/data", method: "GET" })` |
+| `list_skills` | 查看所有可用 Skills | `list_skills()` |
+
+### 使用场景
+
+- 测试后端 API 接口
+- 获取外部数据进行分析
+- 验证 API 响应格式
+
+---
+
 **维护团队**: MTA工作室  
 **设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/agents/vue3.agent.md

@@ -159,5 +159,22 @@ get_standard_by_id({ ids: ['vue3-composition', 'element-plus', 'i18n'] })
 
 ---
 
+## 🚀 Skills 工具（扩展能力）
+
+MTA 已集成以下 Skills，可直接调用：
+
+| 工具 | 用途 | 调用示例 |
+|------|------|----------|
+| `http_request` | 发送 HTTP 请求（API 测试） | `http_request({ url: "https://api.example.com/users", method: "GET" })` |
+| `list_skills` | 查看所有可用 Skills | `list_skills()` |
+
+### 使用场景
+
+- 需要测试后端接口时，直接调用 `http_request` 发送请求
+- 获取外部 API 数据进行分析
+- 验证接口返回格式是否正确
+
+---
+
 **维护团队**: MTA工作室  
 **设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/bin/mta.cjs

@@ -69,6 +69,11 @@ if (args.includes('--list-agents')) {
   const files = readdirSync(agentsDir).filter(f => f.endsWith('.agent.md') && !f.endsWith('.bak'));
   
   for (const file of files) {
+    // 跳过 mta.agent（内部使用，不对外暴露）
+    if (file === 'mta.agent.md') {
+      continue;
+    }
+    
     try {
       const content = readFileSync(join(agentsDir, file), 'utf-8');
       const lines = content.split('\n');
@@ -115,6 +120,99 @@ if (args.includes('--list-agents')) {
   process.exit(0);
 }
 
+// --list-skills: 列出所有 Skills（供 VSCode 插件调用）
+if (args.includes('--list-skills')) {
+  const skillsPath = join(packageRoot, 'skills.json');
+  
+  if (!existsSync(skillsPath)) {
+    console.log(JSON.stringify({ error: 'skills.json 不存在', skills: [] }));
+    process.exit(1);
+  }
+  
+  try {
+    const registry = JSON.parse(readFileSync(skillsPath, 'utf-8'));
+    const skills = Object.entries(registry.skills).map(([id, config]) => ({
+      id,
+      ...config
+    }));
+    
+    console.log(JSON.stringify({
+      version: registry.version,
+      lastCheck: registry.lastCheck,
+      skills,
+      categories: registry.categories
+    }, null, 2));
+  } catch (e) {
+    console.log(JSON.stringify({ error: `读取 Skills 失败: ${e.message}`, skills: [] }));
+    process.exit(1);
+  }
+  
+  process.exit(0);
+}
+
+// --check-skills: 检测 Skills 版本
+if (args.includes('--check-skills')) {
+  // tsup 保留目录结构：dist/skills/versionChecker.js
+  const esmPath = join(packageRoot, 'dist', 'skills', 'versionChecker.js');
+  
+  if (!existsSync(esmPath)) {
+    console.error('[MCP Error] Skills 模块未构建，请运行: npm run build');
+    process.exit(1);
+  }
+  
+  const esmUrl = pathToFileURL(esmPath).href;
+  import(esmUrl).then(async (mod) => {
+    const results = await mod.checkSkillsVersions();
+    console.log(mod.formatVersionCheckResult(results));
+    process.exit(0);
+  }).catch(err => {
+    console.error('[MCP Error] 检测失败:', err.message);
+    process.exit(1);
+  });
+  
+  // 阻止继续执行
+  return;
+}
+
+// --update-skills [skill-id]: 更新 Skills 版本
+const updateSkillsIndex = args.indexOf('--update-skills');
+if (updateSkillsIndex !== -1) {
+  const skillId = args[updateSkillsIndex + 1];
+  // tsup 保留目录结构：dist/skills/versionChecker.js
+  const esmPath = join(packageRoot, 'dist', 'skills', 'versionChecker.js');
+  
+  if (!existsSync(esmPath)) {
+    console.error('[MCP Error] Skills 模块未构建，请运行: npm run build');
+    process.exit(1);
+  }
+  
+  const esmUrl = pathToFileURL(esmPath).href;
+  import(esmUrl).then(async (mod) => {
+    const skillIds = skillId ? [skillId] : undefined;
+    const result = await mod.updateSkillsVersions(skillIds);
+    
+    if (result.updated.length > 0) {
+      console.log(`✅ 已更新 ${result.updated.length} 个 Skills:`);
+      result.updated.forEach(id => console.log(`   - ${id}`));
+    } else {
+      console.log('✅ 所有 Skills 已是最新版本');
+    }
+    
+    if (result.failed.length > 0) {
+      console.log(`⚠️  ${result.failed.length} 个 Skills 更新失败:`);
+      result.failed.forEach(id => console.log(`   - ${id}`));
+    }
+    
+    process.exit(0);
+  }).catch(err => {
+    console.error('[MCP Error] 更新失败:', err.message);
+    process.exit(1);
+  });
+  
+  // 阻止继续执行
+  return;
+}
+
 // 默认行为：启动 MCP 服务器
 const esmPath = join(packageRoot, 'dist', 'index.js');