sc-skill 1.0.0

package/README.md

@@ -0,0 +1,61 @@
+# skill-sync
+
+团队技能同步工具 - 使用软链接管理 Claude Code 技能
+
+## 功能特性
+
+- 🔄 从团队仓库同步技能到本地缓存
+- 🎯 交互式勾选启用/禁用技能
+- 🔗 使用软链接方式，不直接修改技能文件
+- 📦 支持多平台 (Windows/macOS/Linux)
+
+## 安装
+
+```bash
+pnpm install
+pnpm build
+npm link
+```
+
+## 使用
+
+### 1. 同步技能到缓存
+
+```bash
+skill-sync sync
+```
+
+从团队仓库 `https://codeup.aliyun.com/sczlcq/skills.git` 拉取最新技能到 `~/.skill-sync/cache`
+
+### 2. 交互式管理技能
+
+```bash
+skill-sync toggle
+```
+
+使用空格键勾选/取消勾选技能，回车确认。选中的技能会通过软链接启用到 `~/.claude/skills`
+
+### 3. 查看技能状态
+
+```bash
+skill-sync list
+```
+
+显示所有缓存的技能及其启用状态
+
+## 工作原理
+
+1. **缓存区**: 技能存储在 `~/.skill-sync/cache`，通过 git 管理
+2. **软链接**: 启用的技能通过软链接指向缓存区
+3. **目标目录**: `~/.claude/skills` 只包含软链接，不存储实际文件
+
+## 配置
+
+配置文件位置: `~/.skill-sync/config.json`
+
+```json
+{
+  "repo": "https://codeup.aliyun.com/sczlcq/skills.git",
+  "lastSync": "2026-03-10T14:00:00.000Z"
+}
+```

