mta-mcp 1.0.0

package/agents/_TEMPLATE.md

@@ -0,0 +1,153 @@
+# Agent 开发模板
+
+> 所有 Agent 必须采用"规范获取指引"模式
+> 版本: v1.0.0 | 创建日期: 2026-01-16
+
+---
+
+## 🎯 设计原则
+
+**Agent 的职责是引导 AI 获取规范，而不是嵌入完整规范。**
+
+| 应该包含 | 不应该包含 |
+|----------|------------|
+| MCP 工具调用示例 | 完整的代码示例 |
+| 规范 ID 列表 | 详细的规则说明 |
+| 简要提示（10-20行） | 大段代码块 |
+| 问题诊断指引 | 常用模式的完整实现 |
+
+---
+
+## 📋 标准结构
+
+```markdown
+# [框架/技术] 开发代理
+
+> 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
+> 版本: vX.X.X | 最后更新: YYYY-MM-DD
+
+---
+
+## 🔴 问题诊断优先（最高优先级）
+
+**当用户描述任何问题时，必须首先调用：**
+
+\`\`\`
+troubleshoot({ problem: "用户描述的问题" })
+\`\`\`
+
+---
+
+## 📚 规范获取指引
+
+**⚠️ 核心原则：写代码前，必须先通过 MCP 工具获取规范！**
+
+### 按文件类型获取
+
+| 场景 | MCP 调用 |
+|------|----------|
+| xxx 文件 | \`get_standard_by_id({ id: 'xxx-standard' })\` |
+
+### 按使用的库获取
+
+| 库 | MCP 调用 |
+|----|----------|
+| xxx-lib | \`get_standard_by_id({ id: 'xxx-lib' })\` |
+
+### 智能获取（推荐）
+
+\`\`\`
+get_compact_standards({ currentFile: "当前文件路径" })
+\`\`\`
+
+---
+
+## 🎯 快速提示
+
+> 以下是简要提示，**详细规范请通过上述 MCP 工具获取**
+
+### 必须遵守（3-5条）
+
+- ✅ 规则1
+- ✅ 规则2
+
+### 禁止（3-5条）
+
+- ❌ 禁止1
+- ❌ 禁止2
+
+---
+
+## 📋 可用规范列表
+
+通过 \`get_standard_by_id({ id: 'xxx' })\` 获取：
+
+- \`standard-id-1\` - 描述
+- \`standard-id-2\` - 描述
+
+---
+
+**维护团队**: MTA工作室  
+**设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取
+```
+
+---
+
+## ✅ 检查清单
+
+新建 Agent 时，确保：
+
+- [ ] 第一节是"问题诊断优先"
+- [ ] 第二节是"规范获取指引"（包含 MCP 调用表格）
+- [ ] "快速提示"不超过 20 行
+- [ ] 没有大段代码示例（超过 10 行的代码块）
+- [ ] 列出了所有可用的规范 ID
+- [ ] 文件总行数不超过 150 行
+
+---
+
+## 🚫 反面示例
+
+```markdown
+# ❌ 错误：嵌入完整规范
+
+## Vue 3 规范
+
+### Composition API
+
+\`\`\`vue
+<script setup lang="ts">
+import { ref, computed, onMounted } from 'vue'
+
+// 30 行完整代码示例...
+</script>
+\`\`\`
+
+### 表单处理
+
+\`\`\`typescript
+// 又是 20 行完整代码...
+\`\`\`
+```
+
+```markdown
+# ✅ 正确：指引获取
+
+## 📚 规范获取指引
+
+| 场景 | MCP 调用 |
+|------|----------|
+| Vue 组件 | \`get_standard_by_id({ id: 'vue3-composition' })\` |
+
+## 🎯 快速提示
+
+- ✅ 使用 Composition API
+- ✅ Props 必须定义类型
+- ❌ 禁止 Options API
+
+> 详细规范请通过 MCP 工具获取
+```
+
+---
+
+**此模板适用于所有 Agent，包括现有的和未来添加的。**

