@moon791017/neo-skills 1.0.8 → 1.0.10

package/README.md

@@ -68,19 +68,30 @@
 
 本套件支援多種 AI Agent 環境。請依據您的 CLI 工具執行對應指令：
 
-### 🛠️ Gemini CLI
+### Gemini CLI
 
 ```bash
 gemini extension install https://github.com/Benknightdark/neo-skills --auto-update
 ```
 
-### 🤖 Claude Code
+### Claude Code
+
+```bash
+npx -p @moon791017/neo-skills install-claude-skills
+```
+
+### Copilot CLI
+
+```bash
+npx -p @moon791017/neo-skills install-copilot-skills
+```
+
+### 安裝全部AI Agent技能
+
+```bash
+npx -p @moon791017/neo-skills install-skills
+```
 
-| 說明 | 執行指令 |
-| :--- | :--- |
-| Claude 內建外掛安裝  | `claude plugin add https://github.com/Benknightdark/neo-skills` |
-| 透過 `npx` 執行安裝腳本 | `npx @moon791017/neo-skills install-claude-skills` |
-| `npm` 全域安裝後執行 | `npm i @moon791017/neo-skills -g` <br> `install-claude-skills` |
 
 ## 💡 常用指令範例
 
@@ -127,4 +138,4 @@ gemini extension install https://github.com/Benknightdark/neo-skills --auto-upda
 4.  **類型檢查**
     ```bash
     bun run typecheck
-    ```
+    ```

package/bin/_utils.js

@@ -0,0 +1,141 @@
+/**
+ * Shared utilities for agent skill installers.
+ *
+ * 新增 AI agent 只需兩步：
+ * 1. 在 AGENTS 加入設定
+ * 2. 建立 bin/install-{key}-skills.js（複製任一現有檔案，改 named export 即可）
+ */
+import { realpathSync } from 'node:fs';
+import { cp, mkdir, access } from 'node:fs/promises';
+import { join, resolve, dirname, basename } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageRoot = resolve(__dirname, '..');
+const sourceDir = join(packageRoot, 'skills');
+
+/**
+ * Agent 設定中心 — 所有 agent 的安裝參數集中管理於此。
+ * key 須與檔名 install-{key}-skills.js 一致。
+ */
+export const AGENTS = {
+  claude: {
+    name: 'Claude',
+    targetSubDir: '.claude/skills',
+    hint: '請確保您的 Claude Desktop 或相關插件已指向此目錄。',
+  },
+  copilot: {
+    name: 'Copilot',
+    targetSubDir: '.copilot/skills',
+    hint: '請確保您的 GitHub Copilot CLI 已指向此目錄。',
+  },
+  // gemini: {
+  //   name: 'Gemini',
+  //   targetSubDir: '.gemini/skills',
+  //   hint: '請確保您的 Gemini CLI 已指向此目錄。',
+  // },
+};
+
+/**
+ * 從檔名解析 agent key: install-{key}-skills.js → key
+ */
+function extractAgentKey(importMetaUrl) {
+  const filename = basename(fileURLToPath(importMetaUrl), '.js');
+  const match = filename.match(/^install-(.+)-skills$/);
+  if (!match) throw new Error(`無法從檔名 "${filename}" 解析 agent key`);
+  return match[1];
+}
+
+/**
+ * 根據 agent config 建立 installer 函式
+ */
+export function createInstaller({ name: agentName, targetSubDir, hint }) {
+  return async function install() {
+    console.log(`🚀 [${agentName}] 開始同步 Neo Skills...`);
+
+    try {
+      await access(sourceDir);
+    } catch {
+      const msg = `在 ${sourceDir} 找不到來源技能目錄。`;
+      console.error(`❌ 錯誤: ${msg}`);
+      return { success: false, message: msg };
+    }
+
+    const targetSkillsDir = join(homedir(), targetSubDir);
+
+    console.log(`📁 來源路徑: ${sourceDir}`);
+    console.log(`🎯 目標路徑: ${targetSkillsDir}`);
+
+    await mkdir(targetSkillsDir, { recursive: true });
+
+    let copyCount = 0;
+    await cp(sourceDir, targetSkillsDir, {
+      recursive: true,
+      force: true,
+      filter: (src) => {
+        const relativePath = src.replace(sourceDir, '');
+        const isIgnored = relativePath.includes('node_modules') || relativePath.includes('.git');
+        if (!isIgnored) { copyCount++; return true; }
+        return false;
+      }
+    });
+
+    if (copyCount === 0) {
+      console.warn('⚠️ 警告: 沒有任何檔案被複製。請檢查來源目錄是否正確。');
+      return { success: true, message: '沒有任何檔案被複製' };
+    }
+
+    const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${targetSubDir}`;
+    console.log(`✅ [${agentName}] 安裝成功！${msg}`);
+    if (hint) console.log(`💡 提示: ${hint}`);
+    return { success: true, message: msg };
+  };
+}
+
+/**
+ * 從呼叫端的檔名自動解析 agent，建立對應的 installer。
+ * @param {string} importMetaUrl - 呼叫端的 import.meta.url
+ */
+export function createInstallerFromFile(importMetaUrl) {
+  const key = extractAgentKey(importMetaUrl);
+  const config = AGENTS[key];
+  if (!config) throw new Error(`未知的 agent: "${key}"。請在 _utils.js 的 AGENTS 中註冊。`);
+  return createInstaller(config);
+}
+
+/**
+ * 當腳本被直接執行時（非 import），自動呼叫 installer。
+ * Agent 名稱從檔名自動推導。
+ * @param {() => Promise<{ success: boolean, message: string }>} installFn
+ * @param {string} callerUrl - 呼叫端的 import.meta.url
+ */
+export function runAsMain(installFn, callerUrl) {
+  const callerPath = fileURLToPath(callerUrl);
+  const argvPath = process.argv[1];
+  const isMain = Boolean(argvPath) && (
+    resolve(argvPath) === resolve(callerPath) ||
+    realpathSync.native(resolve(argvPath)) === realpathSync.native(resolve(callerPath))
+  );
+  if (!isMain) return;
+
+  const key = extractAgentKey(callerUrl);
+  const agentName = AGENTS[key]?.name || key;
+
+  process.on('uncaughtException', (err) => {
+    console.error('💥 [Fatal Error]:', err);
+    process.exit(1);
+  });
+  process.on('unhandledRejection', (reason) => {
+    console.error('💥 [Unhandled Rejection]:', reason);
+    process.exit(1);
+  });
+
+  installFn().then((result) => {
+    if (!result.success) process.exit(1);
+  }).catch((error) => {
+    console.error(`❌ [${agentName}] 安裝失敗:`, error.message || error);
+    process.exit(1);
+  });
+}

