aodw-skill 0.7.13 → 0.7.17

package/bin/aodw.js

@@ -126,32 +126,30 @@ 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-Next 时填写/.test(content);
-      return hasEmptyTechStack || hasPlaceholder;
+      // Template has "待补充" placeholders
+      const hasPlaceholder = /（待补充）/.test(content);
+      return 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);
+      // Template has comment "# ⚠️ 项目特化文件..." and no actual modules
+      const hasOnlyComments = /^version: 1\s*\n\s*# ⚠️ 项目特化文件/.test(content) &&
+                              /^modules:\s*\n\s*# 示例格式/m.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;
@@ -236,8 +234,7 @@ async function runInit() {
 
   // --- Safeguard: Prevent running in AODW-Next Source Repo ---
   if (fs.existsSync(path.join(process.cwd(), 'cli/bin/aodw.js')) &&
-    (fs.existsSync(path.join(process.cwd(), 'templates/.aodw')) ||
-     fs.existsSync(path.join(process.cwd(), 'templates/.aodw-next')))) {
+    fs.existsSync(path.join(process.cwd(), 'templates/.aodw-next'))) {
     console.log(chalk.red('\n🛑  严重错误: 您正在 AODW-Next 源码仓库中运行 "aodw-skill init"！'));
     console.log(chalk.yellow('    这将导致开发模板覆盖源文件。'));
     console.log(chalk.yellow('    如需更新模板，请使用: cd cli && ./build-local.sh'));
@@ -323,7 +320,7 @@ async function runInit() {
   // 1. Install Core Rules (channel-aware core dir)
   const targetCore = path.join(process.cwd(), CORE_DIRNAME);
   const isUpdate = fs.existsSync(targetCore);
-  
+
   if (isUpdate) {
     console.log(chalk.blue('正在更新核心规则（保留用户生成的文件）...'));
     await copyCoreWithPreservation(SOURCE_CORE, targetCore, true);
@@ -332,6 +329,37 @@ 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('  • 项目文件已存在，跳过初始化'));
+    }
+  }
+
   // 3. Install Adapters based on selected platforms
   console.log(chalk.blue('正在安装适配器...'));
 

package/bin/commands/init-overview.js

@@ -5,9 +5,9 @@ import chalk from 'chalk';
 import yaml from 'js-yaml';
 import inquirer from 'inquirer';
 
-const CORE_DIR = process.env.AODW_CORE_DIR || '.aodw';
-const OVERVIEW_FILE = `${CORE_DIR}/ai-overview.md`;
-const MODULES_INDEX_FILE = `${CORE_DIR}/modules-index.yaml`;
+const CORE_DIR = process.env.AODW_CORE_DIR || '.aodw-next';
+const OVERVIEW_FILE = `${CORE_DIR}/06-project/ai-overview.md`;
+const MODULES_INDEX_FILE = `${CORE_DIR}/06-project/modules-index.yaml`;
 
 // 检测技术栈
 async function detectTechStack() {

package/bin/commands/init-tools.js

@@ -5,8 +5,8 @@ import chalk from 'chalk';
 import yaml from 'js-yaml';
 import inquirer from 'inquirer';
 
-const CORE_DIR = process.env.AODW_CORE_DIR || '.aodw';
-const PACKAGE_NAME = process.env.AODW_PACKAGE_NAME || 'aodw';
+const CORE_DIR = process.env.AODW_CORE_DIR || '.aodw-next';
+const PACKAGE_NAME = process.env.AODW_PACKAGE_NAME || 'aodw-skill';
 const TOOLS_STATUS_FILE = `${CORE_DIR}/tools-status.yaml`;
 
 // 获取模板目录路径（支持开发环境和发布环境）
@@ -19,14 +19,14 @@ function getTemplatesDir() {
   }
   // 如果不存在，尝试 CLI 包内的模板（发布后的模板）
   // 注意：CLI 包内的模板路径是相对于 CLI 源码目录的
-  // 路径：cli/.aodw/templates/tools-config（开发环境）
-  // 或：node_modules/<package>/.aodw/templates/tools-config（发布后）
-  const cliTemplates = path.join(__dirname, '../../.aodw/templates/tools-config');
+  // 路径：cli/.aodw-next/templates/tools-config（开发环境，与 publish.sh 同步目录一致）
+  // 或：node_modules/<package>/.aodw-next/templates/tools-config（发布后）
+  const cliTemplates = path.join(__dirname, '../../.aodw-next/templates/tools-config');
   if (fs.existsSync(cliTemplates)) {
     return cliTemplates;
   }
   // 尝试发布后的路径（node_modules）
-  const nodeModulesTemplates = path.join(cwd, `node_modules/${PACKAGE_NAME}/.aodw/templates/tools-config`);
+  const nodeModulesTemplates = path.join(cwd, `node_modules/${PACKAGE_NAME}/.aodw-next/templates/tools-config`);
   if (fs.existsSync(nodeModulesTemplates)) {
     return nodeModulesTemplates;
   }
@@ -328,7 +328,6 @@ async function installESLint() {
 async function installPrettier() {
   console.log(chalk.blue('📦 正在安装 Prettier...'));
   try {
-    // 先尝试正常安装
     execSync('npm install -D prettier', {
       stdio: 'inherit',
       cwd: process.cwd()
@@ -336,7 +335,6 @@ async function installPrettier() {
     console.log(chalk.green('✔ Prettier 安装完成\n'));
     return true;
   } catch (error) {
-    // 如果出现依赖冲突，尝试使用 --legacy-peer-deps
     if (error.message.includes('ERESOLVE') || error.message.includes('could not resolve')) {
       console.log(chalk.yellow('⚠️  检测到依赖冲突，尝试使用 --legacy-peer-deps 安装...'));
       try {
@@ -348,7 +346,7 @@ async function installPrettier() {
         return true;
       } catch (retryError) {
         console.error(chalk.red(`✗ Prettier 安装失败: ${retryError.message}\n`));
-        console.log(chalk.yellow('💡 提示：您可以手动运行 "npm install -D prettier --legacy-peer-deps" 或 "npm install -D prettier --force"\n'));
+        console.log(chalk.yellow('💡 提示：您可以手动运行 \"npm install -D prettier --legacy-peer-deps\" 或 \"npm install -D prettier --force\"\n'));
         return false;
       }
     } else {
@@ -372,33 +370,26 @@ function ensureRequirementsDevIn() {
 // 通过 uv + pip-tools 安装后端工具
 async function installBackendToolViaPipTools(toolName, versionConstraint) {
   const requirementsDevInPath = ensureRequirementsDevIn();
-  
-  // 检查依赖是否已存在
   const content = fs.readFileSync(requirementsDevInPath, 'utf8');
-  if (content.includes(toolName)) {
+  if (!content.includes(toolName)) {
+    console.log(chalk.blue(`📝 添加 ${toolName} 到 requirements-dev.in...`));
+    fs.appendFileSync(requirementsDevInPath, `${toolName}${versionConstraint}\n`);
+    console.log(chalk.green(`✔ ${toolName} 已添加到 requirements-dev.in\n`));
+  } else {
     console.log(chalk.yellow(`⚠️  ${toolName} 已在 requirements-dev.in 中\n`));
-    return true;
   }
-  
-  // 添加依赖到 requirements-dev.in
-  console.log(chalk.blue(`📝 添加 ${toolName} 到 requirements-dev.in...`));
-  fs.appendFileSync(requirementsDevInPath, `${toolName}${versionConstraint}\n`);
-  console.log(chalk.green(`✔ ${toolName} 已添加到 requirements-dev.in\n`));
-  
-  // 检查是否有 Makefile
+
   const makefilePath = path.join(process.cwd(), 'Makefile');
   const hasMakefile = fs.existsSync(makefilePath);
-  
-  if (hasMakefile) {
-    // 使用 Makefile
-    console.log(chalk.blue('📦 编译依赖（make compile-deps）...'));
-    try {
+
+  try {
+    if (hasMakefile) {
+      console.log(chalk.blue('📦 编译依赖（make compile-deps）...'));
       execSync('make compile-deps', {
         stdio: 'inherit',
         cwd: process.cwd()
       });
       console.log(chalk.green('✔ 依赖编译完成\n'));
-      
       console.log(chalk.blue('📦 同步环境（make sync）...'));
       execSync('make sync', {
         stdio: 'inherit',
@@ -406,33 +397,25 @@ async function installBackendToolViaPipTools(toolName, versionConstraint) {
       });
       console.log(chalk.green('✔ 环境同步完成\n'));
       return true;
-    } catch (error) {
-      console.error(chalk.red(`✗ 依赖安装失败: ${error.message}\n`));
-      console.log(chalk.yellow('💡 提示：请确保已安装 uv 和 pip-tools，并配置了 Makefile\n'));
-      return false;
     }
-  } else {
-    // 直接使用 uv pip compile 和 sync
+
     console.log(chalk.blue('📦 编译依赖（uv pip compile）...'));
-    try {
-      execSync('uv pip compile requirements-dev.in -o requirements-dev.txt', {
-        stdio: 'inherit',
-        cwd: process.cwd()
-      });
-      console.log(chalk.green('✔ 依赖编译完成\n'));
-      
-      console.log(chalk.blue('📦 同步环境（uv pip sync）...'));
-      execSync('uv pip sync requirements-dev.txt', {
-        stdio: 'inherit',
-        cwd: process.cwd()
-      });
-      console.log(chalk.green('✔ 环境同步完成\n'));
-      return true;
-    } catch (error) {
-      console.error(chalk.red(`✗ 依赖安装失败: ${error.message}\n`));
-      console.log(chalk.yellow('💡 提示：请确保已安装 uv 和 pip-tools\n'));
-      return false;
-    }
+    execSync('uv pip compile requirements-dev.in -o requirements-dev.txt', {
+      stdio: 'inherit',
+      cwd: process.cwd()
+    });
+    console.log(chalk.green('✔ 依赖编译完成\n'));
+    console.log(chalk.blue('📦 同步环境（uv pip sync）...'));
+    execSync('uv pip sync requirements-dev.txt', {
+      stdio: 'inherit',
+      cwd: process.cwd()
+    });
+    console.log(chalk.green('✔ 环境同步完成\n'));
+    return true;
+  } catch (error) {
+    console.error(chalk.red(`✗ 依赖安装失败: ${error.message}\n`));
+    console.log(chalk.yellow('💡 提示：请确保已安装 uv 和 pip-tools\n'));
+    return false;
   }
 }
 

package/bin/utils/config.js

@@ -3,7 +3,7 @@ import path from 'path';
 import yaml from 'js-yaml';
 
 function getCoreDir() {
-    return process.env.AODW_CORE_DIR || '.aodw';
+    return process.env.AODW_CORE_DIR || '.aodw-next';
 }
 
 function getProjectConfigFile() {

package/package.json

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

package/.aodw-next/.aodw-next/01-core/ai-interaction-rules.md

@@ -1,218 +0,0 @@
-0. UI 任务判断（前置检查）
-
-在执行任何任务之前，AI 必须首先进行 **任务类型判断**，识别是否为 UI 相关任务。
-
-### 0.1 UI 相关任务判定条件
-
-以下任意条件满足，即视为 **UI 相关任务**：
-- ✅ 涉及页面、界面、布局、组件、表单、Dashboard
-- ✅ 涉及用户操作流程、交互体验、可视化
-- ✅ 涉及前端 UI、样式、视觉呈现
-- ✅ 用户明确提到"界面 / UI / 好看 / 丑 / 设计"
-- ✅ 涉及 UI 改造、UI 新建、UI 优化
-
-### 0.2 判断时机
-
-- **RT 创建阶段**：在 `intake.md` 生成时进行判断
-- **任务执行阶段**：在执行任何代码修改前进行判断
-- **需求变更阶段**：当用户提出新需求时重新判断
-
-### 0.3 判断结果处理
-
-- **非 UI 相关任务**：按正常 AODW 流程执行
-- **UI 相关任务**：**必须进入 UI 专用流程**
-
-> **详细规则**：请参考 `.aodw/02-workflow/ui-workflow-rules.md`
-
----
-
-1. 问题类型（两大类）
-AI 所提出的所有问题必须明确属于：
-	1.	决策型（Decision Question）
-	•	必须提供选项
-	•	必须明确推荐项
-	•	必须给出推荐理由
-	•	必须支持 "custom: …"（≤ 5 个词）
-	2.	信息型（Information Question）
-	•	用于收集信息
-	•	必须提供示例答案
-	•	必须限制用户输入不超过 10 个词
-	•	必须保证问题可被快速回答
-
-⸻
-
-2. 问题的格式规范
-所有问题必须遵守格式（AI 必须严格采用）：
-Q1. <问题内容>
-
-A. <选项1>
-B. <选项2>
-C. <选项3>
-D. <选项4>
-
-Recommended: B（理由：……）
-
-请回复：A/B/C/D 或 custom:<你的答案>
-
-信息型问题格式：
-Q2. <要确认的信息>
-
-示例答案：
-- "订单服务"
-- "支付模块"
-- "只影响前端"
-
-请给我一个 ≤10个词的回答。
-
-3. 每轮最多提出的问题数量
-	•	🚫 单轮禁止提出超过 5 个问题
-	•	建议每轮 3 个 以内
-	•	超过 3 个必须提示用户原因（例如：需求范围大，需要更多澄清）
-
-⸻
-
-4. AI 问题的节奏（Flow Control）
-AI 必须遵守：
-	•	不得一次性问一大堆问题
-	•	必须逐步推进（Ask → Wait → Respond → Continue）
-	•	每轮问题结束后必须总结本轮收集到的信息
-	•	不能在用户未回答的情况下继续提出下一组问题
-
-⸻
-
-5. 用户中断与暂停机制
-AI 必须支持以下命令：
-	•	"先暂停 AODW"
-	•	"等一下，不继续流程"
-	•	"跳过这一步"
-
-AI 必须立即：
-	•	停止流程推进
-	•	切换到「普通代码助手模式」
-	•	并要求用户说"继续 AODW"才能回到流程
-
-⸻
-
-5.5. UI 流程主动触发机制
-
-用户可以在任何时候主动触发 UI 相关流程，AI 必须识别并执行以下命令：
-
-### 5.5.1 UI 流程触发命令识别
-
-AI 必须识别以下用户指令（支持多种表达方式）：
-
-| 触发类型 | 触发词示例 | 执行动作 |
-|---------|-----------|---------|
-| **UI 设计** | "请 AODW 规范，帮我就当前这个 RT 任务的界面进行设计"<br>"按 AODW 规范设计界面"<br>"设计 UI"<br>"生成界面原型" | 执行 UI 设计流程（规则文件读取 → UI 结构与设计说明 → 静态 HTML 原型生成 → 用户确认） |
-| **UI 审计/审查** | "请 AODW 规范，帮我就当前这个 RT 任务的界面进行审计"<br>"审计界面"<br>"审查 UI"<br>"检查界面" | 执行 UI Critic 审查流程（切换到 UI Critic 角色，按 `.aodw/03-standards/ui-kit/ui-kit.md` 第 4 节标准审查） |
-| **UI 挑毛病** | "请 AODW 规范，帮我就当前这个 RT 任务的界面挑毛病"<br>"挑 UI 毛病"<br>"找界面问题"<br>"UI 有什么问题" | 执行 UI Critic 审查流程（严格审查，指出所有问题） |
-
-### 5.5.2 触发条件检查
-
-当用户触发 UI 流程时，AI 必须：
-
-1. **检查当前 RT 上下文**
-   - 确认是否存在当前 RT（检查 `RT/RT-XXX/` 目录）
-   - 如果不存在，提示用户："未找到当前 RT，请先创建或打开一个 RT"
-   - 如果存在，读取 `intake.md` 或 `spec.md` / `spec-lite.md` 了解任务内容
-
-2. **检查是否为 UI 相关任务**
-   - 如果 `intake.md` 中标注了 `ui_related: true`，直接进入 UI 流程
-   - 如果未标注，但任务涉及 UI（根据第 0 节判断），提示用户："检测到当前 RT 可能涉及 UI，是否执行 UI 流程？"
-   - 如果完全不涉及 UI，提示用户："当前 RT 不涉及 UI，是否仍要执行 UI 审查？"
-
-3. **执行对应的 UI 流程**
-   - **UI 设计**：按照 `.aodw/02-workflow/ui-workflow-rules.md` 第 2 节执行
-   - **UI 审计/审查/挑毛病**：按照 `.aodw/02-workflow/ui-workflow-rules.md` 第 3 节执行
-
-### 5.5.3 执行响应模板
-
-当用户触发 UI 流程时，AI 应回复：
-
-```
-✅ **UI 流程已触发**
-- 当前 RT：[RT-XXX]
-- 触发类型：[设计 / 审计 / 挑毛病]
-- 执行动作：[具体要执行的内容]
-- 参考规范：[.aodw/03-standards/ui-kit/ui-kit.md]
-```
-
-### 5.5.4 执行优先级
-
-- **用户主动触发** > **自动流程触发**
-- 如果用户主动触发 UI 流程，即使当前不在 UI 相关阶段，也应立即执行
-- 执行完成后，询问用户是否继续原流程
-
-⸻
-
-6. 错误恢复机制
-如果用户回答不清晰或违背格式，AI 必须：
-	•	或再次提出简化问题
-	•	并提供新的建议选项
-
-⸻
-
-7. 透明度与确认机制
-
-AI 必须主动维护流程的透明度：
-- **复杂任务追踪**：当任务步骤超过 3 步时，必须创建 `task.md` 并实时更新。
-  - **任务追踪检查**：
-    - 在执行复杂任务时，AI 应在每个阶段结束后主动检查 task.md 是否需要更新
-    - 如果发现 task.md 已过时，必须立即更新并告知用户
-    - 在每次提交代码前，AI 必须检查 task.md 是否已更新到最新状态
-- **关键节点确认**：
-  - Plan 完成后，必须暂停并请求批准。
-  - 代码提交前，必须暂停并请求确认。
-
-⸻
-
-8. 门禁检查点与用户确认
-
-> **重要**：详细的门禁检查点定义见 `aodw-constitution.md` 第 4.5 节。
-
-### 8.1 确认词汇表
-
-AI 必须识别以下用户确认指令：
-
-| 确认类型     | 触发词                           | 范围                             |
-| ------------ | -------------------------------- | -------------------------------- |
-| **单步确认** | "继续"、"下一步"、"好"、"ok"     | 只批准当前 Gate，进入下一阶段    |
-| **批准执行** | "批准"、"执行"、"approved"、"go" | 批准 Plan，允许开始编码          |
-| **跳过确认** | "跳过"、"skip"                   | 跳过当前检查点（需二次确认风险） |
-| **暂停流程** | "暂停"、"pause"、"等等"、"停"    | 暂停 AODW 流程，切换到普通模式   |
-| **启动审计** | "审计"、"audit"                  | 启动对应阶段的审计               |
-
-### 8.2 确认边界
-
-**关键规则**：
-- ⚠️ 用户说"继续"只意味着"通过当前 Gate"，**不是"执行到底"**
-- ⚠️ AI 必须在下一个 Gate 再次等待确认
-- ⚠️ 默认模式下，每个 Gate 只能通过一个确认
-
-### 8.3 确认后响应模板
-
-当用户确认后，AI 应回复：
-
-```
-✅ **确认收到**
-- 当前操作：[刚才批准的内容]
-- 正在执行：[即将做的事情]
-- 下一检查点：[下一个 Gate 的位置]
-```
-
-⸻
-
-9. 分支验证前置
-
-AI 在执行任何代码修改操作（`write_to_file`、`replace_file_content`）前，必须：
-
-1. 运行 `git branch --show-current`
-2. 检查结果：
-   - ✅ 如果显示 `feature/RT-XXX-xxx`：继续执行
-   - ❌ 如果显示 `main` 或 `master`：**立即停止**
-3. 如果在 main/master 分支：
-   - 提示用户当前在主分支
-   - 询问是否创建 feature 分支
-   - 创建并切换到分支后才能继续
-
-**违规处理**：如果 AI 在 main/master 分支上修改了业务代码，必须立即回滚。