mcp-probe-kit 3.0.24 → 3.2.0

package/build/tools/start_ui.js

@@ -110,300 +110,300 @@ function resolveTemplateProfile(rawProfile, description) {
         warning: `模板档位 \"${rawProfile}\" 不支持，已回退为 ${fallback}`,
     };
 }
-const PROMPT_TEMPLATE_GUIDED = `# 快速开始
-
-**职责说明**: 本工具仅提供执行指导，不执行实际操作。请按顺序调用以下 MCP 工具。
-
-执行以下工具：
-
-1. 检查 \`docs/project-context.md\` 是否存在，不存在则调用 \`init_project_context\`
-2. 检查 \`docs/design-system.md\` 是否存在，不存在则调用 \`ui_design_system --product_type="{productType}" --stack="{framework}"\`
-3. 检查 \`docs/ui/component-catalog.json\` 是否存在，不存在则调用 \`init_component_catalog\`
-4. \`ui_search --mode=template --query="{description}"\`
-5. 选择模板并保存到 \`docs/ui/{templateName}.json\`
-6. \`render_ui --template="docs/ui/{templateName}.json" --framework="{framework}"\`
-7. 将生成的 UI 文档添加到 \`docs/project-context.md\` 索引中
-
----
-
-## 步骤 1: 生成项目上下文（如不存在）📋
-
-**检查**: 查看 \`docs/project-context.md\` 是否存在
-
-**如果不存在，调用工具**: \`init_project_context\`
-**参数**: 无（使用默认配置）
-
-**预期输出**: 
-- \`docs/project-context.md\` - 项目上下文索引文件
-- \`docs/project-context/\` - 项目文档目录
-
-**失败处理**: 确保 docs 目录存在且有写入权限
-
----
-
-## 步骤 2: 生成设计系统（如不存在）🎨
-
-**检查**: 查看 \`docs/design-system.md\` 是否存在
-
-**如果不存在，调用工具**: \`ui_design_system\`
-**参数**:
-\`\`\`json
-{
-  "product_type": "{productType}",
-  "stack": "{framework}",
-  "description": "{description}"
-}
-\`\`\`
-
-**预期输出**: \`docs/design-system.json\` 和 \`docs/design-system.md\`
-**失败处理**: 检查 docs 目录是否存在，确保有写入权限
-
----
-
-## 步骤 3: 生成组件目录（如不存在）📦
-
-**检查**: 查看 \`docs/ui/component-catalog.json\` 是否存在
-
-**如果不存在，调用工具**: \`init_component_catalog\`
-**参数**: 无
-
-**预期输出**: \`docs/ui/component-catalog.json\`
-**失败处理**: 确保步骤 2 的设计系统文件已生成
-
----
-
-## 步骤 4: 搜索 UI 模板 🔍
-
-**工具**: \`ui_search\`
-**参数**:
-\`\`\`json
-{
-  "mode": "template",
-  "query": "{description}"
-}
-\`\`\`
-
-**预期输出**: 匹配的模板列表（可能为空）
-**失败处理**: 如果没有找到模板，创建最小模板文件再进入渲染步骤
-
----
-
-## 步骤 5: 保存模板文件 🧩
-
-**操作**: 从搜索结果选择模板或创建最小模板
-
-**保存路径**: \`docs/ui/{templateName}.json\`
-
-**最小模板示例**:
-\`\`\`json
-{
-  "name": "UiTemplate",
-  "description": "{description}",
-  "layout": "sectioned"
-}
-\`\`\`
-
----
-
-## 步骤 6: 渲染最终代码 💻
-
-**工具**: \`render_ui\`
-**参数**:
-\`\`\`json
-{
-  "template": "docs/ui/{templateName}.json",
-  "framework": "{framework}"
-}
-\`\`\`
-
-**预期输出**: 完整的 {framework} 组件代码
-**失败处理**: 如果模板不存在，请先完成步骤 5 保存模板文件
-
----
-
-## 步骤 7: 更新项目上下文索引 📝
-
-**操作**: 将生成的 UI 文档添加到 \`docs/project-context.md\` 中
-
-**添加内容**:
-在 "## 📚 文档导航" 部分添加：
-
-\`\`\`markdown
-### [UI 设计系统](./design-system.md)
-项目的 UI 设计规范，包括颜色、字体、组件样式等
-
-### [UI 组件目录](./ui/component-catalog.json)
-可用的 UI 组件及其属性定义
-\`\`\`
-
-在 "## 💡 开发时查看对应文档" 部分的 "添加新功能" 下添加：
-\`\`\`markdown
-- **UI 设计系统**: [design-system.md](./design-system.md) - 查看设计规范
-- **UI 组件目录**: [ui/component-catalog.json](./ui/component-catalog.json) - 查看可用组件
-\`\`\`
-
-**预期结果**: \`docs/project-context.md\` 包含 UI 相关文档的链接
-**失败处理**: 如果文件不存在，跳过此步骤
-
----
-
-## 高级选项
-
-### 自定义设计系统
-编辑 \`docs/design-system.json\` 修改颜色、字体等，然后重新运行。
-
-### 自定义组件
-编辑 \`docs/ui/component-catalog.json\` 添加新组件定义。
-
-### 常见问题
-
-**Q: 设计系统文件已存在，还需要重新生成吗？**
-A: 不需要。如果文件已存在，直接跳过步骤 1。
-
-**Q: 如何使用自定义模板？**
-A: 在 \`docs/ui/\` 目录创建 JSON 模板文件，然后在步骤 4 中指定模板路径。
+const PROMPT_TEMPLATE_GUIDED = `# 快速开始
+
+**职责说明**: 本工具仅提供执行指导，不执行实际操作。请按顺序调用以下 MCP 工具。
+
+执行以下工具：
+
+1. 检查 \`docs/project-context.md\` 是否存在，不存在则调用 \`init_project_context\`
+2. 检查 \`docs/design-system.md\` 是否存在，不存在则调用 \`ui_design_system --product_type="{productType}" --stack="{framework}"\`
+3. 检查 \`docs/ui/component-catalog.json\` 是否存在，不存在则调用 \`init_component_catalog\`
+4. \`ui_search --mode=template --query="{description}"\`
+5. 选择模板并保存到 \`docs/ui/{templateName}.json\`
+6. \`render_ui --template="docs/ui/{templateName}.json" --framework="{framework}"\`
+7. 将生成的 UI 文档添加到 \`docs/project-context.md\` 索引中
+
+---
+
+## 步骤 1: 生成项目上下文（如不存在）📋
+
+**检查**: 查看 \`docs/project-context.md\` 是否存在
+
+**如果不存在，调用工具**: \`init_project_context\`
+**参数**: 无（使用默认配置）
+
+**预期输出**: 
+- \`docs/project-context.md\` - 项目上下文索引文件
+- \`docs/project-context/\` - 项目文档目录
+
+**失败处理**: 确保 docs 目录存在且有写入权限
+
+---
+
+## 步骤 2: 生成设计系统（如不存在）🎨
+
+**检查**: 查看 \`docs/design-system.md\` 是否存在
+
+**如果不存在，调用工具**: \`ui_design_system\`
+**参数**:
+\`\`\`json
+{
+  "product_type": "{productType}",
+  "stack": "{framework}",
+  "description": "{description}"
+}
+\`\`\`
+
+**预期输出**: \`docs/design-system.json\` 和 \`docs/design-system.md\`
+**失败处理**: 检查 docs 目录是否存在，确保有写入权限
+
+---
+
+## 步骤 3: 生成组件目录（如不存在）📦
+
+**检查**: 查看 \`docs/ui/component-catalog.json\` 是否存在
+
+**如果不存在，调用工具**: \`init_component_catalog\`
+**参数**: 无
+
+**预期输出**: \`docs/ui/component-catalog.json\`
+**失败处理**: 确保步骤 2 的设计系统文件已生成
+
+---
+
+## 步骤 4: 搜索 UI 模板 🔍
+
+**工具**: \`ui_search\`
+**参数**:
+\`\`\`json
+{
+  "mode": "template",
+  "query": "{description}"
+}
+\`\`\`
+
+**预期输出**: 匹配的模板列表（可能为空）
+**失败处理**: 如果没有找到模板，创建最小模板文件再进入渲染步骤
+
+---
+
+## 步骤 5: 保存模板文件 🧩
+
+**操作**: 从搜索结果选择模板或创建最小模板
+
+**保存路径**: \`docs/ui/{templateName}.json\`
+
+**最小模板示例**:
+\`\`\`json
+{
+  "name": "UiTemplate",
+  "description": "{description}",
+  "layout": "sectioned"
+}
+\`\`\`
+
+---
+
+## 步骤 6: 渲染最终代码 💻
+
+**工具**: \`render_ui\`
+**参数**:
+\`\`\`json
+{
+  "template": "docs/ui/{templateName}.json",
+  "framework": "{framework}"
+}
+\`\`\`
+
+**预期输出**: 完整的 {framework} 组件代码
+**失败处理**: 如果模板不存在，请先完成步骤 5 保存模板文件
+
+---
+
+## 步骤 7: 更新项目上下文索引 📝
+
+**操作**: 将生成的 UI 文档添加到 \`docs/project-context.md\` 中
+
+**添加内容**:
+在 "## 📚 文档导航" 部分添加：
+
+\`\`\`markdown
+### [UI 设计系统](./design-system.md)
+项目的 UI 设计规范，包括颜色、字体、组件样式等
+
+### [UI 组件目录](./ui/component-catalog.json)
+可用的 UI 组件及其属性定义
+\`\`\`
+
+在 "## 💡 开发时查看对应文档" 部分的 "添加新功能" 下添加：
+\`\`\`markdown
+- **UI 设计系统**: [design-system.md](./design-system.md) - 查看设计规范
+- **UI 组件目录**: [ui/component-catalog.json](./ui/component-catalog.json) - 查看可用组件
+\`\`\`
+
+**预期结果**: \`docs/project-context.md\` 包含 UI 相关文档的链接
+**失败处理**: 如果文件不存在，跳过此步骤
+
+---
+
+## 高级选项
+
+### 自定义设计系统
+编辑 \`docs/design-system.json\` 修改颜色、字体等，然后重新运行。
+
+### 自定义组件
+编辑 \`docs/ui/component-catalog.json\` 添加新组件定义。
+
+### 常见问题
+
+**Q: 设计系统文件已存在，还需要重新生成吗？**
+A: 不需要。如果文件已存在，直接跳过步骤 1。
+
+**Q: 如何使用自定义模板？**
+A: 在 \`docs/ui/\` 目录创建 JSON 模板文件，然后在步骤 4 中指定模板路径。
 `;
