adspecs 0.1.39 → 0.1.41

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "adspecs",
       "description": "AI Coding研发协同开发插件",
-      "version": "0.1.39",
+      "version": "0.1.41",
       "source": "./",
       "author": {
         "name": "Qingwen Chen",

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "adspecs",
   "displayName": "adspecs AI Plugin",
   "description": "AI first工程规范驱动开发插件",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "author": {
     "name": "Qingwen Chen",
     "email": "cqinwn@qq.com",

package/.codebuddy-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "adspecs",
   "displayName": "adspecs AI 工程规范驱动开发插件",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
   "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
   "author": {

package/.qoder-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "adspecs",
   "displayName": "adspecs AI 工程规范驱动开发插件",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
   "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
   "author": {

package/.workbuddy-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "adspecs",
   "displayName": "adspecs AI 工程规范驱动开发插件",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
   "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
   "author": {

package/README.md

@@ -291,7 +291,7 @@ adspecs init
 | `front-demo/`              | Vue 3 前端演示项目（Vite + TS + Element Plus） |
 | `antd-front-demo/`         | Ant Design React 前端演示项目                  |
 | `ant6-front-standard/`     | Ant Design 6 前端编码规范（12 篇）             |
-| `vue3-front-stantard/`     | Vue 3 前端编码规范                             |
+| `vue3-front-standard/`     | Vue 3 前端编码规范                             |
 | `python-end-standard/`     | Python 后端参考                                |
 | `yudaocloud-end-standard/` | 芋道 Cloud 后端集成参考                        |
 | `tools/`                   | 辅助工具集                                     |

package/bin/adspecs.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 'use strict';
 
 const { Command } = require('commander');
@@ -25,7 +25,7 @@ program
   .option('--company <name>', '公司名称', 'XX有限公司')
   .option('--confidentiality <level>', '文件密级: 公开|内部资料|机密|绝密', '内部资料')
   .option('--mode <mode>', '初始化模式: simple|classic|full|demo')
-  .option('--front-demo <stack>', '前端演示技术栈: vue|antd', 'vue')
+  .option('--front-demo <stack>', '前端演示技术栈: vue|antd')
   .option('--modules <list>', '后端模块列表（逗号分隔，格式 {port}-crm-{name}:{package}）')
   .option('--non-interactive', '非交互模式，所有未提供的参数使用默认值')
   .option('--force', '跳过冲突决策，所有已存在区域直接重新创建')

package/hooks/commit-queue.js

@@ -20,7 +20,8 @@ const platform = require('./platform');
 
 // ── 配置 ──────────────────────────────────────────────
 // 队列文件放在目标项目根目录的平台状态目录下。
-// 使用 process.cwd() 获取目标项目根目录（平台运行 hook 时 CWD 即为目标项目）。
+// 项目根由 platform.getProjectRoot() 解析：优先 CLAUDE_PROJECT_DIR 环境变量，兜底 cwd
+// （会话中途 cd 到子目录时，状态文件仍落在真正的项目根，避免队列分裂）。
 const PROJECT_ROOT = platform.getProjectRoot();
 const QUEUE_DIR = platform.getStateDir(PROJECT_ROOT);
 const QUEUE_FILE = path.join(QUEUE_DIR, '.commit-candidates');
@@ -212,10 +213,8 @@ function checkAndReport() {
     });
 
     console.log('');
-    console.log('[commit-queue] To commit with worktree isolation:');
-    console.log('[commit-queue]   /ai-softengineer:git-worktree-manager');
-    console.log('[commit-queue] To commit directly (no worktree):');
-    console.log('[commit-queue]   /ai-softengineer:git-commit');
+    console.log('[commit-queue] 提交已编译通过的功能：');
+    console.log('[commit-queue]   /adspecs-git-commit');
     console.log('══════════════════════════════════════════════════════');
     console.log('');
   }

package/hooks/hooks.json

@@ -1,24 +1,24 @@
 {
-  "_comment": "跨平台 Hook 配置 — 同时支持 Claude Code、Qoder 和 WorkBuddy。${CLAUDE_PLUGIN_ROOT} 由平台在加载插件时注入（所有平台兼容此变量或设置 ADSPECS_PLATFORM=claude|qoder|workbuddy）。",
+  "_comment": "跨平台 Hook 配置 — 同时支持 Claude Code、Qoder 和 WorkBuddy。本文件是插件自身 hooks/hooks.json（由 Claude Code 自动发现），命令一律用 ${CLAUDE_PLUGIN_ROOT} 锚定脚本路径，不依赖会话 CWD（历史版本使用相对路径 hooks/xxx.js，当会话中途 cd 到子目录时会解析失败 MODULE_NOT_FOUND）。项目根定位由脚本内 platform.getProjectRoot() 负责：优先 CLAUDE_PROJECT_DIR 环境变量、兜底 process.cwd()。/project-init 复制到目标项目根的 hooks/hooks.json 副本（供 Qoder/WorkBuddy 加载）由 scaffolder 重写为绝对路径。",
   "hooks": {
     "SessionStart": [
       {
         "hooks": [
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.js"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.js\""
           },
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js init"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js\" init"
           },
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js init"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js\" init"
           },
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/session-logger.js init"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-logger.js\" init"
           }
         ]
       }
@@ -28,7 +28,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/session-logger.js mark"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-logger.js\" mark"
           }
         ]
       }