package/bin/install-claude-skills.js

@@ -1,84 +1,7 @@
 #!/usr/bin/env node
-import { cp, mkdir, access } from 'node:fs/promises';
-import { join, resolve, dirname } from 'node:path';
-import { homedir } from 'node:os';
-import { fileURLToPath } from 'node:url';
+import { createInstallerFromFile, runAsMain } from './_utils.js';
 
-// 立即輸出日誌以確認腳本已啟動
-console.log('🏁 [Debug] 腳本已啟動...');
+export const install = createInstallerFromFile(import.meta.url);
+export { install as installClaudeSkills };
 
-// 捕捉全域錯誤
-process.on('uncaughtException', (err) => {
-  console.error('💥 [Fatal Error]:', err);
-  process.exit(1);
-});
-
-process.on('unhandledRejection', (reason, promise) => {
-  console.error('💥 [Unhandled Rejection]:', reason);
-  process.exit(1);
-});
-
-// 取得當前檔案路徑
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-async function installClaudeSkills() {
-  try {
-    // 1. 定義來源目錄: 腳本所在目錄的上一層的 skills 資料夾
-    // 當透過 npx 執行時，它會指向臨時下載的 package 內容
-    const packageRoot = resolve(__dirname, '..');
-    const sourceDir = join(packageRoot, 'skills');
-    
-    // 2. 定義目標目錄: ~/.claude/skills (跨平台自動處理)
-    const targetBaseDir = join(homedir(), '.claude');
-    const targetSkillsDir = join(targetBaseDir, 'skills');
-
-    console.log('🚀 [Claude] 開始同步 Neo Skills...');
-    
-    // 檢查來源是否存在
-    try {
-      await access(sourceDir);
-    } catch {
-      console.error(`❌ 錯誤: 在 ${sourceDir} 找不到來源技能目錄。`);
-      process.exit(1);
-    }
-
-    console.log(`📁 來源路徑: ${sourceDir}`);
-    console.log(`🎯 目標路徑: ${targetSkillsDir}`);
-
-    // 3. 確保目標目錄存在 (recursive: true 會自動建立多層目錄)
-    await mkdir(targetSkillsDir, { recursive: true });
-
-    // 4. 執行複製
-    let copyCount = 0;
-    await cp(sourceDir, targetSkillsDir, { 
-      recursive: true, 
-      force: true,
-      // 過濾掉不必要的開發檔案
-      filter: (src) => {
-        // 取得相對於來源目錄的路徑
-        const relativePath = src.replace(sourceDir, '');
-        const isIgnored = relativePath.includes('node_modules') || relativePath.includes('.git');
-        
-        if (!isIgnored) {
-          copyCount++;
-          return true;
-        }
-        return false;
-      }
-    });
-
-    if (copyCount === 0) {
-      console.warn('⚠️ 警告: 沒有任何檔案被複製。請檢查來源目錄是否正確。');
-    } else {
-      console.log(`✅ [Claude] 安裝成功！已同步 ${copyCount} 個檔案/資料夾至 .claude/skills`);
-    }
-    console.log('💡 提示: 請確保您的 Claude Desktop 或相關插件已指向此目錄。');
-
-  } catch (error) {
-    console.error('❌ [Claude] 安裝失敗:', error.message || error);
-    process.exit(1);
-  }
-}
-
-installClaudeSkills();
+runAsMain(install, import.meta.url);

