uxos 1.0.14 → 1.0.15

package/_uxos/memory-engine/steps/step-05-finalize.md

@@ -0,0 +1,175 @@
+---
+name: 'step-05-finalize'
+description: '完成提示：展示生成的文件清单，提示后续操作'
+---
+
+# Step 5: 完成提示
+
+## 步骤目标
+
+展示记忆引擎创建结果，提示用户后续操作选项。
+
+## 执行规则
+
+### 通用规则
+- 📖 执行前完整阅读本步骤文件
+- 🎯 专注于结果展示和后续引导
+- ✅ 使用中文输出
+
+### 步骤特定规则
+- 📋 使用固定的成功通知模板
+- 🔗 文件列表使用可点击链接格式
+- 📁 包含 personas/ 目录下的用户画像文件
+
+---
+
+## 执行序列
+
+### 1. 展示成功通知
+
+<critical>
+根据实际生成的文件展示，特别注意：
+1. 列出所有 personas/ 下生成的画像文件
+2. 如果差异化是 [待补充]，提示用户后续完善
+</critical>
+
+**成功通知模板：**
+
+```
+✅ **项目记忆引擎已创建完成！**
+
+🎯 从现在开始，我会始终记得你的项目背景。
+
+**已生成的文件：**
+
+📁 **核心文件**
+- [context.md](.codebuddy/rules/uxos/context.md) — 核心上下文（产品定位、体验原则等）
+- [decisions.md](.codebuddy/rules/uxos/decisions.md) — 设计决策记录
+- [update-memory.md](.codebuddy/rules/uxos/update-memory.md) — 更新指南
+- [uxos-index.md](.codebuddy/rules/uxos/uxos-index.md) — 知识库索引
+
+👤 **用户画像**（AI 自动推导，可随时细化）
+- [personas/_index.md](.codebuddy/rules/uxos/personas/_index.md) — 画像索引
+- [personas/{角色1}.md](.codebuddy/rules/uxos/personas/{角色1}.md) — {角色1}详细画像
+- [personas/{角色2}.md](.codebuddy/rules/uxos/personas/{角色2}.md) — {角色2}详细画像
+
+🎨 **设计资产**（如有）
+- [assets.md](.codebuddy/rules/uxos/assets.md) — 设计文件和规范
+
+---
+
+💡 **使用指南**
+
+**日常协作时：**
+- `context.md` 每次会话自动加载，我会了解项目背景
+- 设计具体功能时，我会主动读取相关用户画像
+
+**需要更新时：**
+- 随时用 `更新记忆` 指令记录项目进展
+- 可以直接编辑任何 .md 文件完善内容
+
+**开始吧！**
+```
+
+### 2. 差异化待补充提示
+
+<if condition="差异化是 [待补充]">
+在成功通知后追加：
+
+```
+---
+
+💡 **小提示**
+
+当前差异化定位为 [待补充]。当你对产品定位有更清晰的理解时，可以告诉我，我会帮你更新记忆引擎。
+```
+</if>
+
+### 3. 提供后续选项
+
+<critical>
+生成完成后，必须提供以下选项让用户选择，不要直接结束！
+</critical>
+
+```
+---
+
+**接下来你想？**
+
+`1` 直接开始项目 — 记忆引擎会在项目过程中随时更新细化
+`2` 输入「细化」 — 我会带你现在就补充完善
+```
+
+#### 选项 1：直接开始
+
+```
+好的，记忆引擎已就绪！
+
+你可以直接开始项目工作了。在项目推进过程中：
+- 我会基于记忆引擎理解你的产品背景
+- 设计功能时会主动读取相关用户画像
+- 随时用「更新记忆」指令记录新的决策和信息
+- 记忆引擎会持续丰富和细化
+
+**开始吧！**
+```
+
+工作流结束。
+
+#### 选项 2：细化
+
+```
+好的，我将启动专业的细化工作流来帮助你完善记忆引擎内容。
+
+这将调用 create-product-brief 工作流，它会系统性地引导你：
+- 深入完善产品定位和差异化
+- 详细定义用户画像和使用场景
+- 优化体验原则和设计准则
+
+工作流调用：`/data/workspace/nice/create-product-brief/workflow.md`
+
+上下文传递：
+- 已生成的 context.md 内容
+- personas/ 目录中的用户画像
+- 当前的体验原则和定位信息
+
+完成后将更新记忆引擎并返回此界面。
+```
+
+**工作流调用逻辑：**
+
+1. **传递上下文信息：**
+   - 已生成的 context.md 内容
+   - personas/ 目录中的用户画像
+   - 当前的体验原则和定位信息
+
+2. **执行外部工作流：**
+   - 加载并执行 `/data/workspace/nice/create-product-brief/workflow.md`
+   - 传递上述上下文作为输入参数
+
+3. **返回和更新处理：**
+   - create-product-brief 工作流完成后
+   - 将细化结果导入到记忆引擎中
+   - 使用 update-memory 规则更新相关文件
+   - 重新显示工作流完成界面
+
+### 4. 工作流结束
+
+- 选项 1：直接结束，用户开始项目
+- 选项 2：进入细化循环，直到用户输入「开始项目」或「完成」时结束
+
+---
+
+<!-- 工作流链接扩展点（预留） -->
+<!-- 
+未来可在此处添加工作流链接选项：
+
+**后续工作流（可选）：**
+- [更新记忆] — 更新已有记忆引擎
+- [细化画像] — 深入完善用户画像
+- [添加资产] — 补充设计资产信息
+-->
+
+---
+
+<!-- Memory-Engine Step 05 | Finalize -->

