mdk-skills 2.2.9 → 2.2.11

package/scripts/cli.js

@@ -1,554 +1,553 @@
 #!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-const { getPackageSkills, getUserSkills, getSkillsSource, backupDir } = require("./core");
-
-// npx 运行时：process.cwd() 是用户项目目录
-// __dirname 是包内 scripts/ 目录
-// 用 fs.realpathSync.native() 归一化 Windows 路径，处理中文/Unicode 编码问题
-const projectRoot = (() => {
-  try {
-    return fs.realpathSync.native(process.cwd());
-  } catch {
-    return process.cwd();
-  }
-})();
-const packageDir = path.join(__dirname, "..");
-let skillsSource = getSkillsSource(projectRoot, packageDir);
-const claudeDest = path.join(projectRoot, ".claude");
-const skillsDest = path.join(claudeDest, "skills");
-const settingsPath = path.join(claudeDest, "settings.json");
-const pkgSkillsSource = path.join(skillsSource, ".claude", "skills");
-
-// ---------- 文件写入 ----------
-
-function readSettings() {
-  if (!fs.existsSync(settingsPath))
-    return { skills: {}, always_apply_skills: [] };
-  try {
-    return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
-  } catch {
-    return { skills: {}, always_apply_skills: [] };
-  }
-}
-
-function writeSettings(settings) {
-  if (!fs.existsSync(claudeDest)) {
-    fs.mkdirSync(claudeDest, { recursive: true });
-  }
-  fs.writeFileSync(
-    settingsPath,
-    JSON.stringify(settings, null, 2) + "\n",
-    "utf-8",
-  );
-}
-
-// ---------- 安装勾选的技能 ----------
-
-// 手动递归拷贝目录，绕开 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);
-    }
-  }
-}
-
-function installSelectedSkills(selectedNames) {
-  // 创建 .claude/ 和 skills/ 目录
-  if (!fs.existsSync(skillsDest)) {
-    fs.mkdirSync(skillsDest, { recursive: true });
-  }
-
-  const allPkgSkills = fs.readdirSync(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)) {
-        try {
-          copyDirSync(src, dest);
-          installedCount++;
-        } catch (err) {
-          console.error(`  ❌ 安装技能 "${name}" 失败:`, err.message);
-        }
-      }
-    } else {
-      // 没勾选的 → 如果之前装了，删掉
-      if (fs.existsSync(dest)) {
-        fs.rmSync(dest, { recursive: true, force: true });
-      }
-    }
-  }
-
-  // 生成 settings.json
-  const settings = readSettings();
-  if (!settings.skills) settings.skills = {};
-
-  for (const name of allPkgSkills) {
-    const enabled = selectedNames.includes(name);
-    if (!settings.skills[name]) {
-      settings.skills[name] = {};
-    }
-    settings.skills[name].enabled = enabled;
-  }
-
-  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);
-    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);
-  }
-
-  return installedCount;
-}
-
-// ---------- 场景选择（场景 → 一键装技能） ----------
-
-function loadProfiles() {
-  const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
-  if (!fs.existsSync(profilesPath)) return null;
-  try {
-    return JSON.parse(fs.readFileSync(profilesPath, "utf-8")).profiles;
-  } catch {
-    return null;
-  }
-}
-
-function applyProfile(profile) {
-  const pkgSkills = fs.readdirSync(pkgSkillsSource);
-  const settings = 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 });
-  }
-  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)) {
-        try {
-          copyDirSync(src, dest);
-        } catch (err) {
-          console.error(`  ❌ 安装技能 "${name}" 失败:`, err.message);
-        }
-      }
-    } else {
-      if (fs.existsSync(dest)) {
-        fs.rmSync(dest, { recursive: true, force: true });
-      }
-    }
-  }
-
-  // 更新 settings
-  if (!settings.skills) settings.skills = {};
-  for (const name of pkgSkills) {
-    const enabled = selected.includes(name);
-    if (!settings.skills[name]) settings.skills[name] = {};
-    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);
-
-  // 安装 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);
-    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);
-  }
-
-  // 输出结果
-  const enabledCount = selected.length;
-  const disabledCount = pkgSkills.length - enabledCount;
-  console.log(`\n  ✅ 已切换到「${profile.name}」`);
-  console.log(`    启用 ${enabledCount} 个技能，停用 ${disabledCount} 个\n`);
-}
-
-async function startSceneSelection() {
-  const { select } = await import("@inquirer/prompts");
-  const chalk = (await import("chalk")).default;
-  const profiles = loadProfiles();
-  const settings = readSettings();
-  const activeProfile = settings._active_profile;
-  const hasExistingInstall = fs.existsSync(claudeDest);
-
-  const choices = profiles.map((p) => {
-    const isActive = p.id === activeProfile;
-    const prefix = isActive ? chalk.green("● ") : "  ";
-    return {
-      name: prefix + p.name,
-      value: p.id,
-      description: isActive
-        ? chalk.dim("当前场景 · ") + (p.description || "")
-        : p.description || "",
-    };
-  });
-
-  // 底部加个分隔
-  choices.push(
-    { name: chalk.dim("────────────────"), value: "__sep__", description: "" },
-    { name: "  查看技能清单", value: "__list__", description: "列出所有技能状态" },
-  );
-
-  const selectedId = await select({
-    message: hasExistingInstall
-      ? "选择开发场景（切换将自动调整技能）"
-      : "选择你的开发场景",
-    instructions: `(↑↓ 导航, Enter 确认)`,
-    choices,
-    pageSize: 10,
-    loop: false,
-  });
-
-  if (selectedId === "__sep__") {
-    return startSceneSelection();
-  }
-
-  if (selectedId === "__list__") {
-    await cmdList();
-    // 看完列表再回到场景选择
-    console.log("");
-    return 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: "已是当前场景，是否进入自定义模式微调技能？",
-      default: false,
-    });
-    if (tweak) {
-      await startInteractiveMenu();
-    }
-    return;
-  }
-
-  applyProfile(profile);
-}
-
-// ---------- 命令：list ----------
-
-async function cmdList() {
-  if (!fs.existsSync(claudeDest)) {
-    console.log("\n  ⚠️  尚未安装技能，请先运行 npx mdk-skills\n");
-    return;
-  }
-
-  const chalk = (await import("chalk")).default;
-  const pkgSkills = getPackageSkills(skillsSource);
-  const userSkills = getUserSkills(claudeDest);
-
-  const skillMap = new Map();
-  for (const s of userSkills) skillMap.set(s.name, s);
-  for (const s of pkgSkills) {
-    if (!skillMap.has(s.name)) {
-      skillMap.set(s.name, { ...s, enabled: false });
-    }
-  }
-
-  const allSkills = [...skillMap.values()];
-
-  console.log(`\n${chalk.bold("📋 mdk-skills 技能清单")}\n`);
-  console.log(
-    `  ${chalk.dim("状态        技能名                版本    描述")}`,
-  );
-  console.log(
-    `  ${chalk.dim("─────────────────────────────────────────────────────")}`,
-  );
-
-  for (const skill of allSkills) {
-    const status = skill.enabled ? chalk.green("● 启用") : chalk.gray("○ 停用");
-    const name = chalk.white(skill.name.padEnd(20));
-    const ver = chalk.dim(skill.version.padEnd(7));
-    const desc = skill.description
-      ? chalk.gray(skill.description)
-      : chalk.dim("(无描述)");
-    console.log(`  ${status}  ${name} ${ver} ${desc}`);
-  }
-
-  console.log(
-    `\n  ${chalk.cyan("💡")} ${chalk.dim("运行 npx mdk-skills 进入场景选择")}\n`,
-  );
-}
-
-// ---------- 交互式菜单（选完即装） ----------
-
-async function startInteractiveMenu() {
-  const { checkbox } = await import("@inquirer/prompts");
-
-  if (!fs.existsSync(pkgSkillsSource)) {
-    console.log("  ⚠️  包内没有找到技能文件\n");
-    return;
-  }
-
-  const pkgSkills = getPackageSkills(skillsSource);
-
-  if (pkgSkills.length === 0) {
-    console.log("  ⚠️  没有可用技能\n");
-    return;
-  }
-
-  // 读取已安装状态：已装且启用的默认勾选
-  const userSkills = 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 defaultChecked = hasExistingInstall
-    ? enabledSet
-    : new Set(pkgSkills.map((s) => s.name));
-
-  const choices = pkgSkills.map((s) => ({
-    name: s.name,
-    value: s.name,
-    description: s.description || undefined,
-    checked: defaultChecked.has(s.name),
-  }));
-
-  const selected = await checkbox({
-    message: "选择要安装的技能（未勾选的将从 .claude/ 中移除）",
-    instructions: "(↑↓ 导航, 空格 开关, Enter 确认)",
-    choices,
-    pageSize: 15,
-    loop: false,
-  });
-
-  const newCount = selected.filter((name) => !installedSet.has(name)).length;
-  const removedCount = [...installedSet].filter(
-    (name) => !selected.includes(name),
-  ).length;
-
-  const installed = installSelectedSkills(selected);
-
-  const parts = [];
-  if (newCount > 0) parts.push(`新装 ${newCount} 个`);
-  if (removedCount > 0) parts.push(`移除 ${removedCount} 个`);
-  const summary = parts.length > 0 ? `（${parts.join("，")}）` : "";
-
-  console.log(`\n  ✅ 技能安装完成 ${summary}\n`);
-}
-
-// ---------- 本地源连接管理 ----------
-
-function cmdConnect(repoPath) {
-  if (!repoPath) {
-    console.log("  ⚠️  用法：npx mdk-skills connect <仓库路径>\n");
-    return;
-  }
-
-  repoPath = path.resolve(repoPath);
-
-  if (!fs.existsSync(path.join(repoPath, ".claude", "skills"))) {
-    console.log(`  ❌ 路径 "${repoPath}" 下没有找到 .claude/skills/\n`);
-    return;
-  }
-
-  const settings = readSettings();
-  settings._skill_source = repoPath;
-  writeSettings(settings);
-
-  console.log(`  ✅ 已绑定技能源: ${repoPath}\n`);
-  console.log(`  💡 运行 npx mdk-skills 选择场景\n`);
-}
-
-function cmdSync() {
-  const settings = readSettings();
-  const sourcePath = settings._skill_source;
-
-  if (!sourcePath) {
-    console.log("  ⚠️  尚未绑定技能源\n");
-    return;
-  }
-
-  if (!fs.existsSync(path.join(sourcePath, ".claude"))) {
-    console.log(`  ❌ 绑定的路径 "${sourcePath}" 已失效\n`);
-    return;
-  }
-
-  // 备份仓库旧内容
-  const repoClaude = path.join(sourcePath, ".claude");
-  if (fs.existsSync(repoClaude)) {
-    backupDir(repoClaude);
-  }
-
-  // 技能 → 反推到仓库
-  const repoSkills = path.join(sourcePath, ".claude", "skills");
-  if (!fs.existsSync(repoSkills)) {
-    fs.mkdirSync(repoSkills, { recursive: true });
-  }
-  for (const name of fs.readdirSync(skillsDest)) {
-    const src = path.join(skillsDest, name);
-    const dest = path.join(repoSkills, name);
-    if (fs.existsSync(dest)) {
-      fs.rmSync(dest, { recursive: true, force: true });
-    }
-    copyDirSync(src, dest);
-  }
-
-  // profiles.json → 反推
-  const projectProfiles = path.join(claudeDest, "profiles.json");
-  if (fs.existsSync(projectProfiles)) {
-    fs.copyFileSync(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(
-    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"));
-  }
-
-  console.log("  ✅ 已同步到仓库\n");
-}
-
-function cmdDisconnect() {
-  const settings = readSettings();
-  if (!settings._skill_source) {
-    console.log("  ⚠️  当前未绑定任何技能源\n");
-    return;
-  }
-
-  const oldPath = settings._skill_source;
-  delete settings._skill_source;
-  writeSettings(settings);
-
-  console.log(`  ✅ 已断开技能源: ${oldPath}\n`);
-  console.log(`  💡 恢复为使用 npm 包内置技能\n`);
-}
-
-// ---------- 主入口 ----------
-
-const COMMANDS = ["list", "connect", "sync", "disconnect", "ui"];
-
-async function main() {
-  const command = process.argv[2];
-  const args = process.argv.slice(3);
-
-  if (!command) {
-    const profiles = loadProfiles();
-    if (profiles) {
-      await startSceneSelection();
-    } else {
-      // 没有 profiles.json 时回退到原来的 checkbox
-      await startInteractiveMenu();
-    }
-  } else if (command === "--help" || command === "-h") {
-    console.log(`
-  mdk-skills CLI
-
-  用法:
-    npx mdk-skills             场景选择 → 一键安装对应技能
-    npx mdk-skills list        查看已安装的技能
-    npx mdk-skills connect     绑定本地技能源仓库路径
-    npx mdk-skills sync        将项目中的技能修改推送到仓库
-    npx mdk-skills disconnect  解绑本地源，恢复使用 npm 包内置技能
-    npx mdk-skills ui          启动 Web 管理面板
-    npx mdk-skills --connect   绑定本地仓库后直接进入场景选择
-    npx mdk-skills --help      显示帮助
-
-  首次运行选择场景后自动配置技能和 CLAUDE.md
-  再次运行可切换场景或进入自定义模式微调
-
-  示例:
-    npx mdk-skills --connect D:/dev/mdk-skills
-    npx mdk-skills connect D:/dev/mdk-skills
-    npx mdk-skills sync
-    npx mdk-skills disconnect
-    npx mdk-skills
-    npx mdk-skills list
-`);
-  } else if (command === "--connect") {
-    cmdConnect(args[0]);
-    skillsSource = getSkillsSource(projectRoot, packageDir);
-    const profiles = loadProfiles();
-    if (profiles) {
-      await startSceneSelection();
-    } else {
-      await startInteractiveMenu();
-    }
-  } else if (command === "list") {
-    await cmdList();
-  } else if (command === "connect") {
-    cmdConnect(args[0]);
-  } else if (command === "sync") {
-    cmdSync();
-  } else if (command === "disconnect") {
-    cmdDisconnect();
-  } else if (command === "ui") {
-    require("./web-ui/server");
-  } else {
-    console.log(`  未知命令: ${command}\n  可用: ${COMMANDS.join(", ")}\n`);
-    process.exit(1);
-  }
-}
-
-main().catch(console.error);
+
+const fs = require("fs");
+const path = require("path");
+const { getPackageSkills, getUserSkills, getSkillsSource, backupDir, listSkillDirs } = require("./core");
+
+// npx 运行时：process.cwd() 是用户项目目录
+// __dirname 是包内 scripts/ 目录
+// 用 fs.realpathSync.native() 归一化 Windows 路径，处理中文/Unicode 编码问题
+const projectRoot = (() => {
+  try {
+    return fs.realpathSync.native(process.cwd());
+  } catch {
+    return process.cwd();
+  }
+})();
+const packageDir = path.join(__dirname, "..");
+let skillsSource = getSkillsSource(projectRoot, packageDir);
+const claudeDest = path.join(projectRoot, ".claude");
+const skillsDest = path.join(claudeDest, "skills");
+const settingsPath = path.join(claudeDest, "settings.json");
+const pkgSkillsSource = path.join(skillsSource, ".claude", "skills");
+
+// ---------- 文件写入 ----------
+
+function readSettings() {
+  if (!fs.existsSync(settingsPath))
+    return { skills: {}, always_apply_skills: [] };
+  try {
+    return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+  } catch {
+    return { skills: {}, always_apply_skills: [] };
+  }
+}
+
+function writeSettings(settings) {
+  if (!fs.existsSync(claudeDest)) {
+    fs.mkdirSync(claudeDest, { recursive: true });
+  }
+  fs.writeFileSync(
+    settingsPath,
+    JSON.stringify(settings, null, 2) + "\n",
+    "utf-8",
+  );
+}
+
+// ---------- 安装勾选的技能 ----------
+
+// 手动递归拷贝目录，绕开 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);
+    }
+  }
+}
+
+function installSelectedSkills(selectedNames) {
+  // 创建 .claude/ 和 skills/ 目录
+  if (!fs.existsSync(skillsDest)) {
+    fs.mkdirSync(skillsDest, { recursive: true });
+  }
+
+  const allPkgSkills = 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)) {
+        try {
+          copyDirSync(src, dest);
+          installedCount++;
+        } catch (err) {
+          console.error(`  ❌ 安装技能 "${name}" 失败:`, err.message);
+        }
+      }
+    } else {
+      // 没勾选的 → 如果之前装了，删掉
+      if (fs.existsSync(dest)) {
+        fs.rmSync(dest, { recursive: true, force: true });
+      }
+    }
+  }
+
+  // 生成 settings.json
+  const settings = readSettings();
+  if (!settings.skills) settings.skills = {};
+
+  for (const name of allPkgSkills) {
+    const enabled = selectedNames.includes(name);
+    if (!settings.skills[name]) {
+      settings.skills[name] = {};
+    }
+    settings.skills[name].enabled = enabled;
+  }
+
+  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);
+    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);
+  }
+
+  return installedCount;
+}
+
+// ---------- 场景选择（场景 → 一键装技能） ----------
+
+function loadProfiles() {
+  const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
+  if (!fs.existsSync(profilesPath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(profilesPath, "utf-8")).profiles;
+  } catch {
+    return null;
+  }
+}
+
+function applyProfile(profile) {
+  const pkgSkills = listSkillDirs(pkgSkillsSource);
+  const settings = 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 });
+  }
+  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)) {
+        try {
+          copyDirSync(src, dest);
+        } catch (err) {
+          console.error(`  ❌ 安装技能 "${name}" 失败:`, err.message);
+        }
+      }
+    } else {
+      if (fs.existsSync(dest)) {
+        fs.rmSync(dest, { recursive: true, force: true });
+      }
+    }
+  }
+
+  // 更新 settings
+  if (!settings.skills) settings.skills = {};
+  for (const name of pkgSkills) {
+    const enabled = selected.includes(name);
+    if (!settings.skills[name]) settings.skills[name] = {};
+    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);
+
+  // 安装 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);
+    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);
+  }
+
+  // 输出结果
+  const enabledCount = selected.length;
+  const disabledCount = pkgSkills.length - enabledCount;
+  console.log(`\n  ✅ 已切换到「${profile.name}」`);
+  console.log(`    启用 ${enabledCount} 个技能，停用 ${disabledCount} 个\n`);
+}
+
+async function startSceneSelection() {
+  const { select } = await import("@inquirer/prompts");
+  const chalk = (await import("chalk")).default;
+  const profiles = loadProfiles();
+  const settings = readSettings();
+  const activeProfile = settings._active_profile;
+  const hasExistingInstall = fs.existsSync(claudeDest);
+
+  const choices = profiles.map((p) => {
+    const isActive = p.id === activeProfile;
+    const prefix = isActive ? chalk.green("● ") : "  ";
+    return {
+      name: prefix + p.name,
+      value: p.id,
+      description: isActive
+        ? chalk.dim("当前场景 · ") + (p.description || "")
+        : p.description || "",
+    };
+  });
+
+  // 底部加个分隔
+  choices.push(
+    { name: chalk.dim("────────────────"), value: "__sep__", description: "" },
+    { name: "  查看技能清单", value: "__list__", description: "列出所有技能状态" },
+  );
+
+  const selectedId = await select({
+    message: hasExistingInstall
+      ? "选择开发场景（切换将自动调整技能）"
+      : "选择你的开发场景",
+    instructions: `(↑↓ 导航, Enter 确认)`,
+    choices,
+    pageSize: 10,
+    loop: false,
+  });
+
+  if (selectedId === "__sep__") {
+    return startSceneSelection();
+  }
+
+  if (selectedId === "__list__") {
+    await cmdList();
+    // 看完列表再回到场景选择
+    console.log("");
+    return 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: "已是当前场景，是否进入自定义模式微调技能？",
+      default: false,
+    });
+    if (tweak) {
+      await startInteractiveMenu();
+    }
+    return;
+  }
+
+  applyProfile(profile);
+}
+
+// ---------- 命令：list ----------
+
+async function cmdList() {
+  if (!fs.existsSync(claudeDest)) {
+    console.log("\n  ⚠️  尚未安装技能，请先运行 npx mdk-skills\n");
+    return;
+  }
+
+  const chalk = (await import("chalk")).default;
+  const pkgSkills = getPackageSkills(skillsSource);
+  const userSkills = getUserSkills(claudeDest);
+
+  const skillMap = new Map();
+  for (const s of userSkills) skillMap.set(s.name, s);
+  for (const s of pkgSkills) {
+    if (!skillMap.has(s.name)) {
+      skillMap.set(s.name, { ...s, enabled: false });
+    }
+  }
+
+  const allSkills = [...skillMap.values()];
+
+  console.log(`\n${chalk.bold("📋 mdk-skills 技能清单")}\n`);
+  console.log(
+    `  ${chalk.dim("状态        技能名                版本    描述")}`,
+  );
+  console.log(
+    `  ${chalk.dim("─────────────────────────────────────────────────────")}`,
+  );
+
+  for (const skill of allSkills) {
+    const status = skill.enabled ? chalk.green("● 启用") : chalk.gray("○ 停用");
+    const name = chalk.white(skill.name.padEnd(20));
+    const ver = chalk.dim(skill.version.padEnd(7));
+    const desc = skill.description
+      ? chalk.gray(skill.description)
+      : chalk.dim("(无描述)");
+    console.log(`  ${status}  ${name} ${ver} ${desc}`);
+  }
+
+  console.log(
+    `\n  ${chalk.cyan("💡")} ${chalk.dim("运行 npx mdk-skills 进入场景选择")}\n`,
+  );
+}
+
+// ---------- 交互式菜单（选完即装） ----------
+
+async function startInteractiveMenu() {
+  const { checkbox } = await import("@inquirer/prompts");
+
+  if (!fs.existsSync(pkgSkillsSource)) {
+    console.log("  ⚠️  包内没有找到技能文件\n");
+    return;
+  }
+
+  const pkgSkills = getPackageSkills(skillsSource);
+
+  if (pkgSkills.length === 0) {
+    console.log("  ⚠️  没有可用技能\n");
+    return;
+  }
+
+  // 读取已安装状态：已装且启用的默认勾选
+  const userSkills = 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 defaultChecked = hasExistingInstall
+    ? enabledSet
+    : new Set(pkgSkills.map((s) => s.name));
+
+  const choices = pkgSkills.map((s) => ({
+    name: s.name,
+    value: s.name,
+    description: s.description || undefined,
+    checked: defaultChecked.has(s.name),
+  }));
+
+  const selected = await checkbox({
+    message: "选择要安装的技能（未勾选的将从 .claude/ 中移除）",
+    instructions: "(↑↓ 导航, 空格 开关, Enter 确认)",
+    choices,
+    pageSize: 15,
+    loop: false,
+  });
+
+  const newCount = selected.filter((name) => !installedSet.has(name)).length;
+  const removedCount = [...installedSet].filter(
+    (name) => !selected.includes(name),
+  ).length;
+
+  const installed = installSelectedSkills(selected);
+
+  const parts = [];
+  if (newCount > 0) parts.push(`新装 ${newCount} 个`);
+  if (removedCount > 0) parts.push(`移除 ${removedCount} 个`);
+  const summary = parts.length > 0 ? `（${parts.join("，")}）` : "";
+
+  console.log(`\n  ✅ 技能安装完成 ${summary}\n`);
+}
+
+// ---------- 本地源连接管理 ----------
+
+function cmdConnect(repoPath) {
+  if (!repoPath) {
+    console.log("  ⚠️  用法：npx mdk-skills connect <仓库路径>\n");
+    return;
+  }
+
+  repoPath = path.resolve(repoPath);
+
+  if (!fs.existsSync(path.join(repoPath, ".claude", "skills"))) {
+    console.log(`  ❌ 路径 "${repoPath}" 下没有找到 .claude/skills/\n`);
+    return;
+  }
+
+  const settings = readSettings();
+  settings._skill_source = repoPath;
+  writeSettings(settings);
+
+  console.log(`  ✅ 已绑定技能源: ${repoPath}\n`);
+  console.log(`  💡 运行 npx mdk-skills 选择场景\n`);
+}
+
+function cmdSync() {
+  const settings = readSettings();
+  const sourcePath = settings._skill_source;
+
+  if (!sourcePath) {
+    console.log("  ⚠️  尚未绑定技能源\n");
+    return;
+  }
+
+  if (!fs.existsSync(path.join(sourcePath, ".claude"))) {
+    console.log(`  ❌ 绑定的路径 "${sourcePath}" 已失效\n`);
+    return;
+  }
+
+  // 备份仓库旧内容
+  const repoClaude = path.join(sourcePath, ".claude");
+  if (fs.existsSync(repoClaude)) {
+    backupDir(repoClaude);
+  }
+
+  // 技能 → 反推到仓库
+  const repoSkills = path.join(sourcePath, ".claude", "skills");
+  if (!fs.existsSync(repoSkills)) {
+    fs.mkdirSync(repoSkills, { recursive: true });
+  }
+  for (const name of 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 });
+    }
+    copyDirSync(src, dest);
+  }
+
+  // profiles.json → 反推
+  const projectProfiles = path.join(claudeDest, "profiles.json");
+  if (fs.existsSync(projectProfiles)) {
+    fs.copyFileSync(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(
+    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"));
+  }
+
+  console.log("  ✅ 已同步到仓库\n");
+}
+
+function cmdDisconnect() {
+  const settings = readSettings();
+  if (!settings._skill_source) {
+    console.log("  ⚠️  当前未绑定任何技能源\n");
+    return;
+  }
+
+  const oldPath = settings._skill_source;
+  delete settings._skill_source;
+  writeSettings(settings);
+
+  console.log(`  ✅ 已断开技能源: ${oldPath}\n`);
+  console.log(`  💡 恢复为使用 npm 包内置技能\n`);
+}
+
+// ---------- 主入口 ----------
+
+const COMMANDS = ["list", "connect", "sync", "disconnect", "ui"];
+
+async function main() {
+  const command = process.argv[2];
+  const args = process.argv.slice(3);
+
+  if (!command) {
+    const profiles = loadProfiles();
+    if (profiles) {
+      await startSceneSelection();
+    } else {
+      // 没有 profiles.json 时回退到原来的 checkbox
+      await startInteractiveMenu();
+    }
+  } else if (command === "--help" || command === "-h") {
+    console.log(`
+  mdk-skills CLI
+
+  用法:
+    npx mdk-skills             场景选择 → 一键安装对应技能
+    npx mdk-skills list        查看已安装的技能
+    npx mdk-skills connect     绑定本地技能源仓库路径
+    npx mdk-skills sync        将项目中的技能修改推送到仓库
+    npx mdk-skills disconnect  解绑本地源，恢复使用 npm 包内置技能
+    npx mdk-skills ui          启动 Web 管理面板
+    npx mdk-skills --connect   绑定本地仓库后直接进入场景选择
+    npx mdk-skills --help      显示帮助
+
+  首次运行选择场景后自动配置技能和 CLAUDE.md
+  再次运行可切换场景或进入自定义模式微调
+
+  示例:
+    npx mdk-skills --connect D:/dev/mdk-skills
+    npx mdk-skills connect D:/dev/mdk-skills
+    npx mdk-skills sync
+    npx mdk-skills disconnect
+    npx mdk-skills
+    npx mdk-skills list
+`);
+  } else if (command === "--connect") {
+    cmdConnect(args[0]);
+    skillsSource = getSkillsSource(projectRoot, packageDir);
+    const profiles = loadProfiles();
+    if (profiles) {
+      await startSceneSelection();
+    } else {
+      await startInteractiveMenu();
+    }
+  } else if (command === "list") {
+    await cmdList();
+  } else if (command === "connect") {
+    cmdConnect(args[0]);
+  } else if (command === "sync") {
+    cmdSync();
+  } else if (command === "disconnect") {
+    cmdDisconnect();
+  } else if (command === "ui") {
+    require("./web-ui/server");
+  } else {
+    console.log(`  未知命令: ${command}\n  可用: ${COMMANDS.join(", ")}\n`);
+    process.exit(1);
+  }
+}
+
+main().catch(console.error);