@moon791017/neo-skills 1.0.18 → 1.0.19

package/README.md

@@ -92,22 +92,22 @@ npx -p @moon791017/neo-skills install-copilot-skills
 npx -p @moon791017/neo-skills install-codex-skills
 ```
 
-### 自訂安裝根目錄
+### 安裝至指定專案
 
-Claude Code、Copilot CLI、Codex CLI 三種安裝指令皆支援 `--target-path` 參數，可指定安裝的根目錄（取代預設的 `$HOME`）。技能子目錄（如 `.claude/skills`）會自動附加：
+Claude Code、Copilot CLI、Codex CLI 三種安裝指令皆支援 `--project-path` 參數，可將技能安裝至指定專案目錄。技能子目錄會自動附加：
 
 ```bash
 # 安裝至 /my/project/.claude/skills
-npx -p @moon791017/neo-skills install-claude-skills --target-path /my/project
+npx -p @moon791017/neo-skills install-claude-skills --project-path /my/project
 
-# 安裝至 /my/project/.copilot/skills
-npx -p @moon791017/neo-skills install-copilot-skills --target-path /my/project
+# 安裝至 /my/project/.github/skills
+npx -p @moon791017/neo-skills install-copilot-skills --project-path /my/project
 
 # 安裝至 /my/project/.codex/skills
