aodw-skill 0.7.7 → 0.7.8

package/bin/aodw.js

@@ -115,6 +115,95 @@ async function copyRecursive(sourceDir, targetDir, processorClass, renameFn = nu
   }
 }
 
+// Helper: Check if a file is a user-generated file (not a template)
+function isUserGeneratedFile(filePath, coreDir) {
+  const relativePath = path.relative(coreDir, filePath);
+  
+  // User-generated files that should be preserved
+  const userGeneratedFiles = [
+    '06-project/ai-overview.md',
+    '06-project/modules-index.yaml',
+    'tools-status.yaml'
+  ];
+  
+  return userGeneratedFiles.some(pattern => relativePath === pattern || relativePath.endsWith(pattern));
+}
+
+// Helper: Check if a file is still a template (has template markers)
+async function isTemplateFile(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return false;
+  }
+  
+  try {
+    const content = await fs.readFile(filePath, 'utf8');
+    
+    // Check for template markers in ai-overview.md
+    if (filePath.endsWith('ai-overview.md')) {
+      // Template has empty tech stack sections like "- 前端：\n- 后端："
+      const hasEmptyTechStack = /- 前端：\s*\n\s*- 后端：/.test(content);
+      // Template has placeholder text
+      const hasPlaceholder = /（由 AI 或人工在首次接入 AODW 时填写/.test(content);
+      return hasEmptyTechStack || hasPlaceholder;
+    }
+    
+    // Check for template markers in modules-index.yaml
+    if (filePath.endsWith('modules-index.yaml')) {
+      // Template has only example comments, no actual modules
+      const hasOnlyComments = /^version: 1\s*\n\s*# 模块索引/.test(content) && 
+                              !/^modules:\s*\n\s*- name:/.test(content);
+      return hasOnlyComments;
+    }
+    
+    // tools-status.yaml is always user-generated if it exists
+    if (filePath.endsWith('tools-status.yaml')) {
+      return false; // If it exists, it's user-generated
+    }
+    
+    return false;
+  } catch (e) {
+    return false;
+  }
+}
+
+// Helper: Smart copy that preserves user-generated files
+async function copyCoreWithPreservation(sourceDir, targetDir, isUpdate = false) {
+  const entries = await fs.readdir(sourceDir, { withFileTypes: true });
+  
+  for (const entry of entries) {
+    const srcPath = path.join(sourceDir, entry.name);
+    const destPath = path.join(targetDir, entry.name);
+    
+    if (entry.isDirectory()) {
+      await fs.ensureDir(destPath);
+      await copyCoreWithPreservation(srcPath, destPath, isUpdate);
+    } else {
+      // Check if this is a user-generated file
+      if (isUserGeneratedFile(destPath, targetDir)) {
+        if (isUpdate) {
+          // During update, check if file exists and is not a template
+          if (fs.existsSync(destPath)) {
+            const isTemplate = await isTemplateFile(destPath);
+            if (!isTemplate) {
+              // File exists and is user-generated, skip overwriting
+              console.log(chalk.gray(`    ⊖ 保留用户文件: ${path.relative(process.cwd(), destPath)}`));
+              continue;
+            } else {
+              // File exists but is still a template, can be overwritten
+              console.log(chalk.yellow(`    ↻ 更新模板文件: ${path.relative(process.cwd(), destPath)}`));
+            }
+          }
+        }
+        // During init, always copy (first time)
+      }
+      
+      // Copy the file
+      await fs.ensureDir(path.dirname(destPath));
+      await fs.copy(srcPath, destPath);
+    }
+  }
+}
+
 // Helper: Return to menu pause
 async function returnToMenu() {
   console.log(); // empty line
@@ -241,7 +330,15 @@ async function runInit() {
 
   // 1. Install Core Rules (channel-aware core dir)
   const targetCore = path.join(process.cwd(), CORE_DIRNAME);
-  await fs.copy(SOURCE_CORE, targetCore);
+  const isUpdate = fs.existsSync(targetCore);
+  
+  if (isUpdate) {
+    console.log(chalk.blue('正在更新核心规则（保留用户生成的文件）...'));
+    await copyCoreWithPreservation(SOURCE_CORE, targetCore, true);
+  } else {
+    console.log(chalk.blue('正在安装核心规则...'));
+    await fs.copy(SOURCE_CORE, targetCore);
+  }
 
   // 3. Install Adapters based on selected platforms
   console.log(chalk.blue('正在安装适配器...'));
@@ -430,6 +527,130 @@ async function showHelp() {
   }
 }
 
+async function generateOverviewPrompt() {
+  console.clear();
+  console.log(chalk.bold.cyan('\n=== 项目概览初始化提示词 ===\n'));
+  console.log(chalk.yellow('📋 请将以下提示词复制给您的 AI 助手（Cursor/Claude/Gemini 等）：\n'));
+  
+  const overviewFile = path.join(process.cwd(), CORE_DIRNAME, '06-project/ai-overview.md');
+  const modulesIndexFile = path.join(process.cwd(), CORE_DIRNAME, '06-project/modules-index.yaml');
+  const hasOverview = fs.existsSync(overviewFile);
+  const hasModulesIndex = fs.existsSync(modulesIndexFile);
+  
+  let overviewPrompt = `请帮我${hasOverview || hasModulesIndex ? '更新' : '初始化'}项目的 AODW 项目概览文档。
+
+**任务说明**：
+根据当前项目的代码结构、技术栈和架构，生成或完善以下文档：
+1. \`${CORE_DIRNAME}/06-project/ai-overview.md\` - 项目概览文档
+2. \`${CORE_DIRNAME}/06-project/modules-index.yaml\` - 模块索引文件
+
+**文件位置**：
+- 项目概览文档：\`${overviewFile}\`
+- 模块索引文件：\`${modulesIndexFile}\`
+
+**参考规则**：
+- 请参考 \`${CORE_DIRNAME}/01-core/ai-project-overview-rules.md\` 中的详细规则
+- 需要检测项目的技术栈（前端、后端、数据库、消息系统等）
+- 需要识别项目的模块结构
+- 需要分析项目的架构模式
+
+**执行步骤**：
+1. 先读取 \`${CORE_DIRNAME}/01-core/ai-project-overview-rules.md\` 了解规则
+2. ${hasOverview ? `读取现有的 \`${CORE_DIRNAME}/06-project/ai-overview.md\` 了解当前项目信息` : '分析项目结构，检测技术栈'}
+3. ${hasModulesIndex ? `读取现有的 \`${CORE_DIRNAME}/06-project/modules-index.yaml\` 了解当前模块结构` : '识别项目模块'}
+4. 生成或更新 \`ai-overview.md\` 和 \`modules-index.yaml\`
+
+**重要提示**：
+- ✅ **这些文件在更新 AODW 时会被保护，不会被覆盖**
+- ${hasOverview ? '如果项目已经有部分概览文档，请基于现有内容进行完善' : '如果项目已经有部分概览文档，请基于现有内容进行完善'}
+- 确保技术栈信息准确
+- 确保模块索引完整
+- **此命令可以重复执行**，每次执行会基于现有内容进行更新和完善
+
+请开始执行。`;
+
+  console.log(chalk.white(overviewPrompt));
+  console.log(chalk.gray('\n' + '='.repeat(60)));
+  console.log(chalk.green('\n✅ 提示词已生成，请复制上面的内容给您的 AI 助手。'));
+  if (hasOverview || hasModulesIndex) {
+    console.log(chalk.blue('\n📝 检测到已有文件，将基于现有内容进行更新。'));
+  }
+  console.log(chalk.yellow('\n💡 提示：完成项目概览初始化后，再执行"工具初始化"可以更准确地识别技术栈。\n'));
+}
+
+async function generateToolsPrompt() {
+  console.clear();
+  console.log(chalk.bold.cyan('\n=== 工具初始化提示词 ===\n'));
+  console.log(chalk.yellow('📋 请将以下提示词复制给您的 AI 助手（Cursor/Claude/Gemini 等）：\n'));
+  
+  // 检查是否已有项目概览和工具状态
+  const overviewFile = path.join(process.cwd(), CORE_DIRNAME, '06-project/ai-overview.md');
+  const toolsStatusFile = path.join(process.cwd(), CORE_DIRNAME, 'tools-status.yaml');
+  const hasOverview = fs.existsSync(overviewFile);
+  const hasToolsStatus = fs.existsSync(toolsStatusFile);
+  
+  let toolsPrompt = `请帮我${hasToolsStatus ? '更新' : '初始化'}项目的开发工具配置。
+
+**任务说明**：
+根据当前项目的技术栈，初始化相应的代码质量工具（ESLint、Prettier、Ruff、Black、rustfmt、clippy 等）。
+
+**文件位置**：
+- 工具状态文件：\`${toolsStatusFile}\`
+- 工具配置文件：根据技术栈生成在项目根目录（如 \`.eslintrc.json\`, \`ruff.toml\`, \`rustfmt.toml\` 等）
+
+**参考规则**：
+- 请参考 \`${CORE_DIRNAME}/05-tooling/ai-tools-init-rules.md\` 中的详细规则
+- 需要根据项目的技术栈选择合适的工具
+- 需要生成相应的配置文件
+- 需要设置 pre-commit hooks（如适用）
+
+**执行步骤**：
+1. 先读取 \`${CORE_DIRNAME}/05-tooling/ai-tools-init-rules.md\` 了解规则
+2. ${hasOverview ? `读取 \`${CORE_DIRNAME}/06-project/ai-overview.md\` 了解技术栈` : '检测项目的技术栈（如果项目概览文档不存在，请先分析项目结构识别技术栈）'}
+3. ${hasToolsStatus ? `读取现有的 \`${CORE_DIRNAME}/tools-status.yaml\` 了解当前工具状态` : '检查当前工具安装状态'}
+4. 根据技术栈选择需要初始化的工具：
+   - 前端（React/Vue）：ESLint、Prettier、PostCSS
+   - 后端（Python）：Ruff、Black、pre-commit
+   - 后端（Java）：Maven、Checkstyle、Spotless、pre-commit
+   - 后端（Rust）：rustfmt、clippy、pre-commit
+5. 生成工具配置文件（参考 \`${CORE_DIRNAME}/templates/tools-config/\` 中的模板）
+6. 更新 \`${CORE_DIRNAME}/tools-status.yaml\` 记录工具状态
+
+**重要提示**：
+`;
+
+  if (!hasOverview) {
+    toolsPrompt += `- ⚠️ **建议先执行"项目概览初始化"**，以便更准确地识别技术栈
+- 如果项目概览文档不存在，请先分析项目结构识别技术栈
+`;
+  } else {
+    toolsPrompt += `- ✅ 项目概览文档已存在，请先读取 \`${CORE_DIRNAME}/06-project/ai-overview.md\` 了解技术栈
+`;
+  }
+  
+  toolsPrompt += `- ✅ **工具状态文件在更新 AODW 时会被保护，不会被覆盖**
+- ✅ **工具配置文件在项目根目录，不会被 AODW 更新影响**
+- 确保生成的配置文件符合项目规范
+- 如果工具已存在，请检查配置是否需要更新
+- **此命令可以重复执行**，每次执行会检查并更新工具配置
+
+请开始执行。`;
+
+  console.log(chalk.white(toolsPrompt));
+  console.log(chalk.gray('\n' + '='.repeat(60)));
+  console.log(chalk.green('\n✅ 提示词已生成，请复制上面的内容给您的 AI 助手。'));
+  
+  if (!hasOverview) {
+    console.log(chalk.yellow('\n⚠️  检测到项目概览文档不存在，建议先执行"项目概览初始化"。\n'));
+  } else {
+    console.log(chalk.green('\n✅ 项目概览文档已存在，可以基于它来初始化工具。\n'));
+  }
+  
+  if (hasToolsStatus) {
+    console.log(chalk.blue('📝 检测到已有工具状态文件，将基于现有状态进行更新。\n'));
+  }
+}
+
 async function configureMode(pause = true, forceConnect = false) {
   const { mode } = await inquirer.prompt([{
     type: 'list',
@@ -515,8 +736,8 @@ async function showMainMenu() {
         { name: '2. 配置全局开发模式 (单机/联网)', value: 'config' },
 
         new inquirer.Separator('--- 工具箱 ---'),
-        { name: '3. 工具初始化 (ESLint/Ruff/Stack)', value: 'init-tools' },
-        { name: '4. 项目概览初始化 (Architecture)', value: 'init-overview' },
+        { name: '3. 项目概览初始化 (Architecture) - 生成提示词', value: 'init-overview-prompt' },
+        { name: '4. 工具初始化 (ESLint/Ruff/Stack) - 生成提示词', value: 'init-tools-prompt' },
 
         new inquirer.Separator('--- 帮助与维护 ---'),
         { name: '5. 查看帮助 & 部署指南', value: 'help' },
@@ -541,12 +762,12 @@ async function showMainMenu() {
           await configureMode();
           await returnToMenu();
           break;
-        case 'init-tools':
-          await initTools();
+        case 'init-overview-prompt':
+          await generateOverviewPrompt();
           await returnToMenu();
           break;
-        case 'init-overview':
-          await initOverview({ interactive: true });
+        case 'init-tools-prompt':
+          await generateToolsPrompt();
           await returnToMenu();
           break;
         case 'help':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aodw-skill",
-  "version": "0.7.7",
+  "version": "0.7.8",
   "description": "Next-channel CLI tool to scaffold AODW in your project",
   "main": "bin/aodw.js",
   "files": [