mta-mcp 3.1.0 → 3.2.1

package/agents/_TEMPLATE.md

@@ -87,6 +87,32 @@ get_compact_standards({ currentFile: "当前文件路径" })
 
 ---
 
+## 🛠️ 增强工具使用指南
+
+> MTA 集成了以下增强工具，在特定场景下应主动使用
+
+### 知识图谱记忆
+
+当需要跨会话记住信息时使用：
+
+| 场景 | 工具调用 |
+|------|----------|
+| 记住用户偏好/项目信息 | \`create_entities + add_observations\` |
+| 查询历史记忆 | \`search_nodes\` 或 \`read_graph\` |
+| 建立概念关联 | \`create_relations\` |
+
+### 顺序思考
+
+当面对复杂问题时使用：
+
+| 场景 | 工具调用 |
+|------|----------|
+| 复杂问题分解 | \`sequentialthinking\` |
+| 多步骤规划 | \`sequentialthinking\` |
+| 需要修订推理 | \`sequentialthinking({ isRevision: true })\` |
+
+---
+
 **维护团队**: MTA工作室  
 **设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取
 ```

package/agents/flutter.agent.md

@@ -109,6 +109,22 @@ get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
 
 > ⚠️ 详细规范请调用：`get_standard_by_id({ id: 'design-restoration' })`
 
+### 核心原则：测量 + 计算
+
+**绝不直接使用测量数据！必须分析计算后再转换为代码参数。**
+
+```
+测量 → 分析（理解设计意图） → 计算（转换参数） → 编码
+```
+
+### 配合 Sketch MCP 使用测量模板
+
+| 场景 | 模板 | 计算示例 |
+|------|------|---------|
+| 行高 | `component-measurement.js` | `height = 文本高度/字号 = 20/14 = 1.43` |
+| 间距 | `gap-measurement.js` | 检测是否统一间距 → 用 `Gap()` |
+| 居中 | 计算上下边距 | 相等则用 `Alignment.center` |
+
 ### 快速提示
 
 | 关键点 | 说明 |
@@ -128,20 +144,26 @@ get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
 
 ---
 
-## 🚀 Skills 工具（扩展能力）
+## 🧠 增强工具使用指南
 
-MTA 已集成以下 Skills，可直接调用：
+> MTA 集成了 Memory 和 Sequential Thinking 能力，可在复杂场景中使用
 
-| 工具 | 用途 | 调用示例 |
-|------|------|----------|
-| `http_request` | 发送 HTTP 请求（API 测试） | `http_request({ url: "https://api.example.com/data", method: "GET" })` |
-| `list_skills` | 查看所有可用 Skills | `list_skills()` |
+### 知识图谱记忆（mcp_memory_*）
 
-### 使用场景
+| 场景 | 推荐工具 | 用法 |
+|------|----------|------|
+| 记录项目偏好 | `mcp_memory_create_entities` | 创建实体保存用户偏好、项目配置 |
+| 关联技术栈 | `mcp_memory_create_relations` | 建立实体间关系（项目→使用→框架） |
+| 查找历史 | `mcp_memory_search_nodes` | 搜索之前记录的信息 |
+| 获取完整上下文 | `mcp_memory_read_graph` | 读取整个知识图谱 |
 
-- 测试后端 API 接口
-- 获取外部数据进行分析
-- 验证 API 响应格式
+### 顺序思考（mcp_sequential-th_sequentialthinking）
+
+| 场景 | 何时使用 |
+|------|----------|
+| 复杂架构设计 | 需要多步骤推理时 |
+| 疑难问题诊断 | 问题原因不明确时 |
+| 大型重构规划 | 需要系统性思考时 |
 
 ---
 

package/agents/i18n.agent.md

@@ -74,5 +74,26 @@ get_compact_standards({ currentFile: "xxx.vue", scenario: "国际化" })
 
 ---
 
+## 🧠 增强工具使用指南
+
+> MTA 集成了 Memory 和 Sequential Thinking 能力，可在复杂场景中使用
+
+### 知识图谱记忆（mcp_memory_*）
+
+| 场景 | 推荐工具 | 用法 |
+|------|----------|------|
+| 记录翻译偏好 | `mcp_memory_create_entities` | 保存项目的翻译规范、术语表 |
+| 关联语言包 | `mcp_memory_create_relations` | 建立键名与翻译的关系 |
+| 查找术语 | `mcp_memory_search_nodes` | 搜索之前定义的术语 |
+
+### 顺序思考（mcp_sequential-th_sequentialthinking）
+
+| 场景 | 何时使用 |
+|------|----------|
+| 批量提取翻译键 | 需要系统性整理时 |
+| 多语言一致性检查 | 需要全面验证时 |
+
+---
+
 **维护团队**: MTA工作室  
 **设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/agents/logicflow.agent.md

