skill-linker 3.0.6 → 3.0.8

package/README.md

@@ -9,6 +9,7 @@
 ## ✨ 功能特色
 
 - **現代化 TUI 介面**：使用 `prompts` 提供流暢的互動體驗。
+- **智慧來源選擇**：執行 `npx skill-linker` 時自動偵測，可選擇從本地庫或 GitHub Clone。
 - **模糊搜尋 (Fuzzy Search)**：在選擇 Repository 時，直接輸入文字即可即時過濾清單。
 - **智慧偵測**：自動偵測系統中已安裝的 Agent，並在選單中預設勾選。
 - **多 Agent 支援**：支援 Claude Code, GitHub Copilot, Antigravity, Cursor, Windsurf, OpenCode, Gemini CLI 等。
@@ -21,7 +22,8 @@
 ### 方式 1：使用 npx (推薦)
 
 ```bash
-# 啟動互動式安裝介面 (選擇本地或新 Clone)
+# 啟動互動式安裝介面
+# 第一步會詢問：從本地庫選擇 或 從 GitHub Clone
 npx skill-linker
 
 # 瀏覽並從庫中 (AgentSkills/) 挑選已下載的 Skill
@@ -29,7 +31,7 @@ npx skill-linker list
 # 或使用縮寫
 npx skill-linker -l
 
-# 從 GitHub Clone 並安裝
+# 直接從 GitHub Clone 並安裝 (跳過來源選擇)
 npx skill-linker --from https://github.com/user/my-skill
 
 # 指定本地路徑 (如果是自己 clone 下來的指定目錄)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-linker",
-  "version": "3.0.6",
+  "version": "3.0.8",
   "description": "Interactive CLI to link AI Agent Skills to various agents (Claude, Copilot, Antigravity, Cursor, etc.)",
   "main": "bin/cli.js",
   "bin": {

package/src/commands/install.js

@@ -80,71 +80,158 @@ async function install(options) {
     }
 
     if (skillPaths.length === 0) {
-        if (!dirExists(DEFAULT_LIB_PATH)) {
-            console.error(chalk.red('[ERROR]'), `Skill library not found: ${DEFAULT_LIB_PATH}`);
-            console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
-            process.exit(1);
+        // First, ask user to choose source: local library or GitHub
+        const hasLocalLibrary = dirExists(DEFAULT_LIB_PATH) && findRepos(DEFAULT_LIB_PATH).length > 0;
+        
+        const sourceChoices = [
+            { title: 'Clone from GitHub', value: 'github' }
+        ];
+        
+        if (hasLocalLibrary) {
+            sourceChoices.unshift({ title: 'Select from local library', value: 'local' });
         }
-
-        const repos = findRepos(DEFAULT_LIB_PATH);
-
-        if (repos.length === 0) {
-            console.error(chalk.red('[ERROR]'), `No repos found in ${DEFAULT_LIB_PATH}`);
-            console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
-            process.exit(1);
+        
+        const { source } = await prompts({
+            type: 'select',
+            name: 'source',
+            message: 'Where do you want to get skills from?',
+            choices: sourceChoices
+        });
+        
+        if (!source) {
+            console.log(chalk.yellow('[WARNING]'), 'No source selected. Exiting.');
+            process.exit(0);
         }
+        
+        // Handle GitHub source
+        if (source === 'github') {
+            const { githubUrl } = await prompts({
+                type: 'text',
+                name: 'githubUrl',
+                message: 'Enter GitHub URL:',
+                validate: value => value.trim() !== '' || 'Please enter a valid GitHub URL'
+            });
+            
+            if (!githubUrl) {
+                console.log(chalk.yellow('[WARNING]'), 'No URL provided. Exiting.');
+                process.exit(0);
+            }
+            
+            // Use the same logic as --from flag
+            console.log(chalk.blue('[INFO]'), `Cloning from ${githubUrl}...`);
+            
+            try {
+                const { skillPath: clonedPath, targetPath, needsUpdate, hasSubpath } = await cloneOrUpdateRepo(githubUrl);
+                
+                if (needsUpdate) {
+                    const { shouldUpdate } = await prompts({
+                        type: 'confirm',
+                        name: 'shouldUpdate',
+                        message: `Repository already exists. Update with git pull?`,
+                        initial: false
+                    });
+                    
+                    if (shouldUpdate) {
+                        await pullRepo(targetPath);
+                        console.log(chalk.green('[SUCCESS]'), 'Repository updated!');
+                    }
+                }
+                
+                // If no subpath, check for skills/ subdirectory
+                if (!hasSubpath && dirExists(path.join(targetPath, 'skills'))) {
+                    const subSkills = listDirectories(path.join(targetPath, 'skills'));
+                    
+                    if (subSkills.length > 0) {
+                        const { selectedSkills } = await prompts({
+                            type: 'multiselect',
+                            name: 'selectedSkills',
+                            message: 'This repo contains multiple skills. Select skills to install:',
+                            choices: [
+                                ...subSkills.map(s => ({ title: s, value: path.join(targetPath, 'skills', s) })),
+                                { title: 'Link entire repo', value: targetPath }
+                            ],
+                            hint: '- Space to select. Return to submit'
+                        });
+                        
+                        if (selectedSkills && selectedSkills.length > 0) {
+                            skillPaths = selectedSkills;
+                        }
+                    } else {
+                        skillPaths = [targetPath];
+                    }
+                } else {
+                    skillPaths = [clonedPath];
+                }
+                
+                console.log(chalk.green('[SUCCESS]'), 'Clone completed!');
+            } catch (error) {
+                console.error(chalk.red('[ERROR]'), error.message);
+                process.exit(1);
+            }
+        }
+        
+        // Handle local library source
+        if (source === 'local') {
+            const repos = findRepos(DEFAULT_LIB_PATH);
+            
+            if (repos.length === 0) {
+                console.error(chalk.red('[ERROR]'), `No repos found in ${DEFAULT_LIB_PATH}`);
+                console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
+                process.exit(1);
+            }
+            
+            console.log('');
+            
+            // 1. Select Repository
+            const { selectedRepo } = await prompts({
+                type: 'autocomplete',
+                name: 'selectedRepo',
+                message: 'Select a repository:',
+                choices: repos.map(repo => ({
+                    title: `${repo.name}${repo.hasSkillsDir ? chalk.dim(' (has skills/)') : ''}`,
+                    value: repo
+                })),
+                suggest: (input, choices) => {
+                    const inputLower = input.toLowerCase();
+                    return Promise.resolve(
+                        choices.filter(choice => choice.title.toLowerCase().includes(inputLower))
+                    );
+                }
+            });
 
-        console.log('');
-
-        // 1. Select Repository
-        const { selectedRepo } = await prompts({
-            type: 'autocomplete',
-            name: 'selectedRepo',
-            message: 'Select a repository:',
-            choices: repos.map(repo => ({
-                title: `${repo.name}${repo.hasSkillsDir ? chalk.dim(' (has skills/)') : ''}`,
-                value: repo
-            })),
-            suggest: (input, choices) => {
-                const inputLower = input.toLowerCase();
-                return Promise.resolve(
-                    choices.filter(choice => choice.title.toLowerCase().includes(inputLower))
-                );
+            if (!selectedRepo) {
+                console.log(chalk.yellow('[WARNING]'), 'No repository selected. Exiting.');
+                process.exit(0);
             }
-        });
 
-        if (!selectedRepo) {
-            console.log(chalk.yellow('[WARNING]'), 'No repository selected. Exiting.');
-            process.exit(0);
-        }
+            // 2. Select Sub-skills (if applicable)
+            if (selectedRepo.hasSkillsDir) {
+                const skillsDir = path.join(selectedRepo.path, 'skills');
+                const subSkills = listDirectories(skillsDir);
 
-        // 2. Select Sub-skills (if applicable)
-        if (selectedRepo.hasSkillsDir) {
-            const skillsDir = path.join(selectedRepo.path, 'skills');
-            const subSkills = listDirectories(skillsDir);
-
-            if (subSkills.length > 0) {
-                const { selectedSubSkills } = await prompts({
-                    type: 'multiselect',
-                    name: 'selectedSubSkills',
-                    message: `Select skills from ${chalk.cyan(selectedRepo.name)} (Space to select):`,
-                    choices: [
-                        ...subSkills.map(s => ({ title: s, value: path.join(skillsDir, s) })),
-                        { title: 'Link entire repo', value: selectedRepo.path }
-                    ],
-                    hint: '- Space to select. Return to submit'
-                });
+                if (subSkills.length > 0) {
+                    const { selectedSubSkills } = await prompts({
+                        type: 'multiselect',
+                        name: 'selectedSubSkills',
+                        message: `Select skills from ${chalk.cyan(selectedRepo.name)} (Space to select):`,
+                        choices: [
+                            ...subSkills.map(s => ({ title: s, value: path.join(skillsDir, s) })),
+                            { title: 'Link entire repo', value: selectedRepo.path }
+                        ],
+                        hint: '- Space to select. Return to submit'
+                    });
 
-                if (!selectedSubSkills || selectedSubSkills.length === 0) {
-                    console.log(chalk.yellow('[WARNING]'), 'No skills selected. Exiting.');
-                    process.exit(0);
+                    if (!selectedSubSkills || selectedSubSkills.length === 0) {
+                        console.log(chalk.yellow('[WARNING]'), 'No skills selected. Exiting.');
+                        process.exit(0);
+                    }
+                    skillPaths = selectedSubSkills;
+                } else {
+                    skillPaths = [selectedRepo.path];
                 }
-                skillPaths = selectedSubSkills;
             } else {
                 skillPaths = [selectedRepo.path];
             }
-        } else {
-            skillPaths = [selectedRepo.path];
         }
     }
 

package/src/utils/file-system.js

@@ -32,10 +32,12 @@ function ensureDir(dirPath) {
  */
 function createSymlink(source, target) {
     try {
-        // Remove existing link/file if present
-        if (fs.existsSync(target) || fs.lstatSync(target).isSymbolicLink()) {
-            fs.unlinkSync(target);
-        }
+        // Ensure parent directory exists
+        ensureDir(path.dirname(target));
+
+        // Remove existing link/file/directory if present
+        // force: true makes it ignore the error if file doesn't exist
+        fs.rmSync(target, { recursive: true, force: true });
 
         fs.symlinkSync(source, target, 'dir');
         return true;