uxos 1.0.13 → 1.0.15

package/_uxos/memory-engine/data/decisions-template.md

@@ -0,0 +1,89 @@
+---
+description: 完整设计决策记录。当讨论设计方案选择、决策调整、历史决策依据，或核心文件中的决策信息不足以支撑判断时读取此规则。
+alwaysApply: false
+generator: memory-engine
+---
+
+# {{产品名称}} 设计决策记录
+
+> 记录设计过程中的关键决策，包含问题背景、决策内容和演变过程。
+
+---
+
+## 快速索引
+
+| # | 决策 | 核心要点 | 类别 |
+|---|------|----------|------|
+| 1 | 初始化记忆库 | {{根据实际填写：基于文档/对话/示例}} | 流程 |
+
+---
+
+## 决策详情
+
+### 1. 初始化记忆引擎 ⚡
+
+> ⚡ 这是记忆引擎创建的第一个决策，记录初始化方式和过程
+
+**时间**：{{YYYY-MM-DD HH:MM}}
+
+**问题**：如何建立产品设计记忆引擎
+
+**决策**：{{从以下三种方式中选择一种填写}}
+
+**方式 A：基于现有文档建立**
+- 检测到项目文件夹中包含现有文档
+- 直接从已有文档中提取产品信息
+- 避免重复询问用户已知信息
+- 整理过程：
+  - 分析了 {{文档1名称}}
+  - 分析了 {{文档2名称}}
+  - 提取了产品名称、对标竞品、工作焦点等核心信息
+
+**方式 B：通过对话引导创建**
+- 项目文件夹中没有检测到项目文档
+- 通过对话收集必要信息
+- 保证记忆库信息的准确性
+- 收集的信息：
+  - 产品名称：{{用户提供的产品名称}}
+  - 对标竞品：{{用户提供的竞品}}
+  - 其他补充信息：{{如有}}
+
+**方式 C：直接创建示例**
+- 项目文件夹中没有检测到项目文档
+- 用户选择直接创建示例，跳过信息收集
+- 快速完成初始化流程
+- 缺失信息标注 [待补充]，后续再补充
+
+**依据**：{{根据选择的方式填写理由}}
+
+**洞察**：`{{从初始化过程中提炼的认知}}`
+
+---
+
+## 决策演变
+
+| 时间 | 原决策 | 调整后 | 原因 |
+|------|--------|--------|------|
+| {{YYYY-MM-DD HH:MM}} | {{原决策内容}} | {{新决策内容}} | {{调整原因}} |
+
+---
+
+## 关键洞察
+
+从决策过程中提炼的设计原则：
+
+### {{洞察主题 1}}
+> {{一句话总结}}
+
+---
+
+## 待决策事项
+
+- [ ] {{待决策议题 1}}
+- [ ] {{待决策议题 2}}
+
+---
+
+*最后更新：{{YYYY-MM-DD HH:MM}}*
+
+<!-- Generated by Memory-Engine workflow -->

package/_uxos/memory-engine/data/personas/_index-template.md

@@ -0,0 +1,33 @@
+---
+description: 用户画像索引。列出所有识别到的目标用户角色及其画像文件位置。
+alwaysApply: false
+generator: memory-engine
+status: auto-generated-draft
+---
+
+# 用户画像索引
+
+> 💡 **提示**：以下用户画像由 Memory Engine 基于产品信息自动推导生成，建议在项目推进过程中根据真实用户调研和反馈持续完善。
+
+## 画像清单
+
+| 角色 | 文件 | 一句话描述 |
+|------|------|-----------|
+| {role_1_name} | [→ 详细画像](./{role_1_file}.md) | {role_1_description} |
+| {role_2_name} | [→ 详细画像](./{role_2_file}.md) | {role_2_description} |
+
+## 使用指引
+
+**何时读取画像文件：**
+- 设计面向特定用户的功能时
+- 需要了解用户痛点、场景、动机时
+- 评估设计方案是否符合用户需求时
+
+**如何使用：**
+1. 从 `context.md` 了解产品概况和用户角色列表
+2. 根据当前任务，读取相关角色的详细画像
+3. 基于画像中的场景和痛点进行设计
+
+---
+
+<!-- Generated by Memory-Engine workflow -->