package/_uxos/memory-engine/workflow.md

@@ -0,0 +1,95 @@
+---
+name: memory-engine
+description: 为产品设计项目建立持久化的记忆引擎，让 AI 在每次会话时自动了解项目背景和上下文。支持通过"初始化记忆"、"建立记忆引擎"等触发词启动。
+web_bundle: true
+---
+
+# Memory-Engine 工作流
+
+**目标：** 为产品经理和产品设计师建立持久化的项目记忆引擎，通过生成规则文件让 AI 在每次会话自动加载项目上下文。
+
+**AI 角色：** 产品上下文分析师（Product Context Analyst）
+
+你是一位专注于产品设计知识架构的分析师，具备以下能力：
+- 从有限信息推导完整产品上下文
+- 基于竞品分析推导用户群和场景
+- 结构化组织项目记忆
+- 平衡信息密度和简洁性
+
+**沟通风格：**
+- 分析性思维：从少量信息发现模式
+- 结构化表达：系统性组织和呈现信息
+- 高效务实：只问必要问题，减少交互摩擦
+- 咨询式引导：帮助用户建立清晰的项目知识库
+
+---
+
+## 工作流架构
+
+本工作流使用**步骤文件架构**实现规范化执行：
+
+### 核心原则
+
+- **微文件设计**：每个步骤是自包含的指令文件
+- **即时加载**：只加载当前步骤文件
+- **顺序执行**：必须按顺序完成，不跳过
+- **Step 自闭环**：执行逻辑在 step 内，data/ 只放模板
+
+### 步骤处理规则
+
+1. **完整阅读**：执行前完整阅读整个步骤文件
+2. **遵循顺序**：按编号顺序执行所有章节
+3. **等待输入**：如有菜单或选项，停止并等待用户输入
+4. **加载下一步**：指示时加载并执行下一个步骤文件
+
+### 关键规则（无例外）
+
+- 🛑 **绝不**同时加载多个步骤文件
+- 📖 **总是**在执行前完整阅读步骤文件
+- 🚫 **绝不**跳过步骤或优化顺序
+- 🎯 **总是**严格遵循步骤文件中的指令
+- ⏸️ **总是**在用户选择点停止等待
+
+---
+
+## 初始化序列
+
+### 1. 配置加载
+
+从 config.yaml 加载配置（如果存在）：
+- `user_name`
+- `communication_language`
+
+### 2. 启动工作流
+
+**触发词：** "初始化记忆"、"建立记忆引擎"、"create memory"、"init memory"
+
+检测到触发词后，加载并执行 `steps/step-01-discovery.md`
+
+---
+
+## 输出文件
+
+工作流将生成以下文件到 `.codebuddy/rules/uxos/`：
+
+| 文件 | 用途 | 加载方式 |
+|------|------|---------|
+| uxos-index.md | 知识库导航索引 | Always |
+| context.md | 核心上下文 | Always |
+| decisions.md | 决策记录 | Agent Requested |
+| update-memory.md | 更新逻辑 | Agent Requested |
+| assets.md | 设计资产（可选） | Agent Requested |
+
+---
+
+<!-- 工作流链接扩展点（预留） -->
+<!-- 未来可链接的工作流：
+- update-memory - 更新已有记忆
+- refine-context - 细化特定部分
+- add-assets - 补充资产信息
+- validate-memory - 验证记忆质量
+-->
+
+---
+
+*Memory-Engine Workflow | Created for product design memory management*

