uxos 0.0.14 → 0.0.16

package/_uxos/memory-engine/steps/step-01-discovery.md

@@ -0,0 +1,119 @@
+---
+name: 'step-01-discovery'
+description: '信息收集：检索项目文件夹文档和分析对话历史，提取产品核心信息'
+nextStepFile: './step-02-evaluation.md'
+---
+
+# Step 1: 信息收集
+
+## 步骤目标
+
+检索项目文件夹中的文档和分析对话历史，提取产品核心信息，为后续推导和生成记忆引擎文件做准备。
+
+## 执行规则
+
+### 通用规则
+- 📖 执行前完整阅读本步骤文件
+- 🎯 专注于信息收集，不做推导
+- ✅ 使用中文输出
+
+### 步骤特定规则
+- 🔍 多源信息收集：项目文档 + 对话历史
+- 🚫 排除系统目录（见下方过滤规则）
+- 📋 提取必要信息和可选信息
+- ⏭️ 收集完成后自动进入下一步
+
+---
+
+## 执行序列
+
+### 1. 快速信息检索
+
+<critical>
+采用最小化检索策略，静默执行以下步骤（不输出过程）：
+
+**Step 1.1 - 检查已有记忆引擎（1次读取）**
+- 尝试读取 `.codebuddy/rules/uxos/context.md`
+- IF 存在 → 提取产品信息，跳到 Step 1.4
+- IF 不存在 → 继续 Step 1.2
+
+**Step 1.2 - 检查项目根目录关键文件（最多3次读取）**
+- 尝试读取 `README.md` 或 `readme.md`（1次）
+- 尝试读取 `package.json`（1次，提取 name/description）
+- 尝试读取项目根目录的任何 `.md` 文件（1次 glob 查询）
+
+**Step 1.3 - 快速扫描对话历史**
+- 从当前对话中提取用户明确提到的：
+  - 产品名称
+  - 对标竞品
+  - 产品价值/定位描述
+
+**Step 1.4 - 汇总信息**
+将收集到的以下信息存储到上下文（不显示给用户）：
+- 产品名称
+- 对标竞品
+- 产品价值/定位描述
+- 其他补充信息（用户角色、场景、痛点等）
+
+**重要约束：**
+- 总检索操作不超过 5 次（读取或查询）
+- 如果前 3 次操作未找到任何信息，立即判断为"空项目"
+- 不要尝试深度搜索、递归查找、多次重试
+</critical>
+
+### 2. 快速路径示例
+
+**空项目场景（最快路径）：**
+```
+检查 1: .codebuddy/rules/uxos/context.md → 不存在
+检查 2: README.md → 不存在  
+检查 3: package.json → 不存在
+对话历史: 无产品信息
+
+判断: 空项目
+→ 立即进入 Step 2（总耗时 < 3秒）
+```
+
+**有文档场景：**
+```
+检查 1: .codebuddy/rules/uxos/context.md → 不存在
+检查 2: README.md → 存在，提取产品名和定位
+对话历史: 用户提到竞品是 Notion
+
+判断: 有足够信息
+→ 进入 Step 2
+```
+
+### 3. 自动进入下一步
+
+<critical>
+信息收集完成后，静默加载并执行 `{nextStepFile}` 进行信息完整度评估。
+
+不要输出任何提示：
+- ❌ "信息收集完成"
+- ❌ "进入下一步"  
+- ❌ "正在分析"
+- ❌ 任何检索过程描述
+
+直接进入 Step 2。
+</critical>
+
+---
+
+## 执行要点
+
+<critical>
+本步骤采用静默执行模式 + 最小化检索：
+- 总检索操作 ≤ 5 次
+- 对于空项目，3 次检查后立即判断
+- 不输出检索过程和详细日志
+- 不显示"提取的信息摘要"
+- 不显示"进入下一步"等过渡提示
+- 静默完成后直接进入 Step 2
+
+**性能目标：空项目初始化 < 5 秒**
+</critical>
+
+---
+
+<!-- Memory-Engine Step 01 | Discovery -->

package/_uxos/memory-engine/steps/step-02-evaluation.md