-const PROMPT_TEMPLATE_STRICT = `# UI 开发编排（严格）
-
-**职责说明**: 本工具仅提供执行指导，不执行实际操作。请按顺序调用以下 MCP 工具。
-
-## ✅ 执行计划
-
-1. 检查 \`docs/project-context.md\`，缺失则调用 \`init_project_context\`
-2. 检查 \`docs/design-system.md\`，缺失则调用 \`ui_design_system --product_type="{productType}" --stack="{framework}"\`
-3. 检查 \`docs/ui/component-catalog.json\`，缺失则调用 \`init_component_catalog\`
-4. \`ui_search --mode=template --query="{description}"\`
-5. 选择模板并保存到 \`docs/ui/{templateName}.json\`
-6. \`render_ui --template="docs/ui/{templateName}.json" --framework="{framework}"\`
-7. 将生成的 UI 文档添加到 \`docs/project-context.md\` 索引中
-
----
-
-## 步骤 1: 生成项目上下文（如不存在）
-
-**检查**: \`docs/project-context.md\`
-**缺失则调用**: \`init_project_context\`
-**预期输出**: \`docs/project-context.md\`
-
----
-
-## 步骤 2: 生成设计系统（如不存在）
-
-**检查**: \`docs/design-system.md\`
-**缺失则调用**: \`ui_design_system\`
-\`\`\`json
-{
-  "product_type": "{productType}",
-  "stack": "{framework}",
-  "description": "{description}"
-}
-\`\`\`
-**预期输出**: \`docs/design-system.json\`、\`docs/design-system.md\`
-
----
-
-## 步骤 3: 生成组件目录（如不存在）
-
-**检查**: \`docs/ui/component-catalog.json\`
-**缺失则调用**: \`init_component_catalog\`
-**预期输出**: \`docs/ui/component-catalog.json\`
-
----
-
-## 步骤 4: 搜索模板
-
-**工具**: \`ui_search\`
-\`\`\`json
-{ "mode": "template", "query": "{description}" }
-\`\`\`
-
----
-
-## 步骤 5: 保存模板文件
-
-**操作**: 从搜索结果选择模板或创建最小模板
-
-**保存路径**: \`docs/ui/{templateName}.json\`
-
----
-
-## 步骤 6: 渲染代码
-
-**工具**: \`render_ui\`
-\`\`\`json
-{ "template": "docs/ui/{templateName}.json", "framework": "{framework}" }
-\`\`\`
-
----
-
-## 步骤 7: 更新项目上下文索引
-
-将 UI 文档链接添加到 \`docs/project-context.md\`
+const PROMPT_TEMPLATE_STRICT = `# UI 开发编排（严格）
+
+**职责说明**: 本工具仅提供执行指导，不执行实际操作。请按顺序调用以下 MCP 工具。
+
+## ✅ 执行计划
+
+1. 检查 \`docs/project-context.md\`，缺失则调用 \`init_project_context\`
+2. 检查 \`docs/design-system.md\`，缺失则调用 \`ui_design_system --product_type="{productType}" --stack="{framework}"\`
+3. 检查 \`docs/ui/component-catalog.json\`，缺失则调用 \`init_component_catalog\`
+4. \`ui_search --mode=template --query="{description}"\`
+5. 选择模板并保存到 \`docs/ui/{templateName}.json\`
+6. \`render_ui --template="docs/ui/{templateName}.json" --framework="{framework}"\`
+7. 将生成的 UI 文档添加到 \`docs/project-context.md\` 索引中
+
+---
+
+## 步骤 1: 生成项目上下文（如不存在）
+
+**检查**: \`docs/project-context.md\`
+**缺失则调用**: \`init_project_context\`
+**预期输出**: \`docs/project-context.md\`
+
+---
+
+## 步骤 2: 生成设计系统（如不存在）
+
+**检查**: \`docs/design-system.md\`
+**缺失则调用**: \`ui_design_system\`
+\`\`\`json
+{
+  "product_type": "{productType}",
+  "stack": "{framework}",
+  "description": "{description}"
+}
+\`\`\`
+**预期输出**: \`docs/design-system.json\`、\`docs/design-system.md\`
+
+---
+
+## 步骤 3: 生成组件目录（如不存在）
+
+**检查**: \`docs/ui/component-catalog.json\`
+**缺失则调用**: \`init_component_catalog\`
+**预期输出**: \`docs/ui/component-catalog.json\`
+
+---
+
+## 步骤 4: 搜索模板
+
+**工具**: \`ui_search\`
+\`\`\`json
+{ "mode": "template", "query": "{description}" }
+\`\`\`
+
+---
+
+## 步骤 5: 保存模板文件
+
+**操作**: 从搜索结果选择模板或创建最小模板
+
+**保存路径**: \`docs/ui/{templateName}.json\`
+
+---
+
+## 步骤 6: 渲染代码
+
+**工具**: \`render_ui\`
+\`\`\`json
+{ "template": "docs/ui/{templateName}.json", "framework": "{framework}" }
+\`\`\`
+
+---
+
+## 步骤 7: 更新项目上下文索引
+
+将 UI 文档链接添加到 \`docs/project-context.md\`
 `;