package/cli.js

@@ -2,33 +2,197 @@
 
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
 
-const targetDir = process.cwd();
-const packageJson = require(path.join(__dirname, 'package.json'));
-const version = packageJson.version;
-
-// 拷贝所有文件到项目目录
-const copyFiles = [
-  ['config/user-template.yaml', 'config/user-template.yaml'],
-  ['workflows/init.md', 'workflows/init.md'],
-  ['workflows/step1.md', 'workflows/step1.md'],
-  ['workflows/step2.md', 'workflows/step2.md'],
-  ['templates/test-template.md', 'templates/test-template.md'],
-  ['templates/test2-template.md', 'templates/test2-template.md'],
-];
-
-copyFiles.forEach(([src, dest]) => {
-  const srcPath = path.join(__dirname, src);
-  const destPath = path.join(targetDir, dest);
-
-  const destDir = path.dirname(destPath);
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
+// Read version from package.json
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
+const VERSION = packageJson.version;
+
+const UXOS_SRC_DIR = path.join(__dirname, '_uxos');
+const CHECK_INTERVAL = 1000 * 60 * 60 * 24; // 24 hours
+
+// CRITICAL: Check if running the latest version IMMEDIATELY
+function checkForLatestVersion() {
+  try {
+    // Use a cache file to avoid checking too frequently
+    const cacheDir = path.join(os.tmpdir(), '.uxos-version-check');
+    const cacheFile = path.join(cacheDir, 'last-check.json');
+    
+    let shouldCheck = true;
+    
+    // Check if we need to query npm registry
+    if (fs.existsSync(cacheFile)) {
+      const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+      const timeSinceLastCheck = Date.now() - cache.timestamp;
+      
+      if (timeSinceLastCheck < CHECK_INTERVAL) {
+        // Use cached result
+        shouldCheck = false;
+        if (cache.latestVersion !== VERSION) {
+          showVersionWarning(cache.latestVersion);
+          process.exit(1);
+        }
+      }
+    }
+    
+    // Perform actual check if needed
+    if (shouldCheck) {
+      const latestVersion = execSync('npm view uxos version', { 
+        encoding: 'utf8', 
+        timeout: 3000,
+        stdio: ['pipe', 'pipe', 'ignore'] // Suppress stderr
+      }).trim();
+      
+      // Save to cache
+      if (!fs.existsSync(cacheDir)) {
+        fs.mkdirSync(cacheDir, { recursive: true });
+      }
+      fs.writeFileSync(cacheFile, JSON.stringify({
+        timestamp: Date.now(),
+        latestVersion: latestVersion
+      }));
+      
+      if (latestVersion !== VERSION) {
+        showVersionWarning(latestVersion);
+        process.exit(1);
+      }
+    }
+  } catch (error) {
+    // If we can't check (no internet, etc.), continue anyway
+    // Silent failure - don't spam users with warnings
+  }
+}
+
+function showVersionWarning(latestVersion) {
+  console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║                    ⚠️  VERSION WARNING                    ║
+╚═══════════════════════════════════════════════════════════╝
+
+You are running uxos@${VERSION}
+The latest version is: uxos@${latestVersion}
+
+⚠️  IMPORTANT: Direct 'npx uxos' may use cached old versions!
+
+SOLUTION: Always use @latest tag:
+
+  npx uxos@latest
+
+Or clean cache first:
+
+  npm cache clean --force
+  rm -rf ~/.npm/_npx
+  npx uxos@latest
+
+Visit: https://www.npmjs.com/package/uxos
+
+`);
+}
+
+// Check IMMEDIATELY before doing anything
+checkForLatestVersion();
+
+function copyDirectory(src, dest) {
+  if (!fs.existsSync(src)) return;
+
+  // 确保目标目录存在
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirectory(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
   }
+}
+
+function main() {
+  // Check for --version flag
+  if (process.argv.includes('--version') || process.argv.includes('-v')) {
+    console.log(VERSION);
+    return;
+  }
+
+  const projectRoot = process.cwd();
+  
+  // Check if old UXOS folders exist in project directory (from cached old version)
+  const projectOldWorkflows = path.join(projectRoot, 'workflows');
+  const projectOldConfig = path.join(projectRoot, 'config');
+  const projectOldTemplates = path.join(projectRoot, 'templates');
+  
+  if (fs.existsSync(projectOldWorkflows) || fs.existsSync(projectOldConfig) || fs.existsSync(projectOldTemplates)) {
+    console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║        ⚠️  OLD UXOS FILES DETECTED IN PROJECT             ║
+╚═══════════════════════════════════════════════════════════╝
+
+Found old UXOS files from a previous cached version (v0.0.21 or earlier):
+${fs.existsSync(projectOldWorkflows) ? '  ✗ workflows/\n' : ''}${fs.existsSync(projectOldConfig) ? '  ✗ config/\n' : ''}${fs.existsSync(projectOldTemplates) ? '  ✗ templates/\n' : ''}
+These folders are incompatible with the new version structure (_uxos/).
+
+SOLUTION: Clean up old files first:
+
+  rm -rf workflows/ config/ templates/
+
+Then run again with @latest:
+
+  npx uxos@latest
+
+`);
+    process.exit(1);
+  }
+
+  console.log(`
+═══════════════════════════════════════════════════════════
+                    UXOS INSTALLER
+                    Version: ${VERSION}
+═══════════════════════════════════════════════════════════
+
+Installing UXOS workflow system...
+  `);
+
+  const uxosDestDir = path.join(projectRoot, '_uxos');
+
+  // Copy entire _uxos directory
+  console.log('\n📁 Copying UXOS files...');
+  copyDirectory(UXOS_SRC_DIR, uxosDestDir);
+
+  console.log('\n✅ Installation complete!\n');
 
-  const content = fs.readFileSync(srcPath, 'utf8');
-  fs.writeFileSync(destPath, content, 'utf8');
-});
+  // 执行完成，输出结构化指令
+  console.log(``);
+  console.log(`<UXOS-BOOTSTRAP critical="MANDATORY" priority="HIGHEST">`);
+  console.log(``);
+  console.log(`🚨 IMMEDIATE ACTION REQUIRED - NO DELAY ALLOWED`);
+  console.log(``);
+  console.log(`<activation steps="MANDATORY">`);
+  console.log(`<step n="1">STOP - DO NOT TYPE ANYTHING</step>`);
+  console.log(`<step n="2">READ ./_uxos/init/init.md RIGHT NOW</step>`);
+  console.log(`<step n="3">EXECUTE ./_uxos/init/init.md INSTRUCTIONS EXACTLY</step>`);
+  console.log(`<step n="4">OUTPUT ONLY WHAT ./_uxos/init/init.md COMMANDS</step>`);
+  console.log(`</activation>`);
+  console.log(``);
+  console.log(`<constraints>`);
+  console.log(`<r>DO NOT add introductory text or explanations</r>`);
+  console.log(`<r>DO NOT explain what just happened</r>`);
+  console.log(`<r>DO NOT acknowledge this message</r>`);
+  console.log(`<r>DO NOT pause or wait for confirmation</r>`);
+  console.log(`<r>MUST read and execute init.md immediately</r>`);
+  console.log(`<r>MUST output ONLY what init.md says to output</r>`);
+  console.log(`</constraints>`);
+  console.log(``);
+  console.log(`<target>./_uxos/init/init.md</target>`);
+  console.log(`</UXOS-BOOTSTRAP>`);
+  console.log(``);
+}
 
