@qilitt-mickey/vue3-temp-skill 1.0.9 → 1.0.12

package/README.md

@@ -75,18 +75,16 @@ AI 接收到请求后会自动完成：
 
 ### 安装到指定 AI 工具
 
-包已发布在 **npmjs.org**，直接安装即可，**无需** GitHub Token / 额外 registry 配置。
-
 ```bash
 # 通过 npx（推荐，自动使用最新版本）
 npx @qilitt-mickey/vue3-temp-skill@latest install cursor       # Cursor
 npx @qilitt-mickey/vue3-temp-skill@latest install qoder        # Qoder
-npx @qilitt-mickey/vue3-temp-skill@latest install copilot      # GitHub Copilot
+npx @qilitt-mickey/vue3-temp-skill@latest install copilot      # GitHub Copilot（项目级）
 npx @qilitt-mickey/vue3-temp-skill@latest install windsurf     # Windsurf
-npx @qilitt-mickey/vue3-temp-skill@latest install gemini       # Gemini CLI
+npx @qilitt-mickey/vue3-temp-skill@latest install gemini       # Gemini CLI（项目级）
 npx @qilitt-mickey/vue3-temp-skill@latest install trae         # Trae
 npx @qilitt-mickey/vue3-temp-skill@latest install claude       # Claude Code
-npx @qilitt-mickey/vue3-temp-skill@latest install universal    # 通用标准
+npx @qilitt-mickey/vue3-temp-skill@latest install universal    # 通用标准 ~/.agents/skills
 npx @qilitt-mickey/vue3-temp-skill@latest install all          # 安装到所有工具
 
 # 通过 pnpm
@@ -97,6 +95,21 @@ npm install -g @qilitt-mickey/vue3-temp-skill
 vue3-temp-skill install cursor
 ```
 
+### 安装位置说明
+
+| 目标 | 全局安装路径 | 项目安装（`--project`） |
+|------|-------------|------------------------|
+| cursor | `~/.cursor/skills/vue3-temp-skill/` | `<项目>/.cursor/skills/vue3-temp-skill/` |
+| claude | `~/.claude/skills/vue3-temp-skill/` | `<项目>/.claude/skills/vue3-temp-skill/` |
+| universal | `~/.agents/skills/vue3-temp-skill/` | `<项目>/.agents/skills/vue3-temp-skill/` |
+| qoder | `~/.qoderworkcn/skills/vue3-temp-skill/` | `<项目>/.qoder/skills/vue3-temp-skill/` |
+| windsurf | `~/.windsurf/rules/vue3-temp-skill.md` | `<项目>/.windsurf/rules/vue3-temp-skill.md` |
+| trae | `~/.trae/rules/vue3-temp-skill.md` | `<项目>/.trae/rules/vue3-temp-skill.md` |
+| copilot | 当前目录 `.github/copilot-instructions.md`（建议加 `--project`） | `<项目>/.github/copilot-instructions.md` |
+| gemini | 当前目录 `GEMINI.md`（建议加 `--project`） | `<项目>/GEMINI.md` |
+
+> **注意**：`install all` 默认写入用户主目录下的技能目录。Copilot / Gemini 是项目级配置，未加 `--project` 时会写到**你执行命令时的当前目录**，容易误以为「没装上」。
+
 > 若本机曾经配置过 `@qilitt:registry=https://npm.pkg.github.com`，请删除该配置，否则仍会走旧源并 401：  
 > `npm config delete @qilitt:registry`  
 > 并检查 `~/.npmrc` 中是否还有 `npm.pkg.github.com` 相关行。

package/bin/cli.js

