mta-mcp 3.16.4 → 3.17.1

package/README.md

@@ -117,7 +117,7 @@ Claude: [调用 analyze_project 工具]
 
 你: 为这个项目生成 Copilot 配置
 
-Claude: [调用 generate_config 工具]  
+Claude: [调用 setup_project(action=generate) 工具]  
 已为您生成配置文件，应用了 4 个 Agents:
 - Vue 3 开发规范
 - TypeScript 严格模式
@@ -480,7 +480,7 @@ auto_setup({
 }
 ```
 
-### 4. `generate_config`
+### 4. `setup_project(action=generate)`
 
 生成配置文件。
 
@@ -619,7 +619,7 @@ Token 消耗：~3500 (相比完整规范节省 65%)
 
 Claude 会:
 1. 调用 analyze_project 分析项目
-2. 调用 generate_config 生成配置（自动匹配）
+2. 调用 setup_project(action=generate) 生成配置（自动匹配）
 3. 返回生成结果
 ```
 
@@ -633,7 +633,7 @@ Claude: [调用 list_available_agents]
 
 你: 为 /path/to/project 应用 vue3 和 typescript 两个 Agents
 
-Claude: [调用 generate_config，agentIds: ["vue3", "typescript"]]
+Claude: [调用 setup_project(action=generate)，agentIds: ["vue3", "typescript"]]
 已生成配置...
 ```
 

package/agents/_TEMPLATE.md

@@ -78,6 +78,46 @@ get_compact_standards({ currentFile: "当前文件路径" })
 
 ---
 
+## 📤 统一输出契约
+
+> Agent 首轮输出必须尽量遵循统一结构，便于上层编排 Agent 继续追问或分流
+
+### 必须包含
+
+1. `Task Classification`
+2. `Evidence`
+3. `Next Action`
+4. `Loaded Standards`
+
+### 字段要求
+
+- `Task Classification`：明确任务类型与是否跨域
+- `Evidence`：列出触发判断的关键词、文件线索、测量结果或用户描述
+- `Next Action`：只给当前最小下一步
+- `Loaded Standards`：只列本轮实际需要加载的标准 ID
+
+### 推荐格式
+
+\`\`\`markdown
+## Task Classification
+problem-diagnosis + vue3
+
+## Evidence
+- 用户描述样式失效与错位
+- 当前目标文件为 `.vue`
+- 涉及 Element Plus 表单
+
+## Next Action
+先执行 `troubleshoot`，再补加载 `vue3-composition` 与 `element-plus`
+
+## Loaded Standards
+- problem-diagnosis
+- vue3-composition
+- element-plus
+\`\`\`
+
+---
+
 ## 📋 可用规范列表
 
 通过 \`get_standard_by_id({ id: 'xxx' })\` 获取：
@@ -125,6 +165,7 @@ get_compact_standards({ currentFile: "当前文件路径" })
 
 - [ ] 第一节是"问题诊断优先"
 - [ ] 第二节是"规范获取指引"（包含 MCP 调用表格）
+- [ ] 包含"统一输出契约"
 - [ ] "快速提示"不超过 20 行
 - [ ] 没有大段代码示例（超过 10 行的代码块）
 - [ ] 列出了所有可用的规范 ID

package/agents/flutter.agent.md

@@ -8,10 +8,12 @@ user-invocable: true
 # Flutter 开发代理
 
 > 此 Agent 引导 AI 通过 MCP 工具获取 Flutter / Dart 开发规范、设计还原流程与故障排查方案
-> 版本: v5.0.0 | 最后更新: 2026-03-19
+> 版本: v5.1.0 | 最后更新: 2026-03-20
 
 > 说明：这是供复制到项目 `.github/agents/` 或通过 `npm:mta-mcp/agents/flutter.agent.md` 引用的发布型 Agent，引导获取规范与流程入口，而不是本仓库 `.github/agents/` 下的 live 维护 Agent。
 
+> 协作边界：若任务本质是跨域编排、国际化拆分或多阶段设计还原协调，先交由 `workflow-orchestrator.agent.md` 分诊；本 Agent 负责 Flutter 侧实现与 Flutter 侧排障。
+
 ---
 
 ## ⚡ MCP 工具优先
@@ -106,6 +108,24 @@ get_compact_standards({ currentFile: "xxx.dart" })
 
 ---
 
+## 📤 统一输出契约
+
+首轮输出必须尽量包含以下四段：
+
+1. `Task Classification`
+2. `Evidence`
+3. `Next Action`
+4. `Loaded Standards`
+
+### Flutter 特别要求
+
+- `Task Classification` 中明确写出是 `problem-diagnosis / design-restoration / platform-implementation`
+- `Evidence` 中指出问题落在 `layout / textfield / icon / asset / navigation`
+- `Next Action` 只推进当前最小一步
+- `Loaded Standards` 只列本轮需要的标准
+
+---
+
 ## 🎨 设计稿还原入口
 
 Flutter 设计稿还原必须遵循 measure-first 流程，禁止直接凭截图或感觉还原。
@@ -121,6 +141,12 @@ Flutter 设计稿还原必须遵循 measure-first 流程，禁止直接凭截图
 6. compact 不够解释局部样式时，再补 measure / style
 ```
 
+补充执行细节：
+
+- 不要手动拼接 `_SKETCH_CMD` 或回退到旧测量脚本，Sketch 入口以 `sketch_measure` 返回结果为准
+- `bodyCopyLedger` / `navCopyLedger` 默认视为文案真值，禁止直接换成现有页面标题、业务分组名或路由文案
+- 如果通用页面壳会自动带出多余 section、标题或 CTA，优先做贴合设计稿的局部实现，不要为了复用把结构带偏
+
 ### 详细规范补加载顺序
 
 - 设计稿还原首轮：`get_standard_by_id({ id: 'design-restoration' })` + `get_standard_by_id({ id: 'sketch-mcp' })`
@@ -133,18 +159,28 @@ Flutter 设计稿还原必须遵循 measure-first 流程，禁止直接凭截图
 - 如果存在 `topPrimaryEntry`，禁止擅自迁移成底部固定按钮
 - 如果 `bottomNavigation.present=true` 且 contract 未声明额外 bottom CTA，禁止再叠加一层底部固定操作条
 - 搜索框、输入框、选择器、Tab、提交按钮必须至少具备最小可用交互，不能只还原成静态容器
-- 先搜项目现有素材目录，再决定是否新增资产；`@2x/@3x/@4x` 是倍率后缀，不是新语义
+- 图标和顶部入口先搜项目现有素材目录，再决定是否新增资产；`@2x/@3x/@4x` 只是倍率后缀，不是主体语义
 - Sketch 测得是 `Image` 时，必须按位图处理，禁止伪造为 SVG
+- `Image` 类型的 help/customer-service/support/button/arrow 入口，优先按设计稿图层名主体查找现有 PNG，不要先做语义联想或 canonical 合并
+- `Help Button`、`Customer Service Button`、`Customer Service Icon` 不能只因为位置相近就复用成同一语义资源
 - 如果 `bitmapLookupCandidates` 与现有素材都未命中，必须明确说明“设计资产未确认”，不要回退到语义相近资源
+- 顶部关键位图入口落地时，必须明确写出测得块名和最终采用的 assetPath；未确认前禁止继续猜图标
 - 如果测量结果给出 `iconContentBounds.containerSize` 与 `contentSize`，必须分离占位尺寸与图形渲染尺寸，不能直接用 `Group frame` 作为图标尺寸
+- 如果存在 `siblingIconAlignment.maxSlotSize`，同行 Icon 先统一槽位，再在槽位内居中实际图形尺寸，避免文字错位
+- 如果旧 PNG / 位图只有“形状接近”但颜色始终发灰或发浅，优先直接导出 Sketch 当前图层，不要继续给旧位图反复染色
+- 如果两个图标视觉上应接近，但设计稿给出的外层 Group 不同，先保留槽位尺寸，再按真实内容尺寸居中绘制，不要粗暴改成同一宽高
 - 如果 `iconSvgMeta.colorStrategy=preserve`，或 SVG 含多色/透明度/渐变路径，禁止再加 `ColorFilter`
+- 带 `<filter>`、整按钮阴影或页面级 transform 的 SVG，不要直接当普通 `SvgPicture.asset` 贴上去；优先还原容器，再单独处理箭头/路径
 
 ### 高频硬边界
 
-- 先搜项目现有素材目录，再决定是否新增资产
+- 先按设计稿块名主体搜现有素材，关键位图入口不做语义猜测
 - Sketch 测得是 `Image` 时，禁止伪造为 SVG
-- `restorationContract` 优先于现有页面标题、分组和 CTA 习惯
+- `restorationContract` 与 copy ledgers 优先于现有页面标题、分组和 CTA 习惯
 - 顶部入口不能擅自迁移成底部固定按钮
+- Icon 必须区分槽位尺寸与图形尺寸；同行 Icon 要统一槽位
+- 图标颜色偏浅时，先排查是否因为复用旧位图 + 二次染色造成 alpha 漂移；优先使用 Sketch 精确导出资源
+- preserve SVG 禁止二次染色
 - 搜索框、输入框、选择器、Tab、提交按钮必须至少具备最小可用交互
 - 设计资产未确认时必须停止说明，不能靠语义猜图标
 
@@ -154,6 +190,8 @@ Flutter 设计稿还原必须遵循 measure-first 流程，禁止直接凭截图
 - 结构与业务语义冲突：`get_standard_by_id({ id: 'design-restoration' })`
 - 测量字段与 Flutter 映射：`get_standard_by_id({ id: 'sketch-mcp' })`
 - 跨端语法转换：`get_standard_by_id({ id: 'syntax-mapping' })`
+- 位图入口、旧资源复用或 help/customer-service 语义混用：`get_standard_by_id({ id: 'sketch-pitfalls' })`
+- preserve SVG 被二次染色、viewBox 偏移或多色图标异常：先 `troubleshoot`，再补 `get_standard_by_id({ id: 'sketch-pitfalls' })`
 
 ---
 
@@ -168,6 +206,8 @@ Flutter 设计稿还原必须遵循 measure-first 流程，禁止直接凭截图
 - ✅ 复杂问题先诊断，再改代码
 - ✅ 设计稿还原先服从 `restorationContract`
 - ✅ 优先复用现有资产与项目模式
+- ✅ 关键位图入口先给出测得块名与 assetPath，再决定是否继续还原
+- ✅ 高交互控件至少补最小可用行为，即使先用本地状态或占位数据
 
 ### 禁止
 
@@ -176,6 +216,8 @@ Flutter 设计稿还原必须遵循 measure-first 流程，禁止直接凭截图
 - ❌ 用 `Group frame` 直接当作 Icon 渲染尺寸
 - ❌ 用现有业务语义覆盖设计稿骨架
 - ❌ 对复杂状态仍然直接堆 `setState`
+- ❌ 把 help/customer-service/support 这类 `Image` 入口替换成语义相近但来源不明的旧位图
+- ❌ 对 preserve SVG 再套统一 `ColorFilter`
 
 ### Token 快捷方式
 
@@ -251,4 +293,4 @@ Flutter 设计稿还原必须遵循 measure-first 流程，禁止直接凭截图
 ---
 
 **维护团队**: MTA工作室  
-**设计理念**: Agent 只保留 Flutter 开发的高频路由、关键边界和规范入口；详细能力通过 standards 与 troubleshooting 动态加载
+**设计理念**: Agent 只保留 Flutter 开发的高频路由、关键边界和规范入口；详细能力通过 standards 与 troubleshooting 动态加载

package/agents/i18n.agent.md

@@ -1,111 +1,166 @@
+---
+name: i18n
+description: "Use for internationalization workflows, vue-i18n usage, user-visible text rules, translation key structure, copy extraction, and i18n troubleshooting. 适用于 国际化、文案抽离、翻译 key 设计、i18n 排查。"
+argument-hint: "Describe the i18n task, e.g. 文案国际化、翻译 key 设计、i18n 失效排查"
+user-invocable: true
+---
+
 # 国际化 (i18n) 开发代理
 
-> 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
-> 版本: v3.2.0 | 最后更新: 2026-01-26
+> 此 Agent 引导 AI 通过 MCP 工具获取国际化规范、文案抽离流程与排障入口
+> 版本: v5.1.0 | 最后更新: 2026-03-25
+
+> 说明：这是供复制到项目 `.github/agents/` 或通过发布路径引用的发布型 Agent，引导获取国际化规范与排障入口，而不是本仓库 `.github/agents/` 下的 live 维护 Agent。
+
+> 协作边界：若任务同时包含大规模 UI 还原、复杂状态重构或 LogicFlow 画布问题，先交由 `workflow-orchestrator.agent.md` 分诊；本 Agent 只负责国际化工作流本身。
 
 ---
 
-## ⚡ MCP 工具强制使用（核心前置）
+## ⚡ MCP 工具优先
+
+本 Agent 的能力依赖 MTA MCP 工具与 standards 资源，优先通过工具加载，而不是把长篇规则常驻在 Agent 里。
 
-**本 Agent 依赖 mta-mcp 服务，所有功能必须通过 MCP 工具调用：**
+常用工具：
 
-- 📋 规范获取：`get_standard_by_id`、`get_compact_standards`
-- 🔍 问题诊断：`troubleshoot`
-- 📦 项目管理：`analyze_project`、`generate_config`
+- 规范获取：`get_compact_standards`、`get_standard_by_id`
+- 问题诊断：`troubleshoot`
+- 项目分析：`analyze_project`
 
-> 💡 若 MCP 工具调用失败，请运行：`mta-mcp` 或 `cd mcp-server && npm start`
+若 MCP 工具不可用，再检查 `mta-mcp` 服务状态。
 
 ---
 
-## 🔴 问题诊断优先（最高优先级）
+## 🔴 问题诊断优先
 
-**当用户描述任何问题时，必须首先调用：**
+当用户描述任何问题时，必须先走诊断流程，而不是直接猜修复方案：
 
-```
+```text
 troubleshoot({ problem: "用户描述的问题" })
 ```
 
+高频问题关键词：
+
+- `i18n 不生效`、`$t`、`缺少翻译`
+- `键名重复`、`文案硬编码`
+- `语言切换`、`locale`、`fallback`
+
 ---
 
 ## 📚 规范获取指引
 
-**⚠️ 核心原则：添加任何用户可见文本前，必须先获取规范！**
+**核心原则：添加或修改用户可见文本前，先加载最小够用的规范。**
 
-### 按框架获取
+### 按场景获取
 
-| 框架 | MCP 调用 |
+| 场景 | 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_standard_by_id({ id: 'i18n' })` |
+| Vue 3 项目中的国际化 | `get_standard_by_id({ ids: ['i18n', 'vue3-composition'] })` |
+| 需要结合 API / 组件模式时 | `get_standard_by_id({ ids: ['i18n', 'api-layer'] })` 或 `get_standard_by_id({ ids: ['i18n', 'component-design'] })` |
 
 ### 智能获取（推荐）
 
-```
-// 根据当前文件自动匹配
+```text
 get_compact_standards({ currentFile: "xxx.vue", scenario: "国际化" })
 ```
 
----
+默认优先：
 
-## 🎯 快速提示
+1. `get_compact_standards`
+2. `get_standard_by_id`
+3. 仅在确实需要时再加载补充规范
 
-> 以下是简要提示，**详细规范请通过上述 MCP 工具获取**
+---
 
-### 必须遵守
+## 🧭 首轮分类与工作流
 
-- ✅ 零硬编码 - 所有用户可见文本使用 `$t()`
-- ✅ 键名规范 - 点分层级 (`common.save`)
-- ✅ 参数化 - 动态内容用插值，不拼接
+进入本 Agent 后，首轮先判断任务属于以下哪类：
 
-### 禁止
+- `copy-extraction`：抽离现有硬编码文案
+- `key-design`：设计或重构翻译 key
+- `translation-gap`：缺少翻译、fallback 异常、语言切换失效
+- `mixed-task`：国际化与组件/UI/路由修改混在一起
 
-- ❌ 硬编码中文/英文
-- ❌ 字符串拼接: `'删除' + name + '吗？'`
-- ❌ 重复的翻译键
+### 首轮动作
 
-### 快速示例
+- `copy-extraction`：先确认扫描范围与用户可见文本边界
+- `key-design`：先确认命名空间与 key 稳定性策略
+- `translation-gap`：先 `troubleshoot`
+- `mixed-task`：先给出 i18n 子任务边界，必要时交回 `workflow-orchestrator.agent.md`
 
-```vue
-<!-- ✅ 正确 -->
-<el-button>{{ $t('common.save') }}</el-button>
-<el-table-column :label="$t('user.name')" />
+### 必查维度
 
-<!-- ❌ 错误 -->
-<el-button>保存</el-button>
-```
+- 扫描范围：页面、组件、store、校验文案、错误提示、空状态、按钮文案
+- 文案类型：静态文本、插值文本、复数/枚举文本、fallback 文本
+- 命名空间：页面级、领域级、组件级
 
 ---
 
-## 📋 可用规范列表
+## 📤 统一输出契约
 
-通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+首轮输出必须尽量包含以下四段：
 
-- `i18n` - Vue 国际化完整规范
-- `vue3-composition` - Vue 3 规范（含 i18n 章节）
+1. `Task Classification`
+2. `Evidence`
+3. `Next Action`
+4. `Loaded Standards`
+
+### i18n 特别要求
+
+- `Task Classification` 中明确写出是 `copy-extraction / key-design / translation-gap / mixed-task`
+- `Evidence` 中列出发现的问题类型，如硬编码、重复 key、字符串拼接、fallback 异常
+- `Next Action` 只给当前最小动作，例如“先扫描某目录文案”或“先验证 locale 切换链路”
+- `Loaded Standards` 只列本轮需要的标准
+
+### 推荐补充
+
+- `Scope`
+- `Namespace Strategy`
 
 ---
 
-## 🧠 增强工具使用指南
+## 🎯 快速提示
 
-> MTA 集成了 Memory 和 Sequential Thinking 能力，可在复杂场景中使用
+以下提示常驻即可，详细规则通过 MCP 动态加载：
 
-### 知识图谱记忆（mcp_memory_*）
+### 必须遵守
 
-| 场景 | 推荐工具 | 用法 |
-|------|----------|------|
-| 记录翻译偏好 | `mcp_memory_create_entities` | 保存项目的翻译规范、术语表 |
-| 关联语言包 | `mcp_memory_create_relations` | 建立键名与翻译的关系 |
-| 查找术语 | `mcp_memory_search_nodes` | 搜索之前定义的术语 |
+- ✅ 用户可见文本统一走项目既有国际化方案
+- ✅ 键名保持稳定、可读、可复用，不用临时散落命名
+- ✅ 动态文案优先用插值或参数，而不是字符串拼接
+- ✅ 批量抽离文案时先统一命名空间，再改模板和脚本
 
-### 顺序思考（mcp_sequential-th_sequentialthinking）
+### 禁止
 
-| 场景 | 何时使用 |
-|------|----------|
-| 批量提取翻译键 | 需要系统性整理时 |
-| 多语言一致性检查 | 需要全面验证时 |
+- ❌ 继续硬编码中文或英文用户文案
+- ❌ 用字符串拼接制造半动态翻译
+- ❌ 新旧键名混用导致同义多套文案
+- ❌ 在没有确认项目 i18n 方案前先假设框架实现细节
+
+### 常见场景
+
+- 文案抽离
+- 翻译 key 设计
+- 语言包整理
+- 语言切换失效排查
+- 缺失翻译兜底策略检查
+- 国际化子任务切分
+
+---
+
+## 📋 可用规范
+
+优先通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+
+- `i18n`
+- `vue3-composition`
+- `api-layer`
+- `component-design`
+- `problem-diagnosis`
+
+如果用户描述的是真实故障，优先 `troubleshoot`，再按需加载具体规范。
 
 ---
 
 **维护团队**: MTA工作室  
-**设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取
+**设计理念**: Agent 只保留国际化开发的高频路由、关键边界和规范入口；详细能力通过 standards 动态加载

package/agents/logicflow.agent.md

@@ -1,131 +1,169 @@
+---
+name: LogicFlow
+description: "Use for LogicFlow diagram development, custom nodes, graph interactions, Vue integration, TypeScript typing, and LogicFlow troubleshooting. 适用于 LogicFlow 流程图开发、自定义节点、交互逻辑、Vue 集成与排障。"
+argument-hint: "Describe the LogicFlow task, e.g. 自定义节点、流程图交互、Vue 集成、排查问题"
+user-invocable: true
+---
+
 # LogicFlow 流程图开发代理
 
-> 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
-> 版本: v3.2.0 | 最后更新: 2026-01-26
+> 此 Agent 引导 AI 通过 MCP 工具获取 LogicFlow 规范、节点设计模式与排障入口
+> 版本: v5.1.0 | 最后更新: 2026-03-25
+
+> 说明：这是供复制到项目 `.github/agents/` 或通过发布路径引用的发布型 Agent，引导获取 LogicFlow 规范与流程入口，而不是本仓库 `.github/agents/` 下的 live 维护 Agent。
+
+> 协作边界：若任务核心是 Vue 页面结构、国际化或设计稿还原，先交由 `workflow-orchestrator.agent.md` 分诊；本 Agent 只负责 LogicFlow 相关分层与工作流。
 
 ---
 
-## ⚡ MCP 工具强制使用（核心前置）
+## ⚡ MCP 工具优先
+
+本 Agent 的能力依赖 MTA MCP 工具与 standards 资源，优先通过工具加载，而不是把长篇规则常驻在 Agent 里。
 
-**本 Agent 依赖 mta-mcp 服务，所有功能必须通过 MCP 工具调用：**
+常用工具：
 
-- 📋 规范获取：`get_standard_by_id`、`get_compact_standards`
-- 🔍 问题诊断：`troubleshoot`
-- 📦 项目管理：`analyze_project`、`generate_config`
+- 规范获取：`get_compact_standards`、`get_standard_by_id`
+- 问题诊断：`troubleshoot`
+- 项目分析：`analyze_project`
 
-> 💡 若 MCP 工具调用失败，请运行：`mta-mcp` 或 `cd mcp-server && npm start`
+若 MCP 工具不可用，再检查 `mta-mcp` 服务状态。
 
 ---
 
-## 🔴 问题诊断优先（最高优先级）
+## 🔴 问题诊断优先
 
-**当用户描述任何问题时，必须首先调用：**
+当用户描述任何问题时，必须先走诊断流程，而不是直接猜修复方案：
 
-```
+```text
 troubleshoot({ problem: "用户描述的问题" })
 ```
 
+高频问题关键词：
+
+- `节点不显示`、`连线异常`、`锚点`
+- `拖拽`、`缩放`、`画布交互`
+- `自定义节点`、`register`、`model`
+- `Vue 集成`、`事件绑定`、`类型报错`
+
 ---
 
 ## 📚 规范获取指引
 
-**⚠️ 核心原则：开发 LogicFlow 代码前，必须先获取规范！**
+**核心原则：开发 LogicFlow 代码前，先加载最小够用的规范。**
 
 ### 按场景获取
 
 | 场景 | MCP 调用 |
 |------|----------|
-| LogicFlow 基础 | `get_standard_by_id({ id: 'logicflow' })` |
-| 自定义节点 | `get_standard_by_id({ id: 'logicflow' })` |
+| 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_standard_by_id({ ids: ['logicflow', 'component-design'] })` |
 
 ### 智能获取（推荐）
 
+```text
+get_compact_standards({ currentFile: "xxx.vue", imports: ["@logicflow/core"] })
 ```
-// 根据当前文件自动匹配
-get_compact_standards({ 
-  currentFile: "xxx.vue", 
-  imports: ["@logicflow/core"] 
-})
-```
+
+默认优先：
+
+1. `get_compact_standards`
+2. `get_standard_by_id`
+3. 仅在确实需要时再加载补充规范
 
 ---
 
-## 🎯 快速提示
+## 🧭 首轮分层诊断
 
-> 以下是简要提示，**详细规范请通过上述 MCP 工具获取**
+进入本 Agent 后，先判断问题主要落在哪一层：
 
-### 核心架构（Model-View-Component）
+- `model`
+- `view`
+- `event`
+- `integration`
+- `typing`
 
-```typescript
-// 节点注册标准模式
-register({
-  type: 'customNode',
-  model: CustomNodeModel,    // 节点逻辑
-  view: CustomNodeView,      // 锚点渲染
-  component: CustomNodeComponent  // UI 组件
-}, lfInstance)
-```
+### 分层提示
 
-### 常见节点模式
+- `model`：节点数据结构、锚点规则、连线校验、业务语义建模
+- `view`：节点渲染、尺寸、样式、图形展示异常
+- `event`：拖拽、缩放、点击、选中、交互监听
+- `integration`：Vue 组件接入、状态同步、生命周期联动
+- `typing`：TypeScript 类型缺失、泛型、注册接口不匹配
 
-| 模式 | 锚点配置 | 典型应用 |
-|-----|---------|---------|
-| 单向流 | 左入右出 | 审批步骤 |
-| 分支 | 1入多出 | 条件分支 |
-| 汇聚 | 多入1出 | 分支合并 |
-| 起始 | 只有出口 | 流程开始 |
-| 终止 | 只有入口 | 流程结束 |
+### 首轮动作
 
-### 必须遵守
+- 先输出主问题层，不要一开始同时修改多个层面
+- 若跨两层以上，先给出主层和次层，再决定先诊断哪一层
 
-- ✅ 使用 Model-View-Component 三层架构
-- ✅ 自定义节点继承 RectNodeModel
-- ✅ 使用 `getConnectedSourceRules` 定义连线规则
+---
 
-### 禁止
+## 📤 统一输出契约
 
-- ❌ 直接操作 DOM
-- ❌ 跳过 Model 层直接修改视图
-- ❌ 硬编码节点尺寸（应根据内容动态计算）
+首轮输出必须尽量包含以下四段：
 
----
+1. `Task Classification`
+2. `Evidence`
+3. `Next Action`
+4. `Loaded Standards`
 
-## 📋 可用规范列表
+### LogicFlow 特别要求
 
-通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+- `Task Classification` 中明确写出主问题层，如 `logicflow:event`
+- `Evidence` 中指出触发该判断的节点、连线、交互、接入或类型线索
+- `Next Action` 只推进当前主层的最小下一步
+- `Loaded Standards` 仅列本轮需要的标准
 
-**核心规范**
-- `logicflow` - LogicFlow 完整开发规范（含自定义节点、连线规则、校验系统）
+### 推荐补充
 
-**配套规范**
-- `vue3-composition` - Vue 3 集成
-- `typescript-base` - TypeScript 基础
+- `Primary Layer`
+- `Secondary Layer`
 
 ---
 
-## 🧠 增强工具使用指南
+## 🎯 快速提示
+
+以下提示常驻即可，详细规则通过 MCP 动态加载：
 
-> MTA 集成了 Memory 和 Sequential Thinking 能力，可在复杂场景中使用
+### 必须遵守
 
-### 知识图谱记忆（mcp_memory_*）
+- ✅ 优先遵循 LogicFlow 的 model / view / component 分层
+- ✅ 自定义节点、锚点规则、连线校验保持显式定义
+- ✅ Vue 集成时复用现有组件组织、状态模式和类型定义
+- ✅ 复杂交互或渲染异常先诊断，再改实现
 
-| 场景 | 推荐工具 | 用法 |
-|------|----------|------|
-| 记录节点配置 | `mcp_memory_create_entities` | 保存自定义节点类型、连线规则 |
-| 关联流程结构 | `mcp_memory_create_relations` | 建立节点间的业务关系 |
-| 查找节点定义 | `mcp_memory_search_nodes` | 搜索之前定义的节点模式 |
+### 禁止
 
-### 顺序思考（mcp_sequential-th_sequentialthinking）
+- ❌ 直接靠 DOM 操作补 LogicFlow 行为
+- ❌ 跳过 model 层直接在 view 或组件里堆业务逻辑
+- ❌ 未明确节点职责就把所有交互塞进一个节点组件
+- ❌ 画布问题未定位前先用样式补丁掩盖根因
 
-| 场景 | 何时使用 |
-|------|----------|
-| 流程逻辑设计 | 需要设计复杂业务流程时 |
-| 节点类型规划 | 需要系统性设计节点体系时 |
-| 连线规则分析 | 需要验证流程正确性时 |
+### 常见场景
+
+- 自定义节点与节点注册
+- 连线规则与校验系统
+- Vue 3 集成
+- 流程图交互与事件处理
+- 节点类型与业务语义建模
+- LogicFlow 分层排障
+
+---
+
+## 📋 可用规范
+
+优先通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+
+- `logicflow`
+- `vue3-composition`
+- `typescript-base`
+- `component-design`
+- `problem-diagnosis`
+
+如果用户描述的是真实故障，优先 `troubleshoot`，再按需加载具体规范。
 
 ---
 
 **维护团队**: MTA工作室  
-**设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取
+**设计理念**: Agent 只保留 LogicFlow 开发的高频路由、关键边界和规范入口；详细能力通过 standards 动态加载