itismyskillmarket 1.3.0 → 1.3.2

package/src/adapters/opencode.ts

@@ -0,0 +1,40 @@
+/**
+ * =============================================================================
+ * OpenCode Platform Adapter
+ * =============================================================================
+ * 
+ * Handles skill installation for OpenCode AI coding tool.
+ * Skills are installed to ~/.config/opencode/skills/<skill-id>/
+ */
+
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import { BaseAdapter } from './base.js';
+
+export class OpenCodeAdapter extends BaseAdapter {
+  readonly id = 'opencode';
+  readonly name = 'OpenCode';
+  
+  get skillDir(): string {
+    // Respect OPENCODE_CONFIG_DIR environment variable
+    const configDir = process.env.OPENCODE_CONFIG_DIR 
+      || path.join(os.homedir(), '.config', 'opencode');
+    return path.join(configDir, 'skills');
+  }
+  
+  async isAvailable(): Promise<boolean> {
+    // Check for environment variable or directory
+    if (process.env.OPENCODE) return true;
+    
+    const configDir = process.env.OPENCODE_CONFIG_DIR 
+      || path.join(os.homedir(), '.config', 'opencode');
+    
+    try {
+      await fs.ensureDir(path.join(configDir, 'skills'));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}

package/src/adapters/registry.ts

@@ -0,0 +1,77 @@
+/**
+ * =============================================================================
+ * Platform Registry
+ * =============================================================================
+ * 
+ * Central registry for platform adapters.
+ * Handles platform detection and selection.
+ */
+
+import { OpenCodeAdapter } from './opencode.js';
+import { ClaudeAdapter } from './claude.js';
+import { VSCodeAdapter } from './vscode.js';
+import type { PlatformAdapter } from '../types.js';
+import type { Platform } from '../constants.js';
+
+const adapters: Map<string, PlatformAdapter> = new Map();
+
+/**
+ * Register all built-in platform adapters
+ */
+function registerAdapters(): void {
+  const opencode = new OpenCodeAdapter();
+  const claude = new ClaudeAdapter();
+  const vscode = new VSCodeAdapter();
+  
+  adapters.set(opencode.id, opencode);
+  adapters.set(claude.id, claude);
+  adapters.set(vscode.id, vscode);
+}
+
+// Register adapters on module load
+registerAdapters();
+
+/**
+ * Detect which platforms are available on the current system
+ */
+export async function detectPlatforms(): Promise<PlatformAdapter[]> {
+  const available: PlatformAdapter[] = [];
+  
+  for (const adapter of adapters.values()) {
+    if (await adapter.isAvailable()) {
+      available.push(adapter);
+    }
+  }
+  
+  return available;
+}
+
+/**
+ * Get adapter for a specific platform
+ */
+export function getPlatformAdapter(platformId: string): PlatformAdapter | undefined {
+  return adapters.get(platformId);
+}
+
+/**
+ * Get all registered adapters
+ */
+export function getAllAdapters(): PlatformAdapter[] {
+  return Array.from(adapters.values());
+}
+
+/**
+ * Get adapter by platform type
+ */
+export function getAdapterByPlatform(platform: Platform): PlatformAdapter | undefined {
+  const idMap: Record<Platform, string> = {
+    opencode: 'opencode',
+    claude: 'claude',
+    vscode: 'vscode',
+    cursor: 'opencode',  // Cursor uses OpenCode-compatible structure
+    codex: 'opencode',  // Codex uses OpenCode-compatible structure
+    antigravity: 'opencode',  // Antigravity uses OpenCode-compatible structure
+  };
+  
+  return adapters.get(idMap[platform]);
+}

package/src/adapters/vscode.ts

@@ -0,0 +1,62 @@
+/**
+ * =============================================================================
+ * VSCode (Copilot) Platform Adapter
+ * =============================================================================
+ * 
+ * Handles skill installation for VSCode GitHub Copilot Agent Skills.
+ * Skills are installed to ~/.copilot/skills/<skill-id>/
+ * 
+ * Note: Also supports ~/.claude/skills/ for cross-compatibility.
+ */
+
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import { BaseAdapter } from './base.js';
+
+export class VSCodeAdapter extends BaseAdapter {
+  readonly id = 'vscode';
+  readonly name = 'VSCode';
+  
+  get skillDir(): string {
+    // Try ~/.copilot/skills first, fallback to ~/.claude/skills
+    return path.join(os.homedir(), '.copilot', 'skills');
+  }
+  
+  async isAvailable(): Promise<boolean> {
+    // Check multiple possible locations
+    const possibleDirs = [
+      path.join(os.homedir(), '.copilot', 'skills'),
+      path.join(os.homedir(), '.claude', 'skills'),
+    ];
+    
+    for (const dir of possibleDirs) {
+      try {
+        await fs.ensureDir(dir);
+        return true;
+      } catch {
+        continue;
+      }
+    }
+    
+    return false;
+  }
+  
+  async install(skillId: string, sourceDir: string): Promise<void> {
+    // Install to ~/.copilot/skills, but also create symlink in ~/.claude/skills
+    await super.install(skillId, sourceDir);
+    
+    // Create cross-compatible symlink in ~/.claude/skills
+    const claudeSkillDir = path.join(os.homedir(), '.claude', 'skills');
+    const targetPath = this.getSkillPath(skillId);
+    const claudeTargetPath = path.join(claudeSkillDir, skillId);
+    
+    try {
+      await fs.ensureDir(claudeSkillDir);
+      await fs.remove(claudeTargetPath);
+      await fs.symlink(targetPath, claudeTargetPath, 'junction');
+    } catch {
+      // Silently fail if symlink not possible (cross-platform compatibility)
+    }
+  }
+}

package/src/cli.ts

@@ -14,10 +14,11 @@
  * - skm ls              列出可用的 skills
  * - skm ls --installed  列出已安装的 skills
  * - skm info <skill>    显示 skill 详情
- * - skm install <skill> 安装 skill
- * - skm uninstall <skill> 卸载 skill
+ * - skm install <skill> 安装 skill（支持 --platform）
+ * - skm uninstall <skill> 卸载 skill（支持 --platform）
  * - skm update [skill] 更新 skill(s)
  * - skm sync            同步平台链接
+ * - skm platforms       显示可用平台
  * 
  * @module cli
  */
@@ -28,16 +29,26 @@
 
 // Commander.js - 轻量级的命令行界面框架
 import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+
+// 获取 package.json 中的版本号
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(resolve(__dirname, '../package.json'), 'utf-8'));
+const VERSION = packageJson.version || '1.3.1';
 
 // 内部模块导入
 import { PLATFORMS } from './constants.js';        // 平台常量
 import { listSkills } from './commands/ls.js';          // 列表命令
+import { searchSkills } from './commands/search.js';   // 搜索命令
 import { showSkillInfo } from './commands/info.js';     // 信息命令
 import { installSkill } from './commands/install.js';   // 安装命令
 import { syncPlatformLinks } from './commands/sync.js';  // 同步命令
 import { updateSkill } from './commands/update.js';     // 更新命令
-import { uninstallSkill } from './commands/uninstall.js'; // 卸载命令
-import { searchSkills } from './commands/search.js';   // 搜索命令
+import { uninstallSkill, uninstallAll } from './commands/uninstall.js'; // 卸载命令
+import { detectPlatforms, getAllAdapters, OpenCodeAdapter, ClaudeAdapter, VSCodeAdapter } from './adapters/index.js'; // 平台适配器
 
 // -----------------------------------------------------------------------------
 // 创建命令程序实例
@@ -64,7 +75,7 @@ const program = new Command();
 program
   .name('skm')
   .description('SkillMarket - Cross-platform skill manager for AI coding tools')
-  .version('1.2.10');
+  .version(VERSION);
 
 // -----------------------------------------------------------------------------
 // 帮助命令 (-h, --help)
@@ -75,38 +86,58 @@ program
  * 
  * 显示详细的使用说明和命令示例
  */
-const helpCmd = program.command('help').description('Display help information');
-helpCmd.action(() => {
+program
+  .hook('preAction', (thisCommand) => {
+    if (thisCommand.opts().help) {
   console.log(`
 SkillMarket CLI
 
 Usage: skm <command> [options]
 
 Commands:
-  --help, -h          Display this help message
-  --ls [options]      List available skills
-                        --installed    Show only installed skills
-                        --updates      Check for updates
-  --info <skill-id>   Display skill information
-  --install <skill>   Install a skill (e.g., skm --install brainstorming)
-                        @version      Install specific version
-                        --all         Install all available skills
-  --uninstall <skill> Remove an installed skill
-  --update [options]  Update skills
-                        --all          Update all skills
-  --sync              Synchronize platform links
-  --platform <name>   Set target platform (${PLATFORMS.join(', ')})
+  ls [options]         List available skills
+                          --installed    Show only installed skills
+                          --updates      Check for updates
+                          --page <n>     Page number (default: 1)
+                          --limit <n>    Items per page (default: 20)
+                          -s, --search   Search by keyword
+  info <skill-id>      Display skill information
+  install <skill>      Install a skill
+                          @version      Install specific version
+                          --platform    Target platforms (opencode,claude,vscode)
+                          --force       Overwrite if already installed
+  uninstall <skill>    Remove an installed skill
+                          --platform    Target platforms
+                          --all          Uninstall ALL installed skills
+                          --dry-run     Preview without deleting
+                          -y, --yes     Skip confirmation
+  update [options]     Update skills
+                          --all          Update all skills
+  sync                 Synchronize platform links
+  platforms            Show available platforms
 
 Examples:
-  skm --ls                    List all available skills
-  skm --ls --installed        Show installed skills only
-  skm --info brainstorming     View skill details
-  skm --install brainstorming Install a skill
-  skm --install brainstorming@1.0.0 Install specific version
-  skm --update --all           Update all installed skills
-  skm --sync                  Sync platform links
-    `);
-});
+  skm ls                     List all available skills (page 1)
+  skm ls --page 2            Go to page 2
+  skm ls --limit 10          Show 10 items per page
+  skm ls --search brain      Search skills by keyword
+  skm ls -s brain           Search with short form
+  skm ls --installed         Show installed skills only
+  skm ls --installed --search test  Search installed skills
+  skm ls --installed --page 2
+  skm info brainstorming     View skill details
+  skm install brainstorming  Install to all platforms
+  skm install brainstorming --platform opencode  Install to OpenCode only
+  skm install brainstorming --platform claude,vscode  Install to multiple
+  skm uninstall brainstorming
+  skm uninstall --all        Uninstall all skills (with confirmation)
+  skm uninstall --all --yes  Force uninstall all without confirmation
+  skm uninstall brainstorming --dry-run  Preview uninstall
+  skm platforms              Show available platforms
+       `);
+      process.exit(0);
+    }
+  });
 
 // -----------------------------------------------------------------------------
 // 列表命令 (skm ls)
@@ -126,8 +157,41 @@ const lsCmd = program.command('ls').description('List available skills');
 lsCmd
   .option('--installed', 'Show only installed skills')
   .option('--updates', 'Check for updates')
+  .option('-p, --page <number>', 'Page number (default: 1)', parseInt)
+  .option('-l, --limit <number>', 'Items per page (default: 20)', parseInt)
+  .option('-s, --search <keyword>', 'Search by keyword (id, displayName, description)')
   .action((opts) => {
-    listSkills(opts);
+    // Ensure numeric options have default values if not provided
+    const options = {
+      ...opts,
+      page: opts.page ?? 1,
+      limit: opts.limit ?? 20,
+      search: opts.search
+    };
+    listSkills(options);
+  });
+
+// -----------------------------------------------------------------------------
+// 搜索命令 (skm search)
+// -----------------------------------------------------------------------------
+
+/**
+ * 搜索命令
+ * 
+ * 独立搜索 npm 上的 skills
+ * 
+ * 用法: skm search <keyword>
+ * 
+ * @example
+ * skm search brain
+ */
+const searchCmd = program.command('search').description('Search skills from npm registry');
+searchCmd
+  .argument('<keyword>', 'Keyword to search')
+  .option('-l, --limit <number>', 'Max results to show (default: 20)', parseInt)
+  .action(async (keyword, opts) => {
+    const limit = opts.limit ?? 20;
+    await searchSkills(keyword, limit);
   });
 
 // -----------------------------------------------------------------------------
@@ -158,25 +222,36 @@ infoCmd
 /**
  * 安装命令
  * 
- * 从 npm 安装指定的 skill 到本地
+ * 从 npm 安装指定的 skill 到本地和跨平台目录
  * 
  * 用法:
- * - skm install <skill>         安装最新版本
+ * - skm install <skill>         安装到所有检测到的平台
  * - skm install <skill>@<ver>   安装指定版本
- * - skm install --all            安装所有可用 skills（预留）
+ * - skm install --platform opencode  安装到特定平台
+ * - skm install --platform claude,vscode  安装到多个平台
+ * - skm install --force         强制覆盖
  * 
  * @example
  * skm install brainstorming
  * skm install brainstorming@1.0.0
+ * skm install brainstorming --platform opencode
  */
-const installCmd = program.command('install').description('Install a skill');
+const installCmd = program.command('install').description('Install a skill to local and platform directories');
 installCmd
   .argument('<skill>', 'Skill ID to install (e.g., brainstorming or @scope/name)')
-  .option('--all', 'Install all available skills')
-  .option('-p, --platform <platform>', `Target platform (${PLATFORMS.join(', ')})`)
+  .option('-p, --platform <platforms>', 'Target platforms (comma-separated: opencode,claude,vscode)')
+  .option('-f, --force', 'Overwrite if already installed')
+  .option('-v, --version <version>', 'Specific version to install')
   .action(async (skill, opts) => {
     try {
-      await installSkill(skill, undefined, opts.platform);
+      const platforms = opts.platform 
+        ? opts.platform.split(',').map((p: string) => p.trim())
+        : undefined;
+      
+      await installSkill(skill, opts.version, {
+        platforms,
+        force: opts.force
+      });
     } catch (err) {
       console.error('Installation failed:', err);
       process.exit(1);
@@ -190,19 +265,60 @@ installCmd
 /**
  * 卸载命令
  * 
- * 移除本地已安装的 skill
+ * 移除本地已安装的 skill 及各平台的文件
  * 
- * 用法: skm uninstall <skill-id>
+ * 用法:
+ * - skm uninstall <skill>    卸载所有平台
+ * - skm uninstall <skill> --platform opencode  卸载特定平台
+ * - skm uninstall --all      卸载所有已安装的 skills
+ * - skm uninstall --dry-run  预览删除内容
+ * 
+ * 新增 (v1.4.0):
+ * --all: 卸载所有已安装的 skills（需要确认）
+ * --dry-run: 预览模式，不实际删除
+ * -y, --yes: 跳过确认提示
  * 
  * @example
  * skm uninstall brainstorming
+ * skm uninstall brainstorming --platform claude
+ * skm uninstall --all
+ * skm uninstall --all --yes
+ * skm uninstall brainstorming --dry-run
  */
-const uninstallCmd = program.command('uninstall').description('Remove an installed skill');
+const uninstallCmd = program.command('uninstall').description('Remove an installed skill from local and platform directories');
 uninstallCmd
-  .argument('<skill>', 'Skill ID to uninstall')
-  .action(async (skill) => {
+  .argument('[skill]', 'Skill ID to uninstall (required unless using --all)')
+  .option('-p, --platform <platforms>', 'Target platforms (comma-separated)')
+  .option('-a, --all', 'Uninstall ALL installed skills (requires confirmation)')
+  .option('-d, --dry-run', 'Preview what would be uninstalled without actually deleting')
+  .option('-y, --yes', 'Skip confirmation prompts')
+  .action(async (skill, opts) => {
     try {
-      await uninstallSkill(skill);
+      const platforms = opts.platform 
+        ? opts.platform.split(',').map((p: string) => p.trim())
+        : undefined;
+      
+      // 处理 --all 选项
+      if (opts.all) {
+        await uninstallAll({
+          platforms,
+          dryRun: opts.dryRun,
+          yes: opts.yes
+        });
+        return;
+      }
+      
+      // skill 参数是必需的（除非使用 --all）
+      if (!skill) {
+        console.error('Error: Skill ID is required (or use --all to uninstall all)');
+        process.exit(1);
+      }
+      
+      await uninstallSkill(skill, {
+        platforms,
+        dryRun: opts.dryRun,
+        yes: opts.yes
+      });
     } catch (err) {
       console.error('Uninstall failed:', err);
       process.exit(1);
@@ -269,46 +385,44 @@ program
   });
 
 // -----------------------------------------------------------------------------
-// 平台命令 (skm platform)
+// 平台命令 (skm platforms)
 // -----------------------------------------------------------------------------
 
 /**
- * 平台命令（预留）
+ * 平台命令
  * 
- * 设置默认目标平台
+ * 显示所有支持的平台及其状态
  * 
- * 用法: skm platform <name>
+ * 用法: skm platforms
  */
-const platformCmd = program.command('platform').description('Set target platform');
-platformCmd
-  .argument('<name>', 'Platform name')
-  .action((name) => {
-    console.log('Platform command - name:', name);
-  });
-
-// -----------------------------------------------------------------------------
-// 搜索命令 (skm search)
-// -----------------------------------------------------------------------------
-
-/**
- * 搜索命令
- * 
- * 在 npm registry 上搜索匹配的 skills
- * 只返回包名包含关键词的 skill
- * 
- * 用法: skm search <keyword>
- * 
- * @example
- * skm search test
- */
-const searchCmd = program.command('search').description('Search skills from npm registry');
-searchCmd
-  .argument('<keyword>', 'Keyword to search')
-  .action(async (keyword) => {
+const platformsCmd = program.command('platforms').description('Show available platforms');
+platformsCmd
+  .action(async () => {
     try {
-      await searchSkills(keyword);
+      const available = await detectPlatforms();
+      
+      console.log('\n📍 Available Platforms:\n');
+      
+      const allPlatforms = [
+        { name: 'OpenCode', adapter: new OpenCodeAdapter() },
+        { name: 'Claude Code', adapter: new ClaudeAdapter() },
+        { name: 'VSCode', adapter: new VSCodeAdapter() },
+      ];
+      
+      for (const { name, adapter } of allPlatforms) {
+        const isAvailable = available.find(a => a.id === adapter.id);
+        const installed = await adapter.listInstalled();
+        
+        if (isAvailable) {
+          console.log(`${name.padEnd(12)} ✅  Available (${installed.length} skills installed)`);
+        } else {
+          console.log(`${name.padEnd(12)} ❌  Not detected`);
+        }
+      }
+      
+      console.log('');
     } catch (err) {
-      console.error('Search failed:', err);
+      console.error('Failed to list platforms:', err);
       process.exit(1);
     }
   });

package/src/commands/info.ts

@@ -19,7 +19,7 @@
 // 导入依赖
 // -----------------------------------------------------------------------------
 
-import { fetchNpmPackage } from './npm.js';    // npm registry 查询
+import { fetchSkillPackage } from './npm.js';    // npm registry 查询
 import { 
   isSkillInstalled,       // 检查 skill 是否已安装
   getInstalledSkills       // 获取已安装 skills 列表
@@ -49,25 +49,14 @@ export async function showSkillInfo(skillId: string): Promise<void> {
   // 处理包名格式
   // -------------------------------------------------------------------------
   
-  /**
-   * 转换 skillId 为完整的 npm 包名格式
-   * 
-   * 支持两种输入格式：
-   * 1. 短格式: "brainstorming" → "@skillmarket/brainstorming"
-   * 2. 完整格式: "@custom/skill" → "@custom/skill"
-   */
-  const packageName = skillId.startsWith('@') 
-    ? skillId                                          // 已经是 scoped 包名
-    : `@skillmarket/${skillId}`;                      // 转换为 scoped 包名
-  
-  console.log(`Fetching info for: ${packageName}\n`);
+  console.log(`Fetching info for: ${skillId}\n`);
   
   try {
     // -------------------------------------------------------------------------
-    // 从 npm 获取包信息
+    // 从 npm 获取包信息（自动尝试多个可能的 scope）
     // -------------------------------------------------------------------------
     
-    const info = await fetchNpmPackage(packageName);
+    const info = await fetchSkillPackage(skillId);
     
     // 包不存在
     if (!info) {