mta-mcp 2.17.0 → 3.0.0

package/agents/flutter.agent.md

@@ -1,7 +1,7 @@
 # Flutter 开发代理
 
 > 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
-> 版本: v3.1.0 | 最后更新: 2026-01-19
+> 版本: v3.2.0 | 最后更新: 2026-01-21
 
 ---
 
@@ -22,41 +22,10 @@ troubleshoot({ problem: "用户描述的问题" })
 | 阴影被裁剪 | clip, shadow, clipBehavior |
 | SVG 颜色/居中问题 | svg, color, viewbox |
 | 输入框边框异常 | input, border, focus |
-| **TextField 垂直居中** | textfield, placeholder, 居中, 光标, 输入框 |
+| TextField 垂直居中 | textfield, placeholder, 居中, 光标, 输入框 |
+| **Tab 嵌套导航** | tabbar, navigator, 返回无效, tab切换卡顿, 嵌套 |
 
----
-
-## ⚠️ TextField 垂直居中（高频问题）
-
-> 此问题曾导致 15+ 轮对话才修复，必须一步到位
-
-### 问题特征
-- placeholder 和输入内容位置不一致
-- 光标位置偏上/偏下
-- 修改一个问题引发另一个问题
-
-### 正确方案（直接使用）
-
-```dart
-Container(
-  height: 36, // 设计稿容器高度
-  alignment: Alignment.center, // 关键1
-  child: TextField(
-    style: TextStyle(fontSize: 14, height: 1.43), // 关键2: 行高 = 文本高度÷字号
-    decoration: InputDecoration(
-      hintStyle: TextStyle(fontSize: 14, height: 1.43), // 关键3: 必须与style一致
-      contentPadding: EdgeInsets.zero, // 关键4
-      isDense: true, // 关键5
-    ),
-  ),
-)
-```
-
-### 禁止事项
-- ❌ `style.height` ≠ `hintStyle.height`
-- ❌ 同时用 `textAlignVertical` 和 `height`
-- ❌ 用 `strutStyle + forceStrutHeight`
-- ❌ 反复调整 `contentPadding` 试错
+> 💡 详细诊断方案由 MCP 工具从 npm 包动态加载
 
 ---
 
@@ -136,36 +105,26 @@ get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
 
 ---
 
-## 🎨 设计稿还原强制规范
-
-> ⚠️ 使用 Sketch/Figma MCP 时必须遵守
-
-### 强制要求：完整读取选中元素及其所有子集
-
-```javascript
-// 正确：一次性获取容器+所有子元素的完整信息
-function extractComplete(element) {
-  // 1. 容器信息
-  console.log(`容器: ${element.frame.width}x${element.frame.height}`);
-  
-  // 2. 所有子元素信息（关键！）
-  element.layers.forEach(child => {
-    console.log(`子元素: ${child.name}`);
-    console.log(`  位置: Y=${child.frame.y}px`);
-    console.log(`  尺寸: ${child.frame.width}x${child.frame.height}`);
-    if (child.type === 'Text') {
-      console.log(`  字号: ${child.style.fontSize}px`);
-      console.log(`  行高: ${child.frame.height / child.style.fontSize}`);
-    }
-  });
-}
-```
+## 🎨 设计稿还原
 
-### 禁止事项
-- ❌ 只读容器属性，忽略内部元素位置
-- ❌ 每次只查一个属性，分散多轮获取
-- ❌ 假设"差不多"而不验证精确像素值
-- ❌ 用"试错法"调整参数
+> ⚠️ 详细规范请调用：`get_standard_by_id({ id: 'design-restoration' })`
+
+### 快速提示
+
+| 关键点 | 说明 |
+|--------|------|
+| **渐变色** | 检查 `fillType` 后读取 `gradient.stops`，勿直接用 `color` 属性 |
+| **全局样式** | 还原前先 grep 搜索项目现有 Token（颜色、圆角、阴影） |
+| **新拟态阴影** | 双阴影：右下深色 + 左上高光 |
+| **行高** | Flutter `height` 是比例值，非像素（如 24px/16px = 1.5） |
+
+### 相关规范
+
+| 规范 | 调用方式 |
+|------|----------|
+| 设计稿还原流程 | `get_standard_by_id({ id: 'design-restoration' })` |
+| Sketch MCP 用法 | `get_standard_by_id({ id: 'sketch-mcp' })` |
+| 跨框架语法映射 | `get_standard_by_id({ id: 'syntax-mapping' })` |
 
 ---
 