@@ -40,7 +40,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js enqueue"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js\" enqueue"
           }
         ],
         "conditions": {
@@ -52,7 +52,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js enqueue"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js\" enqueue"
           }
         ],
         "conditions": {
@@ -65,15 +65,15 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js report"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js\" report"
           },
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js report"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js\" report"
           },
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/session-logger.js report"
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-logger.js\" report"
           }
         ]
       }

package/hooks/platform.js

@@ -72,12 +72,16 @@ function getPluginRoot(hooksDir) {
 
 /**
  * 获取目标项目根目录
- * 两种平台均使用 process.cwd()（运行时 CWD 即为目标项目）
+ * 优先 CLAUDE_PROJECT_DIR（Claude Code 执行 hook 时注入，恒指向会话项目根），
+ * 兜底 process.cwd()。
+ * 背景：旧实现仅用 cwd——会话中途 cd 到子目录（如 front-demo/）后，Stop hook 会把
+ * .wiki-update-queue / marker / 日志等状态误写进子目录，产生项目状态分裂。
+ * Qoder/WorkBuddy 不注入该环境变量，行为与旧版一致。
  *
  * @returns {string}
  */
 function getProjectRoot() {
-  return process.cwd();
+  return process.env.CLAUDE_PROJECT_DIR || process.cwd();
 }
 
 /**

package/hooks/session-logger.js

@@ -18,7 +18,8 @@ const path = require('path');
 const platform = require('./platform');
 
 // ── 路径解析 ──────────────────────────────────────────────
-// 使用 process.cwd() 定位目标项目（不用 __dirname，因为 __dirname 指向插件目录）
+// 项目根由 platform.getProjectRoot() 解析：优先 CLAUDE_PROJECT_DIR，兜底 cwd
+// （不用 __dirname——它指向插件目录而非目标项目）
 const PROJECT_ROOT = platform.getProjectRoot();
 const STATE_DIR = platform.getStateDir(PROJECT_ROOT);
 const MARKER_FILE = path.join(STATE_DIR, '.session-save-marker');

package/hooks/session-start.js

@@ -1,40 +1,17 @@
 #!/usr/bin/env node
 
 /**
- * SessionStart Hook — 注入 using-adspecs 技能引导内容
+ * SessionStart Hook — 会话启动占位脚本
  *
- * 在每次会话启动时，读取 using-adspecs/SKILL.md 并输出为
- * hook additionalContext，确保 Agent 在任何任务开始前
- * 都知道需要检查并使用 ADSpecs 技能。
+ * 原设计：注入 using-adspecs/SKILL.md 引导内容。
+ * 当前状态：using-adspecs skill 不存在，会话引导已由 session-logger.js init 承担
+ *           （注入 AI 会话日志保存指南）。
  *
- * 跨平台兼容：Claude Code / Qoder
+ * 保留此脚本文件是为了 hooks.json 中 SessionStart 事件的结构完整性，
+ * 后续若需要新增会话启动时的上下文注入可在此扩展。
+ *
+ * 跨平台兼容：Claude Code / Qoder / WorkBuddy
  */
 
-const fs = require('fs');
-const path = require('path');
-const platform = require('./platform');
-
-// ── 路径解析 ──────────────────────────────────────────
-// 使用平台工具解析插件根目录（兼容环境变量和 __dirname 回退）
-const PLUGIN_ROOT = platform.getPluginRoot(__dirname);
-const SKILL_PATH = path.join(PLUGIN_ROOT, 'skills', 'using-adspecs', 'SKILL.md');
-
-// ── 读取技能内容 ──────────────────────────────────────
-var skillContent;
-try {
-  skillContent = fs.readFileSync(SKILL_PATH, 'utf8');
-} catch (err) {
-  // 技能文件不存在，静默跳过
-  process.exit(0);
-}
-
-if (!skillContent || skillContent.trim() === '') {
-  process.exit(0);
-}
-
-// ── 输出 Hook Context ─────────────────────────────────
-// 使用平台统一输出协议（hookSpecificOutput.additionalContext）
-platform.outputContext(
-  'SessionStart',
-  '<EXTREMELY-IMPORTANT>\n' + skillContent + '\n</EXTREMELY-IMPORTANT>'
-);
+// 直接退出，不输出任何内容
+process.exit(0);

package/hooks/wiki-queue.js

@@ -19,7 +19,8 @@ const platform = require('./platform');
 
 // ── 配置 ──────────────────────────────────────────────
 // 队列文件放在目标项目根目录的平台状态目录下。
-// 使用 process.cwd() 获取目标项目根目录（平台运行 hook 时 CWD 即为目标项目）。
+// 项目根由 platform.getProjectRoot() 解析：优先 CLAUDE_PROJECT_DIR 环境变量，兜底 cwd
+// （会话中途 cd 到子目录时，状态文件仍落在真正的项目根，避免队列分裂）。
 const PROJECT_ROOT = platform.getProjectRoot();
 const QUEUE_DIR = platform.getStateDir(PROJECT_ROOT);
 const QUEUE_FILE = path.join(QUEUE_DIR, '.wiki-update-queue');

package/package.json

@@ -1,65 +1,65 @@
-{
-  "name": "adspecs",
-  "version": "0.1.39",
-  "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
-  "bin": {
-    "adspecs": "bin/adspecs.js"
-  },
-  "main": "./src/utils.js",
-  "files": [
-    "bin/",
-    "src/",
-    ".claude-plugin/",
-    ".qoder-plugin/",
-    ".codebuddy-plugin/",
-    ".workbuddy-plugin/",
-    ".adspecs/",
-    "skills/",
-    "hooks/",
-    "references/",
-    "scripts/postinstall.js",
-    "scripts/sync-version.js",
-    "CLAUDE.md",
-    "README.md",
-    "INSTALL.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "test": "node --test src/**/*.test.js",
-    "postinstall": "node scripts/postinstall.js",
-    "prepublishOnly": "node scripts/prepublish-check.js",
-    "version": "node scripts/sync-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .qoder-plugin/plugin.json .codebuddy-plugin/plugin.json .workbuddy-plugin/plugin.json",
-    "sync-version": "node scripts/sync-version.js"
-  },
-  "dependencies": {
-    "commander": "^12.0.0",
-    "@inquirer/prompts": "^7.0.0",
-    "chalk": "^4.1.2"
-  },
-  "devDependencies": {},
-  "keywords": [
-    "adspecs",
-    "claude-code",
-    "qoder",
-    "workbuddy",
-    "plugin",
-    "scaffold",
-    "cli",
-    "project-init",
-    "ai-first"
-  ],
-  "author": "Qingwen Chen <cqinwn@qq.com>",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://gitee.com/yuebon/adp-plugins.git"
-  },
-  "homepage": "https://gitee.com/yuebon/adp-plugins#readme",
-  "bugs": {
-    "url": "https://gitee.com/yuebon/adp-plugins/issues"
-  }
-}
+{
+  "name": "adspecs",
+  "version": "0.1.41",
+  "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
+  "bin": {
+    "adspecs": "bin/adspecs.js"
+  },
+  "main": "./src/utils.js",
+  "files": [
+    "bin/",
+    "src/",
+    ".claude-plugin/",
+    ".qoder-plugin/",
+    ".codebuddy-plugin/",
+    ".workbuddy-plugin/",
+    ".adspecs/",
+    "skills/",
+    "hooks/",
+    "references/",
+    "scripts/postinstall.js",
+    "scripts/sync-version.js",
+    "CLAUDE.md",
+    "README.md",
+    "INSTALL.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "node --test src/**/*.test.js",
+    "postinstall": "node scripts/postinstall.js",
+    "prepublishOnly": "node scripts/prepublish-check.js",
+    "version": "node scripts/sync-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .qoder-plugin/plugin.json .codebuddy-plugin/plugin.json .workbuddy-plugin/plugin.json",
+    "sync-version": "node scripts/sync-version.js"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^4.1.2"
+  },
+  "devDependencies": {},
+  "keywords": [
+    "adspecs",
+    "claude-code",
+    "qoder",
+    "workbuddy",
+    "plugin",
+    "scaffold",
+    "cli",
+    "project-init",
+    "ai-first"
+  ],
+  "author": "Qingwen Chen <cqinwn@qq.com>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/yuebon/adp-plugins.git"
+  },
+  "homepage": "https://gitee.com/yuebon/adp-plugins#readme",
+  "bugs": {
+    "url": "https://gitee.com/yuebon/adp-plugins/issues"
+  }
+}