@@ -0,0 +1,128 @@
+---
+name: 'step-02-evaluation'
+description: '评估信息完整度，判断是否有足够信息创建记忆引擎，并路由到下一步'
+nextStepFile: './step-04-generate.md'
+supplementStepFile: './step-03-supplement.md'
+---
+
+# Step 2: 评估信息完整度
+
+## 步骤目标
+
+评估从 Step 1 收集到的信息是否满足创建记忆引擎的最低要求，并根据结果路由到正确的下一步。
+
+## 执行规则
+
+### 通用规则
+- 📖 执行前完整阅读本步骤文件
+- 🎯 专注于判断和路由，不收集新信息
+- ✅ 使用中文输出
+
+### 步骤特定规则
+- 📋 使用明确的判断标准
+- 🔀 根据结果自动路由
+- 📝 向用户展示判断结果
+
+---
+
+## 执行序列
+
+### 1. 静默判断信息完整度
+
+<critical>
+静默执行判断，不输出判断过程：
+
+✅ 信息齐全的条件（满足以下任一即可）：
+- 有产品名称 + 有对标竞品
+- 有产品名称 + 有产品价值/定位描述
+
+❌ 信息不齐全的条件：
+- 缺少产品名称
+- 既没有竞品也没有产品价值描述
+</critical>
+
+### 2. 根据结果决定输出
+
+<critical>
+快速路由，不输出冗长的分析过程。
+</critical>
+
+**如果信息齐全：**
+
+简洁提示后直接进入生成：
+
+```
+✅ 已收集到足够信息，正在创建记忆引擎...
+```
+
+**如果信息不齐全：**
+
+不输出任何提示，直接静默进入 Step 3。
+
+不要输出：
+- ❌ "缺少信息"的详细列表
+- ❌ "信息不完整"的提示
+- ❌ 任何分析过程
+
+直接进入 Step 3 展示补充选项。
+
+### 3. 路由决策
+
+<critical>
+路由逻辑必须严格执行：
+
+IF 信息齐全:
+  → 自动加载并执行 {nextStepFile}（step-04-generate.md）
+  
+ELSE IF 信息不齐全:
+  → 自动加载并执行 {supplementStepFile}（step-03-supplement.md）
+</critical>
+
+---
+
+## 判断示例
+
+### 示例 1：信息齐全
+```
+输入：
+- 产品名称：企业知识库
+- 对标竞品：Notion、Confluence
+
+判断：✅ 齐全（有产品名称 + 有竞品）
+路由：→ step-04-generate.md
+```
+
+### 示例 2：信息齐全（使用产品价值）
+```
+输入：
+- 产品名称：智能日程助手
+- 产品价值：让团队日程协调更高效
+
+判断：✅ 齐全（有产品名称 + 有产品价值）
+路由：→ step-04-generate.md
+```
+
+### 示例 3：信息不齐全
+```
+输入：
+- 产品名称：[未找到]
+- 对标竞品：Notion
+
+判断：❌ 不齐全（缺少产品名称）
+路由：→ step-03-supplement.md
+```
+
+### 示例 4：信息不齐全
+```
+输入：
+- 产品名称：企业知识库
+- 对标竞品：[未找到]
+- 产品价值：[未找到]
+
+判断：❌ 不齐全（既没有竞品也没有产品价值）
+路由：→ step-03-supplement.md
+```
+
+---
+
+<!-- Memory-Engine Step 02 | Evaluation -->

package/_uxos/memory-engine/steps/step-03-supplement.md