package/agents/mta.agent.md

@@ -0,0 +1,226 @@
+# MTA Agent - 智能编码助手
+
+> 🎯 **定位**: Skills-First 的综合编码助手，不仅提供规范，更提供实战技能
+> 版本: v3.0.0 | 最后更新: 2026-01-21
+
+---
+
+## 📊 核心定位
+
+MTA 不是传统的"编码规范管理器"，而是一个**智能编码助手技能包**：
+
+| 能力类型 | 占比 | 说明 |
+|---------|------|------|
+| **Core Standards** | 40% | 告诉你什么是对的/错的 |
+| **Applied Skills** | 60% | 教你怎么做、为什么、遇到问题怎么办 |
+
+### 四大能力模块
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    MTA 智能编码助手                          │
+├─────────────────────────────────────────────────────────────┤
+│  📏 Standards    │  🛠️ Skills       │  🔧 Tools    │  📦 Templates  │
+│  ─────────────   │  ─────────────   │  ──────────  │  ────────────  │
+│  • 编码规范      │  • 问题诊断      │  • 项目分析  │  • API 层封装  │
+│  • 最佳实践      │  • 架构设计      │  • 配置生成  │  • 组件模板    │
+│  • 设计模式      │  • 性能优化      │  • 健康检查  │  • Store 模板  │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## ⚡ 三大零容忍政策（最高优先级）
+
+### 🚫 1. 文档创建零容忍
+
+**绝对禁止**：用户未明说创建文档就不要创建。
+
+| 行为 | 允许？ |
+|------|--------|
+| 用户说"创建 xxx.md" | ✅ 允许 |
+| "帮我记录一下" → 创建 .md | ❌ 禁止 |
+| 完成工作后创建总结文档 | ❌ 禁止 |
+
+### 🔍 2. 问题诊断零容忍
+
+**核心原则**：定位根因，精准修复。
+
+```
+1. 先调用 troubleshoot 工具查找已有案例
+2. 搜索全项目（grep_search）→ 找到所有相关定义
+3. 确认无冲突 → 理解原代码意图
+4. 从源头修复 → 而非末端补救
+```
+
+### 🚨 3. 代码质量零容忍
+
+**每次编辑后必检**：
+- ✅ 标签配对完整
+- ✅ 使用 `get_errors` 工具验证无编译错误
+- ✅ 语法正确，缩进清晰
+
+---
+
+## 🛠️ MCP 工具速查
+
+### 问题诊断类（Skills）
+
+| 工具 | 用途 | 何时调用 |
+|------|------|---------|
+| `troubleshoot` | 🔴 **遇到问题优先调用** | 用户描述任何技术问题 |
+| `health_check` | 检查 MCP 配置状态 | 配置问题、连接问题 |
+
+### 规范获取类（Standards）
+
+| 工具 | 用途 | 何时调用 |
+|------|------|---------|
+| `get_compact_standards` | 获取项目相关规范 | 写代码前 |
+| `get_standard_by_id` | 按 ID 获取特定规范 | 需要具体规范时 |
+| `use_preset` | 使用预设场景规范 | vue3-component、api-call 等 |
+
+### 项目管理类（Tools）
+
+| 工具 | 用途 | 何时调用 |
+|------|------|---------|
+| `analyze_project` | 分析项目技术栈 | 初次接触项目 |
+| `generate_config` | 生成 copilot-instructions.md | 配置新项目 |
+| `analyze_reference_project` | 克隆项目架构 | "参考 xx 创建新项目" |
+
+### 模板应用类（Templates）
+
+| 工具 | 用途 | 何时调用 |
+|------|------|---------|
+| `list_templates` | 列出可用模板 | 查看有哪些模板 |
+| `get_template` | 获取模板内容 | 应用特定模板 |
+
+---
+
+## 📁 知识库结构
+
+MTA 的知识分为两类，明确区分：
+
+### Core Standards（纯规范 - 40%）
+
+```
+standards/
+├── core/           # 通用编码规范
+├── frameworks/     # 框架规范（Vue3、Flutter、React）
+└── libraries/      # 库规范（Element Plus、Pinia）
+```
+
+**特点**：规则列表、对/错示例、可检查验证
+
+### Applied Skills（应用技能 - 60%）
+
+```
+standards/
+├── patterns/              # 设计模式和最佳实践
+├── workflows/             # 开发工作流程
+├── mcp-tools/             # 工具使用技能
+└── troubleshooting-cases/ # 问题诊断案例库
+
+templates/                 # 可复用代码模板
+agents/                    # 开发引导 Agent
+```
+
+**特点**：操作步骤、诊断流程、代码模板、实战经验
+
+---
+
+## 🏗️ 项目维护规范
+
+### 根目录规则
+
+**只允许存在**：
+- README.md（200-300行）
+- setup-copilot.sh
+- check-mcp-status.sh
+- package.json
+- 配置文件
+
+**禁止放置**：
+- ❌ 详细文档（应放 docs/）
+- ❌ 变更日志（应放 docs/development/CHANGELOG.md）
+- ❌ .bak 备份文件
+
+### Agent 编写原则
+
+**Agent 只放引导语，详细内容由 MCP 工具加载**：
+
+| 内容类型 | Agent 中 | MCP 工具加载 |
+|----------|---------|-------------|
+| 问题诊断触发词 | ✅ 保留 | - |
+| MCP 工具调用示例 | ✅ 保留 | - |
+| 简要提示（10-20行） | ✅ 保留 | - |
+| **详细代码示例（>10行）** | ❌ 禁止 | ✅ 放这里 |
+| **完整规则说明** | ❌ 禁止 | ✅ 放这里 |
+
+### 通用规范跨 Agent 同步
+
+如果某个规范不仅限于单一框架，必须更新所有相关 Agent：
+
+| 规范类型 | 需要更新的 Agent |
+|----------|-----------------|
+| 设计稿还原 | flutter, vue3, wechat-miniprogram |
+| 国际化 | 所有涉及 UI 的 Agent |
+| 问题诊断流程 | 所有 Agent |
+
+---
+
+## 🔄 标准工作流
+
+### 修改代码时
+
+```
+1. 理解现有代码 → 完整阅读相关文件
+2. 遇到问题 → 先调用 troubleshoot
+3. 代码修改 → 使用项目现有模式
+4. 编译验证 → 使用 get_errors
+5. 禁止创建文档 → 除非明确要求
+```
+
+### 添加新 Agent 时
+
+```
+1. 复制 agents/_TEMPLATE.md 为基础
+2. 填充框架特定的规范 ID
+3. 添加简要快速提示（10-20行）
+4. 详细规范放入 standards/ 目录
+```
+
+### 添加问题诊断案例时
+
+```
+1. 创建 troubleshooting-cases/{framework}/{case-name}.md
+2. 包含：问题描述、错误尝试、正确方案、关键代码
+3. 更新 standards/README.md 索引
+```
+
+---
+
+## 🎯 定位对比
+
+| 系统 | 定位 | MTA 的差异 |
+|------|------|-----------|
+| **ESLint** | 纯规范检查 | MTA 还提供诊断和解决方案 |
+| **Prettier** | 纯格式化 | MTA 还提供最佳实践指导 |
+| **Stack Overflow** | 问答社区 | MTA 整合进开发工作流 |
+| **GitHub Copilot** | 代码生成 | MTA 提供规范约束和质量保障 |
+
+**MTA = Standards + Skills + Tools + Templates**
+
+---
+
+## 📋 版本历程
+
+| 版本 | 特性 | 日期 |
+|------|------|------|
+| v1.0.0 | 初始版本 - 编码规范管理 | 2025-12 |
+| v2.0.0 | 元规范抽离 - MTA Agent | 2026-01 |
+| v3.0.0 | Skills-First 重新定位 | 2026-01-21 |
+
+---
+
+**维护团队**: MTA工作室  
+**设计理念**: 不只是规范，更是实战技能包

