@tinkcarlos/skillora 0.2.0

package/lib/init.js

@@ -0,0 +1,333 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const readline = require("readline");
+
+const PLATFORMS = [
+  { name: "Claude Code", value: "claude-code", native: true },
+  { name: "Cursor", value: "cursor" },
+  { name: "Codex/GPT", value: "codex" },
+  { name: "Gemini", value: "gemini" },
+  { name: "Windsurf", value: "windsurf" },
+  { name: "Aider", value: "aider" },
+];
+
+const INSTALL_MODES = [
+  { name: "项目模式 (.claude/skills/ - 仅当前项目)", value: "project" },
+  { name: "通用模式 (.agent/skills/ - 多代理兼容)", value: "universal" },
+  { name: "全局模式 (~/.claude/skills/ - 所有项目共享)", value: "global" },
+];
+
+function createReadline() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+}
+
+async function question(rl, prompt) {
+  return new Promise((resolve, reject) => {
+    rl.question(prompt, resolve);
+    rl.once("close", () => reject(new Error("User cancelled")));
+  });
+}
+
+async function selectMultiple(rl, title, options) {
+  console.log(`\n${title}`);
+  options.forEach((opt, i) => {
+    const marker = opt.native ? "◉" : "◯";
+    console.log(`  ${i + 1}. [${marker}] ${opt.name}`);
+  });
+  console.log("\n输入数字选择 (多选用逗号分隔, 如: 1,2), 回车确认:");
+
+  const answer = await question(rl, "> ");
+  if (!answer.trim()) {
+    return options.filter((o) => o.native).map((o) => o.value);
+  }
+
+  const indices = answer.split(",").map((s) => parseInt(s.trim(), 10) - 1);
+  return indices
+    .filter((i) => i >= 0 && i < options.length)
+    .map((i) => options[i].value);
+}
+
+async function selectSingle(rl, title, options) {
+  console.log(`\n${title}`);
+  options.forEach((opt, i) => {
+    const marker = i === 0 ? "◉" : "◯";
+    console.log(`  ${i + 1}. [${marker}] ${opt.name}`);
+  });
+  console.log("\n输入数字选择 (默认: 1):");
+
+  const answer = await question(rl, "> ");
+  const index = answer.trim() ? parseInt(answer.trim(), 10) - 1 : 0;
+  return options[Math.max(0, Math.min(index, options.length - 1))].value;
+}
+
+function getTargetDir(mode) {
+  const cwd = process.cwd();
+  const home = os.homedir();
+
+  switch (mode) {
+    case "universal":
+      return path.join(cwd, ".agent", "skills");
+    case "global":
+      return path.join(home, ".claude", "skills");
+    default:
+      return path.join(cwd, ".claude", "skills");
+  }
+}
+
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function copyDir(src, dest) {
+  fs.cpSync(src, dest, { recursive: true });
+}
+
+function listSkillDirs(rootDir) {
+  if (!fs.existsSync(rootDir)) return [];
+  return fs
+    .readdirSync(rootDir, { withFileTypes: true })
+    .filter((e) => e.isDirectory())
+    .map((e) => path.join(rootDir, e.name))
+    .filter((d) => fs.existsSync(path.join(d, "SKILL.md")));
+}
+
+function generateClaudeMd(skillCount) {
+  return `# CLAUDE.md
+
+## Skills System
+
+本项目已安装 ${skillCount} 个技能，使用 \`skillora read <name>\` 加载。
+
+运行 \`skillora list\` 查看所有可用技能。
+`;
+}
+
+function generateCursorRules(skills) {
+  const skillList = skills
+    .map((s) => `- ${s.name}: ${s.description}`)
+    .join("\n");
+  return `# Cursor Rules
+
+## Available Skills
+
+${skillList}
+
+## Usage
+
+使用 \`skillora read <skill-name>\` 加载技能详情。
+`;
+}
+
+function generateAgentsMd(skills, cliName) {
+  const skillTable = skills
+    .map((s) => `| ${s.name} | ${s.description} |`)
+    .join("\n");
+  return `# AGENTS.md
+
+## Skills
+
+以下技能可通过 \`${cliName} read <name>\` 加载：
+
+| Skill | Description |
+|-------|-------------|
+${skillTable}
+
+## Platform-Specific Instructions
+
+### Claude Code
+- 原生支持 \`.claude/skills/\` 目录
+- 使用 \`Skill("name")\` 调用
+
+### Cursor
+- 使用 \`.cursorrules\` 配置
+- 通过 \`@file\` 引用技能
+
+### Codex/GPT
+- 复制 System Prompt 到对话设置
+
+### Gemini
+- 复制 System Prompt 到对话设置
+
+### Windsurf / Aider
+- 使用 AGENTS.md 配置
+`;
+}
+
+function parseFrontmatter(content) {
+  if (!content || !content.startsWith("---")) return {};
+  const endIndex = content.indexOf("\n---", 3);
+  if (endIndex === -1) return {};
+
+  const raw = content.slice(3, endIndex).trim();
+  const data = {};
+  let currentKey = null;
+  let multilineValue = [];
+
+  for (const line of raw.split(/\r?\n/)) {
+    const indented = line.startsWith("  ") || line.startsWith("\t");
+    if (indented && currentKey) {
+      multilineValue.push(line.trim());
+      continue;
+    }
+
+    if (currentKey && multilineValue.length > 0) {
+      data[currentKey] = multilineValue.join(" ").trim();
+      multilineValue = [];
+    }
+
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    let value = line.slice(idx + 1).trim();
+
+    if (value === "|" || value === ">") {
+      currentKey = key;
+      multilineValue = [];
+      continue;
+    }
+
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1);
+    }
+    if (key && value) data[key] = value;
+    currentKey = null;
+  }
+
+  if (currentKey && multilineValue.length > 0) {
+    data[currentKey] = multilineValue.join(" ").trim();
+  }
+
+  return data;
+}
+
+function readSkillMeta(skillDir) {
+  try {
+    const content = fs.readFileSync(path.join(skillDir, "SKILL.md"), "utf8");
+    const fm = parseFrontmatter(content);
+    return {
+      name: fm.name || path.basename(skillDir),
+      description: fm.description || "",
+      userInvocable: fm["user-invocable"] !== "false",
+    };
+  } catch (err) {
+    console.error(`Warning: Failed to read ${skillDir}: ${err.message}`);
+    return {
+      name: path.basename(skillDir),
+      description: "",
+      userInvocable: true,
+    };
+  }
+}
+
+async function runInit(options, bundledSkillsDir) {
+  let platforms = options.platform
+    ? options.platform.split(",").map((s) => s.trim())
+    : null;
+
+  let mode = options.universal
+    ? "universal"
+    : options.global
+      ? "global"
+      : null;
+
+  // 非交互式模式：如果指定了 platform，默认使用 project 模式
+  const isNonInteractive = platforms !== null;
+  if (isNonInteractive && !mode) {
+    mode = "project";
+  }
+
+  // 交互式选择
+  let rl = null;
+  if (!platforms || !mode) {
+    rl = createReadline();
+    try {
+      if (!platforms) {
+        platforms = await selectMultiple(rl, "选择要配置的平台:", PLATFORMS);
+      }
+      if (!mode) {
+        mode = await selectSingle(rl, "选择安装模式:", INSTALL_MODES);
+      }
+    } finally {
+      rl.close();
+    }
+  }
+
+  console.log("\n正在配置...\n");
+
+  // 确定目标目录
+  const targetDir = getTargetDir(mode);
+  ensureDir(targetDir);
+
+  // 复制技能
+  const skillDirs = listSkillDirs(bundledSkillsDir);
+  let installed = 0;
+
+  for (const skillDir of skillDirs) {
+    const destDir = path.join(targetDir, path.basename(skillDir));
+    if (!fs.existsSync(destDir) || options.force) {
+      if (fs.existsSync(destDir)) {
+        fs.rmSync(destDir, { recursive: true, force: true });
+      }
+      copyDir(skillDir, destDir);
+      installed++;
+    }
+  }
+
+  // 读取技能元数据
+  const installedSkillDirs = listSkillDirs(targetDir);
+  const skills = installedSkillDirs.map(readSkillMeta);
+
+  const cwd = process.cwd();
+  const created = [];
+
+  // 生成平台配置文件
+  if (platforms.includes("claude-code")) {
+    const claudeMdPath = path.join(cwd, "CLAUDE.md");
+    if (!fs.existsSync(claudeMdPath)) {
+      fs.writeFileSync(claudeMdPath, generateClaudeMd(skills.length), "utf8");
+      created.push("CLAUDE.md");
+    }
+  }
+
+  if (platforms.includes("cursor")) {
+    const cursorPath = path.join(cwd, ".cursorrules");
+    fs.writeFileSync(cursorPath, generateCursorRules(skills), "utf8");
+    created.push(".cursorrules");
+  }
+
+  const needsAgentsMd = platforms.some((p) =>
+    ["codex", "gemini", "windsurf", "aider", "cursor"].includes(p),
+  );
+
+  if (needsAgentsMd) {
+    const agentsPath = path.join(cwd, "AGENTS.md");
+    fs.writeFileSync(
+      agentsPath,
+      generateAgentsMd(skills, "skillora"),
+      "utf8",
+    );
+    created.push("AGENTS.md");
+  }
+
+  // 输出结果
+  console.log("✅ 配置完成:\n");
+  console.log(
+    `  - 技能目录: ${targetDir} (${installed} 个新安装, ${skills.length} 个总计)`,
+  );
+  if (created.length > 0) {
+    console.log(`  - 创建文件: ${created.join(", ")}`);
+  }
+  console.log(`  - 平台: ${platforms.join(", ")}`);
+  console.log(`  - 模式: ${mode}`);
+}
+
+module.exports = { runInit, PLATFORMS, INSTALL_MODES };

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@tinkcarlos/skillora",
+  "version": "0.2.0",
+  "description": "CLI installer for bundled Claude Code skills (SKILL.md format)",
+  "bin": {
+    "skillora": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    ".claude/skills",
+    "README.md"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "skills",
+    "ai",
+    "agents",
+    "openskills"
+  ],
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  }
+}