adspecs 0.1.20 → 0.1.21

package/skills/project-init/SKILL.md

@@ -302,7 +302,7 @@ questions: [
      }
      子目录决策 = {
        conventions_decision: "update" | "skip",   # docs 为 skip 且 40-project_conventions/ 有文件时
-       templates_decision:   "update" | "skip",   # .adspecs 为 skip 且 templates/ 有文件时
+       templates_decision:   { "<文件名>": "replace" | "keep", ... },  # .adspecs 为 skip 且 templates/ 有文件时，逐文件确认
      }
      ```
 
@@ -317,7 +317,7 @@ questions: [
      }
      子目录决策 = {
        conventions_decision: "update" | "skip",   # docs 为 skip 且 40-project_conventions/ 有文件时
-       templates_decision:   "update" | "skip",   # .adspecs 为 skip 且 templates/ 有文件时
+       templates_decision:   { "<文件名>": "replace" | "keep", ... },  # .adspecs 为 skip 且 templates/ 有文件时，逐文件确认
      }
      ```
 
@@ -334,7 +334,7 @@ questions: [
      }
      子目录决策 = {
        conventions_decision: "update" | "skip",   # docs 为 skip 且 40-project_conventions/ 有文件时
-       templates_decision:   "update" | "skip",   # .adspecs 为 skip 且 templates/ 有文件时
+       templates_decision:   { "<文件名>": "replace" | "keep", ... },  # .adspecs 为 skip 且 templates/ 有文件时，逐文件确认
      }
      ```
 
@@ -351,7 +351,7 @@ questions: [
      }
      子目录决策 = {
        conventions_decision: "update" | "skip",   # docs 为 skip 且 40-project_conventions/ 有文件时
-       templates_decision:   "update" | "skip",   # .adspecs 为 skip 且 templates/ 有文件时
+       templates_decision:   { "<文件名>": "replace" | "keep", ... },  # .adspecs 为 skip 且 templates/ 有文件时，逐文件确认
      }
      固定技术栈：
        FRONT_DEMO_SOURCE = "antd-front-demo"      # Ant Design React（无需询问用户）
@@ -421,27 +421,79 @@ questions: [
      - 记录子决策：`conventions_decision` = `"update"` | `"skip"`
      - 如果 `40-project_conventions/` 不存在或仅包含空目录 → 跳过此检查，`conventions_decision` = `"skip"`
 
-   - **子目录更新检查（.adspecs/templates/）**：当 `.adspecs/` 已存在且 `.adspecs` 决策为 `skip`，且 `.adspecs/templates/` 下已包含实际文件时，需额外询问用户是否更新模板目录：
-     - 使用 **AskUserQuestion** 工具询问：
+   - **子目录更新检查（.adspecs/templates/）**：当 `.adspecs/` 已存在且 `.adspecs` 决策为 `skip`，且 `.adspecs/templates/` 下已包含实际文件时，需**逐文件**询问用户是否替换模板文件（因用户可能在首次初始化后根据项目实际情况修改了模板内容）：
+
+     **步骤 1：扫描目标目录已有模板文件**
+     - 列出 `$TARGET/.adspecs/templates/` 下所有 `.md` 文件
+     - 同时列出 `$PLUGIN_DIR/.adspecs/templates/` 下所有 `.md` 文件（插件根目录的最新模板）
+     - 计算两组文件集合：
+       - `existing_files`：目标目录中已有的模板文件名列表
+       - `new_files`：插件根目录中存在但目标目录中不存在的模板文件（需要新增）
+       - `common_files`：两边都存在的模板文件（需要逐一确认是否替换）
+
+     **步骤 2：先处理新增文件（无需确认）**
+     - 如果 `new_files` 非空 → 直接复制到目标目录，输出：`📦 模板新增：已添加 {N} 个新模板文件：{文件列表}`
+     - 如果 `new_files` 为空 → 不输出
+
+     **步骤 3：逐文件确认（批量询问）**
+     - 对 `common_files` 中的每个文件，使用 **AskUserQuestion** 工具批量询问（每次最多 4 个文件，因为 AskUserQuestion 最多支持 4 个问题，需要分多轮询问）：
 
        ```
