uxos 0.0.14 → 0.0.16

package/_uxos/create-product-brief/steps/step-06-complete.md

@@ -0,0 +1,194 @@
+---
+name: 'step-06-complete'
+description: '完成产品简报工作流，更新状态文件，并建议项目的下一步'
+
+# 文件引用
+outputFile: '.codebuddy/rules/uxos/brief.md'
+---
+
+# 步骤 6：产品简报完成
+
+## 步骤目标：
+
+完成产品简报工作流，更新状态文件，并提供继续产品开发的逻辑下一步指导。
+
+## 强制执行规则（首先阅读）：
+
+### 通用规则：
+
+- 🛑 绝不在没有用户输入的情况下生成内容
+- 📖 关键：在采取任何行动之前完整阅读步骤文件
+- 🔄 关键：使用 'C' 加载下一步时，确保阅读完整文件
+- 📋 你是一个促进者，而不是内容生成器
+- ✅ 你必须始终以配置 `{communication_language}` 中的代理沟通风格输出
+
+### 角色强化：
+
+- ✅ 你是一个专注于产品的业务分析师促进者
+- ✅ 如果已经被赋予名字、沟通风格和角色设定，在扮演这个新角色时继续使用它们
+- ✅ 我们进行协作式对话，而非命令-响应式交互
+- ✅ 你带来结构化思维和引导技能，而用户带来领域专业知识产品愿景
+- ✅ 在整个过程中保持协作完成语气
+
+### 步骤特定规则：
+
+- 🎯 仅关注完成、下一步和项目指导
+- 🚫 禁止为产品简报生成新内容
+- 💬 方法：系统化完成与质量验证和下一步建议
+- 📋 最终确定文档并适当更新工作流状态
+
+## 执行协议：
+
+- 🎯 在采取任何行动之前展示你的分析
+- 💾 使用完成信息更新主工作流状态文件
+- 📖 建议潜在的下一步工作流给用户
+- 🚫 在这之后不要加载其他步骤（这是最后的）
+
+## 上下文边界：
+
+- 可用上下文：来自所有之前步骤的完整产品简报文档，工作流前置元数据显示所有已完成步骤
+- 重点：完成验证、状态更新和下一步指导
+- 限制：没有新内容生成，只有完成和收尾活动
+- 依赖项：所有之前的步骤必须已完成，内容保存到文档
+
+## 指令序列（不要偏离、跳过或优化）
+
+### 1. 宣布工作流完成
+
+**完成公告：**
+"🎉 **产品简报完成，{{user_name}}！**
+
+我已成功与你协作，为 {{project_name}} 创建了全面的产品简报。
+
+**我们完成的工作：**
+
+- ✅ 包含清晰愿景和问题陈述的执行摘要
+- ✅ 包含解决方案定义和独特差异化因素的核心愿景
+- ✅ 包含丰富用户画像和用户旅程的目标用户
+- ✅ 包含可衡量结果和业务目标的成功指标
+- ✅ 包含专注功能集和清晰边界的 MVP 范围
+- ✅ 在保持当前重点的同时激励人心的未来愿景
+
+**完整的产品简报现在位于：** `{outputFile}`
+
+这个简报作为所有后续产品开发活动和战略决策的基础。"
+
+### 2. 工作流状态更新
+
+**状态文件管理：**
+更新主工作流状态文件：
+
+- 检查 `{output_folder} or {planning_artifacts}/bmm-workflow-status.yaml` 是否存在
+- 如果存在，更新 workflow_status["product-brief"] = `{outputFile}`
+- 添加完成时间戳和元数据
+- 保存文件，保留所有注释和结构
+
+### 3. 文档质量检查
+
+**完整性验证：**
+对产品简报执行最终验证：
+
+- 执行摘要是否清晰传达了愿景和问题？
+- 目标用户是否定义良好，有引人注目的用户画像？
+- 成功指标是否将用户价值与业务目标联系起来？
+- MVP 范围是否专注且现实？
+- 简报是否为下一步提供了清晰的方向？
+
+**一致性验证：**
+
+- 所有部分是否与核心问题陈述一致？
+- 用户价值是否在整个文档中始终被强调？
+- 成功标准是否可以追溯到用户需求和业务目标？
+- MVP 范围是否与问题和解决方案对齐？
+
+### 4. 建议下一步
+
+**推荐的下一步工作流：**
+提供逻辑工作流的指导：
+
+1. `create-prd` - 创建详细的产品需求文档
+   - 简报为详细需求提供基础
+   - 用户画像指导旅程映射
+   - 成功指标成为具体的验收标准
+   - MVP 范围成为详细的功能规格
+
+**其他潜在的下一步：**
+
+1. `create-ux-design` - 用户体验研究和设计（可与 PRD 并行运行）
+2. `domain-research` - 深入市场或领域研究（如果需要）
+
+**战略考虑：**
+
+- PRD 工作流直接建立在这个简报上进行详细规划
+- 考虑团队能力和直接优先级
+- 在承诺详细工作之前使用简报验证概念
+- 简报可以指导早期技术可行性讨论
+
+### 5. 展示菜单选项
+
+**完成确认：**
+"**你的 {{project_name}} 产品简报现已完成，准备好进入下一阶段！**
+
+简报捕获了指导后续产品开发所需的一切：
+
+- 清晰愿景和问题定义
+- 对目标用户的深入理解
+- 可衡量的成功标准
+- 专注的 MVP 范围与现实边界
+- 激励人心的长期愿景
+
+**建议的下一步**
+
+- 用于详细需求的 PRD 工作流？
+- 用于用户体验规划的用户体验设计工作流？
+
+**产品简报完成**"
+
+#### 菜单处理逻辑：
+
+- 由于这是完成步骤，没有继续到其他工作流步骤
+- 用户可以提问或请求审查完成的简报
+- 当被请求时，提供下一步工作流选项的指导
+- 在完成确认后优雅地结束工作流会话
+
+#### 执行规则：
+
+- 这是以完成为重点的最后一步
+- 在这之后没有额外的工作流步骤要加载
+- 用户可以请求审查或澄清完成的简报
+- 提供关于下一步工作流选项的清晰指导
+
+## 关键步骤完成说明
+
+仅当[提供完成确认且工作流状态已更新]，你才会将工作流标记为完成并优雅地结束会话。在最终完成步骤之后不加载其他步骤。
+
+---
+
+## 🚨 系统成功/失败指标
+
+### ✅ 成功：
+
+- 产品简报包含所有必要部分，包含协作内容
+- 所有协作内容正确保存到文档，具有正确的前置元数据
+- 工作流状态文件使用完成信息和时间戳更新
+- 向用户提供清晰的下一步指导，包含具体的工作流推荐
+- 文档质量验证完成，包含完整性和一致性检查
+- 用户确认完成并理解下一步可用选项
+- 工作流在状态跟踪中正确标记为完成
+
+### ❌ 系统失败：
+
+- 不使用完成信息更新工作流状态文件
+- 缺少向用户提供的清晰下一步指导
+- 不与用户确认文档完整性
+- 工作流在状态跟踪中未正确标记为完成
+- 用户不清楚接下来会发生什么或可用的选项
+- 未识别或解决文档质量问题
+
+**主规则：** 跳过步骤、优化序列或不遵循确切指示是被禁止的，构成系统失败。
+
+## 最终工作流完成
+
+这个产品简报现在已完成，作为整个产品生命周期的战略基础。所有后续的设计、架构和开发工作都应该追溯到这个简档中记录的愿景、用户需求和成功指标。
+
+**恭喜你完成 {{project_name}} 的产品简报！** 🎉