package/agents/vue3.agent.md

@@ -132,6 +132,30 @@ get_standard_by_id({ ids: ['vue3-composition', 'element-plus', 'i18n'] })
 **模式规范**
 - `vue-css-nesting` - Vue CSS 嵌套写法
 - `api-layer` - API 层封装模式
+- `design-tokens` - 设计 Token 系统
+
+---
+
+## 🎨 设计稿还原
+
+> ⚠️ 详细规范请调用：`get_standard_by_id({ id: 'design-restoration' })`
+
+### 快速提示
+
+| 关键点 | 说明 |
+|--------|------|
+| **渐变色** | 检查 `fillType` 后读取 `gradient.stops`，勿直接用 `color` 属性 |
+| **全局样式** | 还原前先搜索项目现有 CSS 变量 / Token |
+| **渐变语法** | `background: linear-gradient(135deg, #E01020, #B8101A)` |
+| **阴影语法** | `box-shadow: 8px 8px 20px rgba(28,43,69,0.15)` |
+
+### 相关规范
+
+| 规范 | 调用方式 |
+|------|----------|
+| 设计稿还原流程 | `get_standard_by_id({ id: 'design-restoration' })` |
+| Sketch MCP 用法 | `get_standard_by_id({ id: 'sketch-mcp' })` |
+| 跨框架语法映射 | `get_standard_by_id({ id: 'syntax-mapping' })` |
 
 ---
 

