uxos 1.0.23 → 1.0.24

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

@@ -1,7 +1,6 @@
 ---
-description: 项目核心上下文。包含产品定位、目标用户、当前状态等关键信息，AI 每次会话自动加载。
-alwaysApply: true
-generator: memory-engine
+# 注意不要修改本文头文件，如修改，CodeBuddy（内网版）将按照默认逻辑设置
+type: always
 ---
 
 # {{产品名称}} 核心上下文
@@ -55,15 +54,6 @@ generator: memory-engine
 - {{业务约束：如时间节点、资源限制}}
 - {{规范约束：如合规要求、品牌规范}}
 
-## 知识库导航
-
-| 需要了解 | 读取文件 |
-|----------|----------|
-| 用户画像详情 | `personas/` 目录下对应角色文件 |
-| 决策完整背景 | `decisions` 规则 |
-| 设计资产位置 | `assets` 规则 |
-| 更新记忆引擎 | `update-memory` 规则 |
-
 ---
 
 <!-- Generated by Memory-Engine workflow -->

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

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

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

@@ -2,7 +2,6 @@
 description: {role_name} 用户画像。包含角色定义、典型场景、核心痛点和期望。
 alwaysApply: false
 generator: memory-engine
-status: auto-generated-draft
 ---
 
 # {role_name} 用户画像

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

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

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

@@ -1,12 +1,11 @@
 ---
-description: UXOS 知识库导航索引。提供记忆引擎文件的导航和使用说明，帮助 AI 快速定位所需信息。
-alwaysApply: true
-generator: memory-engine
+# 注意不要修改本文头文件，如修改，CodeBuddy（内网版）将按照默认逻辑设置
+type: always
 ---
 
-# {{产品名称}} 知识库索引
+# {{产品名称}} UXOS 系统索引
 
-> 本文件是 UXOS 知识库的导航索引，帮助 AI 快速定位所需信息。
+> UXOS 知识库结构与 AI 行为指南。
 
 ---
 
@@ -15,6 +14,7 @@ generator: memory-engine
 | 文件/目录 | 用途 | 加载方式 | 何时读取 |
 |----------|------|---------|---------|
 | **context.md** | 核心上下文（概览） | Always | 每次会话自动加载 |
+| **uxos-index.md** | 系统索引（本文件） | Always | 每次会话自动加载 |
 | **personas/** | 用户画像详情 | Agent Requested | 设计具体功能时 |
 | **decisions.md** | 决策记录 | Agent Requested | 需要了解决策背景时 |
 | **update-memory.md** | 更新指南 | Agent Requested | 用户说"更新记忆"时 |
@@ -22,62 +22,23 @@ generator: memory-engine
 
 ---
 
-## 用户画像目录
+## AI 行为指南
 
-> 💡 **重要**：设计具体功能时，请主动读取相关用户画像获取详细场景和痛点。
+> 以下场景触发时，**必须先读取对应文件**再继续工作。
 
-| 角色 | 画像文件 | 适用场景 |
-|------|----------|----------|
-| {{主要用户角色}} | `personas/{{role_1_file}}.md` | 设计面向该角色的功能时 |
-| {{次要用户角色}} | `personas/{{role_2_file}}.md` | 设计面向该角色的功能时 |
+| 触发场景 | 必须读取 | 示例 |
+|---------|---------|------|
+| 设计面向特定用户的功能 | `personas/` 对应文件 | "设计管理员的审批流程" |
+| 用户问"为什么这样设计？" | `decisions.md` | "这个交互为什么这么做？" |
+| 用户说"更新记忆/更新上下文" | `update-memory.md` | "帮我记录这个决策" |
+| 需要设计资产/文件信息 | `assets.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 执行更新
+1. **每次会话**：自动加载 context.md + 本索引
+2. **设计功能时**：先确定目标用户 → 读取对应画像
+3. **做决策时**：参考体验原则，需要历史背景时读取 decisions.md
+4. **检测到更新信号**：主动提醒 → 读取 update-memory.md 后执行
 
 ---
 
@@ -86,17 +47,6 @@ generator: memory-engine
 - **创建时间**：{{YYYY-MM-DD HH:MM}}
 - **最后更新**：{{YYYY-MM-DD HH:MM}}
 - **初始化方式**：{{基于文档/对话引导/直接创建}}
-- **用户画像数量**：{{N}} 个
-
----
-
-<!-- 工作流链接扩展点（预留） -->
-<!-- 相关工作流：
-- update-memory - 更新已有记忆
-- refine-context - 细化特定部分
-- add-personas - 补充用户画像
-- validate-memory - 验证记忆质量
--->
 
 ---