mdk-skills 2.4.19 → 2.4.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdk-skills",
-  "version": "2.4.19",
+  "version": "2.4.21",
   "description": "mdk-engineer - 沉稳靠谱的前端开发助手 Claude Skills 配置包，一键注入 .claude/ 技能目录和 CLAUDE.md 人设配置",
   "author": "XiaoMa",
   "license": "MIT",

package/scripts/cli.js

@@ -2,7 +2,7 @@
 
 const fs = require("fs");
 const path = require("path");
-const { getPackageSkills, getUserSkills, getSkillsSource, backupDir, listSkillDirs } = require("./core");
+const { getPackageSkills, getUserSkills, getSkillsSource, backupDir, listSkillDirs, copyDir } = require("./core");
 
 // npx 运行时：process.cwd() 是用户项目目录
 // __dirname 是包内 scripts/ 目录
@@ -14,31 +14,44 @@ const projectRoot = (() => {
     return process.cwd();
   }
 })();
-let skillsSource = getSkillsSource(projectRoot);
-const claudeDest = path.join(projectRoot, ".claude");
-const skillsDest = path.join(claudeDest, "skills");
-const settingsPath = path.join(claudeDest, "settings.json");
-const pkgSkillsSource = skillsSource
-  ? path.join(skillsSource, ".claude", "skills")
-  : null;
+
+let skillsSource;
+let claudeDest;
+let skillsDest;
+let settingsPath;
+let pkgSkillsSource;
+
+async function pathExists(p) {
+  try { await fs.promises.access(p); return true; } catch { return false; }
+}
+
+async function initPaths() {
+  skillsSource = await getSkillsSource(projectRoot);
+  claudeDest = path.join(projectRoot, ".claude");
+  skillsDest = path.join(claudeDest, "skills");
+  settingsPath = path.join(claudeDest, "settings.json");
+  pkgSkillsSource = skillsSource
+    ? path.join(skillsSource, ".claude", "skills")
+    : null;
+}
 
 // ---------- 文件写入 ----------
 