package/_uxos/memory-engine/data/personas/role-template.md

@@ -0,0 +1,47 @@
+---
+description: {role_name} 用户画像。包含角色定义、典型场景、核心痛点和期望。
+alwaysApply: false
+generator: memory-engine
+status: auto-generated-draft
+---
+
+# {role_name} 用户画像
+
+> 💡 **提示**：此画像由 AI 基于产品信息自动推导生成，建议在实际使用过程中根据真实用户反馈持续细化和完善。
+
+## 角色定义
+
+{role_definition}
+
+## 典型场景
+
+1. **{scenario_1_name}**
+   {scenario_1_description}
+
+2. **{scenario_2_name}**
+   {scenario_2_description}
+
+3. **{scenario_3_name}**
+   {scenario_3_description}
+
+## 核心痛点
+
+1. **{pain_1_name}**
+   {pain_1_description}
+
+2. **{pain_2_name}**
+   {pain_2_description}
+
+## 期望
+
+{expectations}
+
+## 设计启示
+
+> 在为 {role_name} 设计功能时，应该优先考虑：
+> - {design_hint_1}
+> - {design_hint_2}
+
+---
+
+<!-- Generated by Memory-Engine workflow -->

package/_uxos/memory-engine/data/update-memory-template.md

@@ -0,0 +1,160 @@
+---
+description: 记忆引擎更新指南。当用户说"更新记忆"或 AI 检测到更新信号时，读取此规则了解如何正确更新记忆引擎文件。
+alwaysApply: false
+generator: memory-engine
+---
+
+# 记忆引擎更新指南
+
+> 当用户说「更新记忆」「update memory」或 AI 检测到更新信号时，按此指南执行。
+
+---
+
+## 核心理念
+
+> 记忆引擎不是「文档」，是「活的上下文」。
+> 它应该随着项目自然生长，而不是要求用户刻意维护。
+
+**初始化**：低摩擦，快速建立粗粒度理解
+**持续更新**：随着协作深入，逐渐丰富和修正
+
+---
+
+## 1. 更新原则
+
+### 1.1 增量优先
+
+优先添加新信息，而不是替换旧信息。
+
+```
+除非用户明确说"之前的理解是错的"，否则保留历史记录。
+用追加而非覆盖的方式更新。
+```
+
+### 1.2 具体化
+
+用具体信息替换模糊描述：
+
+| 模糊 | 具体 |
+|------|------|
+| 提升用户体验 | 减少表单填写步骤从 5 步到 2 步 |
+| 优化性能 | 搜索响应时间 < 200ms |
+| 面向企业用户 | 面向 500-2000 人规模的中型企业 |
+| [待补充] | 实际收集到的信息 |
+
+### 1.3 决策沉淀
+
+当对话中出现以下信号时，记录到 decisions.md：
+
+- "我们决定..."
+- "最终选择..."
+- "不做 X，因为..."
+- "之前的方案改成..."
+- "放弃了 X，选择 Y"
+
+### 1.4 保持简洁
+
+- context.md 保持简洁，避免冗余描述
+- 决策过多时（3+ 条）拆分到 decisions.md
+- 设计资产信息拆分到 assets.md
+- 删除过时信息，保持记忆库的时效性
+
+**字数参考**：
+- context.md：1000-2000 字（中文字数），重点是「必要」而非「简短」
+- decisions.md：按需扩展，每条决策 100-200 字
+- assets.md：按需扩展
+
+---
+
+## 2. 更新信号检测
+
+### 2.1 主动触发
+
+用户明确要求更新：
+
+- "更新记忆"
+- "update memory"
+- "记住这个决策"
+- "把这个加到记忆库"
+
+### 2.2 被动检测（AI 主动提醒）
+
+| 信号 | 动作 |
+|------|------|
+| 对话内容与 context 记录矛盾 | 询问：「我注意到 X 和之前记录的 Y 不一致，需要更新吗？」 |
+| 出现重要决策 | 询问：「这个决策要记录到记忆库吗？」 |
+| 补充了 [待补充] 的信息 | 自动更新，简单告知用户 |
+| 项目阶段发生变化 | 提醒：「项目似乎进入了新阶段，要更新当前状态吗？」 |
+| 工作焦点明显转移 | 询问：「工作焦点是否已经从 X 转移到 Y？」 |
+
+### 2.3 不要更新的情况
+
+- 临时性的讨论，没有形成结论
+- 用户明确说"这只是想法，还没确定"
+- 纯技术实现细节（除非影响产品决策）
+- 一次性的操作指令
+
+---
+
+## 3. 更新流程
+
+### Step 1: 读取现有记忆
+
+1. 读取 `.codebuddy/rules/uxos/context.md`
+2. 读取 `.codebuddy/rules/uxos/decisions.md`（如存在）
+
+### Step 2: 分析更新内容
+
+1. 对比对话中的新信息与现有记录
+2. 识别需要更新的字段
+3. 判断是「补充」还是「修正」还是「新增」
+
+### Step 3: 直接更新 .md 文件
+
+<critical>
+不要重新生成完整文件，使用 replace_in_file 进行定点修改
+</critical>
+
+1. 使用 `replace_in_file` 工具更新 context.md 的特定部分
+2. 如有新决策，更新 decisions.md
+
+**更新完成后通知：**
+
+```
+✅ 已更新记忆引擎：
+
+- [变更 1：具体说明修改了什么]
+- [变更 2：具体说明修改了什么]
+
+更新的文件：`.codebuddy/rules/uxos/context.md`
+```
+
+---
+
+## 4. 错误处理
+
+| 情况 | 处理方式 |
+|------|----------|
+| 文件不存在 | 提示用户先执行「初始化记忆」 |
+| 更新内容与现有记录冲突 | 询问用户确认，说明冲突点 |
+| replace_in_file 失败 | 重新读取文件，检查内容是否已变更 |
+| 用户中断更新流程 | 保持原文件不变，告知用户可随时继续 |
+
+---
+
+## 5. 阶段感知
+
+检测项目阶段变化，不同阶段 AI 的建议风格应该不同：
+
+| 阶段 | 特征 | AI 建议风格 |
+|------|------|------------|
+| **探索期** | 验证想法、用户调研 | 发散、多提问、鼓励尝试 |
+| **MVP** | 最小可用、快速上线 | 聚焦核心、砍需求、快速迭代 |
+| **成长期** | 功能完善、体验优化 | 平衡、关注数据、A/B 测试 |
+| **成熟期** | 稳定运营、降本增效 | 收敛、风险控制、ROI 导向 |
+
+当检测到阶段变化信号时，主动提醒用户更新。
+
+---
+
+<!-- Generated by Memory-Engine workflow -->