package/dist/cli.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import { GitRepo } from './git.js';
+import { SkillManager } from './manager.js';
+import { DEFAULT_CONFIG, getConfigPath } from './config.js';
+import fs from 'fs-extra';
+const program = new Command();
+program
+    .name('skill-sync')
+    .description('团队技能同步工具')
+    .version('1.0.0');
+program
+    .command('sync')
+    .description('从团队仓库同步技能')
+    .action(async () => {
+    try {
+        console.log('🔄 正在同步技能...');
+        const config = await loadConfig();
+        const git = new GitRepo();
+        await git.clone(config.repo);
+        console.log('✓ 已拉取最新技能到缓存');
+        await saveLastSync();
+        console.log('✅ 同步完成');
+        console.log('\n💡 运行 skill-sync toggle 来启用/禁用技能');
+    }
+    catch (error) {
+        console.error('❌ 同步失败:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('toggle')
+    .description('交互式启用/禁用技能')
+    .action(async () => {
+    try {
+        const manager = new SkillManager();
+        const available = await manager.getAvailableSkills();
+        const enabled = await manager.getEnabledSkills();
+        if (available.length === 0) {
+            console.log('❌ 缓存中没有技能，请先运行 skill-sync sync');
+            process.exit(1);
+        }
+        const answers = await inquirer.prompt([
+            {
+                type: 'checkbox',
+                name: 'skills',
+                message: '选择要启用的技能 (空格选择/取消):',
+                choices: available.map((skill) => ({
+                    name: skill,
+                    checked: enabled.includes(skill),
+                })),
+            },
+        ]);
+        const selected = answers.skills;
+        const toEnable = selected.filter((s) => !enabled.includes(s));
+        const toDisable = enabled.filter((s) => !selected.includes(s));
+        if (toEnable.length > 0) {
+            await manager.enableSkills(toEnable);
+            console.log(`✅ 已启用 ${toEnable.length} 个技能`);
+        }
+        if (toDisable.length > 0) {
+            await manager.disableSkills(toDisable);
+            console.log(`❌ 已禁用 ${toDisable.length} 个技能`);
+        }
+        if (toEnable.length === 0 && toDisable.length === 0) {
+            console.log('✨ 没有变化');
+        }
+    }
+    catch (error) {
+        console.error('❌ 操作失败:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('list')
+    .description('列出技能状态')
+    .action(async () => {
+    const manager = new SkillManager();
+    const available = await manager.getAvailableSkills();
+    const enabled = await manager.getEnabledSkills();
+    if (available.length === 0) {
+        console.log('缓存中没有技能，请先运行 skill-sync sync');
+        return;
+    }
+    console.log(`\n📦 缓存中的技能 (${available.length}):`);
+    available.forEach((skill) => {
+        const status = enabled.includes(skill) ? '✅' : '⬜';
+        console.log(`  ${status} ${skill}`);
+    });
+});
+program.parse();
+async function loadConfig() {
+    const configPath = getConfigPath();
+    if (await fs.pathExists(configPath)) {
+        return await fs.readJson(configPath);
+    }
+    return DEFAULT_CONFIG;
+}
+async function saveLastSync() {
+    const configPath = getConfigPath();
+    await fs.ensureDir(configPath.replace(/[^/\\]+$/, ''));
+    const config = await loadConfig();
+    config.lastSync = new Date().toISOString();
+    await fs.writeJson(configPath, config, { spaces: 2 });
+}

package/dist/config.js

@@ -0,0 +1,19 @@
+import os from 'os';
+import path from 'path';
+export const DEFAULT_REPO = 'https://codeup.aliyun.com/sczlcq/skills.git';
+export const getSkillsDir = () => {
+    const home = os.homedir();
+    return path.join(home, '.claude', 'skills');
+};
+export const getCacheDir = () => {
+    const home = os.homedir();
+    return path.join(home, '.skill-sync', 'cache');
+};
+export const getConfigPath = () => {
+    const home = os.homedir();
+    return path.join(home, '.skill-sync', 'config.json');
+};
+export const DEFAULT_CONFIG = {
+    repo: DEFAULT_REPO,
+    disabledSkills: [],
+};

package/dist/git.js

@@ -0,0 +1,29 @@
+import simpleGit from 'simple-git';
+import fs from 'fs-extra';
+import { getCacheDir } from './config.js';
+export class GitRepo {
+    git;
+    cacheDir;
+    constructor() {
+        this.cacheDir = getCacheDir();
+        this.git = simpleGit();
+    }
+    async clone(repoUrl) {
+        await fs.ensureDir(this.cacheDir);
+        if (await fs.pathExists(this.cacheDir)) {
+            const files = await fs.readdir(this.cacheDir);
+            if (files.length > 0) {
+                await this.pull();
+                return;
+            }
+        }
+        await this.git.clone(repoUrl, this.cacheDir);
+    }
+    async pull() {
+        const repoGit = simpleGit(this.cacheDir);
+        await repoGit.pull();
+    }
+    getCachePath() {
+        return this.cacheDir;
+    }
+}

package/dist/installer.js

@@ -0,0 +1,56 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { getSkillsDir } from './config.js';
+export class SkillInstaller {
+    targetDir;
+    constructor() {
+        this.targetDir = getSkillsDir();
+    }
+    async install(sourceDir) {
+        await fs.ensureDir(this.targetDir);
+        // 备份现有技能
+        const backupDir = `${this.targetDir}.backup.${Date.now()}`;
+        if (await fs.pathExists(this.targetDir)) {
+            await fs.copy(this.targetDir, backupDir);
+        }
+        try {
+            // 复制所有内容（目录和文件）
+            await fs.copy(sourceDir, this.targetDir, {
+                overwrite: true,
+                filter: (src) => {
+                    // 跳过 .git 目录
+                    if (src.includes('.git'))
+                        return false;
+                    return true;
+                },
+            });
+        }
+        catch (error) {
+            // 恢复备份
+            if (await fs.pathExists(backupDir)) {
+                await fs.remove(this.targetDir);
+                await fs.move(backupDir, this.targetDir);
+            }
+            throw error;
+        }
+        // 清理备份
+        if (await fs.pathExists(backupDir)) {
+            await fs.remove(backupDir);
+        }
+    }
+    async list() {
+        if (!(await fs.pathExists(this.targetDir))) {
+            return [];
+        }
+        const items = await fs.readdir(this.targetDir);
+        const skills = [];
+        for (const item of items) {
+            const itemPath = path.join(this.targetDir, item);
+            const stat = await fs.stat(itemPath);
+            if (stat.isDirectory() && !item.startsWith('.')) {
+                skills.push(item);
+            }
+        }
+        return skills;
+    }
+}

package/dist/manager.js

@@ -0,0 +1,69 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { getSkillsDir, getCacheDir } from './config.js';
+export class SkillManager {
+    targetDir;
+    cacheDir;
+    constructor() {
+        this.targetDir = getSkillsDir();
+        this.cacheDir = getCacheDir();
+    }
+    async getAvailableSkills() {
+        if (!(await fs.pathExists(this.cacheDir))) {
+            return [];
+        }
+        const items = await fs.readdir(this.cacheDir);
+        const skills = [];
+        for (const item of items) {
+            if (item.startsWith('.'))
+                continue;
+            const itemPath = path.join(this.cacheDir, item);
+            const stat = await fs.stat(itemPath);
+            if (stat.isDirectory()) {
+                skills.push(item);
+            }
+        }
+        return skills.sort();
+    }
+    async getEnabledSkills() {
+        if (!(await fs.pathExists(this.targetDir))) {
+            return [];
+        }
+        const items = await fs.readdir(this.targetDir);
+        const enabled = [];
+        for (const item of items) {
+            if (item.startsWith('.'))
+                continue;
+            const itemPath = path.join(this.targetDir, item);
+            try {
+                const stat = await fs.lstat(itemPath);
+                if (stat.isSymbolicLink() || stat.isDirectory()) {
+                    enabled.push(item);
+                }
+            }
+            catch (e) {
+                // 忽略错误
+            }
+        }
+        return enabled.sort();
+    }
+    async enableSkills(skillNames) {
+        await fs.ensureDir(this.targetDir);
+        for (const skill of skillNames) {
+            const sourcePath = path.join(this.cacheDir, skill);
+            const targetPath = path.join(this.targetDir, skill);
+            if (await fs.pathExists(targetPath)) {
+                await fs.remove(targetPath);
+            }
+            await fs.symlink(sourcePath, targetPath, 'junction');
+        }
+    }
+    async disableSkills(skillNames) {
+        for (const skill of skillNames) {
+            const targetPath = path.join(this.targetDir, skill);
+            if (await fs.pathExists(targetPath)) {
+                await fs.remove(targetPath);
+            }
+        }
+    }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "sc-skill",
+  "version": "1.0.0",
+  "description": "团队技能同步工具",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": {
+    "sc": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "pnpm run build"
+  },
+  "keywords": [
+    "claude",
+    "skills",
+    "sync",
+    "team",
+    "cli"
+  ],
+  "author": "red-k",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/skill-sync.git"
+  },
+  "packageManager": "pnpm@10.30.2",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "simple-git": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^20.11.0",
+    "inquirer": "^13.3.0",
+    "typescript": "^5.3.3"
+  }
+}