@liangjie559567/ultrapower 5.0.16 → 5.0.18

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultrapower",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution. Combines superpowers' TDD/debugging discipline with OMC's multi-agent execution capabilities.",
-  "version": "5.0.16",
+  "version": "5.0.18",
   "author": {
     "name": "Jesse Vincent & oh-my-claudecode contributors"
   },

package/docs/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:5.0.14 -->
+<!-- OMC:VERSION:5.0.18 -->
 # ultrapower - Multi-Agent Orchestration 智能多 Agent 编排
 
 你正在使用 ultrapower（OMC），这是 Claude Code 的多 agent 编排层。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangjie559567/ultrapower",
-  "version": "5.0.16",
+  "version": "5.0.18",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,8 @@
     "sync-metadata:verify": "tsx scripts/sync-metadata.ts --verify",
     "sync-metadata:dry-run": "tsx scripts/sync-metadata.ts --dry-run",
     "prepare": "npm run build",
-    "prepublishOnly": "npm run build && npm run compose-docs"
+    "prepublishOnly": "npm run build && npm run compose-docs",
+    "postinstall": "node scripts/plugin-setup.mjs"
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.0",

package/scripts/plugin-setup.mjs

@@ -54,6 +54,66 @@ function fixNestedCacheDir() {
 
 fixNestedCacheDir();
 
+// Fix: npm install strips hidden directories (starting with '.'), so .claude-plugin/plugin.json
+// is never extracted to the plugin cache. We recreate it directly in the plugin cache.
+// The postinstall script runs from the npm-cache node_modules dir, so we must target the
+// plugin cache path explicitly rather than relying on __dirname.
+function fixMissingPluginJson() {
+  try {
+    const pluginRoot = dirname(__dirname);
+    const pkgPath = join(pluginRoot, 'package.json');
+    if (!existsSync(pkgPath)) return;
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const version = pkg.version || '0.0.0';
+
+    const pluginJson = {
+      name: 'ultrapower',
+      description: pkg.description || '',
+      version,
+      author: pkg.author ? { name: typeof pkg.author === 'string' ? pkg.author : pkg.author.name } : undefined,
+      homepage: pkg.homepage || '',
+      repository: pkg.repository?.url || pkg.repository || '',
+      license: pkg.license || 'MIT',
+      keywords: pkg.keywords || [],
+      skills: './skills/',
+      mcpServers: './.mcp.json'
+    };
+    const pluginJsonStr = JSON.stringify(pluginJson, null, 2);
+
+    // 1. Write to current install location (npm-cache node_modules dir)
+    const localPluginJsonDir = join(pluginRoot, '.claude-plugin');
+    const localPluginJsonPath = join(localPluginJsonDir, 'plugin.json');
+    if (!existsSync(localPluginJsonPath)) {
+      mkdirSync(localPluginJsonDir, { recursive: true });
+      writeFileSync(localPluginJsonPath, pluginJsonStr);
+      console.log('[OMC] Created .claude-plugin/plugin.json in install dir');
+    }
+
+    // 2. Write directly to plugin cache (marketplace: ultrapower, plugin: ultrapower)
+    // Claude Code copies from npm-cache but skips hidden dirs, so we patch the cache directly.
+    const pluginCacheBase = join(CLAUDE_DIR, 'plugins/cache/ultrapower/ultrapower');
+    if (existsSync(pluginCacheBase)) {
+      const versions = readdirSync(pluginCacheBase);
+      for (const v of versions) {
+        const cacheVersionDir = join(pluginCacheBase, v);
+        const cachePluginJsonDir = join(cacheVersionDir, '.claude-plugin');
+        const cachePluginJsonPath = join(cachePluginJsonDir, 'plugin.json');
+        if (!existsSync(cachePluginJsonPath)) {
+          mkdirSync(cachePluginJsonDir, { recursive: true });
+          // Use version-specific content for each cached version
+          const versionedPkg = { ...pluginJson, version: v };
+          writeFileSync(cachePluginJsonPath, JSON.stringify(versionedPkg, null, 2));
+          console.log(`[OMC] Created .claude-plugin/plugin.json in plugin cache v${v}`);
+        }
+      }
+    }
+  } catch (e) {
+    console.log('[OMC] Warning: Could not create .claude-plugin/plugin.json:', e.message);
+  }
+}
+
+fixMissingPluginJson();
+
 // 1. Create HUD directory
 if (!existsSync(HUD_DIR)) {
   mkdirSync(HUD_DIR, { recursive: true });

package/skills/ax-analyze-error/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-analyze-error
 description: "/ax-analyze-error — Axiom 错误分析工作流：根因诊断 → 自动修复 → 知识入队"
-triggers: ["ax-analyze-error", "analyze error", "报错了", "修 bug", "错误分析"]
 ---
 
 # Axiom 错误分析工作流

package/skills/ax-context/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-context
 description: "/ax-context — Axiom 上下文管理：读取/更新/保存记忆系统，维护任务状态"
-triggers: ["ax-context", "context manager", "上下文管理", "读取记忆", "保存状态"]
 ---
 
 # Axiom 上下文管理 Skill

package/skills/ax-decompose/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-decompose
 description: "/ax-decompose — Axiom 任务拆解工作流：Rough PRD → 系统架构 → 原子任务 DAG → Manifest 清单"
-triggers: ["ax-decompose", "decompose task", "拆解任务", "任务拆解", "细化设计"]
 ---
 
 # Axiom 任务拆解工作流 (Phase 2)

package/skills/ax-draft/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-draft
 description: "/ax-draft — Axiom 需求起草工作流：需求澄清循环 → PRD 初稿生成 → 用户评审门禁"
-triggers: ["ax-draft", "draft requirement", "起草需求", "需求起草", "新需求"]
 ---
 
 # Axiom 需求起草工作流 (Phase 1)

package/skills/ax-evolution/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-evolution
 description: "/ax-evolution — Axiom 进化引擎触发：手动触发知识收割、模式检测和反思"
-triggers: ["ax-evolution", "evolution engine", "进化引擎", "查询知识库", "查询模式库"]
 ---
 
 # Axiom 进化引擎触发 Skill

package/skills/ax-evolve/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-evolve
 description: "/ax-evolve — Axiom 进化工作流：处理学习队列 → 更新知识库 → 模式检测 → 生成进化报告"
-triggers: ["ax-evolve", "evolve", "反思总结", "进化", "ax-reflect"]
 ---
 
 # Axiom 进化工作流

package/skills/ax-export/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-export
 description: "/ax-export — Axiom 系统导出：将 Axiom 配置打包为可移植 zip，支持模板模式和完整模式"
-triggers: ["ax-export", "export axiom", "导出系统", "axiom export"]
 ---
 
 # Axiom 系统导出

package/skills/ax-implement/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-implement
 description: "/ax-implement — Axiom 实施交付工作流：按 Manifest 顺序执行原子任务，含 CI 门禁和自动修复"
-triggers: ["ax-implement", "implement feature", "开始开发", "交付流水线", "ax implement"]
 ---
 
 # Axiom 实施交付工作流 (Phase 3)

package/skills/ax-knowledge/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-knowledge
 description: "/ax-knowledge — Axiom 知识查询：搜索知识库和模式库，返回相关条目"
-triggers: ["ax-knowledge", "knowledge query", "pattern query", "知识查询", "模式查询"]
 ---
 
 # Axiom 知识查询

package/skills/ax-reflect/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-reflect
 description: "/ax-reflect — Axiom 反思工作流：会话总结 → 经验提取 → Action Items → 知识入队"
-triggers: ["ax-reflect", "reflect", "反思", "总结", "session reflect"]
 ---
 
 # Axiom 反思工作流

package/skills/ax-review/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-review
 description: "/ax-review — Axiom 专家评审工作流：5专家并行评审 → 冲突仲裁 → Rough PRD 生成"
-triggers: ["ax-review", "expert review", "需求评审", "专家审查", "ax review"]
 ---
 
 # Axiom 专家评审工作流 (Phase 1.5)

package/skills/ax-rollback/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-rollback
 description: "/ax-rollback — Axiom 回滚工作流：回滚到最近检查点，恢复系统状态"
-triggers: ["ax-rollback", "rollback", "回滚", "恢复状态", "undo"]
 ---
 
 # Axiom 回滚工作流

package/skills/ax-status/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-status
 description: "/ax-status — Axiom 状态仪表盘：显示当前任务状态、进度、记忆摘要和系统健康"
-triggers: ["ax-status", "axiom status", "查看状态", "系统状态", "status"]
 ---
 
 # Axiom 状态仪表盘

package/skills/ax-suspend/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: ax-suspend
 description: "/ax-suspend — Axiom 暂停保存工作流：保存当前状态快照，安全退出会话"
-triggers: ["ax-suspend", "suspend", "暂停任务", "保存退出", "save and exit"]
 ---
 
 # Axiom 暂停保存工作流

package/skills/omc-doctor/SKILL.md

@@ -24,6 +24,53 @@ npm view @liangjie559567/ultrapower version 2>/dev/null || echo "Latest: (unavai
 - 已安装版本 != 最新版本：警告——插件已过时
 - 存在多个版本：警告——缓存陈旧
 
+### 第一步 bis：检查 npm-cache 复用问题
+
+检查插件缓存目录标注的版本号与实际内容是否一致：
+
+```bash
+node -e "
+const p=require('path'),f=require('fs'),h=require('os').homedir();
+const d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude');
+const b=p.join(d,'plugins','cache','omc','ultrapower');
+try {
+  const vs=f.readdirSync(b).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));
+  if(!vs.length){console.log('No cache versions found');process.exit();}
+  const latest=vs[vs.length-1];
+  const pkgPath=p.join(b,latest,'package.json');
+  if(f.existsSync(pkgPath)){
+    const pkg=JSON.parse(f.readFileSync(pkgPath,'utf-8'));
+    if(pkg.version!==latest){
+      console.log('MISMATCH: dir='+latest+' pkg.version='+pkg.version);
+      console.log('CAUSE: npm-cache reuse (semver range satisfied old version)');
+    } else {
+      console.log('OK: version matches ('+latest+')');
+    }
+  } else {
+    console.log('WARN: package.json not found in cache/'+latest);
+  }
+} catch(e){console.log('Error:',e.message);}
+"
+
+# 检查 npm-cache 中存储的 semver 范围
+node -e "
+const p=require('path'),f=require('fs'),h=require('os').homedir();
+const d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude');
+const npmCachePkg=p.join(d,'plugins','npm-cache','package.json');
+if(f.existsSync(npmCachePkg)){
+  const pkg=JSON.parse(f.readFileSync(npmCachePkg,'utf-8'));
+  const dep=pkg.dependencies&&pkg.dependencies['@liangjie559567/ultrapower'];
+  console.log('npm-cache range:',dep||'(not found)');
+} else {
+  console.log('npm-cache: not present (normal for fresh installs)');
+}
+"
+```
+
+**诊断**：
+- `MISMATCH: dir=X pkg.version=Y`：严重错误——npm-cache 复用导致旧内容被安装到新版本目录
+- npm-cache range 显示旧版本范围（如 `^5.0.11`）：警告——下次安装仍会复用旧缓存
+
 ### 第二步：检查 settings.json 中的旧版 hook
 
 读取 `~/.claude/settings.json`（用户级）和 `./.claude/settings.json`（项目级），检查是否存在包含以下条目的 `"hooks"` 键：
@@ -109,6 +156,7 @@ ls -la ~/.claude/skills/ 2>/dev/null
 | 检查项 | 状态 | 详情 |
 |-------|--------|---------|
 | 插件版本 | OK/WARN/CRITICAL | ... |
+| npm-cache 复用 | OK/WARN/CRITICAL | ... |
 | 旧版 Hook (settings.json) | OK/CRITICAL | ... |
 | 旧版脚本 (~/.claude/hooks/) | OK/WARN | ... |
 | CLAUDE.md | OK/WARN/CRITICAL | ... |
@@ -150,6 +198,21 @@ rm -f ~/.claude/hooks/stop-continuation.sh
 node -e "const p=require('path'),f=require('fs'),d=process.env.CLAUDE_CONFIG_DIR||p.join(require('os').homedir(),'.claude'),b=p.join(d,'plugins','cache','omc','ultrapower');try{f.rmSync(b,{recursive:true,force:true});console.log('Plugin cache cleared. Restart Claude Code to fetch latest version.')}catch{console.log('No plugin cache found')}"
 ```
 
+### 修复：npm-cache 复用（插件内容是旧版本）
+
+症状：插件缓存目录版本号与 `package.json` 内 `version` 字段不一致。
+
+```bash
+# 完整清洁重装（必须同时清除 npm-cache）
+claude plugin uninstall ultrapower
+rm -rf ~/.claude/plugins/npm-cache        # 关键：清除 semver 范围缓存
+rm -rf ~/.claude/plugins/cache/ultrapower
+claude plugin marketplace update ultrapower
+claude plugin install ultrapower
+```
+
+> ⚠️ 仅清除插件缓存不够——npm-cache 中的 `^` semver 范围会导致安装器继续复用旧内容。
+
 ### 修复：陈旧缓存（多个版本）
 ```bash
 # 仅保留最新版本（跨平台）

package/skills/omc-setup/SKILL.md

@@ -365,6 +365,23 @@ EOF
 node -e "const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude'),b=p.join(d,'plugins','cache','omc','ultrapower');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));if(v.length<=1){console.log('Cache is clean');process.exit()}v.slice(0,-1).forEach(x=>{f.rmSync(p.join(b,x),{recursive:true,force:true})});console.log('Cleared',v.length-1,'stale cache version(s)')}catch{console.log('No cache directory found (normal for new installs)')}"
 ```
 
+### 如果插件内容是旧版本（npm-cache 复用问题）
+
+**症状**：插件缓存目录标注为新版本号，但实际内容是旧版本（`package.json` 中 `version` 字段不匹配）。
+
+**原因**：`~/.claude/plugins/npm-cache/package.json` 使用 `^` semver 范围，Claude Code 安装器判断旧缓存满足范围后直接复用，不重新下载。
+
+**完整清洁重装**：
+```bash
+claude plugin uninstall ultrapower
+rm -rf ~/.claude/plugins/npm-cache        # 关键：必须清除 npm-cache
+rm -rf ~/.claude/plugins/cache/ultrapower
+claude plugin marketplace update ultrapower
+claude plugin install ultrapower
+```
+
+> ⚠️ 仅清除插件缓存不够，必须同时清除 `npm-cache`。
+
 ## 步骤 3.6：检查更新
 
 如果有新版本可用，通知用户：
@@ -712,6 +729,23 @@ EOF
 node -e "const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude'),b=p.join(d,'plugins','cache','omc','ultrapower');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));if(v.length<=1){console.log('Cache is clean');process.exit()}v.slice(0,-1).forEach(x=>{f.rmSync(p.join(b,x),{recursive:true,force:true})});console.log('Cleared',v.length-1,'stale cache version(s)')}catch{console.log('No cache directory found (normal for new installs)')}"
 ```
 
+### 如果插件内容是旧版本（npm-cache 复用问题）
+
+**症状**：插件缓存目录标注为新版本号，但实际内容是旧版本（`package.json` 中 `version` 字段不匹配）。
+
+**原因**：`~/.claude/plugins/npm-cache/package.json` 使用 `^` semver 范围，Claude Code 安装器判断旧缓存满足范围后直接复用，不重新下载。
+
+**完整清洁重装**：
+```bash
+claude plugin uninstall ultrapower
+rm -rf ~/.claude/plugins/npm-cache        # 关键：必须清除 npm-cache
+rm -rf ~/.claude/plugins/cache/ultrapower
+claude plugin marketplace update ultrapower
+claude plugin install ultrapower
+```
+
+> ⚠️ 仅清除插件缓存不够，必须同时清除 `npm-cache`。
+
 ## 步骤 3.6：检查更新
 
 如果有新版本可用，通知用户：

package/skills/release/SKILL.md

@@ -20,13 +20,18 @@ description: ultrapower 的自动化发布工作流
 按顺序执行以下步骤：
 
 ### 1. 版本升级
-在所有位置更新版本：
+在所有位置更新版本（**必须同步，缺一不可**）：
 - `package.json`
 - `src/installer/index.ts`（VERSION 常量）
 - `src/__tests__/installer.test.ts`（预期版本）
 - `.claude-plugin/plugin.json`
+- `.claude-plugin/marketplace.json`（`"version"` 和 `"source.version"` 两处）
+- `docs/CLAUDE.md`（`<!-- OMC:VERSION:X.Y.Z -->`）
 - `README.md`（版本徽章和标题）
 
+> ⚠️ `marketplace.json` 是安装器读取的入口，版本不同步会导致用户始终安装旧版本。
+> ⚠️ `docs/CLAUDE.md` 是 `/ultrapower:omc-setup` 下载的模板，版本不同步会导致用户安装后显示旧版本号。
+
 ### 2. 运行测试
 ```bash
 npm run test:run
@@ -46,17 +51,24 @@ git push origin main
 git push origin v<version>
 ```
 
-### 5. 发布到 npm
+### 5. 刷新本地 marketplace 缓存
+```bash
+claude plugin marketplace update ultrapower
+```
+> 推送到 GitHub 后必须执行此步，否则本地安装器仍读取旧版 `marketplace.json`。
+
+### 6. 发布到 npm
 ```bash
 npm publish --access public
 ```
+> ⚠️ npm 不允许覆盖已发布版本，版本号必须先升级再发布。
 
-### 6. 创建 GitHub Release
+### 7. 创建 GitHub Release
 ```bash
 gh release create v<version> --title "v<version> - <title>" --notes "<release notes>"
 ```
 
-### 7. 验证
+### 8. 验证
 - [ ] npm: https://www.npmjs.com/package/@liangjie559567/ultrapower
 - [ ] GitHub: https://github.com/liangjie559567/ultrapower/releases
 
@@ -68,6 +80,8 @@ gh release create v<version> --title "v<version> - <title>" --notes "<release no
 | `src/installer/index.ts` | `export const VERSION = 'X.Y.Z'` |
 | `src/__tests__/installer.test.ts` | `expect(VERSION).toBe('X.Y.Z')` |
 | `.claude-plugin/plugin.json` | `"version": "X.Y.Z"` |
+| `.claude-plugin/marketplace.json` | `"version": "X.Y.Z"` 和 `"source": { "version": "X.Y.Z" }` |
+| `docs/CLAUDE.md` | `<!-- OMC:VERSION:X.Y.Z -->` |
 | `README.md` | 标题 + 版本徽章 |
 
 ## 语义化版本
@@ -80,7 +94,104 @@ gh release create v<version> --title "v<version> - <title>" --notes "<release no
 
 - 发布前始终运行测试
 - 创建总结变更的发布说明
-- 插件市场从 GitHub releases 自动同步
+- 推送到 GitHub 后必须运行 `claude plugin marketplace update ultrapower` 刷新本地缓存
+- npm 不允许覆盖已发布版本，每次发布前必须升级版本号
+- `.npmignore` 必须排除缓存目录（`ultrapower/`、`*.tgz`、`.claude/`），防止安装时产生无限嵌套
+
+## .npmignore 必要内容
+
+发布前确认 `.npmignore` 包含以下排除项：
+
+```
+# 防止缓存目录被打包（会导致安装时无限嵌套）
+ultrapower/
+.claude/
+plugins/cache/
+*.tgz
+*.tar.gz
+node_modules/
+.git/
+dist/
+```
+
+## 故障排查
+
+### 安装后 skill 无法识别
+
+检查插件缓存路径是否正确：
+```bash
+ls ~/.claude/plugins/cache/ultrapower/ultrapower/<version>/skills/
+```
+正确路径应直接包含 `skills/`、`dist/` 等目录。
+
+### 缓存目录无限嵌套
+
+症状：`cache/ultrapower/ultrapower/5.x.x/ultrapower/5.x.x/ultrapower/...`
+
+原因：npm 包中包含了 `ultrapower/` 子目录（通常是缓存目录被打包进去）。
+
+修复步骤：
+```bash
+# 1. 卸载插件
+claude plugin uninstall ultrapower
+
+# 2. 清除缓存
+rm -rf ~/.claude/plugins/cache/ultrapower
+rm -rf ~/.claude/plugins/marketplaces/ultrapower
+
+# 3. 确认 .npmignore 已排除 ultrapower/ 目录
+
+# 4. 重新发布（需升级版本号）
+npm publish --access public
+
+# 5. 重新安装
+claude plugin install ultrapower
+```
+
+### 安装后仍是旧版本
+
+原因：本地 marketplace 缓存未更新，安装器读取的是旧版 `marketplace.json`。
+
+修复：
+```bash
+claude plugin marketplace update ultrapower
+claude plugin uninstall ultrapower
+claude plugin install ultrapower
+```
+
+### 安装后插件内容是旧版本（npm-cache 复用）
+
+症状：插件缓存目录标注为新版本号（如 `5.0.17/`），但 `package.json` 内的 `version` 字段仍是旧版本（如 `5.0.11`）。
+
+原因：`~/.claude/plugins/npm-cache/package.json` 中存储了 semver 范围（如 `"^5.0.11"`），Claude Code 安装器判断旧缓存满足该范围，直接复用旧文件而不重新下载。
+
+验证：
+```bash
+cat ~/.claude/plugins/npm-cache/package.json
+# 如果看到 "^5.0.11" 之类的旧版本范围，即为此问题
+cat ~/.claude/plugins/cache/ultrapower/ultrapower/5.0.17/package.json
+# 如果 version 字段不是 5.0.17，确认是 npm-cache 复用导致
+```
+
+修复（完整清洁重装）：
+```bash
+# 1. 卸载插件
+claude plugin uninstall ultrapower
+
+# 2. 清除 npm-cache（关键！仅清除插件缓存不够）
+rm -rf ~/.claude/plugins/npm-cache
+
+# 3. 清除插件缓存
+rm -rf ~/.claude/plugins/cache/ultrapower
+
+# 4. 刷新 marketplace 缓存
+claude plugin marketplace update ultrapower
+
+# 5. 重新安装（此时会强制从 npm 下载最新版）
+claude plugin install ultrapower
+```
+
+> ⚠️ 仅执行步骤 3（清除插件缓存）不够——npm-cache 仍会导致安装器复用旧内容。必须同时清除 npm-cache。
 
 ## 路由触发