+       # 第 1 轮（文件 1~4）
        questions: [
          {
-           question: ".adspecs/templates/ 目录已存在且包含文件，是否使用最新模板文件更新？",
-           header: "templates/",
+           question: "模板文件 {文件名1} 已存在，是否使用最新版本替换？",
+           header: "{文件名1}",
+           options: [
+             { label: "保留现有", description: "保留当前项目中的版本，不做修改（用户可能已按项目实际情况调整过）" },
+             { label: "替换为最新", description: "使用插件根目录中的最新版本覆盖现有文件" }
+           ],
+           multiSelect: false
+         },
+         {
+           question: "模板文件 {文件名2} 已存在，是否使用最新版本替换？",
+           header: "{文件名2}",
            options: [
-             { label: "更新", description: "使用 references 中最新的模板文件覆盖现有内容（已有模板将被替换）" },
-             { label: "跳过", description: "保留现有 .adspecs/templates/ 内容，不做任何修改" }
+             { label: "保留现有", description: "保留当前项目中的版本，不做修改" },
+             { label: "替换为最新", description: "使用插件根目录中的最新版本覆盖现有文件" }
+           ],
+           multiSelect: false
+         },
+         ...  # 最多 4 个问题一轮
+       ]
+       ```
+
+     - 如果 `common_files` 数量超过 4 个，需要分多轮调用 AskUserQuestion，每轮最多 4 个文件
+     - 每轮询问结束后，将用户选择记录到 `templates_decision` 映射中
+
+     **步骤 4：提供批量快捷选项（可选）**
+     - 在首轮询问前，可先通过 AskUserQuestion 提供一个全局快捷选项：
+
+       ```
+       questions: [
+         {
+           question: ".adspecs/templates/ 目录已存在且包含 {N} 个模板文件，是否需要逐文件确认？（选择"否"将统一保留现有文件）",
+           header: "批量确认",
+           options: [
+             { label: "逐文件确认", description: "对每个已修改的模板文件逐一询问是否替换（推荐，用户可能已按项目情况调整过模板）" },
+             { label: "全部保留现有", description: "保留所有现有模板文件不做修改（跳过逐文件确认）" },
+             { label: "全部替换为最新", description: "使用插件根目录中的最新版本覆盖所有模板文件" }
            ],
            multiSelect: false
          }
        ]
        ```
 
-     - 记录子决策：`templates_decision` = `"update"` | `"skip"`
-     - 如果 `.adspecs/templates/` 不存在或仅包含空目录 → 跳过此检查，`templates_decision` = `"skip"`
+     - 如果用户选择"逐文件确认" → 执行步骤 3 的逐文件询问
+     - 如果用户选择"全部保留现有" → `templates_decision` 中所有文件标记为 `"keep"`
+     - 如果用户选择"全部替换为最新" → `templates_decision` 中所有文件标记为 `"replace"`
+
+     **步骤 5：记录子决策**
+     - 记录子决策映射：`templates_decision` = `{ "<文件名>": "replace" | "keep", ... }`
+     - 其中 `"replace"` 表示使用插件根目录最新版本覆盖，`"keep"` 表示保留目标目录现有版本
+     - 如果 `.adspecs/templates/` 不存在或仅包含空目录 → 跳过此检查，`templates_decision` = `{}`（空映射）
 
-7. **输出初始化计划摘要**，包含项目信息（项目名称、项目短名称、公司名称、文件密级、项目目录）、初始化模式、前端技术栈（如适用）、每个区域的操作（创建 / 重新创建 / 跳过）、子目录更新决策（40-project_conventions/ 和 templates/ 的更新/跳过）、feature.json/project.json 属性补全计划以及补充检查结果，等待用户确认后继续执行
+7. **输出初始化计划摘要**，包含项目信息（项目名称、项目短名称、公司名称、文件密级、项目目录）、初始化模式、前端技术栈（如适用）、每个区域的操作（创建 / 重新创建 / 跳过）、子目录更新决策（40-project_conventions/ 的更新/跳过、templates/ 的逐文件确认结果：哪些文件将被替换、哪些将被保留）、feature.json/project.json 属性补全计划以及补充检查结果，等待用户确认后继续执行
 
 ## 工作流程
 
@@ -862,8 +914,7 @@ find "$TARGET/front-demo" -type f | wc -l
 根据区域决策执行：
 
 - `.adspecs` 决策为 `skip` → 输出 `⏭ 阶段 6 跳过：.adspecs/ 已存在，保留现有内容`，但需检查以下子决策和属性补全：
-  - 如果 `templates_decision` = `"update"` → 执行 `cp -r "$PLUGIN_DIR/.adspecs/templates/"* "$TARGET/.adspecs/templates/"`，从插件根目录覆盖更新 `templates/` 下的模板文件，输出：`🔄 阶段 6 补充更新：.adspecs/templates/ 已从插件根目录更新`
-  - 如果 `templates_decision` = `"skip"` → 不做额外处理
+  - 根据 `templates_decision` 逐文件映射执行模板更新（见下方"模板逐文件更新执行逻辑"）
   - 执行 **feature.json 与 project.json 属性补全检查**（见下方）
   - 处理完子决策和属性补全后进入阶段 7
 - `.adspecs` 决策为 `recreate` → 先备份已存在的 `feature.json` 和 `project.json`，然后执行 `rm -rf "$TARGET/.adspecs"`，按下方步骤完整重建，最后恢复备份文件并执行属性补全检查（见下方"feature.json 与 project.json 属性补全"）
@@ -967,13 +1018,33 @@ find "$TARGET/.adspecs" -type f | wc -l
 - 无缺失时：`✅ 阶段 6：feature.json 属性完整，无需补全`
 - 文件不存在时：`✅ 阶段 6：feature.json 已从 references 创建`
 
+#### 模板逐文件更新执行逻辑
+
+当 `.adspecs` 决策为 `skip` 且 `templates_decision` 映射不为空时，按以下方式执行模板文件的逐文件更新：
+
+1. **新增文件**：对于存在于 `$PLUGIN_DIR/.adspecs/templates/` 但不存在于 `$TARGET/.adspecs/templates/` 的文件，直接复制到目标目录
+2. **已有文件逐一处理**：对于 `templates_decision` 映射中的每个文件：
+   - `"replace"` → 执行 `cp "$PLUGIN_DIR/.adspecs/templates/{文件名}" "$TARGET/.adspecs/templates/{文件名}"`，用最新版本覆盖
+   - `"keep"` → 保留目标目录中的现有文件，不做任何操作
+3. **仅复制已标记为 replace 的文件**，不要使用通配符一次性覆盖整个 templates 目录
+
+```bash
+# 示例：逐文件复制被标记为 replace 的模板
+for file in "${REPLACE_FILES[@]}"; do
+  cp "$PLUGIN_DIR/.adspecs/templates/$file" "$TARGET/.adspecs/templates/$file"
+done
+
+# 统计实际更新的模板文件数量
+echo "更新了 ${#REPLACE_FILES[@]} 个模板文件，保留了 ${#KEEP_FILES[@]} 个模板文件"
+```
+
 完成后输出：
 
 - 新建时：`✅ 阶段 6 完成：.adspecs/ 配置与脚本目录已复制（{N} 个文件）`
 - 重建时：`🔄 阶段 6 完成：.adspecs/ 已重新复制（{N} 个文件）`
 - 重建且有文件恢复时：`🔄 阶段 6 完成：.adspecs/ 已重新复制 + 🔧 feature.json/project.json 已恢复并补全属性`
 - 跳过时：`⏭ 阶段 6 跳过：.adspecs/ 已存在，保留现有内容`
-- 跳过但更新模板时：`⏭ 阶段 6 跳过：.adspecs/ 已存在 + 🔄 templates/ 已从插件根目录更新`
+- 跳过但部分更新模板时：`⏭ 阶段 6 跳过：.adspecs/ 已存在 + 🔄 templates/ 已部分更新（{N} 个文件替换，{M} 个文件保留）`
 - 跳过但属性补全时：`⏭ 阶段 6 跳过：.adspecs/ 已存在 + 🔧 feature.json/project.json 已补全缺失属性`
 
 ---
@@ -1101,7 +1172,7 @@ mkdir -p "$TARGET/.adspecs"
 | 区域                      | 状态                              | 说明                                                                       |
 | ------------------------- | --------------------------------- | -------------------------------------------------------------------------- |
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
-| └ templates/              | 🔄 已更新 / ⏭ 已跳过             | .adspecs/ 跳过时，模板子目录的更新决策                                     |
+| └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
 | docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录，40 仅创建空目录                                             |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
@@ -1114,7 +1185,7 @@ mkdir -p "$TARGET/.adspecs"
 | 区域                      | 状态                              | 说明                                                                       |
 | ------------------------- | --------------------------------- | -------------------------------------------------------------------------- |
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
-| └ templates/              | 🔄 已更新 / ⏭ 已跳过             | .adspecs/ 跳过时，模板子目录的更新决策                                     |
+| └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
 | docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制                                      |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
@@ -1128,7 +1199,7 @@ mkdir -p "$TARGET/.adspecs"
 | 区域                      | 状态                              | 说明                                                                       |
 | ------------------------- | --------------------------------- | -------------------------------------------------------------------------- |
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
-| └ templates/              | 🔄 已更新 / ⏭ 已跳过             | .adspecs/ 跳过时，模板子目录的更新决策                                     |
+| └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
 | docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制                                      |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
@@ -1144,7 +1215,7 @@ mkdir -p "$TARGET/.adspecs"
 | 区域                      | 状态                              | 说明                                                                       |
 | ------------------------- | --------------------------------- | -------------------------------------------------------------------------- |
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
-| └ templates/              | 🔄 已更新 / ⏭ 已跳过             | .adspecs/ 跳过时，模板子目录的更新决策                                     |
+| └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
 | docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 按 Python+React 技术栈复制前后端规范                    |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
@@ -1159,7 +1230,7 @@ mkdir -p "$TARGET/.adspecs"
 
 - ✅ 已创建：目录原本不存在，新建完成
 - 🔄 已重建：目录原本存在，按用户选择删除后重新创建
-- 🔄 已更新：父目录跳过，但子目录按用户选择使用 references 最新文件覆盖更新
+- 🔄 已更新：父目录跳过，但子目录按用户选择使用 references 最新文件覆盖更新（templates/ 支持逐文件确认，部分文件可替换、部分保留）
 - 🔧 已补全：已有文件属性与 references 对比后，补充缺失属性（已有属性不覆盖）
 - ⏭ 已跳过：目录原本存在，按用户选择保留未动
 
@@ -1278,7 +1349,7 @@ mkdir -p "$TARGET/.adspecs"
 - [ ] service/ 目录已创建/重建/跳过（仅完整/轻量模式）
 - [ ] front-demo/ 已从 references 按技术栈选择复制/重建/跳过（经典/完整/轻量模式，排除 node_modules、.git、.vite）
 - [ ] .adspecs/ 配置与脚本目录已从插件根目录完整复制/重建/跳过
-- [ ] .adspecs/templates/ 子目录更新检查已完成（.adspecs/ 跳过且模板目录已包含文件时，已通过 AskUserQuestion 获取更新/跳过决策并按决策执行）
+- [ ] .adspecs/templates/ 子目录逐文件更新检查已完成（.adspecs/ 跳过且模板目录已包含文件时，已通过 AskUserQuestion 逐文件确认替换/保留决策并按决策执行）
 - [ ] feature.json 属性补全检查已完成（recreate/skip 时，已对比 references 初始版本并补全缺失属性，已有属性不覆盖）
 - [ ] project.json 属性补全检查已完成（recreate/skip 时，已对比 references 初始版本并补全缺失属性）
 - [ ] .adspecs/project.json 项目元数据文件已生成或更新

package/src/commands/init.js

@@ -51,7 +51,7 @@ module.exports = async function init(options) {
   const decisions = await collectDecisions(areaStates, options);
 
   // === Step 4: 收集子目录决策 ===
-  const subDecisions = await collectSubDecisions(decisions, targetDir, options);
+  const subDecisions = await collectSubDecisions(decisions, targetDir, pluginDir, options);
 
   // === Step 5: 模式升级检测 ===
   const modeUpgrade = detectModeUpgrade(decisions, info.mode, targetDir);

package/src/lib/dir-utils.js

@@ -125,9 +125,37 @@ function listSubdirs(dirPath) {
   return entries.filter((e) => e.isDirectory()).map((e) => e.name);
 }
 
+/**
+ * 列出目录下的所有文件名（不递归）
+ *
+ * @param {string} dirPath - 目录绝对路径
+ * @returns {string[]} 文件名列表
+ */
+function listFiles(dirPath) {
+  if (!fs.existsSync(dirPath)) return [];
+
+  let stat;
+  try {
+    stat = fs.statSync(dirPath);
+  } catch {
+    return [];
+  }
+  if (!stat.isDirectory()) return [];
+
+  let entries;
+  try {
+    entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+
+  return entries.filter((e) => e.isFile()).map((e) => e.name);
+}
+
 module.exports = {
   hasAnyFile,
   isEmptyDirectoryTree,
   countFiles,
   listSubdirs,
+  listFiles,
 };

package/src/lib/prompts.js

@@ -3,7 +3,7 @@
 const fs = require('fs');
 const path = require('path');
 const { input, select, confirm } = require('@inquirer/prompts');
-const { hasAnyFile, isEmptyDirectoryTree } = require('./dir-utils');
+const { hasAnyFile, isEmptyDirectoryTree, listFiles } = require('./dir-utils');
 const { areaDisplayName } = require('./area-scanner');
 
 /**
@@ -220,8 +220,8 @@ async function askAreaDecision(areaName) {
  * @param {object} options - CLI 选项
  * @returns {Promise<object>} 子决策 { conventions, templates }
  */
-async function collectSubDecisions(decisions, targetDir, options) {
-  const sub = { conventions: 'skip', templates: 'skip' };
+async function collectSubDecisions(decisions, targetDir, pluginDir, options) {
+  const sub = { conventions: 'skip', templates: {} };
   const nonInteractive = options.nonInteractive || false;
   const force = options.force || false;
 
@@ -239,11 +239,12 @@ async function collectSubDecisions(decisions, targetDir, options) {
     }
   }
 
-  // templates_decision：.adspecs/ skip 且 templates/ 有文件
+  // templates_decision：.adspecs/ skip 且 templates/ 有文件 → 逐文件确认
   if (decisions.adspecs === 'skip') {
     const tmplDir = path.join(targetDir, '.adspecs/templates');
+    const pluginTmplDir = path.join(pluginDir, '.adspecs/templates');
     if (fs.existsSync(tmplDir) && hasAnyFile(tmplDir)) {
-      sub.templates = await askSubDecision('.adspecs/templates');
+      sub.templates = await collectTemplatesDecision(tmplDir, pluginTmplDir);
     }
   }
 
@@ -266,6 +267,85 @@ async function askSubDecision(subDirName) {
   });
 }
 
+/**
+ * 逐文件确认模板文件是否替换
+ *
+ * 扫描目标目录和插件根目录的模板文件，自动识别新增文件（直接复制），
+ * 对共有文件提供批量快捷选项 + 逐文件确认。
+ *
+ * @param {string} targetTmplDir - 目标项目 templates 目录
+ * @param {string} pluginTmplDir - 插件根目录 templates 目录
+ * @returns {Promise<Object<string, 'replace'|'keep'>>} 逐文件决策映射
+ */
+async function collectTemplatesDecision(targetTmplDir, pluginTmplDir) {
+  const targetFiles = listFiles(targetTmplDir).filter((f) => f.endsWith('.md'));
+  const pluginFiles = listFiles(pluginTmplDir).filter((f) => f.endsWith('.md'));
+
+  const targetSet = new Set(targetFiles);
+  const pluginSet = new Set(pluginFiles);
+
+  // 新增文件（插件有，目标没有）→ 直接复制，无需确认
+  const newFiles = pluginFiles.filter((f) => !targetSet.has(f));
+  // 共有文件 → 需要逐文件确认
+  const commonFiles = pluginFiles.filter((f) => targetSet.has(f));
+
+  if (commonFiles.length === 0) {
+    // 没有共有文件，无需确认
+    return {};
+  }
+
+  // 批量快捷选项
+  const bulkChoice = await select({
+    message: `.adspecs/templates/ 目录已存在且包含 ${targetFiles.length} 个模板文件（其中 ${commonFiles.length} 个为已有，${newFiles.length} 个为新增），如何处理已有文件？`,
+    choices: [
+      { name: '逐文件确认 — 对每个已有模板文件逐一询问是否替换（推荐）', value: 'ask-each' },
+      { name: '全部保留现有 — 保留所有已有模板文件不做修改', value: 'keep-all' },
+      { name: '全部替换为最新 — 使用插件根目录中的最新版本覆盖所有已有模板文件', value: 'replace-all' },
+    ],
+  });
+
+  if (bulkChoice === 'keep-all') {
+    const decision = {};
+    for (const f of commonFiles) {
+      decision[f] = 'keep';
+    }
+    return decision;
+  }
+
+  if (bulkChoice === 'replace-all') {
+    const decision = {};
+    for (const f of commonFiles) {
+      decision[f] = 'replace';
+    }
+    return decision;
+  }
+
+  // 逐文件询问（每批最多 4 个文件，避免 inquirer 单次问题过多）
+  const decision = {};
+  const BATCH_SIZE = 4;
+  for (let i = 0; i < commonFiles.length; i += BATCH_SIZE) {
+    const batch = commonFiles.slice(i, i + BATCH_SIZE);
+    const batchNum = Math.floor(i / BATCH_SIZE) + 1;
+    const totalBatches = Math.ceil(commonFiles.length / BATCH_SIZE);
+
+    console.log('');
+    console.log(`--- 模板文件确认（第 ${batchNum}/${totalBatches} 批，共 ${commonFiles.length} 个） ---`);
+
+    for (const file of batch) {
+      const choice = await select({
+        message: `模板文件 ${file} 已存在，是否使用最新版本替换？`,
+        choices: [
+          { name: '保留现有 — 保留当前项目中的版本（用户可能已按项目实际情况调整过）', value: 'keep' },
+          { name: '替换为最新 — 使用插件根目录中的最新版本覆盖现有文件', value: 'replace' },
+        ],
+      });
+      decision[file] = choice;
+    }
+  }
+
+  return decision;
+}
+
 // ============================================================
 // 模式升级检测
 // ============================================================
@@ -340,6 +420,7 @@ module.exports = {
   collectProjectInfo,
   collectDecisions,
   collectSubDecisions,
+  collectTemplatesDecision,
   detectModeUpgrade,
   confirmExecution,
   askAreaDecision,

package/src/lib/report.js

@@ -91,10 +91,16 @@ function printPlanSummary(info, decisions, subDecisions, modeUpgrade, targetDir)
         `      ${chalk.gray('└')} 40-project_conventions/  ${chalk.gray('→')}  ${decisionLabel(subDecisions.conventions)}`
       );
     }
-    if (areaKey === 'adspecs' && decision === 'skip' && subDecisions.templates !== 'skip') {
-      console.log(
-        `      ${chalk.gray('└')} templates/  ${chalk.gray('→')}  ${decisionLabel(subDecisions.templates)}`
-      );
+    if (areaKey === 'adspecs' && decision === 'skip') {
+      const tmplMap = subDecisions.templates || {};
+      const tmplEntries = Object.entries(tmplMap);
+      const replaceCount = tmplEntries.filter(([, v]) => v === 'replace').length;
+      const keepCount = tmplEntries.filter(([, v]) => v === 'keep').length;
+      if (replaceCount > 0 || keepCount > 0) {
+        console.log(
+          `      ${chalk.gray('└')} templates/  ${chalk.gray('→')}  逐文件确认（${replaceCount} 个替换，${keepCount} 个保留）`
+        );
+      }
     }
   }
 
@@ -153,10 +159,15 @@ function printFinalReport(report, info, decisions, subDecisions, modeUpgrade) {
     const detail = stageDetail(stage);
     console.log(`   | ${stage.name} | ${icon} ${stage.status} | ${detail} |`);
 
-    // 子行：templates/
-    if (stage.name === '.adspecs/' && stage.subDecisions) {
-      if (stage.subDecisions.templates === 'update') {
-        console.log(`   | ${chalk.gray('└ templates/')} | ${chalk.green('🔄')} 已更新 | 从插件根目录覆盖更新 |`);
+    // 子行：templates/（逐文件确认结果）
+    if (stage.name === '.adspecs/' && stage.subDecisions && stage.subDecisions.templates) {
+      const tmpl = stage.subDecisions.templates;
+      if (typeof tmpl === 'object' && (tmpl.replaced > 0 || tmpl.kept > 0 || tmpl.added > 0)) {
+        const parts = [];
+        if (tmpl.added > 0) parts.push(`${tmpl.added} 个新增`);
+        if (tmpl.replaced > 0) parts.push(`${tmpl.replaced} 个替换`);
+        if (tmpl.kept > 0) parts.push(`${tmpl.kept} 个保留`);
+        console.log(`   | ${chalk.gray('└ templates/')} | ${chalk.green('🔄')} 部分更新 | ${parts.join('，')} |`);
       }
     }
 
@@ -190,7 +201,7 @@ function printFinalReport(report, info, decisions, subDecisions, modeUpgrade) {
   console.log(chalk.bold('状态说明：'));
   console.log('   ✅ 已创建 — 目录原本不存在，新建完成');
   console.log('   🔄 已重建 — 目录原本存在，按用户选择删除后重新创建');
-  console.log('   🔄 已更新 — 父目录跳过，但子目录按用户选择使用最新文件覆盖');
+  console.log('   🔄 已更新 — 父目录跳过，但子目录按用户选择使用最新文件覆盖（templates/ 支持逐文件确认，部分替换部分保留）');
   console.log('   🔧 已补全 — 已有文件属性与 references 对比后，补充缺失属性');
   console.log('   ⏭ 已跳过 — 目录原本存在，按用户选择保留未动');
   console.log('');

package/src/lib/scaffolder.js

@@ -6,6 +6,7 @@ const { copyDirFiltered, removeDir, countFiles } = require('./copier');
 const { generateReadme, generateWikiReadme, generateServiceReadme, DOCS_READMES } = require('./readme-gen');
 const { mergeJsonFile, mergeProjectJson } = require('./json-merge');
 const { generatePathsConfig } = require('./paths-defaults');
+const { listFiles } = require('./dir-utils');
 
 /**
  * 脚手架核心
@@ -52,7 +53,7 @@ async function scaffold(opts) {
     confidentiality,
     modules,
     decisions,
-    subDecisions = { conventions: 'skip', templates: 'skip' },
+    subDecisions = { conventions: 'skip', templates: {} },
     modeUpgrade = { detected: false, emptyDirs: [] },
     logger = () => {},
   } = opts;
@@ -408,14 +409,46 @@ async function scaffoldAdspecs(targetDir, pluginDir, decision, subDecisions, log
   if (decision === 'skip') {
     logger(`⏭ 阶段 6 跳过：.adspecs/ 已存在，保留现有内容`);
 
-    // 子决策：templates
-    if (subDecisions.templates === 'update') {
-      copyDirFiltered(
-        path.join(pluginDir, '.adspecs/templates'),
-        path.join(adspecsDir, 'templates')
-      );
-      logger(`🔄 阶段 6 补充更新：.adspecs/templates/ 已从插件根目录更新`);
-      stage.subDecisions = { templates: 'update' };
+    // 子决策：templates（逐文件确认）
+    const templatesDecision = subDecisions.templates || {};
+    const templatesMap = typeof templatesDecision === 'object' ? templatesDecision : {};
+    const replaceFiles = Object.entries(templatesMap)
+      .filter(([, v]) => v === 'replace')
+      .map(([k]) => k);
+    const keepFiles = Object.entries(templatesMap)
+      .filter(([, v]) => v === 'keep')
+      .map(([k]) => k);
+
+    // 新增文件（插件有但目标没有）→ 直接复制
+    const pluginTmplDir = path.join(pluginDir, '.adspecs/templates');
+    const targetTmplDir = path.join(adspecsDir, 'templates');
+    const targetFiles = new Set(listFiles(targetTmplDir));
+    const pluginFiles = listFiles(pluginTmplDir);
+    const newFiles = pluginFiles.filter((f) => !targetFiles.has(f));
+
+    let addedCount = 0;
+    for (const f of newFiles) {
+      fs.copyFileSync(path.join(pluginTmplDir, f), path.join(targetTmplDir, f));
+      addedCount++;
+    }
+    if (addedCount > 0) {
+      logger(`📦 模板新增：已添加 ${addedCount} 个新模板文件`);
+    }
+
+    // 逐文件替换
+    let replacedCount = 0;
+    for (const f of replaceFiles) {
+      const srcPath = path.join(pluginTmplDir, f);
+      const dstPath = path.join(targetTmplDir, f);
+      if (fs.existsSync(srcPath)) {
+        fs.copyFileSync(srcPath, dstPath);
+        replacedCount++;
+      }
+    }
+
+    if (replacedCount > 0 || keepFiles.length > 0) {
+      logger(`🔄 阶段 6 补充更新：.adspecs/templates/ 已部分更新（${replacedCount} 个文件替换，${keepFiles.length} 个文件保留）`);
+      stage.subDecisions = { templates: { replaced: replacedCount, kept: keepFiles.length, added: addedCount } };
     }
 
     // 属性补全（无论是否更新 templates 都执行）