-const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 UI 需求澄清与补全（Requirements Loop）
-
-本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 UI 需求关键要素。
-
-## 🎯 目标
-UI 需求：{description}
-
-## ✅ 规则
-1. **不覆盖用户原始描述**
-2. **补全内容必须标注来源**（User / Derived / Assumption）
-3. **假设必须进入待确认列表**
-4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
-
----
-
-## 🔁 执行步骤（每轮）
-
-### 1) 生成待确认问题
-使用 \`ask_user\` 提问，问题来源于 UI 需求补全清单（目标/交互/状态/设备/可访问性）。
-
-### 2) 更新结构化输出
-将回答补入 \`requirements\`，并标注来源。
-
-### 3) 自检与结束
-若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入 UI 执行计划。
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，按 delegated plan 执行：
-- 设计系统 → 组件目录 → 模板搜索 → 保存模板 → 渲染代码 → 更新上下文
-
----
-
-*编排工具: MCP Probe Kit - start_ui (requirements loop)*
+const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 UI 需求澄清与补全（Requirements Loop）
+
+本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 UI 需求关键要素。
+
+## 🎯 目标
+UI 需求：{description}
+
+## ✅ 规则
+1. **不覆盖用户原始描述**
+2. **补全内容必须标注来源**（User / Derived / Assumption）
+3. **假设必须进入待确认列表**
+4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
+
+---
+
+## 🔁 执行步骤（每轮）
+
+### 1) 生成待确认问题
+使用 \`ask_user\` 提问，问题来源于 UI 需求补全清单（目标/交互/状态/设备/可访问性）。
+
+### 2) 更新结构化输出
+将回答补入 \`requirements\`，并标注来源。
+
+### 3) 自检与结束
+若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入 UI 执行计划。
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，按 delegated plan 执行：
+- 设计系统 → 组件目录 → 模板搜索 → 保存模板 → 渲染代码 → 更新上下文
+
+---
+
+*编排工具: MCP Probe Kit - start_ui (requirements loop)*
 `;