@@ -0,0 +1,176 @@
+---
+name: 'step-03-supplement'
+description: '信息补充：当必要信息不齐全时，提供多种方式让用户补充'
+nextStepFile: './step-04-generate.md'
+---
+
+# Step 3: 信息补充
+
+## 步骤目标
+
+当 Step 2 判断信息不齐全时，提供多种方式让用户补充必要信息，然后进入生成阶段。
+
+## 执行规则
+
+### 通用规则
+- 📖 执行前完整阅读本步骤文件
+- 🎯 专注于收集缺失的必要信息
+- ✅ 使用中文输出
+
+### 步骤特定规则
+- 🔢 使用数字序号引导用户选择
+- ⏸️ **必须等待用户输入**，不能自作主张
+- 📝 **只问 2 个必要问题**（产品名 + 竞品/价值），不问可选信息
+- 🚫 **收到回答后立即进入 Step 4**，不做竞品分析或评估
+- 🚫 严格遵循访谈模板，不追问差异化、核心能力等
+
+---
+
+## 执行序列
+
+### 1. 展示补充选项
+
+<critical>
+必须停下来等待用户选择，不要自动执行任何分支！
+简洁提示，不输出冗长的"缺少信息"列表（Step 2 已经静默处理）
+</critical>
+
+```
+**请选择创建方式：**
+
+`1` 将资料放入项目文件夹，我读取后建立  
+`2` 通过对话快速创建  
+`3` 直接创建，缺失信息标注 [待补充]
+```
+
+### 2. 处理用户选择
+
+#### 选项 1：放入资料
+
+```
+好的，请将相关资料放入项目文件夹。
+
+放入后告诉我，我会重新读取并提取信息。
+```
+
+用户确认后，返回 Step 1 重新收集。
+
+#### 选项 2：通过对话收集
+
+<critical>
+严格执行以下流程，不得偏离：
+
+1. 只问 2 个问题（产品名称 + 竞品或产品价值，二选一即可）
+2. 用户回答后，立即进入 Step 4 生成阶段
+3. 不要继续追问任何其他信息
+4. 不要做竞品评估分析
+5. 不要询问差异化优势、核心能力等
+</critical>
+
+**严格访谈模板：**
+
+```
+需要以下核心信息：
+
+1. 产品名称是什么？
+
+2. 选择以下任一方式描述：
+   - 对标竞品（如：Notion、databricks）
+   - 产品价值/差异化（如：帮助企业降低数据处理成本 50%）
+   - 或两者都有
+```
+
+**解析用户回答：**
+
+用户可能回答：
+- 只有竞品："wedata，对标 databricks" → 有 1+竞品
+- 只有价值："wedata，让数据处理更简单" → 有 1+价值
+- 都有："wedata，对标 databricks，核心是成本更低" → 有 1+竞品+价值
+
+**⚠️ 收到回答后立即执行：**
+- ✅ 解析用户回答，提取产品名称和（竞品 或 产品价值 或 两者）
+- ✅ 如果信息完整（有产品名 + 竞品或价值），直接进入 Step 4
+- ✅ 如果只有产品名，追问一次：对标竞品或产品价值？
+- ❌ 不要询问可选信息（焦点、用户、场景等）
+- ❌ 不要做竞品分析、评估或对比
+
+#### 选项 3：直接创建
+
+```
+好的，将直接创建最小版本记忆引擎，缺失信息标注为"[待补充]"。
+后续可以随时补充。
+```
+
+直接进入 Step 4。
+
+### 3. 解析用户回答
+
+<critical>
+用户回答后，立即解析并进入 Step 4，不要继续追问！
+</critical>
+
+用户可能以多种格式回答：
+
+**格式 1：编号对应**
+```
+用户：
+1. wedata
+2. databricks
+```
+→ 解析完成，立即进入 Step 4
+
+**格式 2：自然语言**
+```
+用户：产品叫 wedata，对标 databricks
+```
+→ 解析完成，立即进入 Step 4
+
+**格式 3：部分回答**
+```
+用户：产品是 wedata
+```
+→ 追问一次：对标竞品有哪些？或者一句话描述产品价值？
+→ 收到回答后，立即进入 Step 4
+
+### 4. 特殊情况处理
+
+**用户不知道竞品：**
+```
+用户：没有明确的竞品
+
+AI：没关系，可以告诉我这个产品大概是做什么的吗？
+    比如：协作工具、数据分析平台、内容管理系统等
+```
+
+**用户回答过于简略：**
+```
+用户：做个 CRM
+
+AI：好的，CRM 系统。对标竞品有哪些？比如 Salesforce、HubSpot？
+    或者一句话描述产品价值？
+```
+
+**用户想跳过：**
+```
+用户：先跳过吧
+
+AI：好的，将直接创建最小版本记忆引擎，缺失信息标注为"[待补充]"。
+    后续可以随时补充。
+```
+
+### 5. 进入下一步
+
+<critical>
+收集到 2 个必要信息后：
+1. 不要继续追问其他信息
+2. 不要做竞品分析或评估
+3. 立即自动加载并执行 `{nextStepFile}` 进行生成
+
+所有可选信息（用户角色、场景、差异化等）由 Step 4 的推导逻辑自动生成，不在此步骤收集！
+</critical>
+
+信息补充完成后，自动加载并执行 `{nextStepFile}` 进行生成。
+
+---
+
+<!-- Memory-Engine Step 03 | Supplement -->

package/_uxos/memory-engine/steps/step-04-generate.md

