aodw-skill 0.7.19 → 0.7.23

package/.aodw-next/01-core/ai-project-overview-rules.md

@@ -193,7 +193,7 @@ Recommended: A（理由：...）
 
 ### 自动检测的内容
 ```markdown
-<!-- AUTO-DETECTED: 以下内容由 aodw-skill init-overview 自动检测 -->
+<!-- AUTO-DETECTED: 以下内容由 aodw-skill init 自动检测 -->
 - 前端：React 18.3.0
 - 后端：FastAPI 0.104.0
 <!-- END AUTO-DETECTED -->
@@ -249,18 +249,18 @@ Recommended: A（理由：...）
 2. **逐步完善**：不要一次性要求用户完善所有信息，可以分步骤进行
 3. **提供建议**：AI 应该基于代码分析提供建议，而不是只询问用户
 4. **格式规范**：确保生成的内容符合 `ai-overview.md` 的模板格式
-5. **及时更新**：当项目结构发生变化时，提醒用户运行 `aodw-skill init-overview` 更新
+5. **及时更新**：当项目结构发生重大变化时，可以运行 `aodw-skill init` 重新检测（会保留用户手动添加的内容）
 
 ---
 
 ## 8. 与 CLI 命令的关系
 
-- **CLI 命令**（`aodw-skill init-overview`）：负责自动检测和生成基础信息
+- **CLI 命令**（`aodw-skill init`）：负责自动检测和生成基础信息
 - **AI 规则**（本文件）：负责引导用户完善复杂信息（架构描述、模块职责等）
 
 两者配合使用：
-1. 用户运行 `aodw-skill init-overview` 生成基础信息
-2. 用户运行"初始化项目概览"命令，AI 引导完善详细信息
+1. 用户运行 `aodw-skill init` 自动生成基础项目信息
+2. 用户通过 AI 对话进一步完善详细信息（架构描述、模块职责等）
 
 
 

package/.aodw-next/05-tooling/ai-tools-init-rules.md

@@ -32,8 +32,8 @@
 
 **如果文件不存在或不完整**：
 - AI 必须停止当前流程。
-- AI 必须提示用户："**检测到项目概览尚未初始化。为了更准确地配置工具，请先执行项目概览初始化。**"
-- 建议运行命令："初始化项目概览"（`aodw-skill init-overview`）。
+- AI 必须提示用户："**检测到项目概览尚未初始化。为了更准确地配置工具，请先运行 `aodw-skill init` 重新初始化项目。**"
+- 说明：项目概览会在 `aodw-skill init` 时自动生成，无需额外命令。
 
 ### Step 2: 读取项目配置
 

package/.aodw-next/SKILL.md

@@ -3,9 +3,10 @@ name: aodw
 description: AODW (AI-Orchestrated Development Workflow) — 完整的 AI 协作开发工作流体系。当用户涉及以下任意场景时必须加载本 skill：新建 RT / 需求 / 功能 / 任务、立项、分支管理、worktree 创建与清理、Spec-Full / Spec-Lite 开发流程、代码提交与合并、RT 审查与完成、AODW 规范检查。关键触发词：RT、立项、新需求、开发任务、feature 分支、worktree、spec、intake、决策、实现、验收。本 skill 管理从立项到合并的完整开发生命周期。
 ---
 
-# AODW — AI 编排开发工作流 (v0.5.1)
+# AODW — AI 编排开发工作流
 
 用 **RT（Request Ticket）** 追踪每个开发任务，通过文档驱动、分支隔离、Gate 检查点和确认门控执行。
+版本以 npm 包 `aodw-skill` 为准。
 
 ## 加载顺序（渐进式披露，优先读 summary）
 

package/README.md

@@ -20,8 +20,9 @@ npx aodw-skill
 
 该命令会：
 1. 安装 AODW-Next 核心规范（`.aodw-next` 目录）
-2. 根据您的选择安装对应的 AI 工具适配器（Cursor / Claude / Antigravity）
-3. 初始化 `RT` 目录用于管理开发任务
+2. 自动检测项目信息（技术栈、架构、模块结构）
+3. 生成项目概览文档（`ai-overview.md` 和 `modules-index.yaml`）
+4. 根据您的选择安装对应的 AI 工具适配器（Cursor / Claude / Antigravity）
 
 ## 使用方法
 
@@ -96,14 +97,6 @@ your-project/
 
 ## 更多命令
 
-### 项目概览初始化
-
-```bash
-npx aodw-skill init-overview
-```
-
-自动检测项目的技术栈、架构和模块结构，生成项目概览文档。
-
 ### 工具初始化
 
 ```bash

package/bin/aodw.js