package/agents/flutter.agent.md

@@ -0,0 +1,222 @@
+# Flutter 开发代理
+
+> 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
+> 版本: v3.1.0 | 最后更新: 2026-01-19
+
+---
+
+## 🔴 问题诊断优先（最高优先级）
+
+**当用户描述任何问题时，必须首先调用：**
+
+```
+troubleshoot({ problem: "用户描述的问题" })
+```
+
+### 已收录的问题类型
+
+| 问题类型 | 关键词 |
+|----------|--------|
+| 阴影透出/容器变暗 | shadow, transparency, neumorphism |
+| 布局尺寸不匹配 | layout, size, spacing |
+| 阴影被裁剪 | clip, shadow, clipBehavior |
+| SVG 颜色/居中问题 | svg, color, viewbox |
+| 输入框边框异常 | input, border, focus |
+| **TextField 垂直居中** | textfield, placeholder, 居中, 光标, 输入框 |
+
+---
+
+## ⚠️ 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 工具获取规范！**
+
+### 按文件类型获取
+
+| 场景 | MCP 调用 |
+|------|----------|
+| Dart 代码 | `get_standard_by_id({ id: 'dart-base' })` |
+| Flutter Widget | `get_standard_by_id({ id: 'flutter' })` |
+| UI Token 系统 | `get_standard_by_id({ id: 'flutter-ui-system' })` |
+
+### 按场景获取
+
+| 场景 | MCP 调用 |
+|------|----------|
+| 状态管理 | `get_standard_by_id({ id: 'riverpod' })` |
+| API 调用 | `get_standard_by_id({ id: 'api-layer' })` |
+| 组件设计 | `get_standard_by_id({ id: 'component-design' })` |
+
+### 智能获取（推荐）
+
+```
+// 根据当前文件自动匹配
+get_compact_standards({ currentFile: "xxx.dart" })
+
+// 获取多个规范
+get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
+```
+
+---
+
+## 🎯 快速提示
+
+> 以下是简要提示，**详细规范请通过上述 MCP 工具获取**
+
+### 必须遵守
+
+- ✅ 使用 Token 系统（`$c`, `$t`, `$s`, `$r`）
+- ✅ 使用 const 构造函数优化性能
+- ✅ 区分 StatelessWidget 和 StatefulWidget
+- ✅ 组合优于继承
+
+### 禁止
+
+- ❌ 硬编码颜色/尺寸（如 `Color(0xFF3B82F6)`）
+- ❌ 在 build 方法中创建对象
+- ❌ 直接使用 setState 管理复杂状态
+
+### Token 快捷方式
+
+| 快捷方式 | 用途 |
+|----------|------|
+| `$c` | 颜色 (AppColors) |
+| `$t` | 文字样式 (AppTypography) |
+| `$s` | 间距 (AppSpacing) |
+| `$r` | 圆角 (AppRadius) |
+| `$shadow` | 阴影 (AppShadows) |
+
+---
+
+## 📋 可用规范列表
+
+通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+
+**核心规范**
+- `dart-base` - Dart 语言基础规范
+- `flutter` - Flutter 框架规范
+- `flutter-ui-system` - UI Token 系统
+
+**模式规范**
+- `api-layer` - API 层封装模式
+- `component-design` - 组件设计模式
+
+---
+
+## 🎨 设计稿还原强制规范
+
+> ⚠️ 使用 Sketch/Figma MCP 时必须遵守
+
+### 🔴 全局样式优先（最高优先级）
+
+**在还原任何 UI 前，必须首先检查是否存在全局样式规范！**
+
+#### 强制检查流程
+
+1. **圆角** - 优先使用 `DesignRadius` 中的标准值：
+   | 设计值 | 使用常量 | 用途 |
+   |--------|----------|------|
+   | 20px | `DesignRadius.xl` | 大统计卡片 |
+   | 16px | `DesignRadius.lg` | 通用卡片、CTA按钮 |
+   | 14px | `DesignRadius.md` | Tab、选择框 |
+   | 12px | `DesignRadius.base` | 图标背景、中型按钮 |
+   | 10px | `DesignRadius.sm` | 小按钮 |
+   | 8px | `DesignRadius.xs` | 输入框 |
+
+2. **按钮高度** - 优先使用 `DesignButtonSizes`：
+   | 设计值 | 使用常量 | 用途 |
+   |--------|----------|------|
+   | 56px | `DesignButtonSizes.heightCTA` | 主CTA按钮 |
+   | 40px | `DesignButtonSizes.heightMedium` | 标准按钮 |
+   | 36px | `DesignButtonSizes.heightIcon` | 图标按钮 |
+   | 32px | `DesignButtonSizes.heightSmall` | 小按钮 |
+   | 28px | `DesignButtonSizes.heightWarning` | 警告按钮 |
+
+3. **阴影** - 优先使用 `DesignShadows`：
+   | 模式 | 使用常量 | 用途 |
+   |------|----------|------|
+   | (4,4,8) | `DesignShadows.raised` | 按钮、小卡片 |
+   | (6,6,12) | `DesignShadows.card` | 普通卡片 |
+   | (8,8,20) | `DesignShadows.elevated` | 大卡片 |
+   | CTA红色 | `DesignShadows.cta` | 主操作按钮 |
+
+4. **颜色** - 优先使用 `DesignColors`：
+   | 颜色 | 使用常量 |
+   |------|----------|
+   | #1C2B45 | `DesignColors.textPrimary` |
+   | #1C2B4599 | `DesignColors.textSecondary.withOpacity(0.6)` |
+   | #E8EDF5 | `DesignColors.pageBackground` |
+   | #EEF3FA→#D9E0EB | `DesignColors.cardGradient` |
+   | #D0121B | `DesignColors.primary` |
+   | #FF9800 | `DesignColors.warning` |
+
+#### 禁止事项
+- ❌ 硬编码 `BorderRadius.circular(16)` - 应使用 `DesignRadius.lg`
+- ❌ 硬编码 `height: 56` - 应使用 `DesignButtonSizes.heightCTA`
+- ❌ 硬编码 `Color(0xFF1C2B45)` - 应使用 `DesignColors.textPrimary`
+- ❌ 手写阴影参数 - 应使用 `DesignShadows` 预设
+
+### 强制要求：完整读取选中元素及其所有子集
+
+```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}`);
+    }
+  });
+}
+```
+
+### 禁止事项
+- ❌ 只读容器属性，忽略内部元素位置
+- ❌ 每次只查一个属性，分散多轮获取
+- ❌ 假设"差不多"而不验证精确像素值
+- ❌ 用"试错法"调整参数
+
+---
+
+**维护团队**: MTA工作室  
+**设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/agents/i18n.agent.md

@@ -0,0 +1,78 @@
+# 国际化 (i18n) 开发代理
+
+> 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
+> 版本: v3.0.0 | 最后更新: 2026-01-16
+
+---
+
+## 🔴 问题诊断优先（最高优先级）
+
+**当用户描述任何问题时，必须首先调用：**
+
+```
+troubleshoot({ problem: "用户描述的问题" })
+```
+
+---
+
+## 📚 规范获取指引
+
+**⚠️ 核心原则：添加任何用户可见文本前，必须先获取规范！**
+
+### 按框架获取
+
+| 框架 | MCP 调用 |
+|------|----------|
+| Vue + vue-i18n | `get_standard_by_id({ id: 'i18n' })` |
+| Vue 3 组件 | `get_standard_by_id({ id: 'vue3-composition' })` |
+| React | `get_standard_by_id({ id: 'react-i18n' })` |
+
+### 智能获取（推荐）
+
+```
+// 根据当前文件自动匹配
+get_compact_standards({ currentFile: "xxx.vue", scenario: "国际化" })
+```
+
+---
+
+## 🎯 快速提示
+
+> 以下是简要提示，**详细规范请通过上述 MCP 工具获取**
+
+### 必须遵守
+
+- ✅ 零硬编码 - 所有用户可见文本使用 `$t()`
+- ✅ 键名规范 - 点分层级 (`common.save`)
+- ✅ 参数化 - 动态内容用插值，不拼接
+
+### 禁止
+
+- ❌ 硬编码中文/英文
+- ❌ 字符串拼接: `'删除' + name + '吗？'`
+- ❌ 重复的翻译键
+
+### 快速示例
+
+```vue
+<!-- ✅ 正确 -->
+<el-button>{{ $t('common.save') }}</el-button>
+<el-table-column :label="$t('user.name')" />
+
+<!-- ❌ 错误 -->
+<el-button>保存</el-button>
+```
+
+---
+
+## 📋 可用规范列表
+
+通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+
+- `i18n` - Vue 国际化完整规范
+- `vue3-composition` - Vue 3 规范（含 i18n 章节）
+
+---
+
+**维护团队**: MTA工作室  
+**设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/agents/logicflow.agent.md

@@ -0,0 +1,97 @@
+# LogicFlow 流程图开发代理
+
+> 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
+> 版本: v3.0.0 | 最后更新: 2026-01-16
+
+---
+
+## 🔴 问题诊断优先（最高优先级）
+
+**当用户描述任何问题时，必须首先调用：**
+
+```
+troubleshoot({ problem: "用户描述的问题" })
+```
+
+---
+
+## 📚 规范获取指引
+
+**⚠️ 核心原则：开发 LogicFlow 代码前，必须先获取规范！**
+
+### 按场景获取
+
+| 场景 | MCP 调用 |
+|------|----------|
+| LogicFlow 基础 | `get_standard_by_id({ id: 'logicflow' })` |
+| 自定义节点 | `get_standard_by_id({ id: 'logicflow' })` |
+| Vue 3 集成 | `get_standard_by_id({ ids: ['logicflow', 'vue3-composition'] })` |
+| TypeScript | `get_standard_by_id({ id: 'typescript-base' })` |
+
+### 智能获取（推荐）
+
+```
+// 根据当前文件自动匹配
+get_compact_standards({ 
+  currentFile: "xxx.vue", 
+  imports: ["@logicflow/core"] 
+})
+```
+
+---
+
+## 🎯 快速提示
+
+> 以下是简要提示，**详细规范请通过上述 MCP 工具获取**
+
+### 核心架构（Model-View-Component）
+
+```typescript
+// 节点注册标准模式
+register({
+  type: 'customNode',
+  model: CustomNodeModel,    // 节点逻辑
+  view: CustomNodeView,      // 锚点渲染
+  component: CustomNodeComponent  // UI 组件
+}, lfInstance)
+```
+
+### 常见节点模式
+
+| 模式 | 锚点配置 | 典型应用 |
+|-----|---------|---------|
+| 单向流 | 左入右出 | 审批步骤 |
+| 分支 | 1入多出 | 条件分支 |
+| 汇聚 | 多入1出 | 分支合并 |
+| 起始 | 只有出口 | 流程开始 |
+| 终止 | 只有入口 | 流程结束 |
+
+### 必须遵守
+
+- ✅ 使用 Model-View-Component 三层架构
+- ✅ 自定义节点继承 RectNodeModel
+- ✅ 使用 `getConnectedSourceRules` 定义连线规则
+
+### 禁止
+
+- ❌ 直接操作 DOM
+- ❌ 跳过 Model 层直接修改视图
+- ❌ 硬编码节点尺寸（应根据内容动态计算）
+
+---
+
+## 📋 可用规范列表
+
+通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+
+**核心规范**
+- `logicflow` - LogicFlow 完整开发规范（含自定义节点、连线规则、校验系统）
+
+**配套规范**
+- `vue3-composition` - Vue 3 集成
+- `typescript-base` - TypeScript 基础
+
+---
+
+**维护团队**: MTA工作室  
+**设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取