@@ -0,0 +1,282 @@
+---
+name: 'step-04-generate'
+description: '推导、展示理解、确认后生成记忆引擎文件'
+nextStepFile: './step-05-finalize.md'
+outputPath: '.codebuddy/rules/uxos'
+personasPath: '.codebuddy/rules/uxos/personas'
+---
+
+# Step 4: 生成记忆引擎文件
+
+## 步骤目标
+
+基于收集到的信息（产品名 + 竞品/产品价值），运用推导逻辑，**展示理解给用户确认**，然后生成记忆引擎文件。
+
+**核心理念：** 推导 → 展示 → 确认 → 生成
+
+## 执行规则
+
+### 通用规则
+- 📖 执行前完整阅读本步骤文件
+- 🎯 专注于推导和生成
+- ✅ 使用中文输出
+
+### 步骤特定规则
+- 🔍 智能判断是否需要 Web 搜索
+- 📋 推导完成后必须展示理解给用户确认
+- ⏸️ 必须等待用户确认后才生成文件
+- 📝 生成包括 personas/ 目录下的用户画像文件
+
+---
+
+## 执行序列
+
+### 阶段 A：推导
+
+#### A.0 获取当前时间
+
+<critical>
+执行系统命令获取当前精确时间：
+- 命令：`date +"%Y-%m-%d %H:%M"`
+- 格式：YYYY-MM-DD HH:MM
+</critical>
+
+#### A.1 分析用户输入
+
+<critical>
+根据用户提供的信息，确定推导场景：
+
+**场景 1：只有竞品（产品名 + 竞品）**
+- 基于竞品推导产品定位、用户角色、体验原则
+- 差异化：留 [待补充]
+- 愿景：留 [待补充]
+
+**场景 2：只有产品价值（产品名 + 产品价值/差异化）**
+- 基于产品价值推导定位、用户角色
+- 差异化：填入用户提供的价值描述
+- 愿景：尝试从价值推导
+
+**场景 3：都有（产品名 + 竞品 + 产品价值）**
+- 最完整的推导
+- 差异化：填入
+- 愿景：结合推导
+</critical>
+
+#### A.2 竞品信息丰富化（如有竞品）
+
+<critical>
+IF 竞品是知名产品（Notion、Figma、飞书、Slack、databricks、Salesforce 等）:
+  → 依赖 AI 知识库，不执行 Web 搜索
+  
+ELSE IF 竞品是不知名产品:
+  → 执行 Web 搜索获取产品信息
+</critical>
+
+#### A.3 推导产品上下文
+
+**推导粒度控制：**
+
+| 维度 | 正确粒度 | 过细（避免） |
+|------|----------|-------------|
+| 用户角色 | 数据工程师、产品经理 | 某公司的高级数据分析师 Tom |
+| 场景 | 数据查询、协作编辑 | 在周一早上生成销售周报 |
+| 痛点 | 查询复杂、性能慢 | 每次写 SQL 要花 30 分钟 |
+
+**推导内容：**
+
+1. **产品定位**（一句话）
+2. **产品类型**（SaaS/平台/工具）
+3. **差异化**（场景 1 留空，场景 2/3 填入）
+4. **愿景**（能推导则填，不能则留空）
+5. **目标用户角色**（2-3 个职业类型）
+6. **体验原则**（2-3 条可执行的原则）
+
+---
+
+### 阶段 B：展示理解 + 确认
+
+#### B.1 展示理解页面
+
+<critical>
+推导完成后，必须展示以下内容给用户确认，不要直接生成文件！
+</critical>
+
+**展示模板：**
+
+```
+📋 **根据你提供的信息，我的理解是：**
+
+**产品信息**
+- 名称：{产品名}
+- 对标：{竞品，如无则显示"无"}
+- 定位：{推导的一句话定位}
+- 差异化：{差异化描述，或"[待补充]"}
+
+**识别到的用户角色**
+- {角色1}：{一句话描述}
+- {角色2}：{一句话描述}
+
+**体验原则**
+1. {原则1}
+2. {原则2}
+
+---
+
+**如果确认，我将创建以下文件：**
+
+| 文件 | 用途 |
+|------|------|
+| context.md | 核心上下文 |
+| decisions.md | 决策记录 |
+| update-memory.md | 更新指南 |
+| uxos-index.md | 知识库索引 |
+| personas/{角色1}.md | {角色1}画像 |
+| personas/{角色2}.md | {角色2}画像 |
+
+---
+
+**请选择：**
+
+`1` 确认，开始创建
+`2` 我想先细化一些内容
+`3` 我想调整信息
+```
+
+#### B.2 处理用户选择
+
+**选项 1：确认创建**
+→ 进入阶段 C 生成文件
+
+**选项 2：细化内容**
+
+```
+好的，我将启动专业的细化工作流来帮助你完善产品信息。
+
+这将调用 create-product-brief 工作流，它会系统性地引导你：
+- 深入完善产品定位和差异化
+- 详细定义用户画像和使用场景
+- 制定体验原则和设计准则
+
+工作流调用：`/data/workspace/nice/create-product-brief/workflow.md`
+
+上下文传递：
+- 已收集的产品信息
+- 当前推导结果
+- 用户角色定义
+
+完成后将返回此界面继续生成流程。
+```
+
+**工作流调用逻辑：**
+
+1. **传递上下文信息：**
+   - 产品名称：{产品名}
+   - 对标竞品：{竞品，如无则传空}
+   - 当前差异化：{差异化描述}
+   - 已识别用户角色：{角色列表}
+
+2. **执行外部工作流：**
+   - 加载并执行 `/data/workspace/nice/create-product-brief/workflow.md`
+   - 传递上述上下文作为输入参数
+
+3. **返回处理：**
+   - create-product-brief 工作流完成后
+   - 将细化结果导入到当前推导结果中
+   - 重新展示更新后的理解页面
+
+**选项 3：调整信息**
+
+```
+好的，请告诉我需要调整什么？
+
+比如：
+- 产品名称不对
+- 竞品需要更换
+- 定位描述不准确
+```
+
+收到调整后，重新推导，重新展示理解页面。
+
+---
+
+### 阶段 C：生成文件
+
+<critical>
+只有用户选择"确认"后才执行此阶段！
+</critical>
+
+#### C.1 创建目录结构
+
+```
+{outputPath}/
+├── context.md
+├── decisions.md
+├── update-memory.md
+├── uxos-index.md
+└── personas/
+    ├── _index.md
+    ├── {role_1}.md
+    └── {role_2}.md
+```
+
+#### C.2 生成文件顺序
+
+1. **生成 context.md**
+   - 读取 `data/context-template.md` 模板
+   - 填入推导结果
+   - 用户画像部分链接到 personas/ 文件
+
+2. **生成 decisions.md**
+   - 读取 `data/decisions-template.md` 模板
+   - 添加初始化决策
+
+3. **生成 update-memory.md**
+   - 读取 `data/update-memory-template.md` 模板
+   - 直接使用模板内容
+
+4. **生成 personas/_index.md**
+   - 读取 `data/personas/_index-template.md` 模板
+   - 填入识别到的用户角色列表
+
+5. **生成 personas/{role}.md（每个角色一个文件）**
+   - 读取 `data/personas/role-template.md` 模板
+   - 填入角色定义、典型场景、痛点
+   - 场景和痛点基于推导，保持合理粒度
+
+6. **生成 uxos-index.md**
+   - 读取 `data/uxos-index-template.md` 模板
+   - 填入产品名称、时间、用户角色列表
+
+7. **检测并生成 assets.md（条件生成）**
+   - 如检测到 Figma 链接等设计资产信息则生成
+
+#### C.3 生成约束
+
+<critical>
+生成文件时必须遵守：
+1. context.md 的用户画像部分要链接到具体 personas/ 文件
+2. context.md 的「关键决策」部分：初始化时只写「已记录 1 条」
+3. personas/ 文件的场景和痛点要保持合理粒度，不要过细
+4. 所有时间格式必须精确到分钟：YYYY-MM-DD HH:MM
+5. 差异化如果是 [待补充]，在 context.md 加提示："💡 后续可通过「更新记忆」完善差异化定位"
+</critical>
+
+---
+
+### 阶段 D：进入下一步
+
+文件生成完成后，自动加载并执行 `{nextStepFile}` 展示结果。
+
+---
+
+## 推导失败处理
+
+| 情况 | 处理方式 |
+|------|----------|
+| 产品和竞品都不知名 | 只填写用户提供的信息，其他字段标注 `[待补充]`，仍然生成文件 |
+| 无法推导用户角色 | 使用通用角色"产品使用者"，提示用户后续细化 |
+| 无法推导体验原则 | 使用通用原则（易用性、可靠性、高效），提示用户后续细化 |
+
+---
+
+<!-- Memory-Engine Step 04 | Generate -->