package/references/vue3-front-standard/INDEX.md

@@ -0,0 +1,54 @@
+# 前端规则文件索引
+
+本目录包含 `sie-front-demo` 的 AI 开发规则。生成或修改代码前，先按任务类型读取对应规则。
+
+## 文件组织
+
+```text
+.claude/rules/
+├── INDEX.md
+├── project-overview.md
+├── gushen-components.md
+├── page-development-rules.md
+├── api-i18n-rules.md
+└── page-template-index.md
+```
+
+## 推荐读取顺序
+
+### 新增普通业务页面
+
+1. `project-overview.md`
+2. `page-development-rules.md`
+3. `gushen-components.md`
+4. `api-i18n-rules.md`
+5. `page-template-index.md`
+
+### 新增列表页
+
+1. `gushen-components.md`
+2. `page-development-rules.md`
+3. `api-i18n-rules.md`
+4. `page-template-index.md`
+
+### 新增表单或流程页面
+
+1. `page-development-rules.md`
+2. `api-i18n-rules.md`
+3. `page-template-index.md`
+
+### 选择复杂页面模板
+
+1. `page-template-index.md`
+2. 根据选中的模式补读 `gushen-components.md` 或 `api-i18n-rules.md`
+
+### 使用 `@gushen` 组件
+
+1. `gushen-components.md`
+2. 如规则不足，读取 `node_modules/@gushen/*/src` 中对应组件源码。
+
+## 维护要求
+
+- 新增规则文件时，同步更新本索引和根目录 `claude.md`。
+- 修改页面模板候选时，同步更新 `page-template-index.md`。
+- 组件依赖升级后，重新读取 `node_modules/@gushen/*/src`，再更新 `gushen-components.md`。

