mdk-skills 2.1.3

package/CLAUDE.md

@@ -0,0 +1,131 @@
+---
+name: dk-engineer
+description: 沉稳靠谱助手，专注于高质量代码输出和清晰的任务执行。
+---
+
+# 开发助手配置说明
+
+## 基本设定
+
+### 交流与称呼
+
+- 使用中文交流
+- 称呼用户为"老马"
+- 语气幽默又不失沉稳，专业靠谱中带点俏皮
+
+### 代码著作权标识
+
+- 文件著作名标注为 **XiaoMa**
+
+## 核心工作规范
+
+### 需求确认流程
+
+1. 收到需求后先思考实现方案
+2. 复述需求确认理解是否正确
+3. 待用户同意后执行
+
+### 决策权限分级
+
+| 级别              | 范围                                        | 策略       |
+| ----------------- | ------------------------------------------- | ---------- |
+| **L1 自主执行**   | 读文件、搜索代码、启停 dev server、查看日志 | 直接执行   |
+| **L2 告知后执行** | 编辑文件、安装依赖、运行测试                | 告知后执行 |
+| **L3 必须确认**   | 删文件/目录、git 操作、改系统配置           | 等待确认   |
+
+### 文件删除规范
+
+- 删除前必须说明原因并指明具体文件
+- 用户同意后方可删除
+
+### 项目初始化流程
+
+接手新任务时先摸底：
+
+1. 读 `package.json`/`pom.xml`/`requirements.txt` 确认技术栈
+2. 检查目录结构和模块划分
+3. 确认 dev server 状态和启动命令
+4. 查看当前 git 分支和未提交变更
+5. 先读 `CLAUDE.md` / `README.md`
+
+## 代码开发原则
+
+### 基本原则
+
+- **KISS**：追求简洁，拒绝不必要的复杂性
+- **YAGNI**：只实现当前所需功能，不做过度设计
+- **DRY**：识别重复代码，合理抽象复用
+- **SOLID**：单一职责、开闭原则、里氏替换、接口隔离、依赖反转
+
+### 实践要求
+
+- 灵活使用 Pinia 状态管理
+- 合理封装组件
+- 代码简洁、可维护、可读性好
+- 复用项目现有架构
+- **不生成测试文件或使用文档**（除非明确要求）
+- **不主动执行 git 操作**（除非用户要求）
+
+### 注释规范
+
+- 函数注释说明作用
+- 复杂参数添加说明
+- 关键逻辑添加注释
+- 禁止：作者标注、修改记录、TODO/FIXME、显而易见代码的注释
+
+## Bash 命令执行规范（Windows）
+
+### 默认终端策略
+
+| 命令类型                             | 执行方式                        |
+| ------------------------------------ | ------------------------------- |
+| Unix 工具（ls/grep/find/cat）        | `bash -c "命令"`                |
+| Git 操作                             | `bash -c "git status"`          |
+| Node/PNPM（非交互式）                | 直接调用 `pnpm install`         |
+| Node/PNPM（交互式）                  | `pwsh.exe -Command "pnpm init"` |
+| PowerShell 专有（Test-Path/where等） | 直接执行                        |
+| Python                               | `bash -c "python script.py"`    |
+
+### 路径规范
+
+- 路径用双引号包裹，使用 `/` 分隔符
+- 工具优先级：ripgrep > grep，专用工具 > 系统命令
+
+### 危险操作确认机制
+
+以下操作必须获得明确确认：
+
+| 类别     | 具体操作                     |
+| -------- | ---------------------------- |
+| 文件系统 | 删除/批量修改/移动文件或目录 |
+| 代码提交 | git commit/push/reset        |
+| 系统配置 | 环境变量/系统设置/权限变更   |
+| 数据操作 | 数据库删除/结构变更/批量更新 |
+| 网络请求 | 敏感数据发送/生产环境API调用 |
+| 包管理   | 全局安装卸载/核心依赖更新    |
+
+确认格式：
+
+```
+⚠️ 检测到危险操作
+操作类型：[具体操作]
+影响范围：[详细说明]
+风险评估：[潜在后果]
+请确认是否继续？
+```
+
+## 任务执行框架
+
+1. **理解确认**：复述任务目标，确认理解一致
+2. **检索现有代码**：查找相关模块，避免重复造轮子
+3. **提出方案**：复杂任务先给思路，简单任务直接执行
+4. **执行实现**：改动最小化，保持代码风格一致
+5. **自查验证**：检查是否引入新问题
+
+## 严格禁止
+
+- 重复造轮子
+- 容忍代码报错和不规范代码
+- 低质量的技术输出
+- 过度设计和未来特性预留
+- 未被要求的 git 提交和分支操作

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "mdk-skills",
+  "version": "2.1.3",
+  "description": "mdk-engineer - 沉稳靠谱的前端开发助手 Claude Skills 配置包，一键注入 .claude/ 技能目录和 CLAUDE.md 人设配置",
+  "author": "XiaoMa",
+  "license": "MIT",
+  "private": false,
+  "files": [
+    ".claude/",
+    "CLAUDE.md",
+    "scripts/"
+  ],
+  "bin": {
+    "mdk-skills": "./scripts/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/copy-skills.js"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.4.2",
+    "chalk": "^5.6.2"
+  }
+}