@@ -93,5 +93,27 @@ register({
 
 ---
 
+## 🧠 增强工具使用指南
+
+> MTA 集成了 Memory 和 Sequential Thinking 能力，可在复杂场景中使用
+
+### 知识图谱记忆（mcp_memory_*）
+
+| 场景 | 推荐工具 | 用法 |
+|------|----------|------|
+| 记录节点配置 | `mcp_memory_create_entities` | 保存自定义节点类型、连线规则 |
+| 关联流程结构 | `mcp_memory_create_relations` | 建立节点间的业务关系 |
+| 查找节点定义 | `mcp_memory_search_nodes` | 搜索之前定义的节点模式 |
+
+### 顺序思考（mcp_sequential-th_sequentialthinking）
+
+| 场景 | 何时使用 |
+|------|----------|
+| 流程逻辑设计 | 需要设计复杂业务流程时 |
+| 节点类型规划 | 需要系统性设计节点体系时 |
+| 连线规则分析 | 需要验证流程正确性时 |
+
+---
+
 **维护团队**: MTA工作室  
 **设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/agents/mta.agent.md

@@ -94,6 +94,22 @@ MTA 不是传统的"编码规范管理器"，而是一个**智能编码助手技
 | `list_templates` | 列出可用模板 | 查看有哪些模板 |
 | `get_template` | 获取模板内容 | 应用特定模板 |
 
+### 知识图谱记忆类（Memory）
+
+| 工具 | 用途 | 何时调用 |
+|------|------|---------|
+| `create_entities` | 创建记忆实体 | 需要跨会话记住信息 |
+| `add_observations` | 添加观察/事实 | 补充实体信息 |
+| `search_nodes` | 搜索记忆 | 查询历史信息 |
+| `read_graph` | 读取全部记忆 | 了解完整上下文 |
+| `create_relations` | 建立关联 | 连接概念/实体 |
+
+### 顺序思考类（Thinking）
+
+| 工具 | 用途 | 何时调用 |
+|------|------|---------|
+| `sequentialthinking` | 分步推理 | 复杂问题分解、多步规划 |
+
 ---
 
 ## 📁 知识库结构
@@ -187,6 +203,25 @@ agents/                    # 开发引导 Agent
 2. 填充框架特定的规范 ID
 3. 添加简要快速提示（10-20行）
 4. 详细规范放入 standards/ 目录
+5. ⚠️ 必须包含"增强工具使用指南"章节（见模板）
+```
+
+**增强工具使用指南**（所有 Agent 必须包含）：
+
+```markdown
+## 🛠️ 增强工具使用指南
+
+### 知识图谱记忆
+| 场景 | 工具调用 |
+|------|----------|
+| 记住用户偏好/项目信息 | \`create_entities + add_observations\` |
+| 查询历史记忆 | \`search_nodes\` 或 \`read_graph\` |
+
+### 顺序思考
+| 场景 | 工具调用 |
+|------|----------|
+| 复杂问题分解 | \`sequentialthinking\` |
+| 多步骤规划 | \`sequentialthinking\` |
 ```
 
 ### 添加问题诊断案例时

package/agents/vue3.agent.md

@@ -159,20 +159,26 @@ get_standard_by_id({ ids: ['vue3-composition', 'element-plus', 'i18n'] })
 
 ---
 
-## 🚀 Skills 工具（扩展能力）
+## 🧠 增强工具使用指南
 
-MTA 已集成以下 Skills，可直接调用：
+> MTA 集成了 Memory 和 Sequential Thinking 能力，可在复杂场景中使用
 
-| 工具 | 用途 | 调用示例 |
-|------|------|----------|
-| `http_request` | 发送 HTTP 请求（API 测试） | `http_request({ url: "https://api.example.com/users", method: "GET" })` |
-| `list_skills` | 查看所有可用 Skills | `list_skills()` |
+### 知识图谱记忆（mcp_memory_*）
 
-### 使用场景
+| 场景 | 推荐工具 | 用法 |
+|------|----------|------|
+| 记录项目偏好 | `mcp_memory_create_entities` | 创建实体保存用户偏好、项目配置 |
+| 关联技术栈 | `mcp_memory_create_relations` | 建立实体间关系（项目→使用→框架） |
+| 查找历史 | `mcp_memory_search_nodes` | 搜索之前记录的信息 |
+| 获取完整上下文 | `mcp_memory_read_graph` | 读取整个知识图谱 |
 
-- 需要测试后端接口时，直接调用 `http_request` 发送请求
-- 获取外部 API 数据进行分析
-- 验证接口返回格式是否正确
+### 顺序思考（mcp_sequential-th_sequentialthinking）
+
+| 场景 | 何时使用 |
+|------|----------|
+| 复杂架构设计 | 需要多步骤推理时 |
+| 疑难问题诊断 | 问题原因不明确时 |
+| 大型重构规划 | 需要系统性思考时 |
 
 ---
 

package/agents/wechat-miniprogram.agent.md

@@ -108,5 +108,27 @@ miniprogram/
 
 ---
 
+## 🧠 增强工具使用指南
+
+> MTA 集成了 Memory 和 Sequential Thinking 能力，可在复杂场景中使用
+
+### 知识图谱记忆（mcp_memory_*）
+
+| 场景 | 推荐工具 | 用法 |
+|------|----------|------|
+| 记录项目配置 | `mcp_memory_create_entities` | 保存小程序配置、API 接口信息 |
+| 关联页面结构 | `mcp_memory_create_relations` | 建立页面间的跳转关系 |
+| 查找配置 | `mcp_memory_search_nodes` | 搜索之前记录的配置信息 |
+
+### 顺序思考（mcp_sequential-th_sequentialthinking）
+
+| 场景 | 何时使用 |
+|------|----------|
+| 页面架构设计 | 需要规划多页面应用时 |
+| 性能优化分析 | 需要系统性排查性能问题时 |
+| 业务逻辑梳理 | 需要理清复杂业务流程时 |
+
+---
+
 **维护团队**: MTA工作室  
 **设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/bin/mta.cjs

@@ -69,11 +69,6 @@ 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');
@@ -120,99 +115,6 @@ 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');