adspecs 0.1.40 → 0.1.41

package/skills/project-init/SKILL.md

@@ -407,7 +407,7 @@ questions: [
 
    - **补充检查（模式升级检测）**：当 `docs/` 已存在且 `docs` 决策为 `skip` 时，如果当前模式为**经典模式**、**完整模式**或**轻量模式**，需额外检查 `docs/40-project_conventions/` 的内容状态：
      - 检查 `docs/40-project_conventions/` 下是否存在实际文件（非空目录）
-     - 如果 `40-project_conventions/` 仅包含空子目录（简易模式的产物：`end-integration/` + `frontend-integration/`，或仅 `frontend-standard/` 为空目录）→ 根据前端技术栈选择自动从 references 补充复制 `frontend-standard/` 的文件内容（Vue → `ecp-front-standard/`，Ant Design React → `ant6-front-standard/`），并输出：`📦 补充：检测到 40-project_conventions/ 为空目录（简易模式产物），已按前端技术栈补充 frontend-standard/`
+     - 如果 `40-project_conventions/` 仅包含空子目录（简易模式的产物：`end-integration/` + `frontend-integration/`，或仅 `frontend-standard/` 为空目录）→ 根据前端技术栈选择自动从 references 补充复制 `frontend-standard/` 的文件内容（Vue → `vue3-front-standard/`，Ant Design React → `ant6-front-standard/`），同时补充复制后端规范 `ecp-end-standard/` 到 `end-standard/`，并输出：`📦 补充：检测到 40-project_conventions/ 为空目录（简易模式产物），已按技术栈补充 frontend-standard/ 和 end-standard/`
      - 如果 `40-project_conventions/` 已包含文件 → 不做额外处理
 
    - **子目录更新检查（40-project_conventions/）**：当 `docs/` 已存在且 `docs` 决策为 `skip`，且 `docs/40-project_conventions/` 下已包含实际文件时，需额外询问用户是否更新此子目录：
@@ -513,13 +513,13 @@ questions: [
 根据区域决策执行：
 
 - `docs` 决策为 `skip` → 输出 `⏭ 阶段 1 跳过：docs/ 已存在，保留现有内容`，但需检查 `conventions_decision` 子决策：
-  - 如果 `conventions_decision` = `"update"` → 根据前端技术栈选择从 `references/ecp-front-standard/`（Vue）或 `references/ant6-front-standard/`（Ant Design React）复制到 `$TARGET/docs/40-project_conventions/frontend-standard/`，覆盖更新前端规范文件，输出：`🔄 阶段 1 补充更新：docs/40-project_conventions/frontend-standard/ 已按前端技术栈更新`
+  - 如果 `conventions_decision` = `"update"` → 根据前端技术栈选择从 `references/vue3-front-standard/`（Vue）或 `references/ant6-front-standard/`（Ant Design React）复制到 `$TARGET/docs/40-project_conventions/frontend-standard/`，覆盖更新前端规范文件；经典/完整模式下同时从 `references/ecp-end-standard/` 复制到 `$TARGET/docs/40-project_conventions/end-standard/` 更新后端规范文件，输出：`🔄 阶段 1 补充更新：docs/40-project_conventions/ 已按技术栈更新前后端规范`
   - 如果 `conventions_decision` = `"skip"` → 不做额外处理
   - 处理完子决策后进入阶段 2
 - `docs` 决策为 `recreate` → 执行 `rm -rf "$TARGET/docs"`，然后按下方步骤完整重建
 - `docs` 决策为 `create` → 直接按下方步骤创建
 
-创建以下完整目录树。大部分目录使用 `mkdir -p` 创建并写入 `README.md`；其中 `40-project_conventions/` 在经典/完整模式下根据前端技术栈选择复制 `ecp-front-standard/`（Vue）或 `ant6-front-standard/`（Ant Design React）到 `frontend-standard/` 子目录，轻量模式下同时复制 `python-end-standard/` 到 `end-standard/` 和 `ant6-front-standard/` 到 `frontend-standard/`，在简易模式下仅创建空子目录结构。模板文件（原 `50-templates/`）已迁移至 `.adspecs/templates/`，随阶段 6 的 `.adspecs/` 复制一并完成。
+创建以下完整目录树。大部分目录使用 `mkdir -p` 创建并写入 `README.md`；其中 `40-project_conventions/` 在经典/完整模式下根据前端技术栈选择复制 `vue3-front-standard/`（Vue）或 `ant6-front-standard/`（Ant Design React）到 `frontend-standard/` 子目录，并复制 `ecp-end-standard/` 到 `end-standard/` 子目录（后端 Java 规范）；轻量模式下复制 `ant6-front-standard/` 到 `frontend-standard/` 和 `python-end-standard/` 到 `end-standard/`；在简易模式下仅创建空子目录结构。模板文件（原 `50-templates/`）已迁移至 `.adspecs/templates/`，随阶段 6 的 `.adspecs/` 复制一并完成。
 
 #### 目录结构
 
@@ -531,8 +531,8 @@ docs/
 ├── 20-prd/
 ├── 30-system-design/
 ├── 40-project_conventions/
-│   ├── frontend-standard/      # 经典/完整模式按前端技术栈复制（Vue→ecp-front-standard，AntD→ant6-front-standard）；轻量模式固定 ant6-front-standard；简易模式为空
-│   └── end-standard/           # 轻量模式固定 python-end-standard；其他模式为空
+│   ├── frontend-standard/      # 经典/完整模式按前端技术栈复制（Vue→vue3-front-standard，AntD→ant6-front-standard）；轻量模式固定 ant6-front-standard；简易模式为空
+│   └── end-standard/           # 经典/完整模式复制 ecp-end-standard（Java）；轻量模式固定 python-end-standard；简易模式为空
 ├── 70-scripts/
 │   └── depoly/
 ├── 80-development/
@@ -603,14 +603,15 @@ docs/
 - 用途: 项目约定，前后端集成开发规范和接口约定
 - 子目录:
   - `frontend-standard/` — 前端约定（按技术栈来源不同）
-  - `end-standard/` — 后端约定（仅轻量模式复制 Python 后端规范）
+  - `end-standard/` — 后端约定（按模式来源不同）
 - 来源规则（经典/完整模式）:
-  - 前端演示技术栈选择 **Vue（默认）** → 复制 `$PLUGIN_DIR/references/ecp-front-standard/` 到 `$TARGET/docs/40-project_conventions/frontend-standard/`
+  - 前端演示技术栈选择 **Vue（默认）** → 复制 `$PLUGIN_DIR/references/vue3-front-standard/` 到 `$TARGET/docs/40-project_conventions/frontend-standard/`
   - 前端演示技术栈选择 **Ant Design React** → 复制 `$PLUGIN_DIR/references/ant6-front-standard/` 到 `$TARGET/docs/40-project_conventions/frontend-standard/`
+  - 后端规范（所有经典/完整模式）→ 复制 `$PLUGIN_DIR/references/ecp-end-standard/` 到 `$TARGET/docs/40-project_conventions/end-standard/`
 - 来源规则（轻量模式）:
   - 前端规范：复制 `$PLUGIN_DIR/references/ant6-front-standard/` 到 `$TARGET/docs/40-project_conventions/frontend-standard/`
   - 后端规范：复制 `$PLUGIN_DIR/references/python-end-standard/` 到 `$TARGET/docs/40-project_conventions/end-standard/`
-- 来源规则（简易模式）: 仅创建空目录结构 `frontend-standard/`，不复制文件
+- 来源规则（简易模式）: 仅创建空目录结构 `frontend-standard/` + `end-standard/`，不复制文件
 
 **70-scripts/**:
 
@@ -665,6 +666,7 @@ mkdir -p "$TARGET/docs/300-specs"
 if [ "{mode}" = "simple" ]; then
   # 简易模式：仅创建空子目录结构，不复制 references 文件
   mkdir -p "$TARGET/docs/40-project_conventions/frontend-standard"
+  mkdir -p "$TARGET/docs/40-project_conventions/end-standard"
 elif [ "{mode}" = "demo" ]; then
   # 轻量模式：固定技术栈 Python + SQLite + React + AntD6，前后端规范都复制
   mkdir -p "$TARGET/docs/40-project_conventions/frontend-standard"
@@ -672,16 +674,18 @@ elif [ "{mode}" = "demo" ]; then
   cp -r "$PLUGIN_DIR/references/ant6-front-standard/." "$TARGET/docs/40-project_conventions/frontend-standard/"
   cp -r "$PLUGIN_DIR/references/python-end-standard/." "$TARGET/docs/40-project_conventions/end-standard/"
 else
-  # 经典/完整模式：按前端技术栈选择复制前端规范到 frontend-standard/
+  # 经典/完整模式：按前端技术栈选择复制前端规范到 frontend-standard/，后端统一复制 ecp-end-standard
   if [ "$FRONT_DEMO_SOURCE" = "antd-front-demo" ]; then
     # Ant Design React 技术栈
     FRONTEND_STANDARD_SOURCE="ant6-front-standard"
   else
     # Vue 技术栈（默认）
-    FRONTEND_STANDARD_SOURCE="ecp-front-standard"
+    FRONTEND_STANDARD_SOURCE="vue3-front-standard"
   fi
   mkdir -p "$TARGET/docs/40-project_conventions/frontend-standard"
+  mkdir -p "$TARGET/docs/40-project_conventions/end-standard"
   cp -r "$PLUGIN_DIR/references/$FRONTEND_STANDARD_SOURCE/." "$TARGET/docs/40-project_conventions/frontend-standard/"
+  cp -r "$PLUGIN_DIR/references/ecp-end-standard/." "$TARGET/docs/40-project_conventions/end-standard/"
 fi
 
 # 注意：模板文件已迁移至 .adspecs/templates/，随阶段 6 的 .adspecs/ 复制一并完成，无需单独复制
@@ -694,7 +698,7 @@ fi
 完成后输出：
 
 - 新建时（简易模式）：`✅ 阶段 1 完成：docs/ 目录结构已创建（11 个一级子目录，40 仅创建空目录；模板在 .adspecs/templates/ 随阶段 6 复制）`
-- 新建时（经典/完整模式）：`✅ 阶段 1 完成：docs/ 目录结构已创建（11 个一级子目录，其中 40 从 references 复制；模板在 .adspecs/templates/ 随阶段 6 复制）`
+- 新建时（经典/完整模式）：`✅ 阶段 1 完成：docs/ 目录结构已创建（11 个一级子目录，其中 40 从 references 复制前后端规范；模板在 .adspecs/templates/ 随阶段 6 复制）`
 - 新建时（轻量模式）：`✅ 阶段 1 完成：docs/ 目录结构已创建（11 个一级子目录，40 按 Python+React 技术栈复制前后端规范；模板在 .adspecs/templates/ 随阶段 6 复制）`
 - 重建时：`🔄 阶段 1 完成：docs/ 目录结构已重新创建（删除旧目录后重建）`
 - 跳过时：`⏭ 阶段 1 跳过：docs/ 已存在，保留现有内容`
@@ -1245,7 +1249,7 @@ mkdir -p "$TARGET/.adspecs"
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
 | └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
-| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录，40 仅创建空目录                                             |
+| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录，40 仅创建空目录（含 frontend-standard/ + end-standard/）    |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
 | wiki/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 基线文件目录 + README.md                                                   |
 | hooks/                    | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | Hook 脚本（hooks.json + platform.js + 4 个事件脚本）                       |
@@ -1259,7 +1263,7 @@ mkdir -p "$TARGET/.adspecs"
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
 | └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
-| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制                                      |
+| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制前后端规范                            |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
 | wiki/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 基线文件目录 + README.md                                                   |
 | front-demo/               | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | {技术栈名}，{N} 个文件                                                     |
@@ -1274,7 +1278,7 @@ mkdir -p "$TARGET/.adspecs"
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
 | └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
-| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制                                      |
+| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制前后端规范                            |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
 | wiki/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 基线文件目录 + README.md                                                   |
 | web-ui/                   | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | {N} 个文件                                                                 |
@@ -1321,7 +1325,7 @@ mkdir -p "$TARGET/.adspecs"
 **经典模式：**
 {pwd}/{PROJECT_DIR}/（或直接 {pwd}/）
 ├── .adspecs/ (插件配置、脚本、模板 + project.json)
-├── docs/ (11 个子目录)
+├── docs/ (11 个子目录 + 40-project_conventions/ 含前端规范 + Java 后端规范)
 ├── hooks/ (Hook 脚本：SessionStart/Stop/PostToolUse 等)
 ├── wiki/ (基线文件目录)
 └── front-demo/ ({技术栈名}前端演示项目)
@@ -1329,7 +1333,7 @@ mkdir -p "$TARGET/.adspecs"
 **完整模式：**
 {pwd}/{PROJECT_DIR}/（或直接 {pwd}/）
 ├── .adspecs/ (插件配置、脚本、模板 + project.json)
-├── docs/ (11 个子目录)
+├── docs/ (11 个子目录 + 40-project_conventions/ 含前端规范 + Java 后端规范)
 ├── hooks/ (Hook 脚本：SessionStart/Stop/PostToolUse 等)
 ├── wiki/ (基线文件目录)
 ├── web-ui/ (Vue3 壳工程)
@@ -1420,7 +1424,7 @@ mkdir -p "$TARGET/.adspecs"
 - [ ] 已选择前端演示技术栈（经典/完整模式：Vue / Ant Design React；轻量模式固定 Ant Design React）
 - [ ] 已按模式检查目标路径下对应区域的存在情况
 - [ ] 对已存在的区域已通过 AskUserQuestion 获取用户选择（重新创建 / 跳过）
-- [ ] docs/ 目录结构已创建/重建/跳过（按用户决策执行；简易模式下 40-project_conventions/ 仅创建空目录，经典/完整模式从 references 复制前端规范，轻量模式复制前后端规范）
+- [ ] docs/ 目录结构已创建/重建/跳过（按用户决策执行；简易模式下 40-project_conventions/ 仅创建空目录，经典/完整模式从 references 复制前后端规范（前端按技术栈 + ecp-end-standard），轻量模式复制 ant6-front-standard + python-end-standard）
 - [ ] 模式升级补充检查已完成（docs/ 跳过时，经典/完整/轻量模式自动检测并补充空的 40-project_conventions/）
 - [ ] 40-project_conventions/ 子目录更新检查已完成（docs/ 跳过且目录已包含文件时，已通过 AskUserQuestion 获取更新/跳过决策并按决策执行）
 - [ ] wiki/ 基线文件目录已创建/重建/跳过

package/src/lib/scaffolder.js

@@ -190,7 +190,15 @@ async function scaffoldDocs(targetDir, pluginDir, mode, frontDemoSource, decisio
         path.join(pluginDir, 'references', frontendStandard),
         path.join(docsDir, '40-project_conventions/frontend-standard')
       );
-      logger(`🔄 阶段 1 补充更新：docs/40-project_conventions/frontend-standard/ 已按前端技术栈更新`);
+      // 经典/完整模式同时更新后端规范
+      if (mode === 'classic' || mode === 'full') {
+        fs.mkdirSync(path.join(docsDir, '40-project_conventions/end-standard'), { recursive: true });
+        copyDirFiltered(
+          path.join(pluginDir, 'references/ecp-end-standard'),
+          path.join(docsDir, '40-project_conventions/end-standard')
+        );
+      }
+      logger(`🔄 阶段 1 补充更新：docs/40-project_conventions/ 已按技术栈更新前后端规范`);
       stage.subDecisions = { conventions: 'update' };
     }
 
@@ -198,11 +206,19 @@ async function scaffoldDocs(targetDir, pluginDir, mode, frontDemoSource, decisio
     if (modeUpgrade.detected) {
       const frontendStandard = resolveFrontendStandard(frontDemoSource);
       fs.mkdirSync(path.join(docsDir, '40-project_conventions/frontend-standard'), { recursive: true });
+      fs.mkdirSync(path.join(docsDir, '40-project_conventions/end-standard'), { recursive: true });
       copyDirFiltered(
         path.join(pluginDir, 'references', frontendStandard),
         path.join(docsDir, '40-project_conventions/frontend-standard')
       );
-      logger(`📦 补充：检测到 40-project_conventions/ 为空目录（简易模式产物），已按前端技术栈补充 frontend-standard/`);
+      // 经典/完整模式同时补充后端规范
+      if (mode === 'classic' || mode === 'full') {
+        copyDirFiltered(
+          path.join(pluginDir, 'references/ecp-end-standard'),
+          path.join(docsDir, '40-project_conventions/end-standard')
+        );
+      }
+      logger(`📦 补充：检测到 40-project_conventions/ 为空目录（简易模式产物），已按技术栈补充 frontend-standard/ 和 end-standard/`);
       stage.modeUpgrade = modeUpgrade;
     }
 
@@ -252,6 +268,11 @@ async function scaffoldDocs(targetDir, pluginDir, mode, frontDemoSource, decisio
       path.join(pluginDir, 'references', frontendStandard),
       path.join(convDir, 'frontend-standard')
     );
+    // 后端规范：经典/完整模式统一复制 ecp-end-standard（Java）
+    copyDirFiltered(
+      path.join(pluginDir, 'references/ecp-end-standard'),
+      path.join(convDir, 'end-standard')
+    );
   }
 
   // 生成各子目录的 README.md（create/recreate/update 都重新生成）
@@ -272,7 +293,7 @@ async function scaffoldDocs(targetDir, pluginDir, mode, frontDemoSource, decisio
       ? '，40 按 Python+React 技术栈复制前后端规范'
       : mode === 'simple'
         ? '，40 仅创建空目录'
-        : '，其中 40 从 references 复制';
+        : '，其中 40 从 references 复制前后端规范';
   logger(`✅ 阶段 1 完成：docs/ 目录结构已${verb}（11 个一级子目录${convNote}）`);
 
   return stage;
@@ -532,6 +553,24 @@ function scaffoldHooks(targetDir, pluginDir, decision, logger) {
   // 从插件根目录复制 hooks/
   const result = copyDirFiltered(path.join(pluginDir, 'hooks'), hooksDir);
 
+  // 重写项目级 hooks/hooks.json 命令：源插件版本用 ${CLAUDE_PLUGIN_ROOT} 锚定，
+  // 但该项目根副本供 Qoder/WorkBuddy 加载（它们不做该占位符替换），且相对路径命令
+  // 在会话 cwd 切换到子目录时会解析失败（MODULE_NOT_FOUND）。脚本随目录已复制到
+  // {targetDir}/hooks/，故把占位符替换为项目 hooks 目录绝对路径（正斜杠，JSON 安全）。
+  const copiedJson = path.join(hooksDir, 'hooks.json');
+  if (fs.existsSync(copiedJson)) {
+    try {
+      const absHooksDir = hooksDir.split(path.sep).join('/');
+      const raw = fs.readFileSync(copiedJson, 'utf8');
+      const rewritten = raw.split('${CLAUDE_PLUGIN_ROOT}').join(absHooksDir);
+      if (rewritten !== raw) {
+        fs.writeFileSync(copiedJson, rewritten, 'utf8');
+      }
+    } catch (e) {
+      logger(`⚠ 阶段 6.8：hooks/hooks.json 路径重写失败（${e.message}），请手工将命令改为绝对路径`);
+    }
+  }
+
   stage.fileCount = result.fileCount;
   stage.status = action === 'recreate' ? 'recreated' : 'created';
 
@@ -582,7 +621,7 @@ function resolveFrontendStandard(frontDemoSource) {
   if (frontDemoSource === 'antd-front-demo') {
     nowFrontendStantard = 'ant6-front-standard'
   } else if (frontDemoSource === 'front-demo') {
-    nowFrontendStantard = 'ecp-front-standard'
+    nowFrontendStantard = 'vue3-front-standard'
   } else if (frontDemoSource === 'vue3-front-standard') {
     nowFrontendStantard = 'vue3-front-standard'
   }