-function readSettings() {
-  if (!fs.existsSync(settingsPath))
+async function readSettings() {
+  if (!(await pathExists(settingsPath)))
     return { skills: {}, always_apply_skills: [] };
   try {
-    return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+    return JSON.parse(await fs.promises.readFile(settingsPath, "utf-8"));
   } catch {
     return { skills: {}, always_apply_skills: [] };
   }
 }
 
-function writeSettings(settings) {
-  if (!fs.existsSync(claudeDest)) {
-    fs.mkdirSync(claudeDest, { recursive: true });
+async function writeSettings(settings) {
+  if (!(await pathExists(claudeDest))) {
+    await fs.promises.mkdir(claudeDest, { recursive: true });
   }
-  fs.writeFileSync(
+  await fs.promises.writeFile(
     settingsPath,
     JSON.stringify(settings, null, 2) + "\n",
     "utf-8",
@@ -47,52 +60,35 @@ function writeSettings(settings) {
 
 // ---------- 安装勾选的技能 ----------
 
-// 手动递归拷贝目录，绕开 Windows 中文路径下 fs.cpSync({ recursive: true }) 死锁的 bug
-function copyDirSync(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const item of fs.readdirSync(src)) {
-    const srcPath = path.join(src, item);
-    const destPath = path.join(dest, item);
-    if (fs.statSync(srcPath).isDirectory()) {
-      copyDirSync(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
+async function installSelectedSkills(selectedNames) {
+  if (!(await pathExists(skillsDest))) {
+    await fs.promises.mkdir(skillsDest, { recursive: true });
   }
-}
 
-function installSelectedSkills(selectedNames) {
-  // 创建 .claude/ 和 skills/ 目录
-  if (!fs.existsSync(skillsDest)) {
-    fs.mkdirSync(skillsDest, { recursive: true });
-  }
-
-  const allPkgSkills = listSkillDirs(pkgSkillsSource);  let installedCount = 0;
+  const allPkgSkills = await listSkillDirs(pkgSkillsSource);
+  let installedCount = 0;
 
   for (const name of allPkgSkills) {
     const src = path.join(pkgSkillsSource, name);
     const dest = path.join(skillsDest, name);
 
     if (selectedNames.includes(name)) {
-      // 勾选了的 → 安装（不存在才装）
-      if (!fs.existsSync(dest)) {
+      if (!(await pathExists(dest))) {
         try {
-          copyDirSync(src, dest);
+          await copyDir(src, dest);
           installedCount++;
         } catch (err) {
           console.error(`  ❌ 安装技能 "${name}" 失败:`, err.message);
         }
       }
     } else {
-      // 没勾选的 → 如果之前装了，删掉
-      if (fs.existsSync(dest)) {
-        fs.rmSync(dest, { recursive: true, force: true });
+      if (await pathExists(dest)) {
+        await fs.promises.rm(dest, { recursive: true, force: true });
       }
     }
   }
 
-  // 生成 settings.json
-  const settings = readSettings();
+  const settings = await readSettings();
   if (!settings.skills) settings.skills = {};
 
   for (const name of allPkgSkills) {
@@ -103,21 +99,19 @@ function installSelectedSkills(selectedNames) {
     settings.skills[name].enabled = enabled;
   }
 
-  writeSettings(settings);
+  await writeSettings(settings);
 
-  // 安装 CLAUDE.md（没有才装）
   const mdSource = path.join(skillsSource, "CLAUDE.md");
   const mdDest = path.join(projectRoot, "CLAUDE.md");
-  if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
-    fs.copyFileSync(mdSource, mdDest);
+  if (await pathExists(mdSource) && !(await pathExists(mdDest))) {
+    await fs.promises.copyFile(mdSource, mdDest);
     console.log("  📝 CLAUDE.md 已创建\n");
   }
 
-  // 复制 profiles.json 到项目
   const profilesSource = path.join(skillsSource, ".claude", "profiles.json");
   const profilesDest = path.join(claudeDest, "profiles.json");
-  if (fs.existsSync(profilesSource) && !fs.existsSync(profilesDest)) {
-    fs.copyFileSync(profilesSource, profilesDest);
+  if (await pathExists(profilesSource) && !(await pathExists(profilesDest))) {
+    await fs.promises.copyFile(profilesSource, profilesDest);
   }
 
   return installedCount;
@@ -125,55 +119,50 @@ function installSelectedSkills(selectedNames) {
 
 // ---------- 场景选择（场景 → 一键装技能） ----------
 
-function loadProfiles() {
+async function loadProfiles() {
   const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
-  if (!fs.existsSync(profilesPath)) return null;
+  if (!(await pathExists(profilesPath))) return null;
   try {
-    return JSON.parse(fs.readFileSync(profilesPath, "utf-8")).profiles;
+    return JSON.parse(await fs.promises.readFile(profilesPath, "utf-8")).profiles;
   } catch {
     return null;
   }
 }
 
-function applyProfile(profile) {
-  const pkgSkills = listSkillDirs(pkgSkillsSource);
-  const settings = readSettings();
+async function applyProfile(profile) {
+  const pkgSkills = await listSkillDirs(pkgSkillsSource);
+  const settings = await readSettings();
 
-  // 确定要启用的技能列表
   let selected;
   if (profile.skills === null) {
-    // null 表示"自定义"，不做操作，由调用方处理
     return;
   } else if (profile.skills.length === 0) {
     selected = [];
   } else {
-    // 只取包内实际存在的技能
     selected = profile.skills.filter((s) => pkgSkills.includes(s));
   }
 
-  // 装启用的、删禁用的
-  if (!fs.existsSync(skillsDest)) {
-    fs.mkdirSync(skillsDest, { recursive: true });
+  if (!(await pathExists(skillsDest))) {
+    await fs.promises.mkdir(skillsDest, { recursive: true });
   }
   for (const name of pkgSkills) {
     const src = path.join(pkgSkillsSource, name);
     const dest = path.join(skillsDest, name);
     if (selected.includes(name)) {
-      if (!fs.existsSync(dest)) {
+      if (!(await pathExists(dest))) {
         try {
-          copyDirSync(src, dest);
+          await copyDir(src, dest);
         } catch (err) {
           console.error(`  ❌ 安装技能 "${name}" 失败:`, err.message);
         }
       }
     } else {
-      if (fs.existsSync(dest)) {
-        fs.rmSync(dest, { recursive: true, force: true });
+      if (await pathExists(dest)) {
+        await fs.promises.rm(dest, { recursive: true, force: true });
       }
     }
   }
 
-  // 更新 settings
   if (!settings.skills) settings.skills = {};
   for (const name of pkgSkills) {
     const enabled = selected.includes(name);
@@ -181,31 +170,26 @@ function applyProfile(profile) {
     settings.skills[name].enabled = enabled;
   }
 
-  // 更新 always_apply_skills
   if (profile.always_apply) {
     settings.always_apply_skills = profile.always_apply;
   }
 
-  // 记录当前活动场景
   settings._active_profile = profile.id;
-  writeSettings(settings);
+  await writeSettings(settings);
 
-  // 安装 CLAUDE.md（没有才装）
   const mdSource = path.join(skillsSource, "CLAUDE.md");
   const mdDest = path.join(projectRoot, "CLAUDE.md");
-  if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
-    fs.copyFileSync(mdSource, mdDest);
+  if (await pathExists(mdSource) && !(await pathExists(mdDest))) {
+    await fs.promises.copyFile(mdSource, mdDest);
     console.log("  📝 CLAUDE.md 已创建\n");
   }
 
-  // 复制 profiles.json 到项目（方便在项目里修改后 sync 推回）
   const profilesSource = path.join(skillsSource, ".claude", "profiles.json");
   const profilesDest = path.join(claudeDest, "profiles.json");
-  if (fs.existsSync(profilesSource)) {
-    fs.copyFileSync(profilesSource, profilesDest);
+  if (await pathExists(profilesSource)) {
+    await fs.promises.copyFile(profilesSource, profilesDest);
   }
 
-  // 输出结果
   const enabledCount = selected.length;
   const disabledCount = pkgSkills.length - enabledCount;
   console.log(`\n  ✅ 已切换到「${profile.name}」`);
@@ -215,10 +199,10 @@ function applyProfile(profile) {
 async function startSceneSelection() {
   const { select } = await import("@inquirer/prompts");
   const chalk = (await import("chalk")).default;
-  const profiles = loadProfiles();
-  const settings = readSettings();
+  const profiles = await loadProfiles();
+  const settings = await readSettings();
   const activeProfile = settings._active_profile;
-  const hasExistingInstall = fs.existsSync(claudeDest);
+  const hasExistingInstall = await pathExists(claudeDest);
 
   const choices = profiles.map((p) => {
     const isActive = p.id === activeProfile;
@@ -232,7 +216,6 @@ async function startSceneSelection() {
     };
   });
 
-  // 底部加个分隔
   choices.push(
     { name: chalk.dim("────────────────"), value: "__sep__", description: "" },
     { name: "  查看技能清单", value: "__list__", description: "列出所有技能状态" },
@@ -254,7 +237,6 @@ async function startSceneSelection() {
 
   if (selectedId === "__list__") {
     await cmdList();
-    // 看完列表再回到场景选择
     console.log("");
     return startSceneSelection();
   }
@@ -262,13 +244,11 @@ async function startSceneSelection() {
   const profile = profiles.find((p) => p.id === selectedId);
 
   if (profile.skills === null) {
-    // "自定义选择" → 跳到 checkbox
     await startInteractiveMenu();
     return;
   }
 
   if (profile.id === activeProfile) {
-    // 选的已经是当前场景，问要不要微调
     const { confirm } = await import("@inquirer/prompts");
     const tweak = await confirm({
       message: "已是当前场景，是否进入自定义模式微调技能？",
@@ -280,20 +260,20 @@ async function startSceneSelection() {
     return;
   }
 
-  applyProfile(profile);
+  await applyProfile(profile);
 }
 
 // ---------- 命令：list ----------
 
 async function cmdList() {
-  if (!fs.existsSync(claudeDest)) {
+  if (!(await pathExists(claudeDest))) {
     console.log("\n  ⚠️  尚未安装技能，请先运行 npx mdk-skills\n");
     return;
   }
 
   const chalk = (await import("chalk")).default;
-  const pkgSkills = getPackageSkills(skillsSource);
-  const userSkills = getUserSkills(claudeDest);
+  const pkgSkills = await getPackageSkills(skillsSource);
+  const userSkills = await getUserSkills(claudeDest);
 
   const skillMap = new Map();
   for (const s of userSkills) skillMap.set(s.name, s);
@@ -333,27 +313,25 @@ async function cmdList() {
 async function startInteractiveMenu() {
   const { checkbox } = await import("@inquirer/prompts");
 
-  if (!fs.existsSync(pkgSkillsSource)) {
+  if (!(await pathExists(pkgSkillsSource))) {
     console.log("  ⚠️  包内没有找到技能文件\n");
     return;
   }
 
-  const pkgSkills = getPackageSkills(skillsSource);
+  const pkgSkills = await getPackageSkills(skillsSource);
 
   if (pkgSkills.length === 0) {
     console.log("  ⚠️  没有可用技能\n");
     return;
   }
 
-  // 读取已安装状态：已装且启用的默认勾选
-  const userSkills = getUserSkills(claudeDest);
+  const userSkills = await getUserSkills(claudeDest);
   const enabledSet = new Set(
     userSkills.filter((s) => s.enabled).map((s) => s.name),
   );
   const installedSet = new Set(userSkills.map((s) => s.name));
 
-  // 首次运行全部默认勾选（省事），再次运行沿用已有状态
-  const hasExistingInstall = fs.existsSync(claudeDest);
+  const hasExistingInstall = await pathExists(claudeDest);
   const defaultChecked = hasExistingInstall
     ? enabledSet
     : new Set(pkgSkills.map((s) => s.name));
@@ -378,7 +356,7 @@ async function startInteractiveMenu() {
     (name) => !selected.includes(name),
   ).length;
 
-  const installed = installSelectedSkills(selected);
+  const installed = await installSelectedSkills(selected);
 
   const parts = [];
   if (newCount > 0) parts.push(`新装 ${newCount} 个`);
@@ -390,7 +368,7 @@ async function startInteractiveMenu() {
 
 // ---------- 本地源连接管理 ----------
 
-function cmdConnect(repoPath) {
+async function cmdConnect(repoPath) {
   if (!repoPath) {
     console.log("  ⚠️  用法：npx mdk-skills connect <仓库路径>\n");
     return;
@@ -398,20 +376,20 @@ function cmdConnect(repoPath) {
 
   repoPath = path.resolve(repoPath);
 
-  if (!fs.existsSync(path.join(repoPath, ".claude", "skills"))) {
+  if (!(await pathExists(path.join(repoPath, ".claude", "skills")))) {
     console.log(`  ❌ 路径 "${repoPath}" 下没有找到 .claude/skills/\n`);
     return;
   }
 
-  const settings = readSettings();
+  const settings = await readSettings();
   settings._skill_source = repoPath;
-  writeSettings(settings);
+  await writeSettings(settings);
 
   console.log(`  ✅ 技能目录已设置: ${repoPath}\n`);
 }
 
-function cmdSync() {
-  const settings = readSettings();
+async function cmdSync() {
+  const settings = await readSettings();
   const sourcePath = settings._skill_source;
 
   if (!sourcePath) {
@@ -419,58 +397,53 @@ function cmdSync() {
     return;
   }
 
-  if (!fs.existsSync(path.join(sourcePath, ".claude"))) {
+  if (!(await pathExists(path.join(sourcePath, ".claude")))) {
     console.log(`  ❌ 绑定的路径 "${sourcePath}" 已失效\n`);
     return;
   }
 
-  // 备份仓库旧内容
   const repoClaude = path.join(sourcePath, ".claude");
-  if (fs.existsSync(repoClaude)) {
-    backupDir(repoClaude);
+  if (await pathExists(repoClaude)) {
+    await backupDir(repoClaude);
   }
 
-  // 技能 → 反推到仓库
   const repoSkills = path.join(sourcePath, ".claude", "skills");
-  if (!fs.existsSync(repoSkills)) {
-    fs.mkdirSync(repoSkills, { recursive: true });
+  if (!(await pathExists(repoSkills))) {
+    await fs.promises.mkdir(repoSkills, { recursive: true });
   }
-  for (const name of listSkillDirs(skillsDest)) {
+  for (const name of await listSkillDirs(skillsDest)) {
     const src = path.join(skillsDest, name);
     const dest = path.join(repoSkills, name);
-    if (fs.existsSync(dest)) {
-      fs.rmSync(dest, { recursive: true, force: true });
+    if (await pathExists(dest)) {
+      await fs.promises.rm(dest, { recursive: true, force: true });
     }
-    copyDirSync(src, dest);
+    await copyDir(src, dest);
   }
 
-  // profiles.json → 反推
   const projectProfiles = path.join(claudeDest, "profiles.json");
-  if (fs.existsSync(projectProfiles)) {
-    fs.copyFileSync(projectProfiles, path.join(sourcePath, ".claude", "profiles.json"));
+  if (await pathExists(projectProfiles)) {
+    await fs.promises.copyFile(projectProfiles, path.join(sourcePath, ".claude", "profiles.json"));
   }
 
-  // settings.json → 反推（过滤掉 _skill_source 和 _active_profile）
   const cleanSettings = { ...settings };
   delete cleanSettings._skill_source;
   delete cleanSettings._active_profile;
-  fs.writeFileSync(
+  await fs.promises.writeFile(
     path.join(sourcePath, ".claude", "settings.json"),
     JSON.stringify(cleanSettings, null, 2) + "\n",
     "utf-8",
   );
 
-  // CLAUDE.md → 反推
   const projectMd = path.join(projectRoot, "CLAUDE.md");
-  if (fs.existsSync(projectMd)) {
-    fs.copyFileSync(projectMd, path.join(sourcePath, "CLAUDE.md"));
+  if (await pathExists(projectMd)) {
+    await fs.promises.copyFile(projectMd, path.join(sourcePath, "CLAUDE.md"));
   }
 
   console.log("  ✅ 已同步到仓库\n");
 }
 
-function cmdClearSource() {
-  const settings = readSettings();
+async function cmdClearSource() {
+  const settings = await readSettings();
   if (!settings._skill_source) {
     console.log("  ⚠️  当前未设置任何技能目录\n");
     return;
@@ -478,7 +451,7 @@ function cmdClearSource() {
 
   const oldPath = settings._skill_source;
   delete settings._skill_source;
-  writeSettings(settings);
+  await writeSettings(settings);
 
   console.log(`  ✅ 已清除技能目录设置: ${oldPath}\n`);
   console.log(`  💡 运行 npx mdk-skills ui 重新设置\n`);
@@ -489,15 +462,16 @@ function cmdClearSource() {
 const COMMANDS = ["list", "connect", "sync", "clear-source", "ui"];
 
 async function main() {
+  await initPaths();
+
   const command = process.argv[2];
   const args = process.argv.slice(3);
 
   if (!command) {
-    const profiles = loadProfiles();
+    const profiles = await loadProfiles();
     if (profiles) {
       await startSceneSelection();
     } else {
-      // 没有 profiles.json 时回退到原来的 checkbox
       await startInteractiveMenu();
     }
   } else if (command === "--help" || command === "-h") {
@@ -522,10 +496,10 @@ async function main() {
     npx mdk-skills ui
 `);
   } else if (command === "--connect") {
-    cmdConnect(args[0]);
-    skillsSource = getSkillsSource(projectRoot);
+    await cmdConnect(args[0]);
+    await initPaths();
     if (skillsSource) {
-      const profiles = loadProfiles();
+      const profiles = await loadProfiles();
       if (profiles) {
         await startSceneSelection();
       } else {
@@ -533,12 +507,12 @@ async function main() {
       }
     }
   } else if (command === "connect") {
-    cmdConnect(args[0]);
+    await cmdConnect(args[0]);
   } else if (command === "sync") {
     if (!skillsSource) { console.log("  ⚠️  未设置技能目录，请先运行 npx mdk-skills ui\n"); return; }
-    cmdSync();
+    await cmdSync();
   } else if (command === "clear-source") {
-    cmdClearSource();
+    await cmdClearSource();
   } else if (command === "ui") {
     require("./web-ui/server");
   } else {