package/_uxos/create-product-brief/workflow.md

@@ -0,0 +1,58 @@
+---
+name: create-product-brief
+description: 通过协作式逐步发现创建全面的产品简报，作为创意业务分析师与用户以同行身份协作。
+web_bundle: true
+---
+
+# 产品简报工作流
+
+**目标：** 通过协作式逐步发现创建全面的产品简报，作为创意业务分析师与用户以同行身份协作。
+
+**你的角色：** 除了你的名字、沟通风格和角色设定外，你还是一位专注于产品的业务分析师，与专家同行协作。这是合作伙伴关系，而非客户-供应商关系。你带来结构化思维和引导技能，而用户带来领域专业知识产品愿景。平等协作。
+
+---
+
+## 工作流架构
+
+此工作流使用**步骤文件架构**进行规范化执行：
+
+### 核心原则
+
+- **微文件设计**：每个步骤都是一个自包含的指令文件，是整体工作流的一部分，必须严格遵守
+- **即时加载**：仅当前步骤文件在内存中 - 在被告知之前绝不加载后续步骤文件
+- **顺序执行**：步骤文件中的顺序必须按顺序完成，不能跳过或优化
+- **状态跟踪**：当工作流生成文档时，使用 `stepsCompleted` 数组在输出文件的前置元数据中跟踪进度
+- **仅追加构建**：按指示将内容追加到输出文件来构建文档
+
+### 步骤处理规则
+
+1. **完整阅读**：在采取任何行动之前始终阅读整个步骤文件
+2. **遵循顺序**：按顺序执行所有编号部分，绝不偏离
+3. **等待输入**：如果显示了菜单，暂停并等待用户选择
+4. **检查继续**：如果步骤有以"继续"为选项的菜单，仅当用户选择 'C'（继续）时才继续下一步
+5. **保存状态**：在加载下一个步骤之前更新前置元数据中的 `stepsCompleted`
+6. **加载下一步**：当被指示时，加载、读取整个文件，然后执行下一个步骤文件
+
+### 关键规则（不得例外）
+
+- 🛑 **绝不**同时加载多个步骤文件
+- 📖 **始终**在执行前阅读整个步骤文件
+- 🚫 **绝不**跳过步骤或优化顺序
+- 💾 **始终**在写入步骤的最终输出时更新输出文件的前置元数据
+- 🎯 **始终**遵循步骤文件中的确切说明
+- ⏸️ **始终**在菜单处暂停并等待用户输入
+- 📋 **绝不**从后续步骤创建心理待办事项列表
+
+---
+
+## 初始化序列
+
+### 1. 配置加载
+
+从 {project-root}/_bmad/bmm/config.yaml 加载并读取完整配置并解析：
+
+- `project_name`、`output_folder`、`planning_artifacts`、`user_name`、`communication_language`、`document_output_language`、`user_skill_level`
+
+### 2. 第一步执行
+
+加载、读取完整文件，然后执行 `./steps/step-01-init.md` 以开始工作流。

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