package/_uxos/memory-engine/data/uxos-index-template.md

@@ -0,0 +1,103 @@
+---
+description: UXOS 知识库导航索引。提供记忆引擎文件的导航和使用说明，帮助 AI 快速定位所需信息。
+alwaysApply: true
+generator: memory-engine
+---
+
+# {{产品名称}} 知识库索引
+
+> 本文件是 UXOS 知识库的导航索引，帮助 AI 快速定位所需信息。
+
+---
+
+## 文件清单
+
+| 文件/目录 | 用途 | 加载方式 | 何时读取 |
+|----------|------|---------|---------|
+| **context.md** | 核心上下文（概览） | Always | 每次会话自动加载 |
+| **personas/** | 用户画像详情 | Agent Requested | 设计具体功能时 |
+| **decisions.md** | 决策记录 | Agent Requested | 需要了解决策背景时 |
+| **update-memory.md** | 更新指南 | Agent Requested | 用户说"更新记忆"时 |
+| **assets.md** | 设计资产 | Agent Requested | 需要设计文件信息时 |
+
+---
+
+## 用户画像目录
+
+> 💡 **重要**：设计具体功能时，请主动读取相关用户画像获取详细场景和痛点。
+
+| 角色 | 画像文件 | 适用场景 |
+|------|----------|----------|
+| {{主要用户角色}} | `personas/{{role_1_file}}.md` | 设计面向该角色的功能时 |
+| {{次要用户角色}} | `personas/{{role_2_file}}.md` | 设计面向该角色的功能时 |
+
+**画像索引**：`personas/_index.md`
+
+---
+
+## 快速导航
+
+### 📋 项目概况
+- 产品定位和差异化 → `context.md` > 产品定位
+- 体验原则 → `context.md` > 体验原则
+- 当前工作焦点 → `context.md` > 当前状态
+
+### 👤 用户画像
+- 用户角色概览 → `context.md` > 目标用户
+- **详细画像（场景/痛点/期望）** → `personas/` 目录下对应文件
+- 画像索引 → `personas/_index.md`
+
+### 📝 决策历史
+- 查看所有决策 → `decisions.md` > 快速索引
+- 了解决策背景 → `decisions.md` > 决策详情
+
+### 🎨 设计资产
+- 设计工具和文件 → `assets.md` > 设计工具与文件
+- 设计系统规范 → `assets.md` > 设计系统
+
+### 🔄 更新记忆
+- 更新原则和流程 → `update-memory.md`
+
+---
+
+## AI 协作指引
+
+### 每次会话
+1. **自动加载** context.md 和本索引文件
+2. 了解产品概况和当前焦点
+
+### 设计具体功能时
+1. **先确定目标用户角色**
+2. **读取对应的 personas/ 画像文件**
+3. 基于画像中的场景和痛点进行设计
+
+### 做设计决策时
+1. 检查 context.md 中的体验原则
+2. 如需了解历史决策，读取 decisions.md
+
+### 检测到更新信号时
+1. 主动提醒用户是否更新记忆
+2. 读取 update-memory.md 执行更新
+
+---
+
+## 知识库状态
+
+- **创建时间**：{{YYYY-MM-DD HH:MM}}
+- **最后更新**：{{YYYY-MM-DD HH:MM}}
+- **初始化方式**：{{基于文档/对话引导/直接创建}}
+- **用户画像数量**：{{N}} 个
+
+---
+
+<!-- 工作流链接扩展点（预留） -->
+<!-- 相关工作流：
+- update-memory - 更新已有记忆
+- refine-context - 细化特定部分
+- add-personas - 补充用户画像
+- validate-memory - 验证记忆质量
+-->
+
+---
+
+<!-- Generated by Memory-Engine workflow -->

package/_uxos/memory-engine/ing/TODO-/344/277/256/346/224/271/346/270/205/345/215/225.md

@@ -0,0 +1,278 @@
+# Memory-Engine 修改清单
+
+> 基于 2026-01-20 的讨论，汇总所有待修改项。
+> 改完一个打勾 ✅，确认后再改下一个。
+
+---
+
+## 🎯 极简修改列表（按影响面排序）
+
+### 阶段 1：基础架构（影响面：整个系统）✅ 已完成
+- [x] 1.1 新增 personas/ 模板结构
+- [x] 1.2 精简 context-template.md
+- [x] 1.3 更新 uxos-index-template.md
+
+### 阶段 2：输入调整（影响面：后续推导逻辑）✅ 已完成
+- [x] 2.1 Step 3 问法调整（2 问变灵活）
+
+### 阶段 3：核心流程重构（影响面：最大）✅ 已完成
+- [x] 3.1 Step 4 拆分为 4-a（推导+展示）和 4-b（确认）
+- [x] 3.2 Step 4 分场景推导逻辑
+- [x] 3.3 Step 4 展示理解页面
+- [x] 3.4 Step 4 确认选项处理
+- [x] 3.5 Step 4 生成 personas/ 文件逻辑
+
+### 阶段 4：输出调整（影响面：小）✅ 已完成
+- [x] 4.1 Step 5 成功通知更新
+
+### 阶段 5：细节完善 ✅ 已完成
+- [x] 5.1 细化引导设计（选项 2）
+- [ ] 5.2 完整流程测试（需人工测试）
+
+---
+
+## 📊 影响面分析
+
+| 修改项 | 影响范围 | 优先级 | 依赖关系 |
+|--------|----------|--------|----------|
+| **personas/ 模板** | 整个输出结构 | 🔴 P0 | 无依赖，是基础 |
+| **context-template 精简** | 所有生成文件的质量 | 🔴 P0 | 无依赖 |
+| **Step 4 拆分** | 整个工作流程 | 🔴 P0 | 依赖模板完成 |
+| **Step 3 问法** | Step 4 推导逻辑 | 🟡 P1 | 无依赖 |
+| **uxos-index 更新** | 导航准确性 | 🟡 P1 | 依赖 personas/ |
+| **Step 5 更新** | 用户体验 | 🟢 P2 | 依赖 Step 4 |
+| **细化引导** | 高级功能 | 🟢 P2 | 依赖 Step 4 |
+
+**修改顺序：**
+```
+阶段 1（基础）→ 阶段 2（输入）→ 阶段 3（核心）→ 阶段 4（输出）→ 阶段 5（完善）
+```
+
+---
+
+## 一、架构变更
+
+### 1.1 新增 personas/ 目录
+- [ ] 在 `data/` 目录下新增 `personas/` 子目录
+- [ ] 创建 `personas/_index-template.md` — 画像索引模板
+- [ ] 创建 `personas/role-template.md` — 单个角色画像模板
+
+### 1.2 输出文件结构调整
+```
+.codebuddy/rules/uxos/
+├── uxos-index.md          # 导航索引
+├── context.md             # 核心上下文（精简版）
+├── decisions.md           # 决策记录
+├── update-memory.md       # 更新逻辑
+├── assets.md              # 设计资产（可选）
+└── personas/              # 👈 新增
+    ├── _index.md          # 画像索引
+    ├── [role-1].md        # 角色1画像
+    └── [role-2].md        # 角色2画像
+```
+
+---
+
+## 二、Step 1 (discovery) 修改
+
+### 2.1 静默执行 ✅ 已完成
+- [x] 不输出检索过程
+- [x] 不显示"提取的信息摘要"
+- [x] 不显示"进入下一步"提示
+
+### 2.2 排除目录列表 ✅ 已完成
+- [x] `.codebuddy/skills/` — 排除
+- [x] `.codebuddy/agents/` — 排除
+- [x] `.codebuddy/rules/` — **保留扫描**
+- [x] `.cursor/` — 排除
+- [x] `.claude/` — 排除
+- [x] `.trae/` — 排除
+- [x] `_uxos/` — 排除
+- [x] `node_modules/` — 排除
+- [x] `.git/` — 排除
+
+---
+
+## 三、Step 2 (evaluation) 修改
+
+### 3.1 静默判断 ✅ 已完成
+- [x] 不输出判断过程
+- [x] 信息齐全时简洁提示后进入 Step 4
+- [x] 信息不足时静默进入 Step 3
+
+---
+
+## 四、Step 3 (supplement) 修改
+
+### 4.1 问法调整（方案 C）
+- [ ] 改为 2 个问题 + 更清晰的提示
+
+**新问法：**
+```
+1. 产品名称是什么？
+2. 选择以下任一方式描述：
+   - 对标竞品（如：Notion、databricks）
+   - 产品价值/差异化（如：帮助企业降低数据处理成本 50%）
+   - 或两者都有
+```
+
+### 4.2 收到回答后立即进入 Step 4 ✅ 已完成
+- [x] 不做竞品分析
+- [x] 不追问差异化、核心能力等
+
+---
+
+## 五、Step 4 (generate) 修改 — 重点
+
+### 5.1 拆分为两个子步骤
+- [ ] Step 4-a：推导 + 展示理解
+- [ ] Step 4-b：用户确认
+
+### 5.2 推导逻辑分场景
+
+**场景 A：只有竞品（1+2）**
+- [ ] 基于竞品推导产品定位、用户角色、体验原则
+- [ ] 差异化：留 [待补充]
+- [ ] 愿景：留 [待补充]
+- [ ] 提示：后续可通过「更新记忆」完善
+
+**场景 B：只有产品价值（1+3）**
+- [ ] 基于产品价值推导定位、用户角色
+- [ ] 差异化：填入产品价值
+- [ ] 愿景：尝试推导，不行就留空
+
+**场景 C：有竞品 + 产品价值（1+2+3）**
+- [ ] 最完整的推导
+- [ ] 差异化：填入
+- [ ] 愿景：结合推导
+
+### 5.3 展示理解页面设计
+- [ ] 展示产品信息（名称、对标、定位）
+- [ ] 展示识别到的用户角色
+- [ ] 列出将创建的文件清单
+
+### 5.4 用户确认选项
+```
+**请选择：**
+
+`1` 确认，开始创建
+`2` 我想先细化一些内容
+`3` 我想调整信息
+```
+
+- [ ] 选项 1：静默生成所有文件 → Step 5
+- [ ] 选项 2：进入细化引导（具体引导方式待设计）
+- [ ] 选项 3：询问要调整什么，修改后重新展示
+
+### 5.5 细化引导设计（选项 2）
+- [ ] 设计细化引导的交互方式
+- [ ] 细化范围：context 信息 + 用户画像
+- [ ] 暂不链接其他工作流，后续补充
+
+---
+
+## 六、context-template.md 修改
+
+### 6.1 精简为概览页
+- [ ] 控制在 800-1200 字
+- [ ] 移除详细的用户画像展开
+
+### 6.2 内容结构调整
+
+**产品定位部分：**
+- [ ] 一句话定位
+- [ ] 产品类型
+- [ ] 对标竞品
+- [ ] 差异化：有就填，没有就 [待补充]
+- [ ] 愿景：能推导就填，不能就 [待补充]
+
+**目标用户部分：**
+- [ ] 只列角色名称 + 一句话描述
+- [ ] 添加指引："详细画像请读取 personas/ 目录"
+
+**体验原则部分：**
+- [ ] 2-3 条可执行的原则
+- [ ] 不只是抽象词汇（高性能、易用性）
+
+**当前状态部分：**
+- [ ] 焦点
+- [ ] 阶段
+
+**关键决策部分：**
+- [ ] 初始化只显示"已记录 1 条决策"
+- [ ] 指向 decisions.md
+
+**关键约束部分：**
+- [ ] 技术约束
+- [ ] 业务约束
+
+---
+
+## 七、新增模板文件
+
+### 7.1 personas/_index-template.md
+- [ ] 创建画像索引模板
+- [ ] 列出所有用户角色
+- [ ] 每个角色的文件路径
+
+### 7.2 personas/role-template.md
+- [ ] 创建单个角色画像模板
+- [ ] 包含：角色定义、典型场景、核心痛点、期望
+
+---
+
+## 八、uxos-index-template.md 修改
+
+- [ ] 加入 personas/ 目录的指引
+- [ ] 更新文件清单
+- [ ] 添加使用指引（何时读取哪个文件）
+
+---
+
+## 九、Step 5 (finalize) 修改
+
+- [ ] 更新成功通知模板
+- [ ] 列出新的文件结构（包含 personas/）
+- [ ] 更新文件链接
+
+---
+
+## 十、Step 4 生成逻辑修改
+
+### 10.1 生成文件顺序调整
+```
+1. context.md
+2. decisions.md
+3. update-memory.md
+4. uxos-index.md
+5. personas/_index.md（新增）
+6. personas/[role-1].md（新增，按识别到的角色数量）
+7. personas/[role-2].md（新增）
+8. assets.md（条件生成）
+```
+
+### 10.2 用户画像生成逻辑
+- [ ] 根据推导出的用户角色数量动态生成
+- [ ] 每个角色一个独立文件
+- [ ] 初始化时画像内容可以简略，后续细化
+
+---
+
+## 修改顺序建议
+
+1. 先改模板文件（context-template, 新增 personas 模板）
+2. 再改 Step 4 的推导和确认逻辑
+3. 再改 Step 3 的问法
+4. 最后改 Step 5 的完成提示
+5. 测试完整流程
+
+---
+
+## 备注
+
+- 细化工作流链接：后续补充
+- 测试重点：确认页面的选项处理逻辑
+
+---
+
+*最后更新：2026-01-20*