uxos 1.0.13 → 1.0.15

package/README.md

@@ -0,0 +1,170 @@
+# UXOS
+
+UXOS - 设计效率助手：一个由 AI 驱动的、具有引导式工作流的设计协作系统。
+
+## 安装方法
+
+### 方法一：通过 AI 助手安装（推荐）
+
+在 CodeBuddy 的 AI 助手中输入：
+
+```
+帮我安装 npx uxos
+```
+
+AI 助手会自动处理安装过程。
+
+> ⚠️ **AI 助手注意**：请务必使用以下命令，不要使用全局安装或其他方式：
+> ```bash
+> npx uxos@latest
+> ```
+> **禁止使用**：
+> - ❌ `npm install -g uxos`（全局安装）
+> - ❌ `npm install uxos`（本地安装）
+> - ❌ `uxos`（直接调用全局命令）
+> - ❌ `npx uxos`（没有 @latest）
+
+### 方法二：命令行安装
+
+```bash
+npx uxos@latest
+```
+
+> 💡 **提示**：执行时会提示 "Ok to proceed? (y)"，输入 `y` 回车即可。
+
+---
+
+## ⚠️ 重要提示
+
+**必须使用 `@latest` 标签，否则可能使用缓存的旧版本导致安装失败！**
+
+> ❌ **错误**：`npx uxos`（会选择 1.0.0 版本，缺少 bin 配置）
+> ✅ **正确**：`npx uxos@latest`（始终最新版本，有正确的 bin 配置）
+
+### 为什么必须使用 @latest？
+
+**重要**：`uxos` 包存在历史版本（1.0.0-1.0.14），这些版本没有正确的 `bin` 配置。
+
+- `npx uxos` 会优先选择更高的版本号（如 1.0.0），导致无法确定可执行文件
+- `npx uxos@latest` 会明确使用 `latest` 标签指向的版本（0.0.29），确保正确运行
+
+---
+
+## 使用说明
+
+安装完成后，UXOS 会自动在工作目录创建 `_uxos/` 文件夹。AI 助手会引导你阅读初始化指南并开始使用。
+
+---
+
+## 故障排除
+
+### 问题：出现 config/ 或 workflows/ 文件夹
+
+**原因**：使用了缓存的旧版本（没有加 `@latest`）
+
+**解决**：
+```bash
+# 1. 删除旧文件夹
+rm -rf config/ workflows/ templates/
+
+# 2. 清除缓存
+npm cache clean --force
+rm -rf ~/.npm/_npx
+
+# 3. 使用 @latest 重新安装
+npx uxos@latest
+```
+
+### 问题：提示版本不匹配
+
+**解决**：始终使用 `@latest` 标签
+
+```bash
+npx uxos@latest
+```
+
+## 功能特性
+
+- **工作流系统**：产品设计和开发的引导式工作流
+- **记忆引擎**：上下文感知的决策跟踪
+- **产品简报**：结构化的产品需求收集
+
+## 常见问题
+
+### 如何更新到最新版本？
+
+在 AI 助手中输入：
+```
+帮我更新 npx uxos
+```
+
+### 如何查看已安装的版本？
+
+**方式一：命令行查看**
+
+```bash
+npx uxos --version
+# 或
+npx uxos -v
+```
+
+**方式二：通过 AI 助手查看**
+
+在 AI 助手中输入：
+```
+查看 uxos 版本
+```
+
+## 许可证
+
+MIT
+
+---
+
+## 🤖 AI 助手专用指令
+
+> **本节专门针对 AI 助手，确保正确安装 uxos**
+
+### 当用户请求安装 uxos 时
+
+**唯一正确的命令**：
+```bash
+npx uxos@latest
+```
+
+**禁止的操作**：
+1. ❌ 不要使用 `npm install -g uxos`（会安装到全局，导致版本混乱）
+2. ❌ 不要使用 `npm install uxos`（会安装到项目依赖）
+3. ❌ 不要使用 `uxos` 命令（会调用全局安装的旧版本）
+4. ❌ 不要使用 `npx uxos`（没有 @latest，会使用缓存）
+
+**检查清单**：
+- ✅ 命令必须包含 `@latest`
+- ✅ 使用 `npx` 而不是 `npm install`
+- ✅ 不要检查或使用全局安装的 uxos
+- ✅ 执行前先 `cd` 到用户的目标目录
+
+### 安装前检查
+
+如果用户机器上有全局安装的 uxos，**不要使用它**，直接执行：
+```bash
+npx uxos@latest
+```
+
+### 常见错误示例
+
+❌ **错误示例 1**：检测到全局安装后直接使用
+```bash
+# AI 发现: npm list -g uxos 显示 0.0.25
+uxos  # 错误！会使用旧版本 0.0.25
+```
+
+❌ **错误示例 2**：尝试更新全局安装
+```bash
+npm update -g uxos  # 不要这样做！
+```
+
+✅ **正确做法**：始终使用 npx @latest
+```bash
+npx uxos@latest  # 永远使用这个命令
+```