@@ -0,0 +1,96 @@
+---
+description: 设计资产信息。当需要查找设计文件位置、设计系统规范、组件库、交付标准或设计工具配置时读取此规则。
+alwaysApply: false
+generator: memory-engine
+---
+
+# {{产品名称}} 设计资产
+
+> 此文件记录设计资产的位置、规范和交付标准。
+
+---
+
+## 设计工具与文件
+
+### 主要工具
+- **设计工具**：{{Figma/Sketch/Adobe XD}}
+- **原型工具**：{{Figma/Principle/ProtoPie}}
+- **标注交付**：{{蓝湖/摹客/Zeplin/Figma}}
+
+### 文件位置
+- **设计文件**：{{链接}}
+- **组件库**：{{链接}}
+- **图标库**：{{链接}}
+
+### 文件结构
+```
+{{项目名称}}/
+├── 01-用户研究/
+├── 02-信息架构/
+├── 03-交互设计/
+├── 04-视觉设计/
+└── 05-设计规范/
+```
+
+---
+
+## 设计系统
+
+### 设计原则
+1. **{{原则名称}}**：{{描述}}
+2. **{{原则名称}}**：{{描述}}
+3. **{{原则名称}}**：{{描述}}
+
+### 品牌调性
+- **关键词**：{{如：专业、可信赖、高效}}
+- **视觉风格**：{{描述}}
+
+### 组件规范
+- **组件库位置**：{{链接}}
+- **使用文档**：{{链接}}
+
+### 色彩规范
+- 主色：{{色值}}
+- 辅助色：{{色值}}
+- 中性色：{{色值范围}}
+
+### 字体规范
+- 主字体：{{字体名称}}
+- 字号体系：{{描述}}
+
+---
+
+## 交付规范
+
+### 命名规则
+- 页面命名：{{规则}}
+- 组件命名：{{规则}}
+- 切图命名：{{规则}}
+
+### 切图要求
+- 格式：{{PNG/SVG/WebP}}
+- 倍率：{{1x/2x/3x}}
+
+### 标注要求
+- 间距单位：{{px/pt/rem}}
+- 响应式断点：{{断点值}}
+
+### 交互说明
+- 动效描述方式：{{描述}}
+- 状态说明方式：{{描述}}
+
+---
+
+## 关键交付物
+
+| 交付物 | 状态 | 位置 |
+|--------|------|------|
+| 信息架构图 | {{完成/进行中/待开始}} | {{链接}} |
+| 交互原型 | | |
+| 视觉设计稿 | | |
+| 设计规范 | | |
+| 组件库 | | |
+
+---
+
+<!-- Generated by Memory-Engine workflow -->

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

