mdk-skills 2.1.5 → 2.1.8

package/.claude/profiles.json

@@ -1,49 +1,3 @@
-// {
-//   "version": 1,
-//   "profiles": [
-//     {
-//       "id": "vue3-frontend",
-//       "name": "前端 Vue3 开发",
-//       "description": "Vue 3 + 业务模式库 + 设计 + 代码审查",
-//       "skills": ["vue", "v3-fe-biz-patterns", "frontend-design", "frontend-code-review", "ui-ux-pro-max"],
-//       "always_apply": ["vue", "frontend-design", "frontend-code-review", "ui-ux-pro-max"]
-//     },
-//     {
-//       "id": "react-frontend",
-//       "name": "前端 React 开发",
-//       "description": "设计 + 审查 + 通用前端能力",
-//       "skills": ["frontend-design", "frontend-code-review", "ui-ux-pro-max"],
-//       "always_apply": ["frontend-design", "frontend-code-review", "ui-ux-pro-max"]
-//     },
-//     {
-//       "id": "backend",
-//       "name": "java后端开发",
-//       "description": "API 设计、数据库、java 后端技能",
-//       "skills": [],
-//       "always_apply": []
-//     },
-//     {
-//       "id": "backend",
-//       "name": "python后端开发",
-//       "description": "API 设计、数据库、python 后端技能",
-//       "skills": [],
-//       "always_apply": []
-//     },
-//     {
-//       "id": "backend",
-//       "name": "nodeJs后端开发",
-//       "description": "API 设计、数据库、nodeJs 后端技能",
-//       "skills": [],
-//       "always_apply": []
-//     },
-//     {
-//       "id": "custom",
-//       "name": "自定义选择",
-//       "description": "按需勾选每一个技能",
-//       "skills": null
-//     }
-//   ]
-// }
 {
   "version": 1,
   "profiles": [
@@ -56,7 +10,8 @@
         "v3-fe-biz-patterns",
         "frontend-design",
         "frontend-code-review",
-        "ui-ux-pro-max"
+        "ui-ux-pro-max",
+        "skill-creator"
       ],
       "always_apply": [
         "vue",
@@ -69,7 +24,12 @@
       "id": "react-frontend",
       "name": "React 前端专项",
       "description": "React 技术栈 | 界面设计 | 代码评审 | 通用前端能力",
-      "skills": ["frontend-design", "frontend-code-review", "ui-ux-pro-max"],
+      "skills": [
+        "frontend-design",
+        "frontend-code-review",
+        "ui-ux-pro-max",
+        "skill-creator"
+      ],
       "always_apply": [
         "frontend-design",
         "frontend-code-review",
@@ -80,21 +40,21 @@
       "id": "backend-java",
       "name": "Java 后端开发",
       "description": "接口架构设计 | 数据库建模 | Java 后端体系能力",
-      "skills": [],
+      "skills": ["skill-creator"],
       "always_apply": []
     },
     {
       "id": "backend-python",
       "name": "Python 后端开发",
       "description": "接口架构设计 | 数据层设计 | Python 后端体系能力",
-      "skills": [],
+      "skills": ["skill-creator"],
       "always_apply": []
     },
     {
       "id": "backend-node",
       "name": "Node.js 后端开发",
       "description": "接口架构设计 | 服务端架构 | Node 后端体系能力",
-      "skills": [],
+      "skills": ["skill-creator"],
       "always_apply": []
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdk-skills",
-  "version": "2.1.5",
+  "version": "2.1.8",
   "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 } = require("./core");
+const { getPackageSkills, getUserSkills, getSkillsSource } = require("./core");
 
 // npx 运行时：process.cwd() 是用户项目目录
 // __dirname 是包内 scripts/ 目录
@@ -15,10 +15,11 @@ const projectRoot = (() => {
   }
 })();
 const packageDir = path.join(__dirname, "..");
+const 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(packageDir, ".claude", "skills");
+const pkgSkillsSource = path.join(skillsSource, ".claude", "skills");
 
 // ---------- 文件写入 ----------
 
@@ -105,7 +106,7 @@ function installSelectedSkills(selectedNames) {
   writeSettings(settings);
 
   // 安装 CLAUDE.md（没有才装）
-  const mdSource = path.join(packageDir, "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);
@@ -118,7 +119,7 @@ function installSelectedSkills(selectedNames) {
 // ---------- 场景选择（场景 → 一键装技能） ----------
 
 function loadProfiles() {
-  const profilesPath = path.join(packageDir, ".claude", "profiles.json");
+  const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
   if (!fs.existsSync(profilesPath)) return null;
   try {
     return JSON.parse(fs.readFileSync(profilesPath, "utf-8")).profiles;
@@ -183,7 +184,7 @@ function applyProfile(profile) {
   writeSettings(settings);
 
   // 安装 CLAUDE.md（没有才装）
-  const mdSource = path.join(packageDir, "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);
@@ -277,7 +278,7 @@ async function cmdList() {
   }
 
   const chalk = (await import("chalk")).default;
-  const pkgSkills = getPackageSkills(packageDir);
+  const pkgSkills = getPackageSkills(skillsSource);
   const userSkills = getUserSkills(claudeDest);
 
   const skillMap = new Map();
@@ -323,10 +324,10 @@ async function startInteractiveMenu() {
     return;
   }
 
-  const pkgSkills = getPackageSkills(packageDir);
+  const pkgSkills = getPackageSkills(skillsSource);
 
   if (pkgSkills.length === 0) {
-    console.log("  ⚠️  包内没有可用技能\n");
+    console.log("  ⚠️  没有可用技能\n");
     return;
   }
 
@@ -373,9 +374,94 @@ async function startInteractiveMenu() {
   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 sync 同步技能\n`);
+}
+
+async function cmdSync() {
+  const settings = readSettings();
+  const sourcePath = settings._skill_source;
+
+  if (!sourcePath) {
+    console.log("  ⚠️  尚未绑定技能源，请先运行 npx mdk-skills connect <路径>\n");
+    return;
+  }
+
+  if (!fs.existsSync(path.join(sourcePath, ".claude", "skills"))) {
+    console.log(`  ❌ 绑定的路径 "${sourcePath}" 已失效或已移动\n`);
+    return;
+  }
+
+  const { backupDir, installSkills, installSettings } = require("./core");
+  const logFile = path.join(claudeDest, ".install.log");
+
+  if (fs.existsSync(claudeDest)) {
+    backupDir(claudeDest);
+  }
+
+  const results = installSkills(
+    path.join(sourcePath, ".claude", "skills"),
+    skillsDest,
+    logFile,
+  );
+
+  installSettings(path.join(sourcePath, ".claude"), claudeDest, logFile);
+
+  // 复制 CLAUDE.md
+  const mdSource = path.join(sourcePath, "CLAUDE.md");
+  const mdDest = path.join(projectRoot, "CLAUDE.md");
+  if (fs.existsSync(mdSource)) {
+    fs.copyFileSync(mdSource, mdDest);
+  }
+
+  const installed = results.filter((r) => r.action === "installed").length;
+  const updated = results.filter((r) => r.action === "updated").length;
+  const skipped = results.filter((r) => r.action === "skipped").length;
+
+  console.log(`\n  ✅ 技能同步完成`);
+  if (installed > 0) console.log(`    新装 ${installed} 个`);
+  if (updated > 0) console.log(`    更新 ${updated} 个`);
+  if (skipped > 0) console.log(`    跳过 ${skipped} 个（无变化）`);
+  console.log("");
+}
+
+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", "enable", "disable"];
+const COMMANDS = ["list", "connect", "sync", "disconnect"];
 
 async function main() {
   const command = process.argv[2];
@@ -396,21 +482,29 @@ async function main() {
   用法:
     npx mdk-skills             场景选择 → 一键安装对应技能
     npx mdk-skills list        查看已安装的技能
+    npx mdk-skills connect     绑定本地技能源仓库路径
+    npx mdk-skills sync        从绑定的源同步技能
+    npx mdk-skills disconnect  解绑本地源，恢复使用 npm 包内置技能
     npx mdk-skills --help      显示帮助
 
   首次运行选择场景后自动配置技能和 CLAUDE.md
   再次运行可切换场景或进入自定义模式微调
 
   示例:
+    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 === "list") {
     await cmdList();
-  } else if (command === "enable" || command === "disable") {
-    console.log(
-      `  ⚠️  该命令已废弃，请直接运行 npx mdk-skills 使用交互菜单\n`,
-    );
+  } else if (command === "connect") {
+    cmdConnect(args[0]);
+  } else if (command === "sync") {
+    await cmdSync();
+  } else if (command === "disconnect") {
+    cmdDisconnect();
   } else {
     console.log(`  未知命令: ${command}\n  可用: ${COMMANDS.join(", ")}\n`);
     process.exit(1);

package/scripts/core.js

@@ -212,6 +212,22 @@ function getPackageSkills(packageDir) {
 /**
  * 获取用户已安装的技能及其 settings 中的 enabled 状态
  */
+/**
+ * 解析技能源路径：
+ * 优先从 settings.json 的 _skill_source 字段读取（本地开发模式）
+ * 没有则回退到包目录（普通用户模式）
+ */
+function getSkillsSource(projectRoot, fallbackDir) {
+  const settingsPath = path.join(projectRoot, ".claude", "settings.json");
+  if (fs.existsSync(settingsPath)) {
+    try {
+      const s = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+      if (s._skill_source) return s._skill_source;
+    } catch {}
+  }
+  return fallbackDir;
+}
+
 function getUserSkills(claudeDest) {
   const skillsDest = path.join(claudeDest, "skills");
   if (!fs.existsSync(skillsDest)) return [];
@@ -253,4 +269,5 @@ module.exports = {
   installSettings,
   getPackageSkills,
   getUserSkills,
+  getSkillsSource,
 };