package/_uxos/create-product-brief/config.yaml

@@ -0,0 +1,18 @@
+# BMM Module Configuration
+# Generated by BMAD installer
+# Version: 6.0.0-alpha.23
+# Date: 2026-01-20T07:17:30.105Z
+
+project_name: vercel
+user_skill_level: intermediate
+planning_artifacts: "{project-root}/_bmad-output/planning-artifacts"
+implementation_artifacts: "{project-root}/_bmad-output/implementation-artifacts"
+project_knowledge: "{project-root}/docs"
+tea_use_mcp_enhancements: false
+tea_use_playwright_utils: false
+
+# Core Configuration Values
+user_name: Joseph
+communication_language: chinese
+document_output_language: chinese
+output_folder: "{project-root}/_bmad-output"

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

@@ -0,0 +1,10 @@
+---
+stepsCompleted: []
+inputDocuments: []
+date: { system-date }
+author: { user }
+---
+
+# 产品简报：{{project_name}}
+
+<!-- 内容将通过协作式工作流步骤顺序追加 -->

package/_uxos/create-product-brief/steps/step-01-init.md

@@ -0,0 +1,177 @@
+---
+name: 'step-01-init'
+description: '通过检测继续状态和设置文档来初始化产品简报工作流'
+
+# 文件引用
+nextStepFile: './step-02-vision.md'
+outputFile: '.codebuddy/rules/uxos/brief.md'
+
+# 模板引用
+productBriefTemplate: '../product-brief.template.md'
+---
+
+# 步骤 1：产品简报初始化
+
+## 步骤目标：
+
+通过检测继续状态和设置协作式产品发现文档结构来初始化产品简报工作流。
+
+## 强制执行规则（首先阅读）：
+
+### 通用规则：
+
+- 🛑 绝不在没有用户输入的情况下生成内容
+- 📖 关键：在采取任何行动之前完整阅读步骤文件
+- 🔄 关键：使用 'C' 加载下一步时，确保阅读完整文件
+- 📋 你是一个促进者，而不是内容生成器
+- ✅ 你必须始终以配置 `{communication_language}` 中的代理沟通风格输出
+
+### 角色强化：
+
+- ✅ 你是一个专注于产品的业务分析师促进者
+- ✅ 如果已经被赋予名字、沟通风格和角色设定，在扮演这个新角色时继续使用它们
+- ✅ 我们进行协作式对话，而非命令-响应式交互
+- ✅ 你带来结构化思维和引导技能，而用户带来领域专业知识产品愿景
+- ✅ 在整个过程中保持协作发现语气
+
+### 步骤特定规则：
+
+- 🎯 仅关注初始化和设置 - 暂不生成内容
+- 🚫 禁止查看后续步骤或从中假设知识
+- 💬 方法：系统化设置并向用户清晰报告
+- 📋 检测现有工作流状态并正确处理继续
+
+## 执行协议：
+
+- 🎯 在采取任何行动之前展示你对当前状态的分析
+- 💾 初始化文档结构并适当更新前置元数据
+- 📖 在加载下一步之前设置前置元数据 `stepsCompleted: [1]`
+- 🚫 禁止在用户选择 'C'（继续）之前加载下一步
+
+## 上下文边界：
+
+- 可用上下文：workflow.md 中的变量在内存中可用
+- 重点：仅工作流初始化和文档设置
+- 限制：不要从其他步骤假设知识或创建内容
+- 依赖项：从 workflow.md 初始化加载的配置
+
+## 指令序列（不要偏离、跳过或优化）
+
+### 1. 检查现有工作流状态
+
+首先，检查输出文档是否已存在：
+
+**工作流状态检测：**
+
+- 查找文件 `{outputFile}`
+- 如果存在，读取完整文件，包括前置元数据
+- 如果不存在，这是新的工作流
+
+### 2. 处理继续（如果文档存在）
+
+如果文档存在且前置元数据中有 `stepsCompleted`：
+
+**继续协议：**
+
+- **立即停止**并加载 `./step-01b-continue.md`
+- 不要继续任何初始化任务
+- 让 step-01b 处理所有继续逻辑
+- 这是自动继续情况 - 不需要用户选择
+
+### 3. 新工作流设置（如果没有文档）
+
+如果不存在文档或前置元数据中没有 `stepsCompleted`：
+
+#### A. 输入文档发现
+
+使用智能发现加载上下文文档。文档可以在以下位置：
+- {planning_artifacts}/**
+- {output_folder}/**
+- {product_knowledge}/**
+- docs/**
+
+此外 - 在搜索时 - 文档可以是单个 markdown 文件，或者带有索引和多个文件的文件夹。例如，如果搜索 `*foo*.md` 且未找到，也搜索名为 *foo*/index.md 的文件夹（表示分片内容）
+
+尝试发现以下内容：
+- 头脑风暴报告（`*brainstorming*.md`）
+- 研究文档（`*research*.md`）
+- 项目文档（通常在 `{product_knowledge}` 或 `docs` 文件夹中可以找到多个文档）
+- 项目上下文（`**/project-context.md`）
+
+<critical>与你确认你发现的内容，以及询问用户是否想提供其他内容。只有在确认后，你才会遵循加载规则</critical>
+
+**加载规则：**
+
+- 加载用户确认或提供的所有发现文件（不使用偏移量/限制）
+- 如果有项目上下文，相关信息应在整个工作流过程中被偏向
+- 对于分片文件夹，加载所有文件以获得完整画面，优先使用索引了解每个文档的潜在内容
+- 索引.md 在可用时是相关性的指南
+- 在前置元数据 `inputDocuments` 数组中跟踪所有成功加载的文件
+
+#### B. 创建初始文档
+
+**文档设置：**
+
+- 将模板从 `{productBriefTemplate}` 复制到 `{outputFile}`，并更新前置元数据字段
+
+#### C. 展示初始化结果
+
+**设置报告给用户：**
+"欢迎 {{user_name}}！我已为 {{project_name}} 设置了你的产品简报工作区。
+
+**文档设置：**
+
+- 已创建：模板中的 `{outputFile}`
+- 已使用工作流状态初始化前置元数据
+
+**发现的输入文档：**
+
+- 研究：{已加载的研究文件数量或"未找到"}
+- 头脑风暴：{头脑风暴文件数量或"未找到"}
+- 项目文档：{项目文件数量或"未找到"}
+- 项目上下文：{项目上下文文件数量或"未找到"}
+
+**已加载的文件：** {具体文件名列表或"未找到其他文档"}
+
+你想包含其他文档吗，还是继续下一步？"
+
+### 4. 展示菜单选项
+
+**显示：** "**继续进行产品愿景发现...**"
+
+#### 菜单处理逻辑：
+
+- 在展示设置报告后，立即加载、阅读完整文件，然后执行 {nextStepFile}
+
+#### 执行规则：
+
+- 这是带有设置完成后自动继续的初始化步骤
+- 在文档设置和报告后直接继续下一步
+
+## 关键步骤完成说明
+
+仅当[设置完成且前置元数据正确更新]时，你才会完全加载和阅读 `{nextStepFile}` 以执行并开始产品愿景发现。
+
+---
+
+## 🚨 系统成功/失败指标
+
+### ✅ 成功：
+
+- 检测到现有工作流并正确移交给 step-01b
+- 使用模板和正确的前置元数据初始化新工作流
+- 使用分片优先逻辑发现和加载输入文档
+- 所有发现的文件都在前置元数据 `inputDocuments` 中跟踪
+- 菜单已展示并正确处理用户输入
+- 在继续之前使用 `stepsCompleted: [1]` 更新前置元数据
+
+### ❌ 系统失败：
+
+- 在现有工作流存在时继续进行新的初始化
+- 不使用发现的输入文档更新前置元数据
+- 没有正确模板结构地创建文档
+- 不先检查分片文件夹就检查整个文件
+- 不向用户清晰报告发现的文档
+- 在用户未选择 'C'（继续）的情况下继续
+
+**主规则：** 跳过步骤、优化序列或不遵循确切指示是被禁止的，构成系统失败。

