@qilitt-mickey/vue3-temp-skill 1.0.8

package/bin/cli.js

@@ -0,0 +1,579 @@
+#!/usr/bin/env node
+
+/**
+ * vue3-temp-skill CLI
+ *
+ * 将 Vue 3 项目开发规范技能安装到指定 AI 工具
+ *
+ * 用法:
+ *   vue3-temp-skill install <target> [options]   安装到指定 AI 工具
+ *   vue3-temp-skill update [target] [options]     更新已安装的技能（默认更新全部已安装目标）
+ *   vue3-temp-skill uninstall [target] [options]  卸载已安装的技能（默认卸载全部）
+ *   vue3-temp-skill list                          查看已安装的目标
+ *   vue3-temp-skill --help                        帮助
+ *   vue3-temp-skill --version                     版本号
+ *
+ * 通过 npx / pnpx 使用时自动下载最新版本：
+ *   npx @qilitt/vue3-temp-skill@latest install cursor
+ *   npx @qilitt/vue3-temp-skill@latest update
+ */
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { execSync } = require("child_process");
+
+const HOME = os.homedir();
+// bin/cli.js → 上一级即包根目录
+const SKILL_DIR = path.resolve(__dirname, "..");
+const SKILL_NAME = "vue3-temp-skill";
+const TRACK_FILE = path.join(HOME, ".vue3-temp-skill.json");
+
+// ============================================================
+// 版本
+// ============================================================
+const PKG_VERSION = require(path.join(SKILL_DIR, "package.json")).version;
+
+// ============================================================
+// AI 工具配置
+// ============================================================
+const TARGETS = {
+  cursor: {
+    name: "Cursor",
+    dir: (p) => (p ? path.join(p, ".cursor/rules") : path.join(HOME, ".cursor/rules")),
+    type: "rules",
+  },
+  qoder: {
+    name: "Qoder",
+    dir: (p) => (p ? path.join(p, ".qoder/skills") : path.join(HOME, ".qoderworkcn/skills")),
+    type: "skills",
+  },
+  copilot: {
+    name: "GitHub Copilot",
+    file: (p) => path.join(p || ".", ".github/copilot-instructions.md"),
+    type: "merge",
+  },
+  windsurf: {
+    name: "Windsurf",
+    dir: (p) => (p ? path.join(p, ".windsurf/rules") : path.join(HOME, ".windsurf/rules")),
+    type: "rules",
+  },
+  gemini: {
+    name: "Gemini CLI",
+    file: (p) => path.join(p || ".", "GEMINI.md"),
+    type: "merge",
+  },
+  trae: {
+    name: "Trae",
+    dir: (p) => (p ? path.join(p, ".trae/rules") : path.join(HOME, ".trae/rules")),
+    type: "rules",
+  },
+  claude: {
+    name: "Claude Code",
+    dir: (p) => (p ? path.join(p, ".claude/skills") : path.join(HOME, ".claude/skills")),
+    type: "skills",
+  },
+  universal: {
+    name: "Universal",
+    dir: (p) => path.join(p || ".", ".agents/skills"),
+    type: "skills",
+  },
+};
+
+// ============================================================
+// 样式
+// ============================================================
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+
+// ============================================================
+// 工具函数
+// ============================================================
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+/**
+ * 复制单个文件
+ */
+function copyFile(src, dest) {
+  if (fs.existsSync(src)) {
+    fs.copyFileSync(src, dest);
+  }
+}
+
+/**
+ * 复制目录（仅用于 references/ 等已知安全的小目录）
+ */
+function copyDir(src, dest) {
+  ensureDir(dest);
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (entry.name.startsWith(".") || entry.isSymbolicLink()) continue;
+    const s = path.join(src, entry.name);
+    const d = path.join(dest, entry.name);
+    if (entry.isDirectory()) copyDir(s, d);
+    else fs.copyFileSync(s, d);
+  }
+}
+
+function removeDir(dir) {
+  if (!fs.existsSync(dir)) return;
+  try {
+    if (process.platform === "win32") {
+      // Windows: rd /s /q 使用系统 API 删除，不受 Node.js 调用栈限制
+      execSync(`rd /s /q "${dir}"`, { stdio: "ignore" });
+    } else {
+      execSync(`rm -rf "${dir}"`, { stdio: "ignore" });
+    }
+  } catch {
+    // 兜底：尝试 Node.js 原生方法
+    try {
+      fs.rmSync(dir, { recursive: true, force: true });
+    } catch {
+      // 静默失败，目录可能已被删除
+    }
+  }
+}
+
+/**
+ * 读取技能完整内容：SKILL.md + references/*.md
+ */
+function readFullSkill() {
+  let content = "";
+
+  const skillMd = path.join(SKILL_DIR, "SKILL.md");
+  if (fs.existsSync(skillMd)) content += fs.readFileSync(skillMd, "utf-8");
+
+  const refsDir = path.join(SKILL_DIR, "references");
+  if (fs.existsSync(refsDir)) {
+    for (const f of fs.readdirSync(refsDir).filter((f) => f.endsWith(".md")).sort()) {
+      content += `\n\n---\n\n${fs.readFileSync(path.join(refsDir, f), "utf-8")}`;
+    }
+  }
+  return content;
+}
+
+// ============================================================
+// 安装记录（用于 update / list / uninstall）
+// ============================================================
+
+function readTrack() {
+  try {
+    return JSON.parse(fs.readFileSync(TRACK_FILE, "utf-8"));
+  } catch {
+    return { installed: [], version: "" };
+  }
+}
+
+function writeTrack(data) {
+  fs.writeFileSync(TRACK_FILE, JSON.stringify(data, null, 2), "utf-8");
+}
+
+function recordInstall(targetKey, projectDir) {
+  const track = readTrack();
+  const key = projectDir ? `${targetKey}@${projectDir}` : targetKey;
+  if (!track.installed.includes(key)) {
+    track.installed.push(key);
+  }
+  track.version = PKG_VERSION;
+  track.updatedAt = new Date().toISOString();
+  writeTrack(track);
+}
+
+function recordUninstall(targetKey, projectDir) {
+  const track = readTrack();
+  const key = projectDir ? `${targetKey}@${projectDir}` : targetKey;
+  track.installed = track.installed.filter((k) => k !== key);
+  writeTrack(track);
+}
+
+// ============================================================
+// 安装逻辑
+// ============================================================
+
+/**
+ * rules 类型：Cursor / Windsurf / Trae
+ */
+function installRules(targetKey, projectDir) {
+  const cfg = TARGETS[targetKey];
+  const targetDir = cfg.dir(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");
+}
+
+/**
+ * skills 类型：Qoder / Claude / Universal
+ */
+function installSkills(targetKey, projectDir) {
+  const cfg = TARGETS[targetKey];
+  const targetDir = cfg.dir(projectDir);
+  const dest = path.join(targetDir, SKILL_NAME);
+
+  // 先清理旧版本
+  if (fs.existsSync(dest)) {
+    removeDir(dest);
+  }
+
+  // 只复制必要文件，不复制整个包目录（避免缓存目录中的无关文件导致递归）
+  ensureDir(dest);
+  copyFile(path.join(SKILL_DIR, "SKILL.md"), path.join(dest, "SKILL.md"));
+  copyFile(path.join(SKILL_DIR, "README.md"), path.join(dest, "README.md"));
+
+  const refsSrc = path.join(SKILL_DIR, "references");
+  if (fs.existsSync(refsSrc)) {
+    copyDir(refsSrc, path.join(dest, "references"));
+  }
+}
+
+/**
+ * merge 类型：Copilot / Gemini
+ */
+function installMerge(targetKey, projectDir) {
+  const cfg = TARGETS[targetKey];
+  const targetFile = cfg.file(projectDir);
+  ensureDir(path.dirname(targetFile));
+
+  const content = readFullSkill();
+  fs.writeFileSync(targetFile, content, "utf-8");
+}
+
+function installTarget(targetKey, projectDir) {
+  const cfg = TARGETS[targetKey];
+  if (cfg.type === "rules") installRules(targetKey, projectDir);
+  else if (cfg.type === "skills") installSkills(targetKey, projectDir);
+  else if (cfg.type === "merge") installMerge(targetKey, projectDir);
+
+  recordInstall(targetKey, projectDir);
+}
+
+// ============================================================
+// 卸载逻辑
+// ============================================================
+
+function uninstallTarget(targetKey, projectDir) {
+  const cfg = TARGETS[targetKey];
+
+  if (cfg.type === "rules") {
+    const targetDir = cfg.dir(projectDir);
+    const ext = targetKey === "cursor" ? ".mdc" : ".md";
+    const file = path.join(targetDir, `${SKILL_NAME}${ext}`);
+    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);
+  } else if (cfg.type === "merge") {
+    const targetFile = cfg.file(projectDir);
+    if (fs.existsSync(targetFile)) fs.unlinkSync(targetFile);
+  }
+
+  recordUninstall(targetKey, projectDir);
+}
+
+// ============================================================
+// CLI 命令
+// ============================================================
+
+function showHelp() {
+  console.log(`
+${bold("vue3-temp-skill")} v${PKG_VERSION}
+Vue 3 企业级中后台项目开发规范技能包
+
+${bold("用法:")}
+  vue3-temp-skill <command> [target] [options]
+
+${bold("命令:")}
+  install <target>    安装技能到指定 AI 工具
+  update [target]     更新已安装的技能（默认更新全部已安装目标）
+  uninstall [target]  卸载技能（默认卸载全部已安装目标）
+  list                查看已安装的目标和版本
+
+${bold("目标 (target):")}
+  cursor       → Cursor
+  qoder        → Qoder
+  copilot      → GitHub Copilot
+  windsurf     → Windsurf
+  gemini       → Gemini CLI
+  trae         → Trae
+  claude       → Claude Code
+  universal    → 通用标准 (.agents/skills/)
+  all          → 安装到所有支持的工具
+
+${bold("选项:")}
+  --project <dir>   安装到指定项目目录（默认全局安装）
+  --help, -h        显示帮助
+  --version, -v     显示版本号
+
+${bold("示例:")}
+  ${dim("# 安装到 Cursor")}
+  npx @qilitt/vue3-temp-skill install cursor
+
+  ${dim("# 安装到 Qoder（指定项目）")}
+  npx @qilitt/vue3-temp-skill install qoder --project ./my-app
+
+  ${dim("# 更新所有已安装的目标（搭配 @latest 拉取最新版）")}
+  npx @qilitt/vue3-temp-skill@latest update
+
+  ${dim("# 查看已安装情况")}
+  npx @qilitt/vue3-temp-skill list
+
+  ${dim("# 卸载")}
+  npx @qilitt/vue3-temp-skill uninstall cursor
+`);
+}
+
+function showVersion() {
+  console.log(PKG_VERSION);
+}
+
+function cmdInstall(target, projectDir) {
+  if (!target) {
+    console.error(red("✗ 请指定安装目标，例如: vue3-temp-skill install cursor"));
+    console.error("运行 vue3-temp-skill --help 查看所有支持的目标");
+    process.exit(1);
+  }
+
+  if (target === "all") {
+    const total = Object.keys(TARGETS).length;
+    let success = 0;
+    const failed = [];
+    for (const key of Object.keys(TARGETS)) {
+      try {
+        installTarget(key, projectDir);
+        success++;
+      } catch (err) {
+        failed.push(TARGETS[key].name);
+      }
+    }
+    if (failed.length === 0) {
+      console.log(green(`✓ 已安装到全部 ${total} 个工具 (v${PKG_VERSION})`));
+    } else {
+      console.log(yellow(`✓ 安装完成: ${success}/${total} 成功`));
+      console.log(red(`  ✗ 失败: ${failed.join(", ")}`));
+    }
+  } else if (TARGETS[target]) {
+    try {
+      installTarget(target, projectDir);
+      console.log(green(`✓ 已安装到 ${TARGETS[target].name} (v${PKG_VERSION})`));
+    } catch (err) {
+      console.error(red(`✗ 安装失败: ${err.message}`));
+      process.exit(1);
+    }
+  } else {
+    console.error(red(`✗ 未知目标: ${target}`));
+    console.error("运行 vue3-temp-skill --help 查看支持的目标");
+    process.exit(1);
+  }
+}
+
+function cmdUpdate(target, projectDir) {
+  const track = readTrack();
+
+  if (track.installed.length === 0) {
+    console.log(yellow("当前没有已安装的目标，请先运行 install 命令"));
+    process.exit(0);
+  }
+
+  // 如果指定了目标，只更新该目标
+  if (target) {
+    if (target !== "all" && !TARGETS[target]) {
+      console.error(red(`✗ 未知目标: ${target}`));
+      process.exit(1);
+    }
+    const targets = target === "all" ? Object.keys(TARGETS) : [target];
+    let success = 0;
+    const failed = [];
+    for (const key of targets) {
+      try {
+        installTarget(key, projectDir);
+        success++;
+      } catch (err) {
+        failed.push(TARGETS[key].name);
+      }
+    }
+    if (failed.length === 0) {
+      console.log(green(`✓ 已更新到 v${PKG_VERSION}`));
+    } else {
+      console.log(yellow(`✓ 更新完成: ${success}/${targets.length} 成功`));
+      console.log(red(`  ✗ 失败: ${failed.join(", ")}`));
+    }
+    return;
+  }
+
+  // 默认更新全部已安装目标
+  let success = 0;
+  const failed = [];
+  for (const entry of track.installed) {
+    const [targetKey, projDir] = entry.includes("@")
+      ? [entry.split("@")[0], entry.split("@").slice(1).join("@")]
+      : [entry, null];
+
+    if (!TARGETS[targetKey]) continue;
+
+    try {
+      installTarget(targetKey, projDir || projectDir);
+      success++;
+    } catch (err) {
+      failed.push(TARGETS[targetKey].name);
+    }
+  }
+  if (failed.length === 0) {
+    console.log(green(`✓ 已更新 ${success} 个工具到 v${PKG_VERSION}`));
+  } else {
+    console.log(yellow(`✓ 更新完成: ${success}/${track.installed.length} 成功`));
+    console.log(red(`  ✗ 失败: ${failed.join(", ")}`));
+  }
+}
+
+function cmdUninstall(target, projectDir) {
+  const track = readTrack();
+
+  if (target) {
+    if (target !== "all" && !TARGETS[target]) {
+      console.error(red(`✗ 未知目标: ${target}`));
+      process.exit(1);
+    }
+    const targets = target === "all" ? Object.keys(TARGETS) : [target];
+    let success = 0;
+    const failed = [];
+    for (const key of targets) {
+      try {
+        uninstallTarget(key, projectDir);
+        success++;
+      } catch (err) {
+        failed.push(TARGETS[key].name);
+      }
+    }
+    if (target === "all") {
+      if (failed.length === 0) {
+        console.log(green(`✓ 已卸载全部 ${success} 个工具`));
+      } else {
+        console.log(yellow(`✓ 卸载完成: ${success}/${targets.length} 成功`));
+        console.log(red(`  ✗ 失败: ${failed.join(", ")}`));
+      }
+    } else {
+      if (failed.length === 0) {
+        console.log(green(`✓ 已卸载 ${TARGETS[target].name}`));
+      } else {
+        console.error(red(`✗ 卸载失败: ${failed.join(", ")}`));
+      }
+    }
+    return;
+  }
+
+  // 默认卸载全部
+  if (track.installed.length === 0) {
+    console.log(yellow("当前没有已安装的目标"));
+    return;
+  }
+
+  let success = 0;
+  for (const entry of track.installed) {
+    const [targetKey, projDir] = entry.includes("@")
+      ? [entry.split("@")[0], entry.split("@").slice(1).join("@")]
+      : [entry, null];
+
+    if (TARGETS[targetKey]) {
+      try {
+        uninstallTarget(targetKey, projDir || projectDir);
+        success++;
+      } catch {
+        // 静默
+      }
+    }
+  }
+  writeTrack({ installed: [], version: "", updatedAt: "" });
+  console.log(green(`✓ 已卸载全部 ${success} 个工具`));
+}
+
+function cmdList() {
+  const track = readTrack();
+
+  console.log(bold(`\nvue3-temp-skill v${track.version || "未安装"}`));
+  console.log(dim(`记录文件: ${TRACK_FILE}\n`));
+
+  if (track.installed.length === 0) {
+    console.log(yellow("当前没有已安装的目标"));
+    return;
+  }
+
+  console.log(bold("已安装的目标:"));
+  for (const entry of track.installed) {
+    const [targetKey, projDir] = entry.includes("@")
+      ? [entry.split("@")[0], entry.split("@").slice(1).join("@")]
+      : [entry, null];
+
+    const cfg = TARGETS[targetKey];
+    const name = cfg ? cfg.name : targetKey;
+    const scope = projDir ? ` (项目: ${projDir})` : " (全局)";
+    console.log(`  ${green("•")} ${name}${scope}`);
+  }
+
+  if (track.updatedAt) {
+    console.log(dim(`\n最后更新: ${track.updatedAt}`));
+  }
+}
+
+// ============================================================
+// 入口
+// ============================================================
+
+function main() {
+  const args = process.argv.slice(2);
+
+  if (!args.length || args.includes("--help") || args.includes("-h")) {
+    showHelp();
+    process.exit(0);
+  }
+
+  if (args.includes("--version") || args.includes("-v")) {
+    showVersion();
+    process.exit(0);
+  }
+
+  const command = args[0];
+  const target = args[1];
+  const projectIdx = args.indexOf("--project");
+  const projectDir = projectIdx !== -1 ? path.resolve(args[projectIdx + 1]) : null;
+
+  switch (command) {
+    case "install":
+      cmdInstall(target, projectDir);
+      break;
+    case "update":
+      cmdUpdate(target === "--project" ? null : target, projectDir);
+      break;
+    case "uninstall":
+      cmdUninstall(target === "--project" ? null : target, projectDir);
+      break;
+    case "list":
+      cmdList();
+      break;
+    default:
+      // 兼容旧用法：直接传 target 名当作 install
+      if (TARGETS[command] || command === "all") {
+        cmdInstall(command, projectDir);
+      } else {
+        console.error(red(`✗ 未知命令: ${command}`));
+        console.error("运行 vue3-temp-skill --help 查看帮助");
+        process.exit(1);
+      }
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@qilitt-mickey/vue3-temp-skill",
+  "version": "1.0.8",
+  "description": "Vue 3 企业级中后台项目开发规范技能包 — 让 AI 编程助手按照团队规范生成代码，并自动审查代码质量",
+  "bin": {
+    "vue3-temp-skill": "./bin/cli.js"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "bin/",
+    "references/",
+    "SKILL.md",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "release": "node release.js",
+    "release:minor": "node release.js minor",
+    "release:major": "node release.js major",
+    "postpublish": "echo 'Published @qilitt-mickey/vue3-temp-skill to npmjs.org'"
+  },
+  "keywords": [
+    "vue3",
+    "skill",
+    "ai",
+    "code-generation",
+    "enterprise",
+    "typescript",
+    "element-plus",
+    "vant",
+    "pinia",
+    "vite"
+  ],
+  "author": "qilitt",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/ai-skills-collection/vue3-temp-skill"
+  },
+  "homepage": "https://gitee.com/ai-skills-collection/vue3-temp-skill#readme"
+}