-const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 UI 需求澄清与补全（Requirements Loop | 严格）
-
-本模式用于稳健补全 UI 需求关键要素，不改变用户意图。
-
-## 🎯 目标
-UI 需求：{description}
-
-## ✅ 规则
-1. 不覆盖用户原始描述
-2. 补全内容必须标注来源（User / Derived / Assumption）
-3. 假设必须进入待确认列表
-4. 每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}
-
----
-
-## 🔁 执行步骤（每轮）
-1) 使用 \`ask_user\` 提问补全关键信息
-2) 更新结构化输出并标注来源
-3) 若 \`openQuestions\` 为空且无高风险假设则结束
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，按 delegated plan 执行 UI 计划
-
----
-
-*编排工具: MCP Probe Kit - start_ui (requirements loop)*
+const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 UI 需求澄清与补全（Requirements Loop | 严格）
+
+本模式用于稳健补全 UI 需求关键要素，不改变用户意图。
+
+## 🎯 目标
+UI 需求：{description}
+
+## ✅ 规则
+1. 不覆盖用户原始描述
+2. 补全内容必须标注来源（User / Derived / Assumption）
+3. 假设必须进入待确认列表
+4. 每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}
+
+---
+
+## 🔁 执行步骤（每轮）
+1) 使用 \`ask_user\` 提问补全关键信息
+2) 更新结构化输出并标注来源
+3) 若 \`openQuestions\` 为空且无高风险假设则结束
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，按 delegated plan 执行 UI 计划
+
+---
+
+*编排工具: MCP Probe Kit - start_ui (requirements loop)*
 `;
 function buildUiQuestions(questionBudget) {
     const base = [
@@ -565,6 +565,17 @@ export async function startUi(args, context) {
         headerNotes.push(buildSkillHeaderNote(skillBridge));
         const memoryContext = await loadMemoryInjectionContext(description || templateName, 'ui');
         const memoryGuideSection = renderMemoryGuideSection(memoryContext);
+        // 记忆优先：先复用历史 UI 资产/模式并规避历史 UI 坑，再进入设计与渲染
+        const memoryRecallStep = memoryContext.enabled
+            ? [{
+                    id: 'recall-memory',
+                    tool: 'search_memory',
+                    when: '开干前（下方「历史经验与坑」已自动注入相似 UI 资产与坑；需要更多时再调）',
+                    args: { query: description || templateName, limit: 5 },
+                    outputs: [],
+                    note: '先复用历史可复用 UI 组件/布局/交互模式，并规避历史 UI 坑（交互/兼容性/可访问性）',
+                }]
+            : [];
         // 验证 mode 参数
         const validModes = ["auto", "manual"];
         if (mode && !validModes.includes(mode)) {
@@ -572,15 +583,15 @@ export async function startUi(args, context) {
                 content: [
                     {
                         type: "text",
-                        text: `❌ 无效的模式: ${mode}
-
-**有效选项**: auto, manual
-
-**示例**:
-\`\`\`
-start_ui "登录页面" --mode=manual
-start_ui "用户列表" --mode=auto
-\`\`\`
+                        text: `❌ 无效的模式: ${mode}
+
+**有效选项**: auto, manual
+
+**示例**:
+\`\`\`
+start_ui "登录页面" --mode=manual
+start_ui "用户列表" --mode=auto
+\`\`\`
 `,
                     },
                 ],
@@ -596,11 +607,11 @@ start_ui "用户列表" --mode=auto
                     content: [
                         {
                             type: "text",
-                            text: `❌ 缺少必要参数
-
-**用法**:
-\`\`\`
-start_ui <描述> --requirements_mode=loop
+                            text: `❌ 缺少必要参数
+
+**用法**:
+\`\`\`
+start_ui <描述> --requirements_mode=loop
 \`\`\``,
                         },
                     ],
@@ -629,6 +640,7 @@ start_ui <描述> --requirements_mode=loop
             const plan = {
                 mode: 'delegated',
                 steps: [
+                    ...memoryRecallStep,
                     skillBridgeStep,
                     {
                         id: 'loop-1',
@@ -712,17 +724,17 @@ start_ui <描述> --requirements_mode=loop
                 ],
                 notes: [
                     ...headerNotes,
-                    ...(memoryContext.enabled ? ['记忆系统: 已启用，先复用历史 UI 资产，再决定是否沉淀本次结果'] : []),
+                    ...(memoryContext.enabled ? ['记忆优先: 已自动注入相似历史 UI 资产与坑（见顶部），先复用并规避同类坑；再决定是否沉淀'] : []),
                 ],
             });
             const loopTemplate = profileDecision.resolved === 'strict'
                 ? LOOP_PROMPT_TEMPLATE_STRICT
                 : LOOP_PROMPT_TEMPLATE_GUIDED;
-            const guide = header + skillBridgeSection + loopTemplate
+            const renderedLoopPrompt = loopTemplate
                 .replace(/{description}/g, description)
                 .replace(/{question_budget}/g, String(questionBudget))
-                .replace(/{assumption_cap}/g, String(assumptionCap))
-                + memoryGuideSection;
+                .replace(/{assumption_cap}/g, String(assumptionCap));
+            const guide = header + memoryGuideSection + skillBridgeSection + renderedLoopPrompt;
             const loopReport = {
                 mode: 'loop',
                 round: 1,
@@ -780,88 +792,89 @@ start_ui <描述> --requirements_mode=loop
             const inferredStack = framework; // 保持用户指定的技术栈，或默认为 react
             // 5. 生成智能执行计划
             const searchQuery = description || templateName;
-            const smartPlanGuided = `# 🚀 智能 UI 开发计划
-
-基于您的描述 "**${description}**"，AI 引擎已为您规划了最佳开发路径。
-
-## 🧠 智能分析结果
-
-- **产品类型**: ${inferredProductType}
-- **推荐风格**: ${recommendation.style.primary}
-- **关键特性**: ${inferredKeywords}
-- **技术栈**: ${inferredStack}
-
----
-
-## 📋 执行步骤（已自动优化参数）
-
-请按顺序执行以下命令：
-
-### 1. 生成项目上下文 📋
-\`\`\`bash
-init_project_context
-\`\`\`
-
-### 2. 生成设计系统 🎨
-\`\`\`bash
-ui_design_system --product_type="${inferredProductType}" --stack="${inferredStack}" --keywords="${inferredKeywords}" --description="${description}"
-\`\`\`
-
-### 3. 生成组件目录 📦
-\`\`\`bash
-init_component_catalog
-\`\`\`
-
-### 4. 生成 UI 模板 📄
-\`\`\`bash
-# 搜索现有模板或生成新模板
-ui_search --mode=template --query="${searchQuery}"
-\`\`\`
-
-### 5. 保存模板文件 🧩
-\`\`\`bash
-# 将选中的模板保存到本地
-# 目标路径：docs/ui/${templateName}.json
-\`\`\`
-
-### 6. 渲染代码 💻
-\`\`\`bash
-render_ui docs/ui/${templateName}.json --framework="${inferredStack}"
-\`\`\`
-
-### 7. 更新项目上下文 📝
-将生成的 UI 文档链接添加到 \`docs/project-context.md\` 的文档导航部分。
-
----
-
-## 💡 为什么选择这个方案？
-
-${recommendation.reasoning}
+            const smartPlanGuided = `# 🚀 智能 UI 开发计划
+
+基于您的描述 "**${description}**"，AI 引擎已为您规划了最佳开发路径。
+
+## 🧠 智能分析结果
+
+- **产品类型**: ${inferredProductType}
+- **推荐风格**: ${recommendation.style.primary}
+- **关键特性**: ${inferredKeywords}
+- **技术栈**: ${inferredStack}
+
+---
+
+## 📋 执行步骤（已自动优化参数）
+
+请按顺序执行以下命令：
+
+### 1. 生成项目上下文 📋
+\`\`\`bash
+init_project_context
+\`\`\`
+
+### 2. 生成设计系统 🎨
+\`\`\`bash
+ui_design_system --product_type="${inferredProductType}" --stack="${inferredStack}" --keywords="${inferredKeywords}" --description="${description}"
+\`\`\`
+
+### 3. 生成组件目录 📦
+\`\`\`bash
+init_component_catalog
+\`\`\`
+
+### 4. 生成 UI 模板 📄
+\`\`\`bash
+# 搜索现有模板或生成新模板
+ui_search --mode=template --query="${searchQuery}"
+\`\`\`
+
+### 5. 保存模板文件 🧩
+\`\`\`bash
+# 将选中的模板保存到本地
+# 目标路径：docs/ui/${templateName}.json
+\`\`\`
+
+### 6. 渲染代码 💻
+\`\`\`bash
+render_ui docs/ui/${templateName}.json --framework="${inferredStack}"
+\`\`\`
+
+### 7. 更新项目上下文 📝
+将生成的 UI 文档链接添加到 \`docs/project-context.md\` 的文档导航部分。
+
+---
+
+## 💡 为什么选择这个方案？
+
+${recommendation.reasoning}
 `;
-            const smartPlanStrict = `# 🚀 智能 UI 开发计划（严格）
-
-## 🧠 智能分析结果
-
-- **产品类型**: ${inferredProductType}
-- **推荐风格**: ${recommendation.style.primary}
-- **关键特性**: ${inferredKeywords}
-- **技术栈**: ${inferredStack}
-
----
-
-## 📋 执行步骤
-
-1) init_project_context
-2) ui_design_system --product_type="${inferredProductType}" --stack="${inferredStack}" --keywords="${inferredKeywords}" --description="${description}"
-3) init_component_catalog
-4) ui_search --mode=template --query="${searchQuery}"
-5) 保存模板到 docs/ui/${templateName}.json
-6) render_ui docs/ui/${templateName}.json --framework="${inferredStack}"
-7) 更新 project-context.md 索引
+            const smartPlanStrict = `# 🚀 智能 UI 开发计划（严格）
+
+## 🧠 智能分析结果
+
+- **产品类型**: ${inferredProductType}
+- **推荐风格**: ${recommendation.style.primary}
+- **关键特性**: ${inferredKeywords}
+- **技术栈**: ${inferredStack}
+
+---
+
+## 📋 执行步骤
+
+1) init_project_context
+2) ui_design_system --product_type="${inferredProductType}" --stack="${inferredStack}" --keywords="${inferredKeywords}" --description="${description}"
+3) init_component_catalog
+4) ui_search --mode=template --query="${searchQuery}"
+5) 保存模板到 docs/ui/${templateName}.json
+6) render_ui docs/ui/${templateName}.json --framework="${inferredStack}"
+7) 更新 project-context.md 索引
 `;
             const plan = {
                 mode: 'delegated',
                 steps: [
+                    ...memoryRecallStep,
                     skillBridgeStep,
                     {
                         id: 'context',
@@ -929,10 +942,10 @@ ${recommendation.reasoning}
                 ],
                 notes: [
                     ...headerNotes,
-                    ...(memoryContext.enabled ? ['记忆系统: 已启用，相似历史 UI 经验全文已自动注入'] : []),
+                    ...(memoryContext.enabled ? ['记忆优先: 已自动注入相似历史 UI 资产与坑（见顶部），先复用并规避同类坑'] : []),
                 ],
             });
-            const smartPlan = header + skillBridgeSection + (profileDecision.resolved === 'strict' ? smartPlanStrict : smartPlanGuided) + memoryGuideSection;
+            const smartPlan = header + memoryGuideSection + skillBridgeSection + (profileDecision.resolved === 'strict' ? smartPlanStrict : smartPlanGuided);
             // Create structured UI report for auto mode
             const uiReport = {
                 summary: `智能 UI 开发：${description}`,
@@ -1015,23 +1028,23 @@ ${recommendation.reasoning}
                 content: [
                     {
                         type: "text",
-                        text: `❌ 缺少必要参数
-
-**用法**:
-\`\`\`
-start_ui <描述> [--framework=react|vue|html]
-\`\`\`
-
-**示例**:
-\`\`\`
-start_ui "登录页面"
-start_ui "用户列表" --framework=vue
-start_ui "设置页面" --framework=react
-\`\`\`
-
-**提示**: 
-- 确保已运行 \`ui_design_system\` 生成设计系统
-- 组件目录会自动生成（如果不存在）
+                        text: `❌ 缺少必要参数
+
+**用法**:
+\`\`\`
+start_ui <描述> [--framework=react|vue|html]
+\`\`\`
+
+**示例**:
+\`\`\`
+start_ui "登录页面"
+start_ui "用户列表" --framework=vue
+start_ui "设置页面" --framework=react
+\`\`\`
+
+**提示**: 
+- 确保已运行 \`ui_design_system\` 生成设计系统
+- 组件目录会自动生成（如果不存在）
 `,
                     },
                 ],
