mdk-skills 2.1.6 → 2.1.9

package/.claude/profiles.json

@@ -10,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",
@@ -23,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",
@@ -34,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.6",
+  "version": "2.1.9",
   "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, backupDir } = 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,106 @@ 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 选择场景\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", "enable", "disable"];
+const COMMANDS = ["list", "connect", "sync", "disconnect"];
 
 async function main() {
   const command = process.argv[2];
@@ -396,21 +494,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") {
+    cmdSync();
+  } else if (command === "disconnect") {
+    cmdDisconnect();
   } else {
     console.log(`  未知命令: ${command}\n  可用: ${COMMANDS.join(", ")}\n`);
     process.exit(1);

package/scripts/core.js

@@ -209,6 +209,22 @@ function getPackageSkills(packageDir) {
   });
 }
 
+/**
+ * 解析技能源路径：
+ * 优先从 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;
+}
+
 /**
  * 获取用户已安装的技能及其 settings 中的 enabled 状态
  */
@@ -253,4 +269,5 @@ module.exports = {
   installSettings,
   getPackageSkills,
   getUserSkills,
+  getSkillsSource,
 };