@moon791017/neo-skills 1.1.0 → 1.1.1

package/README.md

@@ -96,26 +96,51 @@
 
 ## 📦 安裝與使用
 
-Neo Skills 已全面升級並採用 [agentskills.io](https://agentskills.io) 官方推薦的 **Agent Skills 開源標準規範**。
+Neo Skills 已全面升級並支援專屬的極簡安裝器，同時相容於 [agentskills.io](https://agentskills.io) 官方推薦的 **Agent Skills 開源標準規範**。
 
-透過標準的 **Skills CLI**，您不需要手動下載、複製或在 `CLAUDE.md` 等檔案中手動附加長篇大論的系統提示詞。現代的 AI Coding Agents（如 Claude Code, Cursor, Copilot 等）已原生支持從 `.agents/skills/` 自動發現與加載這些高度專業的技能。
+根據您的使用場景，可以選擇以下兩種最適合您的安裝方式：
 
-> [!NOTE]
-> 技能下載管理工具底層使用由 Vercel Labs 開源的全球 package manager `skills` (即 `@vercel/skills`)。這使得技能的安裝與管理如同 npm 安裝套件般優雅、快速。
+---
+
+### 一、一鍵同步全域技能（Antigravity CLI 專用，推薦）
+
+如果您使用的是 **Antigravity CLI**，建議使用專門設計的 `neo-skills` 安裝工具（舊稱 `install-skills`）。這是一個極簡化的工具，會一鍵將本專案所有的專家技能，複製到您的全域路徑 `~/.gemini/antigravity-cli/skills` 中，同時自動過濾無關檔案（如 `.git`、`node_modules`、`.DS_Store` 等）。
+
+#### 透過 npx 直接執行：
+```bash
+npx -y @moon791017/neo-skills@latest
+```
+
+#### 本地開發手動安裝：
+如果您已複製本專案至本地，也可以直接在專案根目錄下執行：
+```bash
+node bin/install-skills.js
+```
 
 ---
 
-### 一、一鍵安裝所有技能
+### 二、使用標準 Skills CLI 安裝（通用於專案或其他 AI Agent）
 
-如果您希望將 Neo Skills 專案內建的所有專家技能一次性安裝至您的當前專案中，只需在專案根目錄下執行：
+針對其他支援 [agentskills.io](https://agentskills.io) 標準規範的 AI 代理（如 Claude Code, Cursor, Copilot 等），您可以使用標準的 `skills` 包管理器。預設會安裝至當前專案，**若您希望將技能安裝至全域路徑，只需在指令後方加上 `-g` 參數**。
 
+#### 1. 專案一鍵安裝所有技能（免互動勾選）：
 ```bash
-npx skills add Benknightdark/neo-skills
+npx skills add Benknightdark/neo-skills --all
 ```
 
+> [!TIP]
+> * **全域一鍵安裝**：若要將所有技能安裝至標準全域路徑下，只需加上 `-g`：`npx skills add Benknightdark/neo-skills --all -g`。
+> * **命令行指定**：若只需安裝特定 Skill，可以使用 `--skill <名稱>`（例如 `npx skills add Benknightdark/neo-skills --skill neo-typescript,neo-vue`）。
+
+#### 💡 終端機互動選單操作小秘訣：
+如果您執行了不帶 `--all` 的預設互動選單命令 `npx skills add Benknightdark/neo-skills`：
+1. **一鍵全選 (Select All)**：在選單畫面中直接按下鍵盤上的 **`a`** 鍵，即可立刻自動勾選所有的技能！
+2. **反向選取 (Invert Selection)**：按下鍵盤上的 **`i`** 鍵，反向切換目前的所有勾選狀態。
+3. **確認送出**：全選後按下 `Enter` 鍵即可一次完成安裝。
+
 ---
 
-### 二、按需安裝特定技能
+### 三、按需安裝特定技能
 
 如果您只需要其中某幾項特定領域的專家技能，您可以使用 `--skill` 參數指定安裝：
 
@@ -145,21 +170,6 @@ npx skills add Benknightdark/neo-skills
 
 ---
 
-### 三、主流 AI Agent 對齊說明
-
-在安裝技能後，主流的 AI 代理會遵循以下載入機制，無須任何額外手動配置：
-
-> [!TIP]
-> **全域安裝選項**：若您希望將技能安裝至全域路徑以供所有專案使用，可以在上述指令後面加上 `-g` 參數（例如 `npx skills add -g Benknightdark/neo-skills`）。
-
-| AI Agent | 專案載入目錄 (Project-level) | 全域載入目錄 (Global-level) | 系統提示載入方式 |
-| :--- | :--- | :--- | :--- |
-| **Antigravity (AGY)** | `<project>/.agents/skills/` | `~/.gemini/skills/` | 自動掃描並動態感知載入（Perceive 階段） |
-| **Claude Code** | `<project>/.agents/skills/` | `~/.claude/skills/` | 原生載入並透過 trigger-phrases 自動觸發 |
-| **Copilot CLI / Cursor** | `<project>/.agents/skills/` | `~/.copilot/skills/` | 自動偵測專案下的 `.agents/` 設定檔案 |
-
----
-
 ### 四、安裝系統提示詞 (`install-system-instructions`)
 
 > [!IMPORTANT]

package/bin/install-skills.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+/**
+ * Neo Skills — 全域技能安裝程式
+ *
+ * 用法：
+ *   install-skills        安裝專案的技能至全域 Antigravity CLI 技能目錄 (~/.gemini/skills)
+ */
+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 { setupGlobalErrorHandlers } from './_cli-utils.js';
+
+setupGlobalErrorHandlers();
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(__dirname, '..');
+const sourceDir = join(packageRoot, 'skills');
+
+async function main() {
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║   🧠 Neo Skills — 全域技能安裝程式       ║');
+  console.log('╚══════════════════════════════════════════╝');
+  console.log('');
+
+  try {
+    await access(sourceDir);
+  } catch {
+    console.error(`❌ 錯誤: 找不到來源技能目錄 ${sourceDir}`);
+    process.exit(1);
+  }
+
+  // 決定安裝目標路徑 (支援透過 TEST_HOME_DIR 覆寫以供測試)
+  const home = process.env.TEST_HOME_DIR || homedir();
+  const targetDir = join(home, '.gemini/antigravity-cli/skills');
+
+  console.log(`🚀 開始同步 Neo Skills 至全域 Antigravity CLI...`);
+  console.log(`📁 來源路徑: ${sourceDir}`);
+  console.log(`🎯 目標路徑: ${targetDir}`);
+  console.log('');
+
+  try {
+    await mkdir(targetDir, { recursive: true });
+
+    let copyCount = 0;
+    await cp(sourceDir, targetDir, {
+      recursive: true,
+      force: true,
+      filter: (src) => {
+        // 解析相對於來源目錄的相對路徑
+        const relativePath = src.replace(sourceDir, '');
+        
+        // 忽略無關的隱藏檔案或特定資料夾
+        const isIgnored = 
+          relativePath.includes('node_modules') || 
+          relativePath.includes('.git') ||
+          relativePath.includes('dist') ||
+          relativePath.includes('.antigravitycli') ||
+          relativePath.includes('.agents') ||
+          relativePath.includes('.DS_Store');
+        
+        if (!isIgnored) {
+          copyCount++;
+          return true;
+        }
+        return false;
+      }
+    });
+
+    if (copyCount === 0) {
+      console.warn('⚠️ 警告: 沒有任何技能檔案被複製。');
+    } else {
+      console.log('══════════════════════════════════════════');
+      console.log(`✅ 安裝成功！已同步 ${copyCount} 個項目到全域。`);
+      console.log('💡 提示: Neo Skills 已成功安裝。請確保您的 Antigravity CLI 已正常啟用技能！');
+    }
+  } catch (error) {
+    console.error(`❌ 安裝失敗:`, error.message || error);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moon791017/neo-skills",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "type": "module",
   "description": "Neo Skills: A Universal Expert Agent Extension",
   "homepage": "https://neo-blog-iota.vercel.app/",
@@ -13,6 +13,8 @@
     "ai agent skills"
   ],
   "bin": {
+    "neo-skills": "./bin/install-skills.js",
+    "install-skills": "./bin/install-skills.js",
     "install-system-instructions": "./bin/install-system-instructions.js"
   },
   "files": [