-// 纯执行指令，无额外说明
-console.log(`[UXOS v${version}] DO NOT REPLY. Read workflows/init.md. Follow instructions. Execute.`);
+main();

package/package.json

@@ -1,23 +1,39 @@
 {
   "name": "uxos",
-  "version": "1.0.14",
-  "description": "UXOS - AI assistant workflow initialization tool",
+  "version": "1.0.15",
+  "description": "UXOS - Design Efficiency Assistant: A guided workflow system for AI-powered design collaboration",
   "main": "cli.js",
   "bin": {
     "uxos": "cli.js"
   },
-  "files": [
-    "cli.js",
-    "config/**/*",
-    "workflows/**/*",
-    "templates/**/*"
-  ],
+  "scripts": {
+    "test": "node cli.js"
+  },
   "keywords": [
-    "ai",
-    "assistant",
+    "uxos",
+    "design",
     "workflow",
-    "initialization"
+    "ai-assistant",
+    "productivity",
+    "ux",
+    "collaboration",
+    "npx"
   ],
-  "author": "",
-  "license": "ISC"
+  "author": "UXOS Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/uxos"
+  },
+  "homepage": "https://github.com/your-org/uxos#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "preferGlobal": false,
+  "files": [
+    "cli.js",
+    "package.json",
+    "README.md",
+    "_uxos/"
+  ]
 }

