@catcuts-skills/hello-world 1.0.5 → 1.0.7

package/README.md

@@ -70,15 +70,44 @@ npm test
 
 ### 卸载
 
+**重要**：由于 npm 的限制，全局卸载时 preuninstall hook 可能不会执行。请按照以下步骤正确卸载：
+
+#### 方式 1：使用 npm scripts（推荐）
+
 ```bash
 # 全局卸载
+npm run uninstall:global
 npm uninstall -g @catcuts-skills/hello-world
 
 # 项目级卸载
+npm run uninstall:local
 npm uninstall @catcuts-skills/hello-world
 ```
 
-卸载时会自动清理 skill 文件。
+#### 方式 2：手动清理（如果方式 1 失败）
+
+```bash
+# 1. 清理技能文件
+rm -rf ~/.claude/skills/hello-world
+rm -rf ~/.agents/skills/hello-world
+
+# 2. 卸载 npm 包
+npm uninstall -g @catcuts-skills/hello-world
+```
+
+**Windows PowerShell**:
+```powershell
+# 1. 清理技能文件
+Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\skills\hello-world"
+Remove-Item -Recurse -Force "$env:USERPROFILE\.agents\skills\hello-world"
+
+# 2. 卸载 npm 包
+npm uninstall -g @catcuts-skills/hello-world
+```
+
+#### 为什么需要两步？
+
+npm 的 `preuninstall` hook 在全局卸载时**不保证被执行**，这是 npm 的已知限制。因此需要先手动清理技能文件，再卸载 npm 包。
 
 ## 使用示例
 

package/package.json

@@ -1,14 +1,16 @@
 {
     "name": "@catcuts-skills/hello-world",
-    "version": "1.0.5",
+    "version": "1.0.7",
     "description": "简单的 Hello World 示例技能，用于验证技能安装是否成功。显示欢迎信息、环境信息和使用示例。",
     "main": "index.js",
     "scripts": {
         "postinstall": "node scripts/install-skill.js",
-        "preuninstall": "node scripts/uninstall-skill.js",
+        "preuninstall": "node scripts/uninstall-skill.js || exit 0",
         "test": "node scripts/install-skill.js --dry-run",
         "install:global": "node scripts/install-skill.js --global",
         "install:local": "node scripts/install-skill.js --local",
+        "uninstall:global": "node scripts/uninstall-skill.js --global",
+        "uninstall:local": "node scripts/uninstall-skill.js --local",
         "lint": "echo 'Add your linting commands here'"
     },
     "files": [

package/scripts/install-skill.js

@@ -84,7 +84,7 @@ function isSymlink(filePath) {
 function safeRemovePath(filePath, description) {
     try {
         if (!fs.existsSync(filePath)) {
-            return { success: true, removed: false, message: '不存在' };
+            return { success: true, removed: false, message: `不存在：${description}(${filePath})` };
         }
 
         const stats = fs.lstatSync(filePath);
@@ -96,28 +96,28 @@ function safeRemovePath(filePath, description) {
             return {
                 success: true,
                 removed: true,
-                message: `已删除符号链接: ${description}`
+                message: `已删除符号链接: ${description}(${filePath})`
             };
         } else if (isDir) {
             fs.rmSync(filePath, { recursive: true, force: true });
             return {
                 success: true,
                 removed: true,
-                message: `已删除目录: ${description}`
+                message: `已删除目录: ${description}(${filePath})`
             };
         } else {
             fs.unlinkSync(filePath);
             return {
                 success: true,
                 removed: true,
-                message: `已删除文件: ${description}`
+                message: `已删除文件: ${description}(${filePath})`
             };
         }
     } catch (error) {
         return {
             success: false,
             removed: false,
-            message: `删除失败: ${error.message}`
+            message: `删除失败: ${description}(${filePath}) - ${error.message}`
         };
     }
 }

package/scripts/uninstall-skill.js

@@ -53,7 +53,7 @@ function log(message, type = 'info') {
 function safeRemovePath(filePath, description) {
     try {
         if (!fs.existsSync(filePath)) {
-            return { success: true, removed: false, message: '不存在' };
+            return { success: true, removed: false, message: `已不存在：${description}(${filePath})` };
         }
 
         const stats = fs.lstatSync(filePath);
@@ -65,32 +65,32 @@ function safeRemovePath(filePath, description) {
             return {
                 success: true,
                 removed: true,
-                message: `已删除符号链接: ${description}`
+                message: `已删除符号链接: ${description}(${filePath})`
             };
         } else if (isDir) {
             fs.rmSync(filePath, { recursive: true, force: true });
             return {
                 success: true,
                 removed: true,
-                message: `已删除目录: ${description}`
+                message: `已删除目录: ${description}(${filePath})`
             };
         } else {
             fs.unlinkSync(filePath);
             return {
                 success: true,
                 removed: true,
-                message: `已删除文件: ${description}`
+                message: `已删除文件: ${description}(${filePath})`
             };
         }
     } catch (error) {
         // 忽略"文件不存在"错误，可能已被并发删除
         if (error.code === 'ENOENT') {
-            return { success: true, removed: false, message: '已不存在' };
+            return { success: true, removed: false, message: `已不存在：${description}(${filePath})` };
         }
         return {
             success: false,
             removed: false,
-            message: `删除失败: ${error.message}`
+            message: `删除失败: ${description}(${filePath}) - ${error.message}`
         };
     }
 }