skillhubs 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# skillhubs
+
+企业内部 Skills 管理 CLI —— 为 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 提供自定义 Slash Command 的安装与管理。
+
+## 功能概览
+
+- **安装/更新/卸载** Skill，自动注册为 Claude Code 的 `/command`
+- **搜索/查看** Registry 中的可用 Skill
+- 支持 Skill 附属资源（scripts、references、assets 目录）
+- 通过环境变量或配置文件灵活指定 Registry 地址
+
+## 安装
+
+```bash
+npm install -g skillhubs
+```
+
+## 快速开始
+
+### 1. 配置 Registry 地址
+
+```bash
+skillhubs config set registry https://your-registry.example.com
+```
+
+或通过环境变量：
+
+```bash
+export SKILL_REGISTRY=https://your-registry.example.com
+```
+
+### 2. 搜索并安装 Skill
+
+```bash
+skillhubs search <关键词>
+skillhubs add <skill名称>
+```
+
+### 3. 在 Claude Code 中使用
+
+安装完成后，在 Claude Code 中直接输入：
+
+```
+/<skill名称> 你的输入内容
+```
+
+## 命令一览
+
+| 命令 | 说明 |
+| --- | --- |
+| `skillhubs add <name>` | 安装最新版 Skill |
+| `skillhubs add <name>@<version>` | 安装指定版本 |
+| `skillhubs update <name>` | 更新 Skill 到最新版 |
+| `skillhubs remove <name>` | 卸载 Skill |
+| `skillhubs list` | 列出已安装的 Skill |
+| `skillhubs search <keyword>` | 搜索 Skill |
+| `skillhubs info <name>` | 查看 Skill 详情 |
+| `skillhubs config set registry <url>` | 设置 Registry 地址 |
+| `skillhubs --version` | 查看 CLI 版本 |
+
+## 配置
+
+CLI 配置存储在 `~/.skillsrc` 文件中，当前支持的配置项：
+
+| 配置项 | 说明 |
+| --- | --- |
+| `registry` | Skills Registry 服务地址 |
+
+配置优先级：环境变量 `SKILL_REGISTRY` > 配置文件 `~/.skillsrc`
+
+## 安装路径
+
+Skill 安装后存放于 `~/.claude/commands/` 目录下，Claude Code 会自动识别该目录中的 `.md` 文件作为自定义 Slash Command。
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const axios = require("axios");
+const yaml = require("js-yaml");
+const unzipper = require("unzipper");
+
+const { version: CLI_VERSION } = require("./package.json");
+const [, , command, skillName, ...rest] = process.argv;
+
+// ── 配置 ──────────────────────────────────────────────────
+const CONFIG_FILE = path.join(os.homedir(), ".skillsrc");
+
+function loadConfig() {
+    let cfg = {};
+    if (fs.existsSync(CONFIG_FILE)) {
+        try { cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8")); } catch {}
+    }
+    return cfg;
+}
+
+const config = loadConfig();
+const REGISTRY_URL = process.env.SKILL_REGISTRY || config.registry;
+
+if (!REGISTRY_URL && command !== "--version" && command !== "-v" && command !== "--help" && command !== "-h" && command !== "config" && command !== undefined) {
+    console.error("错误：未配置 registry 地址");
+    console.error("请执行：skillhubs config set registry <企业内网地址>");
+    console.error("或设置环境变量：export SKILL_REGISTRY=<企业内网地址>");
+    process.exit(1);
+}
+
+// Claude Code 读取自定义 slash command 的目录
+const CLAUDE_SKILLS_DIR = path.join(os.homedir(), ".claude", "commands");
+
+// ── 解析 YAML frontmatter ─────────────────────────────────
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!match) return { meta: {}, body: content.trim() };
+    return {
+        meta: yaml.load(match[1]) || {},
+        body: match[2].trim(),
+    };
+}
+
+// ── 帮助信息 ───────────────────────────────────────────────
+function printHelp() {
+    console.log(`
+skillhubs CLI v${CLI_VERSION}
+
+用法:
+  skillhubs add <name>                    安装最新版 skill 到 Claude Code
+  skillhubs add <name>@<version>          安装指定版本
+  skillhubs update <name>                 更新 skill 到最新版
+  skillhubs remove <name>                 卸载 skill
+  skillhubs list                          列出已安装的 skill
+  skillhubs search <keyword>              搜索 skill
+  skillhubs info <name>                   查看 skill 详情
+  skillhubs config set registry <url>     设置 registry 地址
+  skillhubs --version                     查看 CLI 版本
+
+安装后在 Claude Code 中使用：
+  /<skill-name> 你的输入内容
+`);
+}
+
+// ── 安装 ───────────────────────────────────────────────────
+async function addSkill(nameWithVersion) {
+    let name = nameWithVersion;
+    let targetVersion = null;
+
+    if (nameWithVersion.includes("@")) {
+        [name, targetVersion] = nameWithVersion.split("@");
+    }
+
+    let versions;
+    try {
+        const { data } = await axios.get(`${REGISTRY_URL}/api/skills/${name}`);
+        versions = data;
+    } catch {
+        console.error(`Skill "${name}" 不存在`);
+        process.exit(1);
+    }
+
+    const target = targetVersion
+        ? versions.find(v => v.version === targetVersion)
+        : versions[0];
+
+    if (!target) {
+        console.error(`版本 ${targetVersion} 不存在`);
+        process.exit(1);
+    }
+
+    console.log(`正在安装 ${target.name}@${target.version}...`);
+
+    // 下载 zip 到临时目录
+    const zipPath = path.join(os.tmpdir(), `skillhubs-${target.name}-${target.version}.zip`);
+    const writer = fs.createWriteStream(zipPath);
+
+    const resp = await axios({
+        url: `${REGISTRY_URL}/api/skills/${target.name}/${target.version}/download`,
+        method: "GET",
+        responseType: "stream",
+    });
+
+    resp.data.pipe(writer);
+    await new Promise((resolve, reject) => {
+        writer.on("finish", resolve);
+        writer.on("error", reject);
+    });
+
+    // 解压到临时目录
+    const tmpExtract = path.join(os.tmpdir(), `skillhubs-extract-${target.name}-${Date.now()}`);
+    await fs.createReadStream(zipPath)
+        .pipe(unzipper.Extract({ path: tmpExtract }))
+        .promise();
+
+    // 查找 skill.md（兼容根目录和子目录，如 macOS 手动压缩会多一层文件夹）
+    let srcMd = path.join(tmpExtract, "skill.md");
+    if (!fs.existsSync(srcMd)) {
+        const subDirs = fs.readdirSync(tmpExtract).filter(f =>
+            fs.statSync(path.join(tmpExtract, f)).isDirectory()
+        );
+        for (const dir of subDirs) {
+            const candidate = path.join(tmpExtract, dir, "skill.md");
+            if (fs.existsSync(candidate)) {
+                srcMd = candidate;
+                break;
+            }
+        }
+    }
+    if (!fs.existsSync(srcMd)) {
+        console.error("zip 包中缺少 skill.md 文件");
+        process.exit(1);
+    }
+    // 以 skill.md 所在目录作为 skill 根目录（兼容多层结构）
+    const skillRoot = path.dirname(srcMd);
+
+    const content = fs.readFileSync(srcMd, "utf-8");
+    const { body } = parseFrontmatter(content);
+
+    if (!fs.existsSync(CLAUDE_SKILLS_DIR)) {
+        fs.mkdirSync(CLAUDE_SKILLS_DIR, { recursive: true });
+    }
+
+    fs.writeFileSync(path.join(CLAUDE_SKILLS_DIR, `${target.name}.md`), body, "utf-8");
+
+    // 复制可选目录：scripts/、references/、assets/
+    const OPTIONAL_DIRS = ["scripts", "references", "assets"];
+    const destBase = path.join(CLAUDE_SKILLS_DIR, target.name);
+
+    for (const dir of OPTIONAL_DIRS) {
+        const srcDir = path.join(skillRoot, dir);
+        if (fs.existsSync(srcDir)) {
+            fs.cpSync(srcDir, path.join(destBase, dir), { recursive: true });
+            console.log(`  已复制 ${dir}/ → ${path.join(destBase, dir)}`);
+        }
+    }
+
+    // 清理临时文件
+    fs.rmSync(tmpExtract, { recursive: true });
+    fs.unlinkSync(zipPath);
+
+    console.log(`✓ ${target.name}@${target.version} 已安装`);
+    console.log(`  提示词：${path.join(CLAUDE_SKILLS_DIR, target.name + ".md")}`);
+    console.log(`  在 Claude Code 中使用：/${target.name}`);
+}
+
+// ── 卸载 ───────────────────────────────────────────────────
+function removeSkill(name) {
+    const mdPath = path.join(CLAUDE_SKILLS_DIR, `${name}.md`);
+    const dirPath = path.join(CLAUDE_SKILLS_DIR, name);
+
+    if (!fs.existsSync(mdPath)) {
+        console.error(`Skill "${name}" 未安装`);
+        process.exit(1);
+    }
+
+    fs.unlinkSync(mdPath);
+    if (fs.existsSync(dirPath)) fs.rmSync(dirPath, { recursive: true });
+    console.log(`✓ ${name} 已卸载`);
+}
+
+// ── 列出已安装 ─────────────────────────────────────────────
+function listSkills() {
+    if (!fs.existsSync(CLAUDE_SKILLS_DIR)) {
+        console.log("暂无已安装的 skill");
+        return;
+    }
+
+    const skills = fs.readdirSync(CLAUDE_SKILLS_DIR)
+        .filter(f => f.endsWith(".md") && fs.statSync(path.join(CLAUDE_SKILLS_DIR, f)).isFile());
+
+    if (!skills.length) { console.log("暂无已安装的 skill"); return; }
+
+    console.log("已安装的 Skills:\n");
+    skills.forEach(f => {
+        const name = f.replace(".md", "");
+        const hasExtra = fs.existsSync(path.join(CLAUDE_SKILLS_DIR, name));
+        console.log(`  /${name}${hasExtra ? "  [含附属目录]" : ""}`);
+    });
+}
+
+// ── 搜索 ───────────────────────────────────────────────────
+async function searchSkills(keyword) {
+    const { data } = await axios.get(`${REGISTRY_URL}/api/skills`, { params: { search: keyword } });
+    if (!data.length) { console.log("没有找到相关 skill"); return; }
+
+    console.log(`找到 ${data.length} 个 skill:\n`);
+    data.forEach(s => {
+        console.log(`  ${s.name}@${s.version}  ${s.description || ""}  [${s.author}]`);
+    });
+}
+
+// ── 查看详情 ───────────────────────────────────────────────
+async function infoSkill(name) {
+    let versions;
+    try {
+        const { data } = await axios.get(`${REGISTRY_URL}/api/skills/${name}`);
+        versions = data;
+    } catch {
+        console.error(`Skill "${name}" 不存在`);
+        process.exit(1);
+    }
+
+    const latest = versions[0];
+    console.log(`\n${latest.name}`);
+    console.log("─".repeat(40));
+    console.log(`描述：    ${latest.description || "暂无"}`);
+    console.log(`作者：    ${latest.author || "未知"}`);
+    console.log(`最新版本：${latest.version}`);
+    console.log(`下载数：  ${latest.download_count}`);
+    console.log(`标签：    ${latest.tags || "无"}`);
+    console.log(`\n所有版本：${versions.map(v => v.version).join(", ")}`);
+    console.log(`\n安装命令：skillhubs add ${latest.name}`);
+    console.log(`使用方式：在 Claude Code 中输入 /${latest.name}\n`);
+}
+
+// ── 配置 ───────────────────────────────────────────────────
+function setConfig(key, value) {
+    let cfg = {};
+    if (fs.existsSync(CONFIG_FILE)) {
+        try { cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8")); } catch {}
+    }
+    cfg[key] = value;
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2));
+    console.log(`✓ 配置已更新: ${key} = ${value}`);
+}
+
+// ── 主入口 ─────────────────────────────────────────────────
+(async () => {
+    switch (command) {
+        case "add":
+            if (!skillName) { console.error("请指定 skill 名称"); process.exit(1); }
+            await addSkill(skillName);
+            break;
+
+        case "update":
+            if (!skillName) { console.error("请指定 skill 名称"); process.exit(1); }
+            await addSkill(skillName);
+            break;
+
+        case "remove":
+        case "uninstall":
+            if (!skillName) { console.error("请指定 skill 名称"); process.exit(1); }
+            removeSkill(skillName);
+            break;
+
+        case "list":
+            listSkills();
+            break;
+
+        case "search":
+            if (!skillName) { console.error("请指定搜索关键词"); process.exit(1); }
+            await searchSkills(skillName);
+            break;
+
+        case "info":
+            if (!skillName) { console.error("请指定 skill 名称"); process.exit(1); }
+            await infoSkill(skillName);
+            break;
+
+        case "config":
+            if (skillName === "set" && rest.length >= 2) {
+                setConfig(rest[0], rest[1]);
+            } else {
+                console.log("用法: skillhubs config set <key> <value>");
+            }
+            break;
+
+        case "--version":
+        case "-v":
+            console.log(CLI_VERSION);
+            break;
+
+        case "--help":
+        case "-h":
+        case undefined:
+            printHelp();
+            break;
+
+        default:
+            console.error(`未知命令: ${command}`);
+            printHelp();
+            process.exit(1);
+    }
+})();

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "skillhubs",
+  "version": "1.0.0",
+  "description": "企业内部 Skills 管理 CLI",
+  "main": "index.js",
+  "bin": {
+    "skillhubs": "index.js"
+  },
+  "keywords": [
+    "ai",
+    "skills",
+    "enterprise",
+    "cli",
+    "agent",
+    "claude"
+  ],
+  "license": "MIT",
+  "files": [
+    "index.js"
+  ],
+  "dependencies": {
+    "axios": "^1.6.0",
+    "js-yaml": "^4.1.0",
+    "unzipper": "^0.10.11"
+  }
+}