uxos 0.0.21 → 0.0.23

package/README.md

@@ -0,0 +1,72 @@
+# UXOS
+
+UXOS - 设计效率助手：一个由 AI 驱动的、具有引导式工作流的设计协作系统。
+
+## 安装方法
+
+**⚠️ 重要提示**：首次安装或更新时，请使用以下命令清除缓存：
+
+```bash
+# 清除 npm 缓存
+npm cache clean --force
+
+# 删除 npx 缓存
+rm -rf ~/.npm/_npx
+```
+
+**方法一：通过 AI 助手安装**
+
+在 CodeBuddy 的 AI 助手中输入以下指令：
+
+```
+帮我安装 npx uxos
+```
+
+**方法二：命令行安装**
+
+```bash
+# 强制安装最新版本
+npx --yes uxos@latest
+```
+
+然后跟随 AI 助手的指引即可完成安装。
+
+## 使用说明
+
+安装完成后，UXOS 会自动在工作目录创建 `_uxos/` 文件夹。AI 助手会引导你阅读初始化指南并开始使用。
+
+## 功能特性
+
+- **工作流系统**：产品设计和开发的引导式工作流
+- **记忆引擎**：上下文感知的决策跟踪
+- **产品简报**：结构化的产品需求收集
+
+## 常见问题
+
+### 如何更新到最新版本？
+
+在 AI 助手中输入：
+```
+帮我更新 npx uxos
+```
+
+### 如何查看已安装的版本？
+
+**方式一：命令行查看**
+
+```bash
+npx uxos --version
+# 或
+npx uxos -v
+```
+
+**方式二：通过 AI 助手查看**
+
+在 AI 助手中输入：
+```
+查看 uxos 版本
+```
+
+## 许可证
+
+MIT

package/cli.js

@@ -3,6 +3,10 @@
 const fs = require('fs');
 const path = require('path');
 