@@ -1060,21 +1073,22 @@ start_ui "设置页面" --framework=react
             ],
             notes: [
                 ...headerNotes,
-                ...(memoryContext.enabled ? ['记忆系统: 已启用，相似历史 UI 经验全文已自动注入'] : []),
+                ...(memoryContext.enabled ? ['记忆优先: 已自动注入相似历史 UI 资产与坑（见顶部），先复用并规避同类坑'] : []),
             ],
         });
         const baseTemplate = profileDecision.resolved === 'strict'
             ? PROMPT_TEMPLATE_STRICT
             : PROMPT_TEMPLATE_GUIDED;
-        let guide = header + skillBridgeSection + baseTemplate;
-        guide = safeReplace(guide, '{description}', escapeJson(description));
-        guide = safeReplace(guide, '{productType}', productType);
-        guide = safeReplace(guide, '{framework}', framework);
-        guide = safeReplace(guide, '{templateName}', templateName);
-        guide += memoryGuideSection;
+        let body = skillBridgeSection + baseTemplate;
+        body = safeReplace(body, '{description}', escapeJson(description));
+        body = safeReplace(body, '{productType}', productType);
+        body = safeReplace(body, '{framework}', framework);
+        body = safeReplace(body, '{templateName}', templateName);
+        const guide = header + memoryGuideSection + body;
         const plan = {
             mode: 'delegated',
             steps: [
+                ...memoryRecallStep,
                 skillBridgeStep,
                 {
                     id: 'context',