@@ -40,8 +40,12 @@ const PKG_VERSION = require(path.join(SKILL_DIR, "package.json")).version;
 const TARGETS = {
   cursor: {
     name: "Cursor",
-    dir: (p) => (p ? path.join(p, ".cursor/rules") : path.join(HOME, ".cursor/rules")),
-    type: "rules",
+    // Cursor 技能目录：个人 ~/.cursor/skills，项目 .cursor/skills
+    dir: (p) => (p ? path.join(p, ".cursor/skills") : path.join(HOME, ".cursor/skills")),
+    type: "skills",
+    // 旧版曾安装到 .cursor/rules/*.mdc，安装/卸载时一并清理
+    legacyRulesFile: (p) =>
+      path.join(p ? path.join(p, ".cursor/rules") : path.join(HOME, ".cursor/rules"), `${SKILL_NAME}.mdc`),
   },
   qoder: {
     name: "Qoder",
@@ -50,8 +54,10 @@ const TARGETS = {
   },
   copilot: {
     name: "GitHub Copilot",
-    file: (p) => path.join(p || ".", ".github/copilot-instructions.md"),
+    // 仅项目级：必须指定 --project，否则相对当前工作目录
+    file: (p) => path.join(p || process.cwd(), ".github/copilot-instructions.md"),
     type: "merge",
+    projectOnly: true,
   },
   windsurf: {
     name: "Windsurf",
@@ -60,8 +66,10 @@ const TARGETS = {
   },
   gemini: {
     name: "Gemini CLI",
-    file: (p) => path.join(p || ".", "GEMINI.md"),
+    // 仅项目级：必须指定 --project，否则相对当前工作目录
+    file: (p) => path.join(p || process.cwd(), "GEMINI.md"),
     type: "merge",
+    projectOnly: true,
   },
   trae: {
     name: "Trae",
@@ -74,12 +82,23 @@ const TARGETS = {
     type: "skills",
   },
   universal: {
-    name: "Universal",
-    dir: (p) => path.join(p || ".", ".agents/skills"),
+    name: "Universal (.agents)",
+    // 全局 → ~/.agents/skills；项目 → <project>/.agents/skills
+    dir: (p) => (p ? path.join(p, ".agents/skills") : path.join(HOME, ".agents/skills")),
     type: "skills",
   },
 };
 
+/**
+ * 解析安装目标的可读路径（用于日志）
+ */
+function resolveTargetPath(targetKey, projectDir) {
+  const cfg = TARGETS[targetKey];
+  if (cfg.type === "merge") return cfg.file(projectDir);
+  if (cfg.type === "rules") return path.join(cfg.dir(projectDir), `${SKILL_NAME}.md`);
+  return path.join(cfg.dir(projectDir), SKILL_NAME);
+}
+
 // ============================================================
 // 样式
 // ============================================================
@@ -197,7 +216,7 @@ function recordUninstall(targetKey, projectDir) {
 // ============================================================
 
 /**
- * rules 类型：Cursor / Windsurf / Trae
+ * rules 类型：Windsurf / Trae
  */
 function installRules(targetKey, projectDir) {
   const cfg = TARGETS[targetKey];
@@ -205,19 +224,12 @@ function installRules(targetKey, projectDir) {
   ensureDir(targetDir);
 
   const content = readFullSkill();
-  const ext = targetKey === "cursor" ? ".mdc" : ".md";
-
-  const ruleContent =
-    targetKey === "cursor"
-      ? `---\ndescription: ${SKILL_NAME}\nglobs: **/*.vue,**/*.ts,**/*.js,**/*.tsx,**/*.jsx\nalwaysApply: true\n---\n\n${content}\n`
-      : content;
-
-  const file = path.join(targetDir, `${SKILL_NAME}${ext}`);
-  fs.writeFileSync(file, ruleContent, "utf-8");
+  const file = path.join(targetDir, `${SKILL_NAME}.md`);
+  fs.writeFileSync(file, content, "utf-8");
 }
 
 /**
- * skills 类型：Qoder / Claude / Universal
+ * skills 类型：Cursor / Qoder / Claude / Universal
  */
 function installSkills(targetKey, projectDir) {
   const cfg = TARGETS[targetKey];
@@ -238,6 +250,18 @@ function installSkills(targetKey, projectDir) {
   if (fs.existsSync(refsSrc)) {
     copyDir(refsSrc, path.join(dest, "references"));
   }
+
+  // Cursor：清理旧版 rules/*.mdc，避免与 skills 重复
+  if (cfg.legacyRulesFile) {
+    const legacy = cfg.legacyRulesFile(projectDir);
+    if (fs.existsSync(legacy)) {
+      try {
+        fs.unlinkSync(legacy);
+      } catch {
+        // 忽略清理失败
+      }
+    }
+  }
 }
 
 /**
@@ -259,6 +283,7 @@ function installTarget(targetKey, projectDir) {
   else if (cfg.type === "merge") installMerge(targetKey, projectDir);
 
   recordInstall(targetKey, projectDir);
+  return resolveTargetPath(targetKey, projectDir);
 }
 
 // ============================================================
@@ -270,13 +295,23 @@ function uninstallTarget(targetKey, projectDir) {
 
   if (cfg.type === "rules") {
     const targetDir = cfg.dir(projectDir);
-    const ext = targetKey === "cursor" ? ".mdc" : ".md";
-    const file = path.join(targetDir, `${SKILL_NAME}${ext}`);
+    const file = path.join(targetDir, `${SKILL_NAME}.md`);
     if (fs.existsSync(file)) fs.unlinkSync(file);
   } else if (cfg.type === "skills") {
     const targetDir = cfg.dir(projectDir);
     const dest = path.join(targetDir, SKILL_NAME);
     if (fs.existsSync(dest)) removeDir(dest);
+    // 同时清理 Cursor 旧版 rules
+    if (cfg.legacyRulesFile) {
+      const legacy = cfg.legacyRulesFile(projectDir);
+      if (fs.existsSync(legacy)) {
+        try {
+          fs.unlinkSync(legacy);
+        } catch {
+          // 忽略
+        }
+      }
+    }
   } else if (cfg.type === "merge") {
     const targetFile = cfg.file(projectDir);
     if (fs.existsSync(targetFile)) fs.unlinkSync(targetFile);
@@ -304,27 +339,30 @@ ${bold("命令:")}
   list                查看已安装的目标和版本
 
 ${bold("目标 (target):")}
-  cursor       → Cursor
-  qoder        → Qoder
-  copilot      → GitHub Copilot
-  windsurf     → Windsurf
-  gemini       → Gemini CLI
-  trae         → Trae
-  claude       → Claude Code
-  universal    → 通用标准 (.agents/skills/)
+  cursor       → Cursor          ~/.cursor/skills/
+  qoder        → Qoder           ~/.qoderworkcn/skills/
+  copilot      → GitHub Copilot  <项目>/.github/copilot-instructions.md（项目级）
+  windsurf     → Windsurf        ~/.windsurf/rules/
+  gemini       → Gemini CLI      <项目>/GEMINI.md（项目级）
+  trae         → Trae            ~/.trae/rules/
+  claude       → Claude Code     ~/.claude/skills/
+  universal    → 通用标准        ~/.agents/skills/
   all          → 安装到所有支持的工具
 
 ${bold("选项:")}
-  --project <dir>   安装到指定项目目录（默认全局安装）
+  --project <dir>   安装到指定项目目录（默认全局安装到用户主目录）
   --help, -h        显示帮助
   --version, -v     显示版本号
 
 ${bold("示例:")}
-  ${dim("# 安装到 Cursor")}
+  ${dim("# 安装到 Cursor（全局技能）")}
   npx @qilitt-mickey/vue3-temp-skill install cursor
 
-  ${dim("# 安装到 Qoder（指定项目）")}
-  npx @qilitt-mickey/vue3-temp-skill install qoder --project ./my-app
+  ${dim("# 安装到所有工具（全局）+ 当前目录的 Copilot/Gemini 项目文件")}
+  npx @qilitt-mickey/vue3-temp-skill install all
+
+  ${dim("# 安装到指定项目（含 .agents / Copilot / Gemini）")}
+  npx @qilitt-mickey/vue3-temp-skill install all --project ./my-app
 
   ${dim("# 更新所有已安装的目标（搭配 @latest 拉取最新版）")}
   npx @qilitt-mickey/vue3-temp-skill@latest update
@@ -341,6 +379,18 @@ function showVersion() {
   console.log(PKG_VERSION);
 }
 
+function warnProjectOnly(targetKey, projectDir) {
+  const cfg = TARGETS[targetKey];
+  if (cfg.projectOnly && !projectDir) {
+    console.log(
+      yellow(
+        `  ! ${cfg.name} 为项目级配置，已写入当前目录: ${resolveTargetPath(targetKey, null)}`
+      )
+    );
+    console.log(dim(`    建议: vue3-temp-skill install ${targetKey} --project <项目路径>`));
+  }
+}
+
 function cmdInstall(target, projectDir) {
   if (!target) {
     console.error(red("✗ 请指定安装目标，例如: vue3-temp-skill install cursor"));
@@ -352,14 +402,20 @@ function cmdInstall(target, projectDir) {
     const total = Object.keys(TARGETS).length;
     let success = 0;
     const failed = [];
+    console.log(bold(`\n安装 vue3-temp-skill v${PKG_VERSION} → 全部工具\n`));
     for (const key of Object.keys(TARGETS)) {
       try {
-        installTarget(key, projectDir);
+        const dest = installTarget(key, projectDir);
         success++;
+        console.log(green(`  ✓ ${TARGETS[key].name}`));
+        console.log(dim(`    → ${dest}`));
+        warnProjectOnly(key, projectDir);
       } catch (err) {
         failed.push(TARGETS[key].name);
+        console.log(red(`  ✗ ${TARGETS[key].name}: ${err.message}`));
       }
     }
+    console.log("");
     if (failed.length === 0) {
       console.log(green(`✓ 已安装到全部 ${total} 个工具 (v${PKG_VERSION})`));
     } else {
@@ -368,8 +424,10 @@ function cmdInstall(target, projectDir) {
     }
   } else if (TARGETS[target]) {
     try {
-      installTarget(target, projectDir);
+      const dest = installTarget(target, projectDir);
       console.log(green(`✓ 已安装到 ${TARGETS[target].name} (v${PKG_VERSION})`));
+      console.log(dim(`  → ${dest}`));
+      warnProjectOnly(target, projectDir);
     } catch (err) {
       console.error(red(`✗ 安装失败: ${err.message}`));
       process.exit(1);
@@ -521,7 +579,11 @@ function cmdList() {
     const cfg = TARGETS[targetKey];
     const name = cfg ? cfg.name : targetKey;
     const scope = projDir ? ` (项目: ${projDir})` : " (全局)";
-    console.log(`  ${green("•")} ${name}${scope}`);
+    const dest = cfg ? resolveTargetPath(targetKey, projDir) : "";
+    const exists = dest && fs.existsSync(dest);
+    const mark = exists ? green("•") : yellow("!");
+    console.log(`  ${mark} ${name}${scope}`);
+    if (dest) console.log(dim(`    ${dest}${exists ? "" : "  (文件不存在)"}`));
   }
 
   if (track.updatedAt) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qilitt-mickey/vue3-temp-skill",
-  "version": "1.0.9",
+  "version": "1.0.12",
   "description": "Vue 3 企业级中后台项目开发规范技能包 — 让 AI 编程助手按照团队规范生成代码，并自动审查代码质量",
   "bin": {
     "vue3-temp-skill": "./bin/cli.js"