adspecs 0.1.13 → 0.1.15

package/.claude-plugin/marketplace.json

@@ -1,23 +1,23 @@
-{
-  "name": "adspecs-marketplace",
-  "owner": {
-    "name": "Qingwen Chen",
-    "email": "cqinwn@qq.com",
-    "url": "https://gitee.com/yuebon/adspecs",
-    "github": "https://gitee.com/yuebon/adspecs"
-  },
-  "plugins": [
-    {
-      "name": "adspecs",
-      "description": "AI Coding研发协同开发插件",
-      "version": "0.1.13",
-      "source": "./",
-      "author": {
-        "name": "Qingwen Chen",
-        "email": "cqinwn@qq.com",
-        "url": "https://gitee.com/yuebon/adspecs",
-        "github": "https://gitee.com/yuebon/adspecs"
-      }
-    }
-  ]
-}
+{
+  "name": "adspecs-marketplace",
+  "owner": {
+    "name": "Qingwen Chen",
+    "email": "cqinwn@qq.com",
+    "url": "https://gitee.com/yuebon/adspecs",
+    "github": "https://gitee.com/yuebon/adspecs"
+  },
+  "plugins": [
+    {
+      "name": "adspecs",
+      "description": "AI Coding研发协同开发插件",
+      "version": "0.1.15",
+      "source": "./",
+      "author": {
+        "name": "Qingwen Chen",
+        "email": "cqinwn@qq.com",
+        "url": "https://gitee.com/yuebon/adspecs",
+        "github": "https://gitee.com/yuebon/adspecs"
+      }
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,14 +1,18 @@
-{
-  "name": "adspecs",
-  "displayName": "adspecs AI Plugin",
-  "description": "AI first工程规范驱动开发插件",
-  "version": "0.1.13",
-  "author": {
-    "name": "Qingwen Chen",
-    "email": "cqinwn@qq.com",
-    "url": "https://gitee.com/yuebon/adspecs"
-  },
-  "skills": "./skills/",
-  "license": "apache-2.0",
-  "keywords": ["adspecs", "ai", "development"]
-}
+{
+  "name": "adspecs",
+  "displayName": "adspecs AI Plugin",
+  "description": "AI first工程规范驱动开发插件",
+  "version": "0.1.15",
+  "author": {
+    "name": "Qingwen Chen",
+    "email": "cqinwn@qq.com",
+    "url": "https://gitee.com/yuebon/adspecs"
+  },
+  "skills": "./skills/",
+  "license": "apache-2.0",
+  "keywords": [
+    "adspecs",
+    "ai",
+    "development"
+  ]
+}

package/README.md

@@ -7,7 +7,6 @@
 
 ---
 
-![简介](assets\readme-illustrations\cartoon\cover.svg)
 ## 简介
 
 AdSpecs 是一个基于 Claude Code 的 AI 工程研发协同插件，提供：
@@ -24,8 +23,6 @@ AdSpecs 是一个基于 Claude Code 的 AI 工程研发协同插件，提供：
 
 ## AI Coding六维魔方
 
-![AI Coding六维魔方](assets/readme-illustrations/cartoon/00-ai-coding-six-dimension-cube.svg)
-
 WAF六个架构维度。每个面由多个能力模块组成，每个方块代表一个可独立使用的能力颗粒。
 
 **D1·意图传递**
@@ -45,8 +42,6 @@ AI Coding能力从个人复制到团队与组织，形成可推广的资产和
 
 ## 解决什么问题
 
-![总体流程图](assets\readme-illustrations\cartoon\00-collaboration-platform.svg)
-
 AdSpecs不同于CC、codex、XXwork等产品，其要真正要解决的，是让 AI 从“个人助手”进入“团队正式交付系统”，这是它的核心价值。
 
 我们也就擅长干这个，干单体用户的场景咱也干不过这些模型厂商啥的。
@@ -84,7 +79,7 @@ AI 可以写得更快，但必须跑测试、过 Review、留审计、受权限
 ## 核心思路-基于 CR 的全流程协作与贯穿
 
 AdSpecs 是以 **CR（Change Request）工作容器**为核心，CR 不是简单的需求单，而是一次变更从想法、需求、设计、任务、代码、测试、评审的工作容器，协作过程组织成一个可追踪、可评审、可沉淀的闭环。
-![核心思路](assets\readme-illustrations\cartoon\01-core-idea.svg)
+
 ### 1. 基于 CR 的协作闭环
 
 每个 CR 承载一次需求变更或功能交付，从需求输入开始，逐步沉淀为设计、任务、代码、测试与评审结论。所有角色围绕同一个 CR 协同，避免需求、设计、实现、测试分散在不同上下文中。
@@ -114,11 +109,6 @@ AdSpecs 是以 **CR（Change Request）工作容器**为核心，CR 不是简单
 
 ---
 
-## 总体流程
-
-![总体流程图](assets/readme-illustrations/cartoon/02-overall-flow.svg)
-
-
 ## 插件结构
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adspecs",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
   "bin": {
     "adspecs": "./bin/adspecs.js"

package/src/commands/plugin.js

@@ -39,13 +39,21 @@ function getPluginName() {
 /**
  * 安装（注册）插件到 Claude Code
  *
+ * Claude Code 的 marketplace 命令期望路径指向包含 `.claude-plugin/marketplace.json`
+ * 的目录，因此传入 PLUGIN_DIR（而非 PLUGIN_DIR/.claude-plugin）。
+ *
  * @param {object} options
  * @param {string} options.scope - 安装范围: user|project
  */
 exports.install = async function install(options) {
   const scope = options.scope || 'user';
   const pluginName = getPluginName();
-  const pluginManifestDir = path.join(PLUGIN_DIR, '.claude-plugin');
+
+  // marketplace.json 必须存在，否则无法注册
+  const marketplaceJson = path.join(PLUGIN_DIR, '.claude-plugin', 'marketplace.json');
+  if (!fs.existsSync(marketplaceJson)) {
+    throw new Error(`未找到 marketplace 清单: ${marketplaceJson}`);
+  }
 
   console.log(chalk.cyan('🔌 adspecs 插件注册'));
   console.log('');
@@ -65,25 +73,36 @@ exports.install = async function install(options) {
     process.exit(1);
   }
 
-  // 2. 注册 marketplace（可能已存在，忽略错误）
+  // 2. 注册 marketplace
+  //    注意：传入 PLUGIN_DIR，claude 会去找 <PLUGIN_DIR>/.claude-plugin/marketplace.json
   console.log(chalk.gray('   → 注册 marketplace...'));
+  let marketplaceRegistered = false;
   try {
     execSync(
-      `claude plugins marketplace add "${pluginManifestDir}" --scope ${scope}`,
+      `claude plugins marketplace add "${PLUGIN_DIR}" --scope ${scope}`,
       { stdio: 'pipe' }
     );
     console.log(chalk.green('   ✅ marketplace 注册成功'));
+    marketplaceRegistered = true;
   } catch (err) {
     const stderr = err.stderr ? err.stderr.toString() : '';
-    if (stderr.includes('already exists') || stderr.includes('already registered')) {
+    const stdout = err.stdout ? err.stdout.toString() : '';
+    const combined = stderr + stdout;
+    if (combined.includes('already exists') || combined.includes('already registered')) {
       console.log(chalk.yellow('   ⏭ marketplace 已存在，跳过'));
+      marketplaceRegistered = true; // 已存在也视为可用
     } else {
-      console.log(chalk.yellow('   ⚠ marketplace 注册失败（可能已存在），继续安装...'));
+      // 把真实错误输出，方便排查，不再静默吞掉
+      console.log(chalk.red(`   ❌ marketplace 注册失败: ${combined.trim() || err.message}`));
     }
   }
 
   // 3. 安装插件
+  //    只有 marketplace 注册成功（或已存在）时，才能按名称安装
   console.log(chalk.gray('   → 安装插件...'));
+  if (!marketplaceRegistered) {
+    throw new Error('marketplace 未注册成功，无法按名称安装插件，请检查上方错误');
+  }
   try {
     execSync(`claude plugins install ${pluginName} --scope ${scope}`, {
       stdio: 'pipe',
@@ -91,10 +110,12 @@ exports.install = async function install(options) {
     console.log(chalk.green(`   ✅ ${pluginName} 插件安装成功`));
   } catch (err) {
     const stderr = err.stderr ? err.stderr.toString() : '';
-    if (stderr.includes('already installed')) {
+    const stdout = err.stdout ? err.stdout.toString() : '';
+    const combined = stderr + stdout;
+    if (combined.includes('already installed')) {
       console.log(chalk.yellow(`   ⏭ ${pluginName} 已安装，跳过`));
     } else {
-      throw new Error(`插件安装失败: ${stderr || err.message}`);
+      throw new Error(`插件安装失败: ${combined.trim() || err.message}`);
     }
   }