-npx -p @moon791017/neo-skills install-codex-skills --target-path /my/project
+npx -p @moon791017/neo-skills install-codex-skills --project-path /my/project
 ```
 
-若未指定 `--target-path`，則使用預設根目錄 `$HOME`（即 `~/.claude/skills`、`~/.copilot/skills`、`~/.codex/skills`）。
+若未指定 `--project-path`，則安裝至全域路徑（`~/.claude/skills`、`~/.copilot/skills`、`~/.codex/skills`）。
 
 ### 安裝全部AI Agent技能
 

package/bin/_utils.js

@@ -19,36 +19,45 @@ const sourceDir = join(packageRoot, 'skills');
 /**
  * Agent 設定中心 — 所有 agent 的安裝參數集中管理於此。
  * key 須與檔名 install-{key}-skills.js 一致。
+ *
+ * 各欄位說明：
+ *   name        — 顯示用名稱，用於 CLI 輸出的 log 標籤。
+ *   homePath    — 全域安裝路徑（相對於 $HOME）。未指定 --project-path 時使用。
+ *   projectPath — （選填）專案安裝路徑（相對於 --project-path）。
+ *                  指定 --project-path 且此欄位有值時，優先使用此路徑取代 homePath。
+ *                  例如 Copilot：全域 ~/.copilot/skills，專案 <project>/.github/skills。
+ *   hint        — 安裝成功後顯示的提示訊息。
  */
 export const AGENTS = {
   claude: {
     name: 'Claude',
-    targetSubDir: '.claude/skills',
+    homePath: '.claude/skills',
     hint: '請確保您的 Claude Desktop 或相關插件已指向此目錄。',
   },
   copilot: {
     name: 'Copilot',
-    targetSubDir: '.copilot/skills',
+    homePath: '.copilot/skills',
+    projectPath: '.github/skills',
     hint: '請確保您的 GitHub Copilot CLI 已指向此目錄。',
   },
   codex: {
     name: 'Codex',
-    targetSubDir: '.codex/skills',
+    homePath: '.codex/skills',
     hint: '請確保您的 Codex CLI 已指向此目錄。',
   },
   // gemini: {
   //   name: 'Gemini',
-  //   targetSubDir: '.gemini/skills/neo-skills',
+  //   homePath: '.gemini/skills/neo-skills',
   //   hint: '請確保您的 Gemini CLI 已指向此目錄。',
   // },
 };
 
 /**
- * 從 CLI 參數解析 --target-path 值
+ * 從 CLI 參數解析 --project-path 值
  * @returns {string | undefined}
  */
-function parseTargetPath() {
-  const idx = process.argv.indexOf('--target-path');
+function parseProjectPath() {
+  const idx = process.argv.indexOf('--project-path');
   if (idx === -1 || idx + 1 >= process.argv.length) return undefined;
   return process.argv[idx + 1];
 }
@@ -64,11 +73,25 @@ function extractAgentKey(importMetaUrl) {
 }
 
 /**
- * 根據 agent config 建立 installer 函式
- * @param {object} config - agent 設定
- * @param {string} [targetPath] - 使用者透過 --target-path 指定的自訂路徑
+ * 根據 agent config 建立 installer 函式。
+ *
+ * 路徑解析邏輯：
+ *   1. 決定根目錄 (baseDir)：
+ *      - 有 --project-path → 使用者指定的絕對路徑
+ *      - 無 --project-path → $HOME
+ *   2. 決定子目錄 (subDir)：
+ *      - 有 --project-path 且 config 定義了 projectPath → 使用 projectPath
+ *      - 其餘情況 → 使用 homePath
+ *   3. 最終安裝路徑 = baseDir + subDir
+ *
+ * 範例（以 Copilot 為例）：
+ *   預設:         ~/.copilot/skills     （homedir + homePath）
+ *   --project-path /my/project:  /my/project/.github/skills （targetPath + projectPath）
+ *
+ * @param {object} config - AGENTS 中的 agent 設定物件
+ * @param {string} [targetPath] - 使用者透過 --project-path 指定的自訂根目錄
  */
-export function createInstaller({ name: agentName, targetSubDir, hint }, targetPath) {
+export function createInstaller({ name: agentName, homePath, projectPath, hint }, targetPath) {
   return async function install() {
     console.log(`🚀 [${agentName}] 開始同步 Neo Skills...`);
 
@@ -80,8 +103,11 @@ export function createInstaller({ name: agentName, targetSubDir, hint }, targetP
       return { success: false, message: msg };
     }
 
+    // 根目錄：--project-path 優先，否則 $HOME
     const baseDir = targetPath ? resolve(targetPath) : homedir();
-    const targetSkillsDir = join(baseDir, targetSubDir);
+    // 子目錄：專案層級有獨立路徑時採用 projectPath，否則用預設的 homePath
+    const subDir = targetPath && projectPath ? projectPath : homePath;
+    const targetSkillsDir = join(baseDir, subDir);
 
     console.log(`📁 來源路徑: ${sourceDir}`);
     console.log(`🎯 目標路徑: ${targetSkillsDir}`);
@@ -105,7 +131,7 @@ export function createInstaller({ name: agentName, targetSubDir, hint }, targetP
       return { success: true, message: '沒有任何檔案被複製' };
     }
 
-    const displayPath = targetPath || targetSubDir;
+    const displayPath = targetPath || homePath;
     const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${displayPath}`;
     console.log(`✅ [${agentName}] 安裝成功！${msg}`);
     if (hint) console.log(`💡 提示: ${hint}`);
@@ -116,7 +142,7 @@ export function createInstaller({ name: agentName, targetSubDir, hint }, targetP
 /**
  * 從呼叫端的檔名自動解析 agent，建立對應的 installer。
  * @param {string} importMetaUrl - 呼叫端的 import.meta.url
- * @param {string} [targetPath] - 使用者透過 --target-path 指定的自訂路徑
+ * @param {string} [targetPath] - 使用者透過 --project-path 指定的自訂路徑
  */
 export function createInstallerFromFile(importMetaUrl, targetPath) {
   const key = extractAgentKey(importMetaUrl);
@@ -152,7 +178,7 @@ export function runAsMain(installFn, callerUrl) {
     process.exit(1);
   });
 
-  const targetPath = parseTargetPath();
+  const targetPath = parseProjectPath();
   const actualInstallFn = targetPath
     ? createInstallerFromFile(callerUrl, targetPath)
     : installFn;

package/gemini-extension.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moon791017/neo-skills",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "type": "module",
   "description": "Neo Skills: A Universal Expert Agent Extension",
   "homepage": "https://neo-blog-iota.vercel.app/",