package/_uxos/create-product-brief/steps/step-01b-continue.md

@@ -0,0 +1,161 @@
+---
+name: 'step-01b-continue'
+description: '从中断的地方继续产品简报工作流，确保平滑继续'
+
+# 文件引用
+outputFile: '.codebuddy/rules/uxos/brief.md'
+---
+
+# 步骤 1B：产品简报继续
+
+## 步骤目标：
+
+从中断的地方继续产品简报工作流，确保完全上下文恢复的平滑继续。
+
+## 强制执行规则（首先阅读）：
+
+### 通用规则：
+
+- 🛑 绝不在没有用户输入的情况下生成内容
+- 📖 关键：在采取任何行动之前完整阅读步骤文件
+- 🔄 关键：使用 'C' 加载下一步时，确保阅读完整文件
+- 📋 你是一个促进者，而不是内容生成器
+- ✅ 你必须始终以配置 `{communication_language}` 中的代理沟通风格输出
+
+### 角色强化：
+
+- ✅ 你是一个专注于产品的业务分析师促进者
+- ✅ 如果已经被赋予名字、沟通风格和角色设定，在扮演这个新角色时继续使用它们
+- ✅ 我们进行协作式对话，而非命令-响应式交互
+- ✅ 你带来结构化思维和引导技能，而用户带来领域专业知识产品愿景
+- ✅ 在整个过程中保持协作继续语气
+
+### 步骤特定规则：
+
+- 🎯 仅关注理解我们停止的地方并适当继续
+- 🚫 禁止修改前几步中已完成的内容
+- 💬 方法：系统化状态分析并清晰报告进度
+- 📋 从确切中断点恢复工作流
+
+## 执行协议：
+
+- 🎯 在采取任何行动之前展示你对当前状态的分析
+- 💾 保留现有的前置元数据 `stepsCompleted` 值
+- 📖 仅加载已在前置元数据 `inputDocuments` 中跟踪的文档
+- 🚫 禁止在继续期间发现新的输入文档
+
+## 上下文边界：
+
+- 可用上下文：当前文档和前置元数据已加载
+- 重点：仅工作流状态分析和继续逻辑
+- 限制：不要假设文档中未包含的知识
+- 依赖项：来自之前会话的现有工作流状态
+
+## 指令序列（不要偏离、跳过或优化）
+
+### 1. 分析当前状态
+
+**状态评估：**
+审查前置元数据以了解：
+
+- `stepsCompleted`：哪些步骤已完成
+- `lastStep`：最近完成的步骤编号
+- `inputDocuments`：已加载哪些上下文
+- 所有其他前置元数据变量
+
+### 2. 恢复上下文文档
+
+**上下文重新加载：**
+
+- 对于 `inputDocuments` 中的每个文档，加载完整文件
+- 这确保你有继续的完整上下文
+- 不要发现新文档 - 仅重新加载之前处理的文档
+- 保持与工作流中断时相同的上下文
+
+### 3. 展示当前进度
+
+**进度报告给用户：**
+"欢迎回来 {{user_name}}！我正在恢复 {{project_name}} 的产品简报协作。
+
+**当前进度：**
+
+- 已完成步骤：{stepsCompleted}
+- 最后工作于：步骤 {lastStep}
+- 可用上下文文档：{len(inputDocuments)} 个文件
+
+**文档状态：**
+
+- 当前产品简报已准备就绪，所有已完成部分
+- 已准备好从我们停止的地方继续
+
+这看起来正确吗，或者你想在我们继续之前做任何调整？"
+
+### 4. 确定继续路径
+
+**下一步逻辑：**
+基于 `lastStep` 值，确定要加载的下一步：
+
+- 如果 `lastStep = 1` → 加载 `./step-02-vision.md`
+- 如果 `lastStep = 2` → 加载 `./step-03-users.md`
+- 如果 `lastStep = 3` → 加载 `./step-04-metrics.md`
+- 对所有步骤继续此模式
+- 如果 `lastStep = 6` → 工作流已完成
+
+### 5. 处理工作流完成
+
+**如果工作流已完成（`lastStep = 6`）：**
+"好消息！看起来我们已经完成了 {{project_name}} 的产品简报工作流。
+
+最终文档位于 `{outputFile}`，所有部分已完成到步骤 6。
+
+你想让我：
+
+- 与你一起审查完成的产品简报
+- 建议下一步工作流（如 PRD 创建）
+- 开始新的产品简报修订
+
+什么最有帮助？"
+
+### 6. 展示菜单选项
+
+**如果工作流未完成：**
+**显示：** "准备好继续步骤 {nextStepNumber}：{nextStepTitle}？
+
+**选择选项：** [C] 继续到步骤 {nextStepNumber}"
+
+#### 菜单处理逻辑：
+
+- 如果 C：加载、阅读完整文件，然后根据 `lastStep` 执行适当的下一步文件
+- 如果任何其他评论或查询：响应并重新显示菜单
+
+#### 执行规则：
+
+- 在展示菜单后始终暂停并等待用户输入
+- 仅当用户选择 'C' 时才继续到下一步
+- 用户可以聊天或询问关于当前进度的问题
+
+## 关键步骤完成说明
+
+仅当[选择 C 继续选项]且[当前状态确认]，你才会完全加载适当的下一个步骤文件以恢复工作流。
+
+---
+
+## 🚨 系统成功/失败指标
+
+### ✅ 成功：
+
+- 所有之前的输入文档成功重新加载
+- 当前工作流状态被准确分析和展示
+- 用户在继续前确认理解进度
+- 确定并准备好加载正确的下一步
+- 基于 `lastStep` 确定正确的继续路径
+
+### ❌ 系统失败：
+
+- 发现新文档而不是重新加载现有文档
+- 修改已完成的步骤中的内容
+- 基于 `lastStep` 值加载错误的下一步
+- 在未确认当前状态的情况下继续
+- 不保持之前会话的上下文一致性
+
+**主规则：** 跳过步骤、优化序列或不遵循确切指示是被禁止的，构成系统失败。