package/references/vue3-front-standard/api-i18n-rules.md

@@ -0,0 +1,65 @@
+# API 与多语言规则
+
+## API 文件
+
+新增 API 放在 `src/api/<module>/<page>/index.ts` 或已有模块目录下。
+
+推荐写法：
+
+```ts
+import request from '@/utils/request'
+
+export function findPagination(data: any) {
+  return request({
+    url: '/api/demoa/example/find-pagination',
+    method: 'post',
+    data,
+  })
+}
+```
+
+## 请求规则
+
+- POST 保存、更新、分页查询按现有接口要求传 `data`。
+- 保存/更新业务对象通常使用 `{ params: formData }` 包装。
+- GET 查询单条使用 `params`，不要拼接复杂 query 字符串。
+- 不确定后端前缀时，先参考同模块 API 文件，不要凭空新增服务前缀。
+- 需要动态域名时，参考旧页面中的 `window.getVersionTypeApiUrl(...)` 用法。
+
+## 成功判断
+
+- Composition API 页面优先 import `reqIsSucceed`。
+- Options API 旧页面可使用 `this.reqIsSucceed(res)`。
+- 不要在新页面里散落 `res.code === 800`、`res.status === 'S'`；只有维护旧接口或流程接口时才沿用既有判断。
+
+## 错误处理
+
+- 保存、删除、提交等用户操作需要 loading 防重复点击。
+- 失败时显示后端 `msg` 或明确错误提示。
+- 不要吞掉 catch；至少恢复 loading 状态。
+
+## 多语言
+
+本工程语言包位于：
+
+- `src/lang/zh-cn.ts`
+- `src/lang/en-us.ts`
+- `src/lang/zh-tw.ts`
+- `src/lang/modules/<module>/<locale>.ts`
+
+规则：
+
+- 新增用户可见文案优先放入模块语言包。
+- 至少补齐 `zh-cn`、`en-us`、`zh-tw`；如果现有模块已有 `hu-hu`、`vi-vn`，同步评估是否需要补。
+- 模板中使用 `$t('module.key')` 或 `t('module.key')`。
+- 表格列名、按钮、提示、确认文案、校验信息都属于用户可见文案。
+
+## 路由标题
+
+路由 `meta.title` 使用中文标题；`meta.enTitle` 在当前工程常见为多语言 JSON 字符串：
+
+```ts
+enTitle: '{"zh-tw":"消息中心","en-us":"letters","hu-hu":"Üzenetközpont","vi-vn":"Trung tâm thông điệp"}'
+```
+
+新增路由时保持和邻近路由一致。