@@ -0,0 +1,69 @@
+---
+description: 项目核心上下文。包含产品定位、目标用户、当前状态等关键信息，AI 每次会话自动加载。
+alwaysApply: true
+generator: memory-engine
+---
+
+# {{产品名称}} 核心上下文
+
+## 产品定位
+
+{{一句话描述产品是什么、为谁、解决什么问题}}
+
+- **产品类型**：{{Web应用/SaaS/平台/工具}}
+- **对标竞品**：{{竞品名称}}
+- **差异化**：{{产品价值/差异化描述，如无则写 [待补充]}}
+- **愿景**：{{产品愿景，如无法推导则写 [待补充]}}
+
+## 体验原则
+
+> 设计决策时优先遵循以下原则：
+
+1. **{{原则1名称}}**：{{可执行的描述}}
+2. **{{原则2名称}}**：{{可执行的描述}}
+3. **{{原则3名称}}**：{{可执行的描述}}
+
+## 目标用户
+
+> 💡 此处仅列出角色概览。设计具体功能时，请读取对应画像文件获取详细场景和痛点。
+
+| 角色 | 一句话描述 | 详细画像 |
+|------|-----------|----------|
+| {{主要用户角色}} | {{一句话描述}} | → 读取 `personas/{{role_1_file}}.md` |
+| {{次要用户角色}} | {{一句话描述}} | → 读取 `personas/{{role_2_file}}.md` |
+
+**何时需要读取详细画像：**
+- 设计面向特定用户的功能时
+- 需要了解用户具体痛点和使用场景时
+- 评估设计方案是否符合用户需求时
+
+## 当前状态
+
+- **阶段**：{{探索期/MVP/成长期/成熟期}}
+- **焦点**：{{当前具体在做什么}}
+- **待解决**：{{当前面临的主要问题}}
+
+## 关键决策
+
+已记录 {{N}} 条关键决策。
+
+> 需要了解决策的完整背景、依据和历史演变，请读取 `decisions` 规则。
+
+## 关键约束
+
+- {{技术约束：如技术栈、平台限制}}
+- {{业务约束：如时间节点、资源限制}}
+- {{规范约束：如合规要求、品牌规范}}
+
+## 知识库导航
+
+| 需要了解 | 读取文件 |
+|----------|----------|
+| 用户画像详情 | `personas/` 目录下对应角色文件 |
+| 决策完整背景 | `decisions` 规则 |
+| 设计资产位置 | `assets` 规则 |
+| 更新记忆引擎 | `update-memory` 规则 |
+
+---
+
+<!-- Generated by Memory-Engine workflow -->

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 -->