adspecs 0.1.30 → 0.1.32

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "adspecs",
       "description": "AI Coding研发协同开发插件",
-      "version": "0.1.30",
+      "version": "0.1.32",
       "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.30",
+  "version": "0.1.32",
   "author": {
     "name": "Qingwen Chen",
     "email": "cqinwn@qq.com",

package/.codebuddy-plugin/plugin.json

@@ -0,0 +1,24 @@
+{
+  "name": "adspecs",
+  "displayName": "adspecs AI 工程规范驱动开发插件",
+  "version": "0.1.32",
+  "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
+  "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
+  "author": {
+    "name": "Qingwen Chen",
+    "email": "cqinwn@qq.com"
+  },
+  "homepage": "https://gitee.com/yuebon/adspecs",
+  "repository": "https://gitee.com/yuebon/adspecs",
+  "logo": "./assets/avatar.svg",
+  "keywords": [
+    "codebuddy-plugin",
+    "adspecs",
+    "spec-driven",
+    "tdd"
+  ],
+  "category": "developer-tools",
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json",
+  "defaultEnabled": true
+}

package/.qoder-plugin/plugin.json

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

package/CLAUDE.md

@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **adspecs AI Plugin** — a Claude Code / Qoder / WorkBuddy plugin for ECP (Enterprise Cloud Platform) full-lifecycle AI-driven development. Provides 30 skills (slash commands) covering requirements, SOW authoring, system design, task breakdown, unit testing, code review, feature status tracking, and wiki sync.
 
-- **Plugin name**: `adspecs` (see `.claude-plugin/plugin.json` / `.qoder-plugin/plugin.json` / `.workbuddy-plugin/plugin.json`)
+- **Plugin name**: `adspecs` (see `.claude-plugin/plugin.json` / `.qoder-plugin/plugin.json` / `.codebuddy-plugin/plugin.json` / `.workbuddy-plugin/plugin.json`)
 - **Author**: Qingwen Chen
 - **License**: Apache 2.0
 - **Language**: Chinese (all documentation, templates, and skill instructions are in Chinese)
@@ -18,7 +18,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 adspecs/
 ├── .claude-plugin/              # Plugin metadata for Claude Code
 ├── .qoder-plugin/               # Plugin metadata for Qoder
-├── .workbuddy-plugin/           # Plugin metadata for WorkBuddy
+├── .codebuddy-plugin/           # Plugin metadata for WorkBuddy (CodeBuddy format)
+├── .workbuddy-plugin/           # Plugin metadata for WorkBuddy (legacy, backward compat)
 ├── .adspecs/                    # Plugin runtime config, templates, scripts & extensions (copied to target projects)
 │   ├── templates/               #   21 standard document templates (PRD, system design, etc.)
 │   ├── extensions/              #   Extension configs (git hooks, etc.)

package/bin/adspecs.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 'use strict';
 
 const { Command } = require('commander');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adspecs",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
   "bin": {
     "adspecs": "bin/adspecs.js"
@@ -11,6 +11,7 @@
     "src/",
     ".claude-plugin/",
     ".qoder-plugin/",
+    ".codebuddy-plugin/",
     ".workbuddy-plugin/",
     ".adspecs/",
     "skills/",
@@ -31,7 +32,7 @@
     "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 .workbuddy-plugin/plugin.json",
+    "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": {

package/scripts/postinstall.js

@@ -137,6 +137,22 @@ try {
     } catch {
       // codebuddy plugin list 失败 → 静默跳过
     }
+  } else {
+    // 5. WorkBuddy — 无 codebuddy CLI 时的回退方案
+    // 手工注册：创建 marketplace 目录 → junction 链接 → known_marketplaces.json → enabledPlugins
+    try {
+      var wkHome = path.join(require('os').homedir(), '.workbuddy');
+      if (fs.existsSync(wkHome)) {
+        var utilsPath = path.join(installDir, 'src', 'utils');
+        var { registerWorkBuddyPlugin } = require(utilsPath);
+        var wbResult = registerWorkBuddyPlugin(installDir, 'adspecs');
+        if (wbResult.success) {
+          refreshedPlatforms.push('WorkBuddy');
+        }
+      }
+    } catch {
+      // 注册失败 → 静默跳过（非 WorkBuddy 用户无需处理）
+    }
   }
 
   // 输出一行提示（仅当有平台被刷新）

package/scripts/sync-version.js

@@ -5,10 +5,11 @@
  * 版本同步脚本
  *
  * 在 `npm version <type>` 时自动执行（通过 preversion 钩子）。
- * 将 package.json 的新版本同步到四套插件清单文件：
+ * 将 package.json 的新版本同步到五套插件清单文件：
  *   - .claude-plugin/plugin.json
  *   - .claude-plugin/marketplace.json
  *   - .qoder-plugin/plugin.json
+ *   - .codebuddy-plugin/plugin.json
  *   - .workbuddy-plugin/plugin.json
  *
  * 也可手动运行：`npm run sync-version`
@@ -87,6 +88,15 @@ function main() {
     updated.push(`.workbuddy-plugin/plugin.json (${old} → ${newVersion})`);
   }
 
+  // 5. .codebuddy-plugin/plugin.json — 始终与 package.json 保持版本一致
+  const cbPlugin = readJson('.codebuddy-plugin/plugin.json');
+  if (cbPlugin && cbPlugin.version !== newVersion) {
+    const old = cbPlugin.version;
+    cbPlugin.version = newVersion;
+    writeJson('.codebuddy-plugin/plugin.json', cbPlugin);
+    updated.push(`.codebuddy-plugin/plugin.json (${old} → ${newVersion})`);
+  }
+
   if (updated.length === 0) {
     console.log('✅ 所有清单版本已一致，无需更新');
   } else {

package/src/commands/plugin.js

@@ -34,7 +34,7 @@ function getPluginName(platform) {
   if (platform === 'qoder') {
     manifestDir = '.qoder-plugin';
   } else if (platform === 'workbuddy') {
-    manifestDir = '.workbuddy-plugin';
+    manifestDir = '.codebuddy-plugin';
   } else {
     manifestDir = '.claude-plugin';
   }
@@ -121,7 +121,7 @@ function checkCodebuddyCli() {
  * 若 CLI 不可用则回退为手工配置 enabledPlugins
  */
 async function installForWorkBuddy(pluginName, scope) {
-  const workbuddyManifest = path.join(PLUGIN_DIR, '.workbuddy-plugin', 'plugin.json');
+  const workbuddyManifest = path.join(PLUGIN_DIR, '.codebuddy-plugin', 'plugin.json');
   if (!fs.existsSync(workbuddyManifest)) {
     throw new Error(`未找到 WorkBuddy 插件清单: ${workbuddyManifest}`);
   }
@@ -147,34 +147,23 @@ async function installForWorkBuddy(pluginName, scope) {
       }
     }
   } else {
-    // 方式 B：回退为手工配置 enabledPlugins（无 CLI 时）
+    // 方式 B：回退为手工配置（无 CLI 时）
+    // 完整注册：创建 marketplace 目录 → junction 链接 → known_marketplaces.json → enabledPlugins
     console.log(chalk.yellow('   ⚠ 未检测到 codebuddy CLI，使用手工配置方式'));
-    const workbuddyHome = path.join(os.homedir(), '.workbuddy');
-    const settingsPath = path.join(workbuddyHome, 'settings.json');
-
-    // 确保 .workbuddy 目录存在
-    fs.mkdirSync(workbuddyHome, { recursive: true });
+    console.log('');
 
-    // 读取或创建 settings.json
-    let settings = {};
-    if (fs.existsSync(settingsPath)) {
-      try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (_e) { /* use default */ }
-    }
-    if (!settings.enabledPlugins) settings.enabledPlugins = {};
+    const { registerWorkBuddyPlugin } = require('../utils');
+    const result = registerWorkBuddyPlugin(PLUGIN_DIR, pluginName);
 
-    var registryKey;
-    if (scope === 'project') {
-      registryKey = `${pluginName}@${PLUGIN_DIR.replace(/\\/g, '/')}`;
+    if (result.success) {
+      console.log(chalk.green('   ✅ 已完成 WorkBuddy 插件注册'));
+      console.log(chalk.gray('   📁 插件目录:'));
+      console.log(chalk.gray(`      ${PLUGIN_DIR}`));
+      console.log(chalk.gray('   📁 marketplace:'));
+      console.log(chalk.gray(`      ~/.workbuddy/plugins/marketplaces/local/`));
     } else {
-      registryKey = `${pluginName}@local`;
+      throw new Error(`WorkBuddy 插件注册失败: ${result.reason}`);
     }
-
-    settings.enabledPlugins[registryKey] = true;
-
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
-    console.log(chalk.green(`   ✅ 已在 settings.json 中启用插件 (${registryKey})`));
-    console.log(chalk.gray('   📁 请确保 WorkBuddy 可访问以下目录:'));
-    console.log(chalk.gray(`      ${PLUGIN_DIR}`));
     console.log(chalk.gray('   请重启 WorkBuddy 使 skills 与 hooks 生效。'));
   }
 }
@@ -345,23 +334,7 @@ async function installQoderProject(pluginName, qoderManifest) {
   }
 }
 
-/**
- * 递归复制目录（排除指定目录名）
- */
-function copyDirRecursive(src, dest, excludeDirs) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    if (excludeDirs && excludeDirs.includes(entry.name)) continue;
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDirRecursive(srcPath, destPath, excludeDirs);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
+const { copyDirRecursive } = require('../utils');
 
 /**
  * Qoder 用户级卸载 — 移除链接 + 注册表条目 + 启用配置
@@ -530,13 +503,43 @@ async function uninstallWorkBuddy(pluginName, scope) {
       }
     }
   } else {
-    // 回退：手工清除 enabledPlugins 条目
-    const settingsPath = path.join(os.homedir(), '.workbuddy', 'settings.json');
+    // 回退：手工清除 marketplace 注册 + junction 链接 + enabledPlugins 条目
+    const workbuddyHome = path.join(os.homedir(), '.workbuddy');
+    const localMarketplaceDir = path.join(workbuddyHome, 'plugins', 'marketplaces', 'local');
+    const pluginLinkPath = path.join(localMarketplaceDir, pluginName);
+    const settingsPath = path.join(workbuddyHome, 'settings.json');
+    const knownMarketplacesPath = path.join(workbuddyHome, 'plugins', 'known_marketplaces.json');
+
+    let cleaned = false;
+
+    // 1. 移除 junction / 目录
+    if (fs.existsSync(pluginLinkPath)) {
+      try {
+        fs.rmSync(pluginLinkPath, { recursive: true, force: true });
+        console.log(chalk.green('   ✅ 已移除插件链接'));
+        cleaned = true;
+      } catch (err) {
+        console.log(chalk.yellow(`   ⚠ 移除插件链接失败: ${err.message}`));
+      }
+    }
+
+    // 2. 移除 marketplace 目录级清单 (.codebuddy-plugin/marketplace.json)
+    const catalogDir = path.join(localMarketplaceDir, '.codebuddy-plugin');
+    if (fs.existsSync(catalogDir)) {
+      try {
+        fs.rmSync(catalogDir, { recursive: true, force: true });
+        console.log(chalk.green('   ✅ 已移除 marketplace 清单'));
+        cleaned = true;
+      } catch (err) {
+        console.log(chalk.yellow(`   ⚠ 移除 marketplace 清单失败: ${err.message}`));
+      }
+    }
+
+    // 3. 从 settings.json 移除
     if (fs.existsSync(settingsPath)) {
       let settings = {};
       try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (_e) { /* use default */ }
       if (settings.enabledPlugins) {
-        // 移除所有 adspecs 相关条目
         const keysBefore = Object.keys(settings.enabledPlugins).length;
         for (var key in settings.enabledPlugins) {
           if (key.startsWith(pluginName + '@')) {
@@ -546,12 +549,29 @@ async function uninstallWorkBuddy(pluginName, scope) {
         const keysAfter = Object.keys(settings.enabledPlugins).length;
         if (keysBefore > keysAfter) {
           fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
-          console.log(chalk.green(`   ✅ 已从 settings.json 移除插件配置`));
+          console.log(chalk.green('   ✅ 已从 settings.json 移除插件配置'));
+          cleaned = true;
         } else {
-          console.log(chalk.yellow(`   ⏭ 未在 settings.json 中找到插件配置`));
+          console.log(chalk.yellow('   ⏭ 未在 settings.json 中找到插件配置'));
         }
       }
     }
+
+    // 4. 从 known_marketplaces.json 移除 local marketplace
+    if (fs.existsSync(knownMarketplacesPath)) {
+      let knownMarketplaces = {};
+      try { knownMarketplaces = JSON.parse(fs.readFileSync(knownMarketplacesPath, 'utf8')); } catch (_e) { /* use default */ }
+      if (knownMarketplaces.local) {
+        delete knownMarketplaces.local;
+        fs.writeFileSync(knownMarketplacesPath, JSON.stringify(knownMarketplaces, null, 4) + '\n', 'utf8');
+        console.log(chalk.green('   ✅ 已从 known_marketplaces.json 移除 local marketplace'));
+        cleaned = true;
+      }
+    }
+
+    if (!cleaned) {
+      console.log(chalk.yellow('   ⏭ 未找到需要清理的插件配置'));
+    }
   }
   console.log(chalk.gray('   请重启 WorkBuddy 使变更生效。'));
 }

package/src/commands/update.js

@@ -83,8 +83,8 @@ module.exports = async function update(options) {
   console.log('');
   console.log('   🔄 插件注册刷新：');
   console.log('      Claude Code  — postinstall 钩子已自动刷新命令行插件注册');
-  console.log('      Qoder        — 通过 .qoder-plugin/ 清单自动发现，无需手动刷新');
-  console.log('      WorkBuddy    — 通过 .workbuddy-plugin/ 清单自动发现，无需手动刷新');
+  console.log('      Qoder / CodeBuddy / WorkBuddy — postinstall 钩子已自动刷新插件注册');
+  console.log('      如未自动刷新，请执行 adspecs plugin install --platform <platform>');
   console.log('');
   console.log(`   验证: ${chalk.gray('adspecs --version')}`);
   console.log('');

package/src/utils.js

@@ -9,6 +9,7 @@
 
 const path = require('path');
 const fs = require('fs');
+const os = require('os');
 
 /**
  * 获取插件根目录（即 adspecs/ 目录）
@@ -70,6 +71,136 @@ function safeWriteJson(filePath, data) {
   fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8');
 }
 
+/**
+ * 递归复制目录（排除指定目录名）
+ * @param {string} src
+ * @param {string} dest
+ * @param {string[]} excludeDirs
+ */
+function copyDirRecursive(src, dest, excludeDirs) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (excludeDirs && excludeDirs.includes(entry.name)) continue;
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath, excludeDirs);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * 注册 WorkBuddy 本地插件 marketplace
+ *
+ * 手工方式完成完整注册，无需 codebuddy CLI：
+ *   1. 创建 ~/.workbuddy/plugins/marketplaces/local/ 目录
+ *   2. 创建 junction 链接（或回退复制）指向插件目录
+ *   3. 生成 marketplace 目录级清单 (.codebuddy-plugin/marketplace.json)
+ *   4. 在 known_marketplaces.json 中注册 local marketplace
+ *   5. 在 settings.json 的 enabledPlugins 中启用插件
+ *
+ * @param {string} pluginDir - adspecs 插件根目录
+ * @param {string} [pluginName='adspecs'] - 插件名称
+ * @returns {{success: boolean, reason?: string}}
+ */
+function registerWorkBuddyPlugin(pluginDir, pluginName) {
+  pluginName = pluginName || 'adspecs';
+
+  const workbuddyHome = path.join(os.homedir(), '.workbuddy');
+
+  // 检查 WorkBuddy 配置目录是否存在
+  if (!fs.existsSync(workbuddyHome)) {
+    return { success: false, reason: '未检测到 WorkBuddy 配置目录 (~/.workbuddy)' };
+  }
+
+  const localMarketplaceDir = path.join(workbuddyHome, 'plugins', 'marketplaces', 'local');
+  const pluginLinkPath = path.join(localMarketplaceDir, pluginName);
+  const settingsPath = path.join(workbuddyHome, 'settings.json');
+  const knownMarketplacesPath = path.join(workbuddyHome, 'plugins', 'known_marketplaces.json');
+
+  try {
+    // 1. 创建 local marketplace 目录
+    fs.mkdirSync(localMarketplaceDir, { recursive: true });
+
+    // 2. 创建 junction / symlink（已存在则先移除重建）
+    if (fs.existsSync(pluginLinkPath)) {
+      try { fs.rmSync(pluginLinkPath, { recursive: true, force: true }); } catch (_err) {
+        try { fs.unlinkSync(pluginLinkPath); } catch (_e) { /* ignore */ }
+      }
+    }
+    try {
+      fs.symlinkSync(pluginDir, pluginLinkPath, 'junction');
+    } catch (_symlinkErr) {
+      // junction 创建失败 → 回退为复制关键目录
+      fs.mkdirSync(pluginLinkPath, { recursive: true });
+      const entriesToCopy = ['.codebuddy-plugin', '.workbuddy-plugin', 'skills', 'hooks', 'references', 'commands'];
+      for (const entry of entriesToCopy) {
+        const srcPath = path.join(pluginDir, entry);
+        if (!fs.existsSync(srcPath)) continue;
+        const destPath = path.join(pluginLinkPath, entry);
+        if (fs.lstatSync(srcPath).isDirectory()) {
+          copyDirRecursive(srcPath, destPath, ['node_modules']);
+        } else {
+          fs.copyFileSync(srcPath, destPath);
+        }
+      }
+      // 同步复制根目录关键文件
+      for (const file of ['package.json', 'CLAUDE.md', 'README.md']) {
+        const srcFile = path.join(pluginDir, file);
+        if (fs.existsSync(srcFile)) {
+          fs.copyFileSync(srcFile, path.join(pluginLinkPath, file));
+        }
+      }
+    }
+
+    // 3. 生成 marketplace 目录级清单（.codebuddy-plugin/marketplace.json）
+    //    WorkBuddy 扫描器需要此文件才能发现 marketplace 中的插件
+    const catalogDir = path.join(localMarketplaceDir, '.codebuddy-plugin');
+    fs.mkdirSync(catalogDir, { recursive: true });
+    const pkg = getPkg();
+    safeWriteJson(path.join(catalogDir, 'marketplace.json'), {
+      name: 'local',
+      description: 'Local plugins',
+      plugins: [{
+        name: pluginName,
+        source: './' + pluginName,
+        version: pkg.version,
+        description: pkg.description
+      }]
+    });
+
+    // 4. 注册 local marketplace
+    let knownMarketplaces = safeReadJson(knownMarketplacesPath, {});
+    const now = new Date().toISOString();
+
+    knownMarketplaces.local = {
+      type: 'directory',
+      source: {
+        source: 'directory',
+        path: localMarketplaceDir
+      },
+      installLocation: localMarketplaceDir,
+      autoUpdate: false,
+      description: 'Local plugins',
+      lastUpdated: now
+    };
+    safeWriteJson(knownMarketplacesPath, knownMarketplaces);
+
+    // 5. 启用插件
+    let settings = safeReadJson(settingsPath, {});
+    if (!settings.enabledPlugins) settings.enabledPlugins = {};
+    settings.enabledPlugins[`${pluginName}@local`] = true;
+    safeWriteJson(settingsPath, settings);
+
+    return { success: true };
+  } catch (err) {
+    return { success: false, reason: err.message };
+  }
+}
+
 module.exports = {
   getPluginDir,
   getPkg,
@@ -77,4 +208,6 @@ module.exports = {
   isInsidePlugin,
   safeReadJson,
   safeWriteJson,
+  copyDirRecursive,
+  registerWorkBuddyPlugin,
 };