package/agents/wechat-miniprogram.agent.md

@@ -85,5 +85,28 @@ miniprogram/
 
 ---
 
+## 🎨 设计稿还原
+
+> ⚠️ 详细规范请调用：`get_standard_by_id({ id: 'design-restoration' })`
+
+### 快速提示
+
+| 关键点 | 说明 |
+|--------|------|
+| **渐变色** | 检查 `fillType` 后读取 `gradient.stops`，勿直接用 `color` 属性 |
+| **全局样式** | 还原前先搜索项目现有变量（app.wxss 中的 CSS 变量） |
+| **rpx 换算** | 设计稿 px * 2 = rpx（基于 750px 设计稿） |
+| **阴影语法** | `box-shadow: 8px 8px 20px rgba(28,43,69,0.15)` |
+
+### 相关规范
+
+| 规范 | 调用方式 |
+|------|----------|
+| 设计稿还原流程 | `get_standard_by_id({ id: 'design-restoration' })` |
+| Sketch MCP 用法 | `get_standard_by_id({ id: 'sketch-mcp' })` |
+| 跨框架语法映射 | `get_standard_by_id({ id: 'syntax-mapping' })` |
+
+---
+
 **维护团队**: MTA工作室  
 **设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/dist/index.js

@@ -5700,7 +5700,7 @@ async function listTroubleshootingCases(framework) {
 }
 
 // src/index.ts
-var SERVER_VERSION = "2.14.0";
+var SERVER_VERSION = "3.0.0";
 var logger3 = createLogger("Server");
 var CopilotPromptsMCPServer = class {
   constructor() {