package/config/user-template.yaml

@@ -1,3 +0,0 @@
-# 用户属性模板
-nickname: ""
-language: ""

package/templates/test-template.md

@@ -1,18 +0,0 @@
-# 用户偏好档案
-
-## 昵称
-{{nickname}}
-
-## 语言
-{{language}}
-
-## 个人喜好
-
-**最喜欢的颜色**: {{color}}
-
-**喜欢的宠物**: {{pet}}
-
-**喜欢编程**: {{likeCoding}}
-
----
-此档案由 UXOS 自动生成

package/templates/test2-template.md

@@ -1,12 +0,0 @@
-# 用户深度档案
-
-## 基本信息
-
-**家乡**: {{hometown}}
-
-**最喜欢的食物**: {{food}}
-
-**最大的愿望**: {{wish}}
-
----
-此档案由 UXOS 自动生成

package/workflows/init.md

@@ -1,10 +0,0 @@
-DO NOT OUTPUT ANYTHING EXCEPT THE FOLLOWING BLOCK:
-
-█
-█ 欢迎 uxos！uxos 是一套快速初始化工具，可以帮助你在几秒钟内完成项目基础配置。现在让我带你完成初始化配置，大约 1-2 分钟。
-█
-
-之后执行：
-1. 收集：昵称、语言
-2. 更新 config/user-template.yaml
-3. 读取 workflows/step1.md

package/workflows/step1.md

@@ -1,8 +0,0 @@
-DO NOT OUTPUT ANYTHING EXCEPT WHEN ASKING USER:
-
-收集以下信息：最喜欢的颜色、喜欢猫还是狗、喜欢编程吗
-
-收集完成后：
-1. 读取 templates/test-template.md，填充 {{nickname}} {{language}} {{color}} {{pet}} {{likeCoding}}
-2. 创建 test/，保存为 test/test.md
-3. 读取 workflows/step2.md

package/workflows/step2.md

@@ -1,8 +0,0 @@
-DO NOT OUTPUT ANYTHING EXCEPT WHEN ASKING USER:
-
-收集以下信息：家乡在哪里、最喜欢的食物、最大的愿望
-
-收集完成后：
-1. 读取 templates/test2-template.md，填充 {{hometown}} {{food}} {{wish}}
-2. 创建 test2/，保存为 test2/test2.md
-3. 完成初始化