package/bin/install-copilot-skills.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { createInstallerFromFile, runAsMain } from './_utils.js';
+
+export const install = createInstallerFromFile(import.meta.url);
+export { install as installCopilotSkills };
+
+runAsMain(install, import.meta.url);

package/bin/install-skills.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { AGENTS, createInstaller } from './_utils.js';
+
+process.on('uncaughtException', (err) => {
+  console.error('💥 [Fatal Error]:', err);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason) => {
+  console.error('💥 [Unhandled Rejection]:', reason);
+  process.exit(1);
+});
+
+async function main() {
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║   🧠 Neo Skills — 統一安裝程式          ║');
+  console.log('╚══════════════════════════════════════════╝');
+  console.log('');
+
+  const results = [];
+
+  for (const [key, config] of Object.entries(AGENTS)) {
+    console.log(`━━━ 正在安裝: ${config.name} ━━━`);
+    try {
+      const installFn = createInstaller(config);
+      const result = await installFn();
+      results.push({ name: config.name, ...result });
+    } catch (error) {
+      console.error(`❌ [${config.name}] 安裝失敗:`, error.message || error);
+      results.push({ name: config.name, success: false, message: error.message || String(error) });
+    }
+    console.log('');
+  }
+
+  // 彙總報告
+  console.log('══════════════════════════════════════════');
+  console.log('📊 安裝結果彙總:');
+  const failed = results.filter(r => !r.success);
+
+  for (const r of results) {
+    console.log(`  ${r.success ? '✅' : '❌'} ${r.name}: ${r.message}`);
+  }
+
+  console.log('');
+  console.log(`成功: ${results.length - failed.length} / ${results.length}`);
+
+  if (failed.length > 0) {
+    console.log(`失敗: ${failed.length} — ${failed.map(r => r.name).join(', ')}`);
+    process.exit(1);
+  }
+
+  console.log('🎉 全部安裝完成！');
+}
+
+main();

package/gemini-extension.json

@@ -1,7 +1,7 @@
 {
   "name": "neo-skills",
   "description": "A universal capability extension for Gemini CLI",
-  "version": "0.43.3",
+  "version": "0.45.0",
   "mcpServers": {
     "neo-skills": {
       "command": "node",

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@moon791017/neo-skills",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "type": "module",
   "description": "Neo Skills: A Universal Expert Agent Extension",
   "bin": {
-    "neo-skills": "./bin/install-claude-skills.js",
-    "install-claude-skills": "./bin/install-claude-skills.js"
+    "neo-skills": "./bin/install-skills.js",
+    "install-skills": "./bin/install-skills.js",
+    "install-claude-skills": "./bin/install-claude-skills.js",
+    "install-copilot-skills": "./bin/install-copilot-skills.js"
   },
   "files": [
     "dist",