+// Read version from package.json
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
+const VERSION = packageJson.version;
+
 const UXOS_SRC_DIR = path.join(__dirname, '_uxos');
 
 function createDirectory(dir) {
@@ -42,9 +46,41 @@ function copyDirectory(src, dest) {
 }
 
 function main() {
+  // Check for --version flag
+  if (process.argv.includes('--version') || process.argv.includes('-v')) {
+    console.log(VERSION);
+    return;
+  }
+
+  // Check for old version structure and warn user
+  const oldWorkflowsDir = path.join(__dirname, 'workflows');
+  const oldTemplatesDir = path.join(__dirname, 'templates');
+  if (fs.existsSync(oldWorkflowsDir) || fs.existsSync(oldTemplatesDir)) {
+    console.log(`
+═══════════════════════════════════════════════════════════
+⚠️  WARNING: OLD VERSION DETECTED
+═══════════════════════════════════════════════════════════
+
+You are using an outdated version of UXOS.
+
+To update to the latest version, run:
+
+  npm cache clean --force
+  rm -rf ~/.npm/_npx
+  npx --yes uxos@latest
+
+Current version: OLD (0.0.21 or earlier)
+Latest version:  0.0.22+
+
+For more information, visit: https://www.npmjs.com/package/uxos
+`);
+    process.exit(1);
+  }
+
   console.log(`
 ═══════════════════════════════════════════════════════════
                     UXOS INSTALLER
+                    Version: ${VERSION}
 ═══════════════════════════════════════════════════════════
 
 Installing UXOS workflow system...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uxos",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "UXOS - Design Efficiency Assistant: A guided workflow system for AI-powered design collaboration",
   "main": "cli.js",
   "bin": {

package/_uxos/workflow-integration-plan.md

@@ -1,714 +0,0 @@
-# Memory-Engine 与 Create-Product-Brief 工作流衔接计划
-
-**文档创建时间：** 2026-01-21 10:10  
-**状态：** 待实施（已完成深度分析）  
-**优先级：** P1（暂时搁置，但已梳理清楚）
-
----
-
-## 一、项目背景
-
-### 1.1 初始需求
-
-在构建 **memory-engine 工作流**时，有两个位置需要提供"细化内容"的选项：
-
-1. **Step 4 - 生成阶段**（`step-04-generate.md`）
-   - 位置：阶段 B "展示理解 + 确认" 的选项 2
-   - 场景：用户在看到 AI 推导的产品上下文后，想要进一步细化
-
-2. **Step 5 - 完成阶段**（`step-05-finalize.md`）
-   - 位置：完成后的选项 2
-   - 场景：初始化完成后，用户想要补充完善记忆引擎内容
-
-这两个位置都需要链接到一个**专业的细化工作流**。
-
-### 1.2 工作流概述
-
-#### Memory-Engine 工作流
-- **路径：** `/data/workspace/nice/memory-engine/`
-- **目标：** 为产品设计项目建立持久化的记忆引擎
-- **输入：** 2 个必要信息（产品名 + 竞品/产品价值）
-- **输出：** 生成到 `.codebuddy/rules/uxos/` 的规则文件
-  - `context.md`（核心上下文，Always 加载）
-  - `personas/*.md`（用户画像详情）
-  - `decisions.md`（决策记录）
-  - `uxos-index.md`（知识库索引）
-  - `update-memory.md`（更新指南）
-- **特点：** 快速推导，低摩擦交互
-
-#### Create-Product-Brief 工作流
-- **路径：** `/data/workspace/nice/create-product-brief/`
-- **目标：** 通过协作式逐步发现创建全面的产品简报
-- **输入：** 通过"输入文档发现"机制自动查找项目文档
-- **输出：** 生成到 `.codebuddy/rules/uxos/brief.md` 的简报文档
-- **特点：** 深度协作，系统化发现
-
----
-
-## 二、当前状态
-
-### 2.1 已完成的工作
-
-✅ **简单衔接（已实施）**
-
-在 memory-engine 的两个位置添加了对 create-product-brief 的调用：
-
-**修改文件 1：** `nice/memory-engine/steps/step-04-generate.md`
-```markdown
-**选项 2：细化内容**
-
-工作流调用：`/data/workspace/nice/create-product-brief/workflow.md`
-
-上下文传递：
-- 产品名称：{产品名}
-- 对标竞品：{竞品，如无则传空}
-- 当前差异化：{差异化描述}
-- 已识别用户角色：{角色列表}
-```
-
-**修改文件 2：** `nice/memory-engine/steps/step-05-finalize.md`
-```markdown
-**选项 2：细化**
-
-工作流调用：`/data/workspace/nice/create-product-brief/workflow.md`
-
-上下文传递：
-- 已生成的 context.md 内容
-- personas/ 目录中的用户画像
-- 当前的体验原则和定位信息
-```
-
-**问题：** 这只是"表面衔接"，实际上无法正常工作。
-
-### 2.2 深度分析发现的问题
-
-#### 问题 1：文件无法被发现 ❌
-
-**Create-Product-Brief 的发现逻辑（step-01-init.md）：**
-
-```markdown
-发现路径：
-- {planning_artifacts}/**
-- {output_folder}/**
-- {product_knowledge}/**
-- docs/**
-
-发现模式：
-- *brainstorming*.md
-- *research*.md
-- **/project-context.md
-- 分片文件夹（folder/index.md）
-```
-
-**Memory-Engine 生成的文件：**
-```
-.codebuddy/rules/uxos/
-├── context.md
-├── personas/
-│   ├── _index.md
-│   ├── pm.md
-│   └── designer.md
-├── decisions.md
-└── uxos-index.md
-```
-
-**问题：** 文件名模式不匹配，无法被自动发现！
-
-#### 问题 2：数据格式不兼容 ❌
-
-**Memory-Engine 的 context.md 格式：**
-```markdown
-## 产品定位
-- 产品类型：AI 技能工具
-- 差异化：xxx
-- 愿景：xxx
-
-## 目标用户
-| 角色 | 描述 | 详情链接 |
-|------|------|----------|
-| 产品经理 | ... | → personas/pm.md |
-```
-
-**Create-Product-Brief 期望的输入格式：**
-- 头脑风暴报告（自由形式的讨论）
-- 研究文档（分析报告）
-- 项目上下文（概览性描述）
-
-**问题：** 格式和粒度都不同，AI 无法直接使用！
-
-#### 问题 3：工作流定位冲突 ❌
-
-| 维度 | Memory-Engine | Create-Product-Brief |
-|------|---------------|----------------------|
-| **目的** | 创建 AI 记忆引擎 | 创建产品简报文档 |
-| **输入方式** | 2 个必要信息 + AI 推导 | 协作式深度发现（6 个步骤）|
-| **输出位置** | `.codebuddy/rules/uxos/` | `.codebuddy/rules/uxos/brief.md` |
-| **输出性质** | 规则文件（Always 加载） | 规划文档（参考文档） |
-| **深度** | 概览 + 索引 | 详细 + 全面 |
-| **使用场景** | AI 自动加载理解项目 | 人类阅读的策划文档 |
-
-**问题：** 两者定位不同，简单调用会导致混乱！
-
-#### 问题 4：上下文传递机制缺失 ❌
-
-当前的"调用"只是文字说明，实际上：
-- 没有真正的参数传递机制
-- Create-Product-Brief 不知道从哪里读取已有信息
-- 无法判断是"全新创建"还是"基于已有细化"
-
----
-
-## 三、解决方案设计
-
-### 3.1 综合衔接方案（推荐）
-
-#### 核心思路
-
-1. **修改 Create-Product-Brief 的发现逻辑**
-   - 添加 Memory-Engine 源的特殊检测
-   - 识别 `.codebuddy/rules/uxos/` 下的文件
-   
-2. **创建"细化模式"入口**
-   - Step 2-5 增加"检查已有信息"逻辑
-   - 提供"基于现有深化"和"重新发现"两种路径
-   
-3. **实现真正的上下文传递**
-   - 通过文件路径传递
-   - 通过 frontmatter 标记来源
-
-4. **建立返回更新机制**
-   - 细化完成后可选更新 Memory-Engine 文件
-
-### 3.2 具体修改清单
-
-#### 修改 1：Create-Product-Brief Step-01-init.md
-
-**位置：** `nice/create-product-brief/steps/step-01-init.md`
-
-**在"#### A. 输入文档发现"部分后添加：**
-
-```markdown
-#### A-2. Memory-Engine 源检测
-
-<critical>
-在标准文档发现后，检测是否存在 Memory-Engine 生成的文件：
-
-**检测路径：**
-- `.codebuddy/rules/uxos/context.md`
-- `.codebuddy/rules/uxos/personas/_index.md`
-- `.codebuddy/rules/uxos/uxos-index.md`
-
-**如果检测到 Memory-Engine 源：**
-
-1. **加载文件：**
-   - 读取 `context.md` 的完整内容
-   - 读取 `personas/_index.md` 获取用户角色列表
-   - 读取所有 `personas/*.md` 文件
-
-2. **标记来源：**
-   - 在前置元数据中添加：`memoryEngineSource: true`
-   - 在前置元数据中添加：`memoryEngineFiles: [列出所有加载的文件]`
-
-3. **向用户确认：**
-   "我发现你已经通过 Memory-Engine 创建了项目记忆引擎：
-   
-   **已有信息：**
-   - 产品名称：{从 context.md 提取}
-   - 产品定位：{从 context.md 提取}
-   - 已识别用户角色：{从 context.md 提取}
-   - 用户画像详情：{personas 文件数量} 个
-   
-   这次创建产品简报，我将基于这些已有信息进行深化。
-   
-   你想包含其他文档吗，还是继续下一步？"
-
-4. **继续流程：**
-   - 如果用户确认，继续到步骤 B
-   - 如果用户提供其他文档，加载后继续
-</critical>
-```
-
-#### 修改 2：Create-Product-Brief Step-02-vision.md
-
-**位置：** `nice/create-product-brief/steps/step-02-vision.md`
-
-**在"### 1. 开始愿景发现"之前添加：**
-
-```markdown
-### 0. 检查 Memory-Engine 源
-
-<if condition="memoryEngineSource === true in frontmatter">
-
-**从 Memory-Engine 源提取信息：**
-从前置元数据 `memoryEngineFiles` 中加载的 context.md 提取：
-- 产品定位
-- 差异化描述
-- 愿景描述
-
-**展示已有信息并提供选择：**
-
-"我发现你已经通过 Memory-Engine 定义了基础的产品愿景：
-
-**已有信息：**
-```
-产品定位：{从 context.md 提取}
-差异化：{从 context.md 提取}
-愿景：{从 context.md 提取}
-```
-
-**请选择细化方式：**
-
-`1` **基于现有深化** — 我会在已有基础上引导你补充：
-   - 更详细的问题陈述和影响分析
-   - 竞争格局和现有解决方案缺口
-   - 更具体的差异化因素和不公平优势
-   
-`2` **重新发现** — 从头开始协作式愿景发现
-
-请选择：`1` 或 `2`"
-
-**处理用户选择：**
-
-- 如果选择 `1`：
-  - 跳过基础问题（"核心问题是什么？"等）
-  - 直接进入深化引导：
-    - "基于你的产品定位'{定位}'，我们来深入分析问题影响..."
-    - "针对差异化'{差异化}'，让我们挖掘不公平优势..."
-  - 在生成内容时，整合已有信息 + 新收集的细节
-  
-- 如果选择 `2`：
-  - 按原流程执行（从 ### 1. 开始愿景发现）
-  - 忽略已有信息，重新发现
-
-</if>
-
-<if condition="memoryEngineSource !== true">
-  按原流程执行
-</if>
-```
-
-#### 修改 3：Create-Product-Brief Step-03-users.md
-
-**位置：** `nice/create-product-brief/steps/step-03-users.md`
-
-**在"### 1. 开始用户发现"之前添加：**
-
-```markdown
-### 0. 检查 Memory-Engine 源
-
-<if condition="memoryEngineSource === true in frontmatter">
-
-**从 Memory-Engine 源提取用户信息：**
-从前置元数据 `memoryEngineFiles` 中加载：
-- context.md 中的用户角色表格
-- personas/_index.md 中的用户清单
-- 所有 personas/*.md 文件的详细内容
-
-**展示已有用户画像并提供选择：**
-
-"我发现你已经通过 Memory-Engine 识别了目标用户：
-
-**已识别用户角色：**
-{遍历 personas 文件，展示每个角色的概览}
-
-**请选择细化方式：**
-
-`1` **基于现有深化** — 我会在已有用户画像基础上引导你补充：
-   - 更生动的用户故事和背景
-   - 更详细的使用场景和任务
-   - 更具体的痛点和情感影响
-   - 完整的用户旅程映射
-   
-`2` **重新发现** — 从头开始协作式用户发现
-
-请选择：`1` 或 `2`"
-
-**处理用户选择：**
-
-- 如果选择 `1`：
-  - 遍历每个已识别的用户角色
-  - 为每个角色进行深化引导：
-    - "我们来丰富'{角色名}'的画像..."
-    - "给这个角色一个真实的姓名和背景故事..."
-  - 在生成内容时，整合已有信息 + 新收集的细节
-  
-- 如果选择 `2`：
-  - 按原流程执行
-  - 重新发现用户
-
-</if>
-
-<if condition="memoryEngineSource !== true">
-  按原流程执行
-</if>
-```
-
-#### 修改 4：Memory-Engine Step-04-generate.md
-
-**位置：** `nice/memory-engine/steps/step-04-generate.md`
-
-**在"选项 2：细化内容"部分修改为：**
-
-```markdown
-**选项 2：细化内容**
-
-<critical>
-启动 create-product-brief 工作流进行专业细化。
-
-**准备工作：**
-1. 确认已生成的文件位置：
-   - `.codebuddy/rules/uxos/context.md`
-   - `.codebuddy/rules/uxos/personas/`
-
-**调用工作流：**
-"好的，我将启动 create-product-brief 工作流来帮助你深化产品信息。
-
-这个工作流会：
-- 自动检测并读取你刚才生成的 context.md 和 personas
-- 基于已有信息，引导你补充更详细的内容
-- 最终生成完整的产品简报文档
-
-准备好了吗？我现在加载 create-product-brief 工作流..."
-
-**加载工作流：**
-加载并执行：`/data/workspace/nice/create-product-brief/workflow.md`
-
-**说明：**
-- create-product-brief 会自动检测 Memory-Engine 源
-- 它会提供"基于现有深化"选项
-- 完成后会生成 brief.md，你可以选择是否同步更新 memory-engine 文件
-</critical>
-```
-
-#### 修改 5：Memory-Engine Step-05-finalize.md
-
-**位置：** `nice/memory-engine/steps/step-05-finalize.md`
-
-**在"选项 2：细化"部分修改为：**
-
-```markdown
-**选项 2：细化**
-
-<critical>
-启动 create-product-brief 工作流进行专业细化。
-
-**确认已生成文件：**
-- `.codebuddy/rules/uxos/context.md`
-- `.codebuddy/rules/uxos/personas/`
-- `.codebuddy/rules/uxos/decisions.md`
-
-**调用工作流：**
-"好的，我将启动 create-product-brief 工作流来帮助你完善记忆引擎内容。
-
-这个工作流会：
-- 自动读取你的 context.md 和用户画像
-- 引导你补充更详细的产品愿景、用户旅程、成功指标
-- 生成完整的产品简报文档（brief.md）
-
-简报生成后，我会询问你是否要将细化的内容同步回 memory-engine 文件。
-
-准备好了吗？我现在加载 create-product-brief 工作流..."
-
-**加载工作流：**
-加载并执行：`/data/workspace/nice/create-product-brief/workflow.md`
-
-**后续处理：**
-- create-product-brief 完成后返回此处
-- 询问用户："是否要将 brief.md 中的细化内容同步更新到 context.md 和 personas？"
-- 如果是，使用 update-memory 规则更新相关文件
-</critical>
-```
-
-### 3.3 返回更新机制（可选）
-
-#### 修改 6：Create-Product-Brief Step-06-complete.md
-
-**在完成步骤中添加：**
-
-```markdown
-### 6. Memory-Engine 同步（可选）
-
-<if condition="memoryEngineSource === true in frontmatter">
-
-**检测到 Memory-Engine 源，提供同步选项：**
-
-"🔄 **同步选项**
-
-我发现你是基于 Memory-Engine 的信息创建的这份产品简报。
-
-现在简报已完成，包含了更详细的：
-- 产品愿景和问题陈述
-- 用户画像和旅程
-- 成功指标和 MVP 范围
-
-**你想要：**
-
-`1` **同步回 Memory-Engine** — 将简报中的细化内容更新到 context.md 和 personas
-`2` **保持独立** — 简报和 Memory-Engine 保持各自独立
-
-**说明：**
-- Memory-Engine：AI 自动加载的项目记忆（简洁、结构化）
-- Product Brief：完整的产品策划文档（详细、叙事性）
-- 同步会保持 Memory-Engine 的简洁性，只更新关键信息
-
-请选择：`1` 或 `2`"
-
-**如果选择 1：**
-- 提取 brief.md 中的关键信息
-- 使用增量更新方式修改 context.md 和 personas/*.md
-- 保持 Memory-Engine 文件的简洁结构
-- 向用户确认更新完成
-
-**如果选择 2：**
-- 仅完成 brief.md
-- 两者保持独立
-
-</if>
-```
-
----
-
-## 四、技术细节
-
-### 4.1 文件路径映射
-
-| Memory-Engine 输出 | Create-Product-Brief 使用 |
-|-------------------|--------------------------|
-| `.codebuddy/rules/uxos/context.md` | 作为 project-context 输入 |
-| `.codebuddy/rules/uxos/personas/*.md` | 作为用户画像基础 |
-| `.codebuddy/rules/uxos/uxos-index.md` | 作为索引参考 |
-
-### 4.2 数据转换逻辑
-
-**从 context.md 提取愿景信息：**
-```markdown
-Memory-Engine 格式：
-## 产品定位
-- 产品类型：{type}
-- 差异化：{differentiation}
-- 愿景：{vision}
-
-转换为 Brief 格式：
-## 核心愿景
-### 问题陈述
-{需要深化}
-### 提议解决方案
-{基于产品定位展开}
-### 关键差异化因素
-{基于差异化深化}
-```
-
-**从 personas/*.md 提取用户信息：**
-```markdown
-Memory-Engine 格式：
-# {角色名} 用户画像
-## 角色定义
-{description}
-## 典型场景
-1. {scenario1}
-## 核心痛点
-1. {pain1}
-
-转换为 Brief 格式：
-### 主要用户
-#### {角色名}
-**背景：** {需要引导用户补充}
-**问题体验：** {基于核心痛点展开}
-**成功愿景：** {需要引导用户补充}
-```
-
-### 4.3 前置元数据标记
-
-**Create-Product-Brief 的 brief.md frontmatter：**
-```yaml
----
-stepsCompleted: []
-inputDocuments: []
-memoryEngineSource: true  # 新增标记
-memoryEngineFiles:        # 新增字段
-  - .codebuddy/rules/uxos/context.md
-  - .codebuddy/rules/uxos/personas/_index.md
-  - .codebuddy/rules/uxos/personas/pm.md
-  - .codebuddy/rules/uxos/personas/designer.md
-date: { system-date }
-author: { user }
----
-```
-
----
-
-## 五、待办事项清单
-
-### 阶段 1：核心衔接（P0）
-
-- [ ] 修改 `create-product-brief/steps/step-01-init.md`
-  - [ ] 添加 Memory-Engine 源检测逻辑
-  - [ ] 实现文件自动加载
-  - [ ] 实现前置元数据标记
-
-- [ ] 修改 `create-product-brief/steps/step-02-vision.md`
-  - [ ] 添加"检查 Memory-Engine 源"逻辑
-  - [ ] 实现"基于现有深化"路径
-  - [ ] 实现数据整合逻辑
-
-- [ ] 修改 `create-product-brief/steps/step-03-users.md`
-  - [ ] 添加"检查 Memory-Engine 源"逻辑
-  - [ ] 实现基于已有画像的深化引导
-  - [ ] 实现数据整合逻辑
-
-### 阶段 2：调用优化（P1）
-
-- [ ] 修改 `memory-engine/steps/step-04-generate.md`
-  - [ ] 完善工作流调用说明
-  - [ ] 添加文件路径确认逻辑
-
-- [ ] 修改 `memory-engine/steps/step-05-finalize.md`
-  - [ ] 完善工作流调用说明
-  - [ ] 添加返回处理逻辑
-
-### 阶段 3：返回同步（P2，可选）
-
-- [ ] 修改 `create-product-brief/steps/step-06-complete.md`
-  - [ ] 添加 Memory-Engine 同步检测
-  - [ ] 实现同步更新逻辑
-  - [ ] 实现数据转换和精简
-
-### 阶段 4：测试验证（P0）
-
-- [ ] 端到端测试流程
-  - [ ] 测试全新 Memory-Engine → 细化
-  - [ ] 测试已有 Memory-Engine → 细化
-  - [ ] 测试同步更新功能
-
-- [ ] 边界情况测试
-  - [ ] Memory-Engine 文件不完整
-  - [ ] 用户选择重新发现
-  - [ ] 多次细化迭代
-
----
-
-## 六、注意事项和风险
-
-### 6.1 设计原则
-
-1. **非破坏性修改**
-   - 所有修改向后兼容
-   - Create-Product-Brief 仍可独立使用
-   - Memory-Engine 仍可独立使用
-
-2. **用户选择权**
-   - 检测到已有信息时，提供"深化"或"重新发现"选择
-   - 完成后提供"同步"或"保持独立"选择
-
-3. **保持各自特性**
-   - Memory-Engine：简洁、结构化
-   - Product Brief：详细、叙事性
-
-### 6.2 潜在风险
-
-| 风险 | 影响 | 缓解措施 |
-|------|------|----------|
-| 文件路径变化 | 检测失败 | 使用配置化路径 |
-| 数据格式演化 | 转换失败 | 添加版本检测 |
-| 用户期望不符 | 体验不佳 | 清晰说明两者定位差异 |
-| 同步导致数据丢失 | 内容覆盖 | 使用增量更新，提供预览 |
-
-### 6.3 后续优化方向
-
-1. **智能模式切换**
-   - 根据 Memory-Engine 内容完整度，自动建议跳过哪些步骤
-
-2. **双向同步**
-   - Brief 更新时可选同步回 Memory-Engine
-   - Memory-Engine 更新时可选同步到 Brief
-
-3. **版本管理**
-   - 记录每次细化的版本
-   - 支持查看细化历史
-
----
-
-## 七、快速实施指南
-
-### 如果要继续实施，按以下顺序执行：
-
-1. **先修改 Create-Product-Brief 的接收端（阶段 1）**
-   - 让它能检测和读取 Memory-Engine 源
-   - 让它能提供"基于现有深化"选项
-
-2. **再优化 Memory-Engine 的调用端（阶段 2）**
-   - 让调用说明更清晰
-   - 确保文件路径正确传递
-
-3. **最后实现返回同步（阶段 3，可选）**
-   - 这是增强功能，不是必需的
-
-4. **全程测试验证（阶段 4）**
-   - 每完成一个阶段就测试
-   - 确保不破坏现有功能
-
-### 预估工作量
-
-- 阶段 1：4-6 小时
-- 阶段 2：1-2 小时
-- 阶段 3：2-3 小时
-- 阶段 4：2-3 小时
-- **总计：9-14 小时**
-
----
-
-## 八、相关文件清单
-
-### 需要修改的文件
-
-```
-nice/create-product-brief/
-├── steps/
-│   ├── step-01-init.md          ← 修改：添加 Memory-Engine 源检测
-│   ├── step-02-vision.md        ← 修改：添加"基于现有深化"逻辑
-│   ├── step-03-users.md         ← 修改：添加"基于现有深化"逻辑
-│   └── step-06-complete.md      ← 修改：添加同步选项（可选）
-
-nice/memory-engine/
-├── steps/
-│   ├── step-04-generate.md      ← 修改：完善工作流调用
-│   └── step-05-finalize.md      ← 修改：完善工作流调用
-```
-
-### 涉及的输入/输出文件
-
-```
-.codebuddy/rules/uxos/
-├── context.md           ← Memory-Engine 输出，Brief 读取
-├── personas/            ← Memory-Engine 输出，Brief 读取
-│   ├── _index.md
-│   ├── pm.md
-│   └── designer.md
-├── decisions.md         ← Memory-Engine 输出
-├── uxos-index.md        ← Memory-Engine 输出
-├── update-memory.md     ← Memory-Engine 输出
-└── brief.md             ← Brief 输出（新增）
-```
-
----
-
-## 九、联系和参考
-
-### 相关文档
-
-- Memory-Engine 工作流计划：`_bmad-output/bmb-creations/workflows/memory-engine/workflow-plan-memory-engine.md`
-- 编辑计划：`_bmad-output/bmb-creations/edit-plan-create-product-brief.md`
-- Memory-Engine 决策记录：`ME/decisions.md`（已删除，需重建）
-
-### 关键决策
-
-- **决策 #30-34**：Memory-Engine 的 BMAD 架构转换
-- **按需加载原则**：Memory-Engine 采用概览+索引模式
-- **低摩擦交互**：Memory-Engine 只问 2 个必要问题
-- **协作式发现**：Create-Product-Brief 的核心理念
-
----
-
-**文档状态：** ✅ 已完成深度分析，待实施  
-**下次捡起来时：** 直接看"五、待办事项清单"开始执行  
-**任何 AI 接手：** 阅读本文档即可理解全貌并继续工作