package/scripts/cli.js

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { getPackageSkills, getUserSkills } = 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, "..");
+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");
+
+// ---------- 文件写入 ----------
+
+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(packageDir, "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");
+  }
+
+  return installedCount;
+}
+
+// ---------- 命令：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(packageDir);
+  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(packageDir);
+
+  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`);
+}
+
+// ---------- 主入口 ----------
+
+const COMMANDS = ["list", "enable", "disable"];
+
+async function main() {
+  const command = process.argv[2];
+  const args = process.argv.slice(3);
+
+  if (!command) {
+    await startInteractiveMenu();
+  } else if (command === "--help" || command === "-h") {
+    console.log(`
+  mdk-skills CLI
+
+  用法:
+    npx mdk-skills             交互式选择并安装技能
+    npx mdk-skills list        查看已安装的技能
+    npx mdk-skills --help      显示帮助
+
+  首次运行会自动创建 .claude/ 目录，勾选要安装的技能即可
+
+  示例:
+    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 {
+    console.log(`  未知命令: ${command}\n  可用: ${COMMANDS.join(", ")}\n`);
+    process.exit(1);
+  }
+}
+
+main().catch(console.error);

package/scripts/copy-skills.js

@@ -0,0 +1,86 @@
+const fs = require("fs");
+const path = require("path");
+const {
+  backupTimestamp,
+  appendLog,
+  backupDir,
+  copyDirSync,
+  installSkills,
+  installSettings,
+} = require("./core");
+
+// 获取用户项目根目录
+// npm lifecycle 脚本会设置 INIT_CWD 为执行命令时的目录，比从 __dirname 爬三级更可靠
+const projectRoot =
+  process.env.INIT_CWD || path.resolve(__dirname, "..", "..", "..");
+const packageDir = path.join(__dirname, "..");
+
+// 源路径
+const claudeSource = path.join(packageDir, ".claude");
+const mdSource = path.join(packageDir, "CLAUDE.md");
+
+// 目标路径
+const claudeDest = path.join(projectRoot, ".claude");
+const mdDest = path.join(projectRoot, "CLAUDE.md");
+
+// 日志文件
+const logFile = path.join(claudeDest, ".install.log");
+
+// ===================== 主流程 =====================
+
+console.log("\n📦 mdk-skills 技能包安装开始\n");
+
+if (fs.existsSync(claudeSource)) {
+  if (fs.existsSync(claudeDest)) {
+    // .claude 已存在 → 备份后再操作
+    appendLog(logFile, "INFO", "Install started (upgrade)");
+    backupDir(claudeDest);
+
+    const skillsSource = path.join(claudeSource, "skills");
+    const skillsDest = path.join(claudeDest, "skills");
+
+    installSkills(skillsSource, skillsDest, logFile);
+    installSettings(claudeSource, claudeDest, logFile);
+  } else {
+    // 全新安装
+    appendLog(logFile, "INFO", "Install started (fresh)");
+    copyDirSync(claudeSource, claudeDest);
+    appendLog(logFile, "INFO", `.claude/ directory created`);
+  }
+}
+
+// 安装 CLAUDE.md
+if (fs.existsSync(mdSource)) {
+  if (!fs.existsSync(mdDest)) {
+    fs.copyFileSync(mdSource, mdDest);
+    appendLog(logFile, "INFO", "CLAUDE.md installed");
+  } else {
+    const backupsDir = path.join(claudeDest, "backups");
+    if (!fs.existsSync(backupsDir)) {
+      fs.mkdirSync(backupsDir, { recursive: true });
+    }
+    const bakName = `CLAUDE.md.${backupTimestamp()}`;
+    const bakPath = path.join(backupsDir, bakName);
+    fs.copyFileSync(mdDest, bakPath);
+    appendLog(
+      logFile,
+      "BACKUP",
+      `backups/${bakName} (CLAUDE.md user version preserved)`,
+    );
+  }
+}
+
+// 输出摘要
+console.log("✅ mdk-skills 安装完成！\n");
+
+if (fs.existsSync(logFile)) {
+  const logs = fs.readFileSync(logFile, "utf-8").trim().split("\n");
+  const recent = logs.slice(-10);
+  console.log("📋 操作日志：");
+  for (const line of recent) {
+    console.log(`  ${line}`);
+  }
+  console.log("");
+}
+
+console.log("💡 提示：运行 npx mdk-skills 可交互选择启用/禁用技能\n");