@qinsilk/scm-agent-tools 0.0.0-stage → 0.2.0

package/cli/skills.js

@@ -0,0 +1,89 @@
+// 技能安装：把包内 skills/ 目录下的全部官方技能（qinsilk-scm 与 16 个报表技能）
+// 逐个以链接方式登记到各家 AI 助手共同扫描的 ~/.agents/skills 目录。
+// 链接指向 npm 全局安装位置内部，因此包升级即技能更新；
+// 链接失败时降级为整目录复制（复制版不会随升级更新，输出中如实说明）。
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+function packageSkillsRoot() {
+  return path.join(__dirname, '..', 'skills');
+}
+
+/** 包内全部官方技能名：skills/ 下含 SKILL.md 的一级子目录 */
+function packagedSkillNames(sourceRoot = packageSkillsRoot()) {
+  return fs
+    .readdirSync(sourceRoot, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory() && fs.existsSync(path.join(sourceRoot, entry.name, 'SKILL.md')))
+    .map((entry) => entry.name);
+}
+
+/** 各家 AI 助手的技能目录；--all 时追加 Claude/Cursor 的专属目录 */
+function skillTargetDirs({ all = false, home = os.homedir() } = {}) {
+  const dirs = [path.join(home, '.agents', 'skills')];
+  if (all) {
+    dirs.push(path.join(home, '.claude', 'skills'));
+    dirs.push(path.join(home, '.cursor', 'skills'));
+  }
+  return dirs;
+}
+
+function isLink(p) {
+  try {
+    return fs.lstatSync(p).isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const name of fs.readdirSync(src)) {
+    const s = path.join(src, name);
+    const d = path.join(dest, name);
+    if (fs.statSync(s).isDirectory()) {
+      copyDir(s, d);
+    } else {
+      fs.copyFileSync(s, d);
+    }
+  }
+}
+
+/** 安装单个技能目录，返回动作描述 */
+function installOne(sourceRoot, destRoot, skillName) {
+  const src = path.join(sourceRoot, skillName);
+  const dest = path.join(destRoot, skillName);
+  if (fs.existsSync(dest) || isLink(dest)) {
+    if (!isLink(dest)) {
+      return `skipped（${dest} 已存在且不是本工具的链接，未覆盖）`;
+    }
+    // 旧链接重建，保证指向当前包位置
+    fs.rmSync(dest, { recursive: true, force: true });
+  }
+  try {
+    // Windows 用 junction 不需要管理员权限；其他系统用符号链接
+    fs.symlinkSync(src, dest, process.platform === 'win32' ? 'junction' : 'dir');
+    return `linked（升级自动更新）`;
+  } catch (e) {
+    copyDir(src, dest);
+    return `copied（降级为复制，升级后需重新安装技能）`;
+  }
+}
+
+/**
+ * 安装全部官方技能。返回每个目标目录的安装结果：
+ * [{ dir, skills: [{ name, action }] }]
+ */
+function installSkills({ all = false, home = os.homedir() } = {}) {
+  const sourceRoot = packageSkillsRoot();
+  const names = packagedSkillNames(sourceRoot);
+  return skillTargetDirs({ all, home }).map((dir) => {
+    fs.mkdirSync(dir, { recursive: true });
+    return {
+      dir,
+      skills: names.map((name) => ({ name, action: installOne(sourceRoot, dir, name) })),
+    };
+  });
+}
+
+module.exports = { packagedSkillNames, installSkills };

package/cli/table.js

@@ -0,0 +1,43 @@
+// 表格输出：无第三方依赖的简易对齐表格，供人类可读输出。
+function printTable(rows, columns) {
+  if (!rows || !rows.length) {
+    console.log('（无数据）');
+    return;
+  }
+  const headers = columns.map((c) => c.label);
+  const lines = rows.map((row) => columns.map((c) => stringify(row[c.field])));
+  const widths = headers.map((h, i) => Math.max(displayWidth(h), ...lines.map((line) => displayWidth(line[i]))));
+
+  const print = (cells) => {
+    console.log(cells.map((cell, i) => pad(cell, widths[i])).join('  '));
+  };
+  print(headers);
+  console.log(widths.map((w) => '-'.repeat(w)).join('  '));
+  lines.forEach(print);
+}
+
+/** 中文字符按 2 列宽计算，保证对齐 */
+function displayWidth(text) {
+  let width = 0;
+  for (const ch of String(text)) {
+    width += ch.charCodeAt(0) > 0xff ? 2 : 1;
+  }
+  return width;
+}
+
+function pad(text, width) {
+  const padding = width - displayWidth(text);
+  return text + ' '.repeat(Math.max(0, padding));
+}
+
+function stringify(value) {
+  if (value === null || value === undefined) {
+    return '-';
+  }
+  if (Array.isArray(value)) {
+    return value.join(',');
+  }
+  return String(value);
+}
+
+module.exports = { printTable };