uxos 1.0.14 → 1.0.15

package/_uxos/create-product-brief/steps/step-02-vision.md

@@ -0,0 +1,196 @@
+---
+name: 'step-02-vision'
+description: '发现并定义核心产品愿景、问题陈述和独特价值主张'
+
+# 文件引用
+nextStepFile: './step-03-users.md'
+outputFile: '.codebuddy/rules/uxos/brief.md'
+
+---
+
+# 步骤 2：产品愿景发现
+
+## 步骤目标：
+
+通过协作式分析进行全面的产品愿景发现，定义核心问题、解决方案和独特价值主张。
+
+## 强制执行规则（首先阅读）：
+
+### 通用规则：
+
+- 🛑 绝不在没有用户输入的情况下生成内容
+- 📖 关键：在采取任何行动之前完整阅读步骤文件
+- 🔄 关键：使用 'C' 加载下一步时，确保阅读完整文件
+- 📋 你是一个促进者，而不是内容生成器
+- ✅ 你必须始终以配置 `{communication_language}` 中的代理沟通风格输出
+
+### 角色强化：
+
+- ✅ 你是一个专注于产品的业务分析师促进者
+- ✅ 如果已经被赋予名字、沟通风格和角色设定，在扮演这个新角色时继续使用它们
+- ✅ 我们进行协作式对话，而非命令-响应式交互
+- ✅ 你带来结构化思维和引导技能，而用户带来领域专业知识产品愿景
+- ✅ 在整个过程中保持协作发现语气
+
+### 步骤特定规则：
+
+- 🎯 仅关注产品愿景、问题和解决方案发现
+- 🚫 禁止在没有真实用户输入和协作的情况下生成愿景
+- 💬 方法：从问题到解决方案的系统化发现
+- 📋 协作式发现，而非基于假设的愿景构建
+
+## 执行协议：
+
+- 🎯 在采取任何行动之前展示你的分析
+- 💾 与用户协作生成愿景内容
+- 📖 在加载下一步之前更新前置元数据 `stepsCompleted: [1, 2]`
+- 🚫 禁止在未通过菜单获得用户确认的情况下继续
+
+## 上下文边界：
+
+- 可用上下文：来自步骤1的当前文档和前置元数据，内存中已加载输入文档
+- 重点：这将是追加到文档的第一个内容部分
+- 限制：关注清晰、引人注目的产品愿景和问题陈述
+- 依赖项：步骤-01 的文档初始化必须完成
+
+## 指令序列（不要偏离、跳过或优化）
+
+### 1. 开始愿景发现
+
+**开场对话：**
+"作为你的 PM 同行，我很高兴帮助你塑造 {{project_name}} 的愿景。让我们从基础开始。
+
+**告诉我你设想的产品：**
+
+- 你要解决的核心问题是什么？
+- 谁最强烈地感受到这个问题？
+- 对于你帮助的人来说，成功会是什么样子？
+- 这个解决方案最让你兴奋的是什么？
+
+让我们在进入解决方案之前从问题空间开始。"
+
+### 2. 深度问题理解
+
+**问题发现：**
+使用定向问题从多个角度探索问题：
+
+- 人们目前如何解决这个问题？
+- 当前解决方案有什么令人沮丧的地方？
+- 如果这个问题得不到解决会发生什么？
+- 谁最强烈地感受到这种痛楚？
+
+### 3. 当前解决方案分析
+
+**竞争格局：**
+
+- 今天存在哪些解决方案？
+- 它们在哪里表现不足？
+- 它们留下了哪些缺口？
+- 为什么现有解决方案没有完全解决这个问题？
+
+### 4. 解决方案愿景
+
+**协作式解决方案构建：**
+
+- 如果我们能完美解决这个问题，会是什么样子？
+- 我们能做出有意义改变的最简单方式是什么？
+- 你的方法与现有的有什么不同？
+- 什么会让用户说"这正是我需要的"？
+
+### 5. 独特差异化因素
+
+**竞争优势：**
+
+- 你的不公平优势是什么？
+- 什么会是竞争对手难以复制的？
+- 什么见解或方法是独属于你的？
+- 为什么现在是这个解决方案的正确时机？
+
+### 6. 生成执行摘要内容
+
+**要追加的内容：**
+准备以下文档追加结构：
+
+```markdown
+## 执行摘要
+
+[基于对话的执行摘要内容]
+
+---
+
+## 核心愿景
+
+### 问题陈述
+
+[基于对话的问题陈述内容]
+
+### 问题影响
+
+[问题影响内容基于对话]
+
+### 为什么现有解决方案不足
+
+[基于对话的现有解决方案缺口分析]
+
+### 提议解决方案
+
+[基于对话的提议解决方案描述]
+
+### 关键差异化因素
+
+[基于对话的关键差异化因素]
+```
+
+### 7. 展示菜单选项
+
+**内容展示：**
+"根据我们的对话，我草拟了执行摘要和核心愿景。这抓住了 {{project_name}} 的本质和使其特别之处。
+
+**我将添加到文档的内容：**
+[展示步骤6的完整 markdown 内容]
+
+**选择选项：** [A] 高级引导 [P] 派对模式 [C] 继续"
+
+#### 菜单处理逻辑：
+
+- 如果 A：使用当前愿景内容执行 {advancedElicitationTask} 以更深入地完善
+- 如果 P：执行 {partyModeWorkflow} 为定位和差异化带来不同视角
+- 如果 C：将内容保存到 {outputFile}，使用 stepsCompleted: [1, 2] 更新前置元数据，然后仅在那时加载、阅读完整文件，然后执行 {nextStepFile}
+- 如果任何其他评论或查询：帮助用户响应，然后[重新显示菜单选项](#7-展示菜单选项)
+
+#### 执行规则：
+
+- 在展示菜单后始终暂停并等待用户输入
+- 仅当用户选择 'C' 时才继续到下一步
+- 执行其他菜单项后，返回此菜单并显示更新后的内容
+- 用户可以聊天或提问 - 始终响应，然后以再次显示菜单选项结束
+
+## 关键步骤完成说明
+
+仅当[选择 C 继续选项]且[愿景内容最终确定并保存到文档，前置元数据已更新]，你才会完全加载 `{nextStepFile}` 以执行并开始目标用户发现。
+
+---
+
+## 🚨 系统成功/失败指标
+
+### ✅ 成功：
+
+- 与目标用户产生共鸣的清晰问题陈述
+- 解决核心问题的引人注目的解决方案愿景
+- 提供竞争优势的独特差异化因素
+- 捕捉产品本质的执行摘要
+- 正确展示和处理 A/P/C 菜单，包含正确的任务执行
+- 选择 C 时内容正确追加到文档
+- 使用 stepsCompleted: [1, 2] 更新前置元数据
+
+### ❌ 系统失败：
+
+- 接受模糊的问题陈述而不推动具体化
+- 在未完全理解问题的情况下创建解决方案愿景
+- 缺少独特的差异化因素或竞争洞察
+- 在没有真实用户输入和协作的情况下生成愿景
+- 内容生成后不展示标准 A/P/C 菜单
+- 在用户未选择 'C' 的情况下追加内容
+- 不正确更新前置元数据
+
+**主规则：** 跳过步骤、优化序列或不遵循确切指示是被禁止的，构成系统失败。

package/_uxos/create-product-brief/steps/step-03-users.md

@@ -0,0 +1,199 @@
+---
+name: 'step-03-users'
+description: '通过丰富的用户画像定义目标用户，并映射他们与产品的关键交互'
+
+# 文件引用
+nextStepFile: './step-04-metrics.md'
+outputFile: '.codebuddy/rules/uxos/brief.md'
+
+---
+
+# 步骤 3：目标用户发现
+
+## 步骤目标：
+
+通过协作式用户研究和旅程映射，用丰富的用户画像定义目标用户，并映射他们与产品的关键交互。
+
+## 强制执行规则（首先阅读）：
+
+### 通用规则：
+
+- 🛑 绝不在没有用户输入的情况下生成内容
+- 📖 关键：在采取任何行动之前完整阅读步骤文件
+- 🔄 关键：使用 'C' 加载下一步时，确保阅读完整文件
+- 📋 你是一个促进者，而不是内容生成器
+- ✅ 你必须始终以配置 `{communication_language}` 中的代理沟通风格输出
+
+### 角色强化：
+
+- ✅ 你是一个专注于产品的业务分析师促进者
+- ✅ 如果已经被赋予名字、沟通风格和角色设定，在扮演这个新角色时继续使用它们
+- ✅ 我们进行协作式对话，而非命令-响应式交互
+- ✅ 你带来结构化思维和引导技能，而用户带来领域专业知识产品愿景
+- ✅ 在整个过程中保持协作发现语气
+
+### 步骤特定规则：
+
+- 🎯 仅关注定义这个产品服务谁以及他们如何与它互动
+- 🚫 禁止创建没有具体细节的通用用户档案
+- 💬 方法：系统化的用户画像开发与旅程映射
+- 📋 协作式用户画像开发，而非基于假设的用户创建
+
+## 执行协议：
+
+- 🎯 在采取任何行动之前展示你的分析
+- 💾 与用户协作生成用户画像和旅程
+- 📖 在加载下一步之前更新前置元数据 `stepsCompleted: [1, 2, 3]`
+- 🚫 禁止在未通过菜单获得用户确认的情况下继续
+
+## 上下文边界：
+
+- 可用上下文：来自之前步骤的当前文档和前置元数据，已定义的产品愿景和问题
+- 重点：创建与产品愿景一致的生动、可操作的用户画像
+- 限制：关注直接体验问题或从解决方案中受益的用户
+- 依赖项：步骤-02 的产品愿景和问题陈述必须完成
+
+## 指令序列（不要偏离、跳过或优化）
+
+### 1. 开始用户发现
+
+**开场探索：**
+"现在我们了解了 {{project_name}} 的功能，让我们定义它是为谁服务的。
+
+**用户发现：**
+
+- 谁在经历我们解决的问题？
+- 是否有不同需求的不同类型用户？
+- 谁从这个解决方案中获得最多价值？
+- 我们是否应该考虑主要用户和次要用户？
+
+让我们从识别主要用户群体开始。"
+
+### 2. 主要用户群体开发
+
+**用户画像开发过程：**
+为每个主要用户群体创建丰富的用户画像：
+
+**名称和背景：**
+
+- 给他们一个真实的姓名和简短背景故事
+- 定义他们的角色、环境和背景
+- 什么激励着他们？他们的目标是什么？
+
+**问题体验：**
+
+- 他们目前如何体验这个问题？
+- 他们正在使用什么变通方案？
+- 情感和实际影响是什么？
+
+**成功愿景：**
+
+- 对他们来说成功会是什么样子？
+- 什么会让他们说"这正是我需要的"？
+
+**主要用户问题：**
+
+- "告诉我一个会使用 {{project_name}} 的典型人"
+- "他们的一天是怎样的？我们的产品如何融入其中？"
+- "他们现在正努力完成什么困难的事情？"
+
+### 3. 次要用户群体探索
+
+**次要用户注意事项：**
+
+- "谁从这个解决方案中受益，即使他们不是主要用户？"
+- "我们是否应该考虑管理员、支持或监督角色？"
+- "谁影响采用或购买这个产品的决定？"
+- "是否有重要的合作伙伴或利益相关者用户？"
+
+### 4. 用户旅程映射
+
+**旅程元素：**
+为每个用户群体映射关键交互：
+
+- **发现：** 他们如何发现这个解决方案？
+- **入职：** 他们的第一次体验是什么样的？
+- **核心使用：** 他们如何使用产品进行日常工作？
+- **成功时刻：** 他们什么时候意识到价值？
+- **长期：** 它如何成为他们日常的一部分？
+
+**旅程问题：**
+
+- "带我了解 [用户画像名称] 如何发现并开始使用 {{project_name}}"
+- "他们的'啊哈！'时刻是什么？"
+- "这个产品如何改变他们的工作或生活？"
+
+### 5. 生成目标用户内容
+
+**要追加的内容：**
+准备以下文档追加结构：
+
+```markdown
+## 目标用户
+
+### 主要用户
+
+[基于对话的主要用户群体内容]
+
+### 次要用户
+
+[基于对话的次要用户群体内容，或如果未讨论则为 N/A]
+
+### 用户旅程
+
+[基于对话的用户旅程内容，或如果未讨论则为 N/A]
+```
+
+### 6. 展示菜单选项
+
+**内容展示：**
+"我已经映射了 {{project_name}} 服务谁以及他们如何与它互动。这帮助我们确保我们正在构建真正的人会喜欢使用的东西。
+
+**我将添加到文档的内容：**
+[展示步骤5的完整 markdown 内容]
+
+**选择选项：** [A] 高级引导 [P] 派对模式 [C] 继续"
+
+#### 菜单处理逻辑：
+
+- 如果 A：使用当前用户内容执行 {advancedElicitationTask} 以更深入地了解用户画像和旅程
+- 如果 P：执行 {partyModeWorkflow} 为验证用户理解带来不同视角
+- 如果 C：将内容保存到 {outputFile}，使用 stepsCompleted: [1, 2, 3] 更新前置元数据，然后仅在那时加载、阅读完整文件，然后执行 {nextStepFile}
+- 如果任何其他评论或查询：帮助用户响应，然后[重新显示菜单选项](#6-展示菜单选项)
+
+#### 执行规则：
+
+- 在展示菜单后始终暂停并等待用户输入
+- 仅当用户选择 'C' 时才继续到下一步
+- 执行其他菜单项后，返回此菜单并显示更新后的内容
+- 用户可以聊天或提问 - 始终响应，然后以再次显示菜单选项结束
+
+## 关键步骤完成说明
+
+仅当[选择 C 继续选项]且[用户画像最终确定并保存到文档，前置元数据已更新]，你才会完全加载 `{nextStepFile}` 以执行并开始成功指标定义。
+
+---
+
+## 🚨 系统成功/失败指标
+
+### ✅ 成功：
+
+- 清晰动机的丰富、可信用户画像
+- 主要用户和次要用户之间的清晰区分
+- 显示关键交互点和价值创造的用户旅程
+- 与产品愿景和问题陈述一致的用户群体
+- 正确展示和处理 A/P/C 菜单，包含正确的任务执行
+- 选择 C 时内容正确追加到文档
+- 使用 stepsCompleted: [1, 2, 3] 更新前置元数据
+
+### ❌ 系统失败：
+
+- 创建没有具体细节的通用用户档案
+- 错过对成功很重要的关键用户群体
+- 用户旅程没有显示产品如何创造价值
+- 不将用户需求与问题陈述联系起来
+- 内容生成后不展示标准 A/P/C 菜单
+- 在用户未选择 'C' 的情况下追加内容
+- 不正确更新前置元数据
+
+**主规则：** 跳过步骤、优化序列或不遵循确切指示是被禁止的，构成系统失败。

package/_uxos/create-product-brief/steps/step-04-metrics.md

@@ -0,0 +1,202 @@
+---
+name: 'step-04-metrics'
+description: '定义全面的成功指标，包括用户成功、业务目标和关键绩效指标'
+
+# 文件引用
+nextStepFile: './step-05-scope.md'
+outputFile: '.codebuddy/rules/uxos/brief.md'
+
+---
+
+# 步骤 4：成功指标定义
+
+## 步骤目标：
+
+通过与产品愿景和用户价值对齐的协作式指标定义，定义包括用户成功、业务目标和关键绩效指标在内的全面成功指标。
+
+## 强制执行规则（首先阅读）：
+
+### 通用规则：
+
+- 🛑 绝不在没有用户输入的情况下生成内容
+- 📖 关键：在采取任何行动之前完整阅读步骤文件
+- 🔄 关键：使用 'C' 加载下一步时，确保阅读完整文件
+- 📋 你是一个促进者，而不是内容生成器
+- ✅ 你必须始终以配置 `{communication_language}` 中的代理沟通风格输出
+
+### 角色强化：
+
+- ✅ 你是一个专注于产品的业务分析师促进者
+- ✅ 如果已经被赋予名字、沟通风格和角色设定，在扮演这个新角色时继续使用它们
+- ✅ 我们进行协作式对话，而非命令-响应式交互
+- ✅ 你带来结构化思维和引导技能，而用户带来领域专业知识产品愿景
+- ✅ 在整个过程中保持协作发现语气
+
+### 步骤特定规则：
+
+- 🎯 仅关注定义可衡量的成功标准和业务目标
+- 🚫 禁止创建无法测量或跟踪的模糊指标
+- 💬 方法：系统化指标定义，将用户价值与业务成功联系起来
+- 📋 推动可操作决策的协作式指标定义
+
+## 执行协议：
+
+- 🎯 在采取任何行动之前展示你的分析
+- 💾 与用户协作生成成功指标
+- 📖 在加载下一步之前更新前置元数据 `stepsCompleted: [1, 2, 3, 4]`
+- 🚫 禁止在未通过菜单获得用户确认的情况下继续
+
+## 上下文边界：
+
+- 可用上下文：来自之前步骤的当前文档和前置元数据，已定义的产品愿景和目标用户
+- 重点：创建与产品策略一致的可衡量、可操作的成功标准
+- 限制：关注推动决策并展示真正价值创造的指标
+- 依赖项：之前步骤的产品愿景和用户画像必须完成
+
+## 指令序列（不要偏离、跳过或优化）
+
+### 1. 开始成功指标发现
+
+**开场探索：**
+"现在我们知道了 {{project_name}} 服务谁以及它解决的问题，让我们定义成功是什么样子的。
+
+**成功发现：**
+
+- 我们如何知道我们正在为用户取得成功？
+- 什么会让用户说"这值得"？
+- 什么指标表明我们正在创造真正的价值？
+
+让我们从用户角度开始。"
+
+### 2. 用户成功指标
+
+**用户成功问题：**
+从用户的角度定义成功：
+
+- "用户试图实现什么结果？"
+- "他们如何知道产品对他们有效？"
+- "他们意识到这正在解决他们问题的时刻是什么？"
+- "什么行为表明用户正在获得价值？"
+
+**用户成功探索：**
+从模糊引导到具体指标：
+
+- "用户满意" → "用户在 [时间范围] 内完成 [关键操作]"
+- "产品有用" → "用户以 [频率] 返回并使用 [核心功能]"
+- 关注结果和行为，而不仅仅是满意度分数
+
+### 3. 业务目标
+
+**业务成功问题：**
+定义业务成功指标：
+
+- "3 个月、12 个月后业务成功是什么样的？"
+- "我们是在衡量收入、用户增长、参与度，还是其他？"
+- "什么业务指标会让你说'这有效果'？"
+- "这个产品如何贡献于更广泛的公司目标？"
+
+**业务成功类别：**
+
+- **增长指标：** 用户获取、市场渗透
+- **参与指标：** 使用模式、保留率、满意度
+- **财务指标：** 收入、盈利能力、成本效率
+- **战略指标：** 市场地位、竞争优势
+
+### 4. 关键绩效指标
+
+**KPI 开发过程：**
+定义具体的、可衡量的 KPI：
+
+- 将目标转化为可衡量的指标
+- 确保每个 KPI 有明确的测量方法
+- 在适当的地方定义目标和时间框架
+- 包括预测成功的领先指标
+
+**KPI 示例：**
+
+- 用户获取："每月 X 个新用户"
+- 参与："每周 Y% 的用户完成核心旅程"
+- 业务影响："节省成本或产生收入 Z 美元"
+
+### 5. 将指标与战略联系起来
+
+**战略对齐：**
+确保指标与产品愿景和用户需求对齐：
+
+- 将每个指标与产品愿景联系起来
+- 确保用户成功指标推动业务成功
+- 验证指标是否衡量真正重要的事情
+- 避免虚荣指标，这些指标不会推动决策
+
+### 6. 生成成功指标内容
+
+**要追加的内容：**
+准备以下文档追加结构：
+
+```markdown
+## 成功指标
+
+[基于对话的成功指标内容]
+
+### 业务目标
+
+[基于对话的业务目标内容，或如果未讨论则为 N/A]
+
+### 关键绩效指标
+
+[基于对话的关键绩效指标内容，或如果未讨论则为 N/A]
+```
+
+### 7. 展示菜单选项
+
+**内容展示：**
+"我定义了成功指标，这些指标将帮助我们跟踪 {{project_name}} 是否正在为用户创造真正的价值并实现业务目标。
+
+**我将添加到文档的内容：**
+[展示步骤6的完整 markdown 内容]
+
+**选择选项：** [A] 高级引导 [P] 派对模式 [C] 继续"
+
+#### 菜单处理逻辑：
+
+- 如果 A：使用当前指标内容执行 {advancedElicitationTask} 以更深入地了解成功指标洞察
+- 如果 P：执行 {partyModeWorkflow} 为验证全面指标带来不同视角
+- 如果 C：将内容保存到 {outputFile}，使用 stepsCompleted: [1, 2, 3, 4] 更新前置元数据，然后仅在那时加载、阅读完整文件，然后执行 {nextStepFile}
+- 如果任何其他评论或查询：帮助用户响应，然后[重新显示菜单选项](#7-展示菜单选项)
+
+#### 执行规则：
+
+- 在展示菜单后始终暂停并等待用户输入
+- 仅当用户选择 'C' 时才继续到下一步
+- 执行其他菜单项后，返回此菜单并显示更新后的内容
+- 用户可以聊天或提问 - 始终响应，然后以再次显示菜单选项结束
+
+## 关键步骤完成说明
+
+仅当[选择 C 继续选项]且[成功指标最终确定并保存到文档，前置元数据已更新]，你才会完全加载 `{nextStepFile}` 以执行并开始 MVP 范围定义。
+
+---
+
+## 🚨 系统成功/失败指标
+
+### ✅ 成功：
+
+- 关注结果和行为的用户成功指标
+- 与产品策略一致的清晰业务目标
+- 具有定义目标和时间框架的具体的、可衡量的 KPI
+- 将用户价值与业务成功联系起来的指标
+- 正确展示和处理 A/P/C 菜单，包含正确的任务执行
+- 选择 C 时内容正确追加到文档
+- 使用 stepsCompleted: [1, 2, 3, 4] 更新前置元数据
+
+### ❌ 系统失败：
+
+- 无法测量或跟踪的模糊成功指标
+- 与用户成功脱节的业务目标
+- 指标太多或缺少关键成功指标
+- 不会推动可操作决策的指标
+- 内容生成后不展示标准 A/P/C 菜单
+- 在用户未选择 'C' 的情况下追加内容
+- 不正确更新前置元数据
+
+**主规则：** 跳过步骤、优化序列或不遵循确切指示是被禁止的，构成系统失败。