@@ -18,8 +18,14 @@ import {
 import { serve } from './commands/serve.js';
 import { createNewRT } from './commands/new.js';
 import { initTools } from './commands/init-tools.js';
-import { initOverview } from './commands/init-overview.js';
 import { saveProjectConfig, saveUserConfig, getProjectConfig, getUserConfig } from './utils/config.js';
+import {
+  detectTechStack,
+  analyzeDirectoryStructure,
+  detectModules,
+  generateOverviewFile,
+  generateModulesIndex
+} from './commands/init-overview.js';
 
 const require = createRequire(import.meta.url);
 const packageJson = require('../package.json');
@@ -293,35 +299,46 @@ async function runInit() {
     await fs.copy(SOURCE_CORE, targetCore);
   }
 
-  // 2. Initialize project files from templates (first time only)
-  if (!isUpdate) {
-    console.log(chalk.blue('正在初始化项目文件...'));
-    const projectDir = path.join(targetCore, '06-project');
-    const templateDir = path.join(SOURCE_CORE, 'templates');
-
-    // Check if project files need to be initialized
-    const aiOverviewExists = fs.existsSync(path.join(projectDir, 'ai-overview.md'));
-    const modulesIndexExists = fs.existsSync(path.join(projectDir, 'modules-index.yaml'));
-
-    if (!aiOverviewExists && !modulesIndexExists) {
-      // Copy templates from templates/ directory
-      if (fs.existsSync(templateDir)) {
-        const aiOverviewTemplate = path.join(templateDir, 'ai-overview.template.md');
-        const modulesIndexTemplate = path.join(templateDir, 'modules-index.template.yaml');
-
-        if (fs.existsSync(aiOverviewTemplate)) {
-          await fs.copy(aiOverviewTemplate, path.join(projectDir, 'ai-overview.md'));
-          console.log(chalk.yellow('  • 已生成 ai-overview.md（模板）'));
-        }
-        if (fs.existsSync(modulesIndexTemplate)) {
-          await fs.copy(modulesIndexTemplate, path.join(projectDir, 'modules-index.yaml'));
-          console.log(chalk.yellow('  • 已生成 modules-index.yaml（模板）'));
-        }
-      }
-      console.log(chalk.gray('  💡 运行 "aodw-skill init-overview" 来自动填充项目信息'));
-    } else {
-      console.log(chalk.gray('  • 项目文件已存在，跳过初始化'));
+  // 2. Initialize project files from templates (for both init and update)
+  console.log(chalk.blue('正在初始化项目文件...'));
+  const projectDir = path.join(targetCore, '06-project');
+  const aiOverviewPath = path.join(projectDir, 'ai-overview.md');
+  const modulesIndexPath = path.join(projectDir, 'modules-index.yaml');
+
+  // Regenerate files when they are missing OR still template placeholders
+  const aiOverviewExists = fs.existsSync(aiOverviewPath);
+  const modulesIndexExists = fs.existsSync(modulesIndexPath);
+  const aiOverviewIsTemplate = aiOverviewExists ? await isTemplateFile(aiOverviewPath) : true;
+  const modulesIndexIsTemplate = modulesIndexExists ? await isTemplateFile(modulesIndexPath) : true;
+  const shouldGenerateProjectFiles =
+    !aiOverviewExists || !modulesIndexExists || aiOverviewIsTemplate || modulesIndexIsTemplate;
+
+  if (shouldGenerateProjectFiles) {
+    // Auto-detect project info and generate files
+    console.log(chalk.blue('正在检测项目信息...'));
+    const techStack = await detectTechStack();
+    const directoryStructure = await analyzeDirectoryStructure();
+    const modules = await detectModules();
+
+    console.log(chalk.green('  • 技术栈检测完成'));
+    const techStackSummary = [];
+    if (techStack.frontend.length > 0) techStackSummary.push(`前端: ${techStack.frontend.join(', ')}`);
+    if (techStack.backend.length > 0) techStackSummary.push(`后端: ${techStack.backend.join(', ')}`);
+    if (techStack.database.length > 0) techStackSummary.push(`数据库: ${techStack.database.join(', ')}`);
+    if (techStackSummary.length > 0) {
+      console.log(chalk.gray(`    检测到: ${techStackSummary.join(' | ')}`));
     }
+
+    console.log(chalk.green('  • 目录结构分析完成'));
+    console.log(chalk.green('  • 模块识别完成'));
+
+    // Generate files with detected info
+    await generateOverviewFile({ techStack, directoryStructure, modules }, null, modules);
+    await generateModulesIndex(modules);
+    console.log(chalk.yellow('  • 已生成 ai-overview.md（自动检测）'));
+    console.log(chalk.yellow('  • 已生成 modules-index.yaml（自动检测）'));
+  } else {
+    console.log(chalk.gray('  • 项目文件已存在且为用户内容，跳过初始化'));
   }
 
   // 3. Install Adapters based on selected platforms
@@ -673,22 +690,6 @@ program
   .description('Initialize development tools (ESLint, Prettier, Ruff, Black, etc.)')
   .action(initTools);
 
-program
-  .command('init-overview')
-  .alias('overview')
-  .description('Initialize or update project overview (tech stack, architecture, modules)')
-  .option('--update', 'Update mode: only update changed parts (default)', true)
-  .option('--force', 'Force mode: full rescan and update', false)
-  .option('--scan-only', 'Scan only: detect changes without updating files', false)
-  .option('--no-interactive', 'Non-interactive mode: skip confirmations', false)
-  .action((options) => {
-    initOverview({
-      update: options.update !== false,
-      force: options.force || false,
-      scanOnly: options.scanOnly || false,
-      interactive: options.interactive !== false,
-    });
-  });
 
 // Main Entry Point
 if (!process.argv.slice(2).length) {

package/package.json

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