@moon791017/neo-skills 1.0.17 → 1.0.19

package/README.md

@@ -92,13 +92,29 @@ npx -p @moon791017/neo-skills install-copilot-skills
 npx -p @moon791017/neo-skills install-codex-skills
 ```
 
+### 安裝至指定專案
+
+Claude Code、Copilot CLI、Codex CLI 三種安裝指令皆支援 `--project-path` 參數，可將技能安裝至指定專案目錄。技能子目錄會自動附加：
+
+```bash
+# 安裝至 /my/project/.claude/skills
+npx -p @moon791017/neo-skills install-claude-skills --project-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 --project-path /my/project
+```
+
+若未指定 `--project-path`，則安裝至全域路徑（`~/.claude/skills`、`~/.copilot/skills`、`~/.codex/skills`）。
+
 ### 安裝全部AI Agent技能
 
 ```bash
 npx -p @moon791017/neo-skills install-skills
 ```
 
-
 ## 💡 常用指令範例
 
 您可以直接對 AI 代理下達以下指令或在對話中描述需求：
@@ -113,7 +129,6 @@ npx -p @moon791017/neo-skills install-skills
 | **生成 C# Interface** | `幫我針對這個 class 產生介面` 或 `/neo:dotnet-gen-interface` |
 | **技術解析與架構洞察** | `分析這個專案的架構` 或 `/neo:explain` |
 
-
 ## 🛠 開發指南
 
 本專案使用 **Bun** 進行開發與建置。

package/bin/_utils.js

@@ -19,30 +19,49 @@ 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 參數解析 --project-path 值
+ * @returns {string | undefined}
+ */
+function parseProjectPath() {
+  const idx = process.argv.indexOf('--project-path');
+  if (idx === -1 || idx + 1 >= process.argv.length) return undefined;
+  return process.argv[idx + 1];
+}
+
 /**
  * 從檔名解析 agent key: install-{key}-skills.js → key
  */
@@ -54,9 +73,25 @@ function extractAgentKey(importMetaUrl) {
 }
 
 /**
- * 根據 agent config 建立 installer 函式
+ * 根據 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 }) {
+export function createInstaller({ name: agentName, homePath, projectPath, hint }, targetPath) {
   return async function install() {
     console.log(`🚀 [${agentName}] 開始同步 Neo Skills...`);
 
@@ -68,7 +103,11 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
       return { success: false, message: msg };
     }
 
-    const targetSkillsDir = join(homedir(), targetSubDir);
+    // 根目錄：--project-path 優先，否則 $HOME
+    const baseDir = targetPath ? resolve(targetPath) : homedir();
+    // 子目錄：專案層級有獨立路徑時採用 projectPath，否則用預設的 homePath
+    const subDir = targetPath && projectPath ? projectPath : homePath;
+    const targetSkillsDir = join(baseDir, subDir);
 
     console.log(`📁 來源路徑: ${sourceDir}`);
     console.log(`🎯 目標路徑: ${targetSkillsDir}`);
@@ -92,7 +131,8 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
       return { success: true, message: '沒有任何檔案被複製' };
     }
 
-    const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${targetSubDir}`;
+    const displayPath = targetPath || homePath;
+    const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${displayPath}`;
     console.log(`✅ [${agentName}] 安裝成功！${msg}`);
     if (hint) console.log(`💡 提示: ${hint}`);
     return { success: true, message: msg };
@@ -102,12 +142,13 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
 /**
  * 從呼叫端的檔名自動解析 agent，建立對應的 installer。
  * @param {string} importMetaUrl - 呼叫端的 import.meta.url
+ * @param {string} [targetPath] - 使用者透過 --project-path 指定的自訂路徑
  */
-export function createInstallerFromFile(importMetaUrl) {
+export function createInstallerFromFile(importMetaUrl, targetPath) {
   const key = extractAgentKey(importMetaUrl);
   const config = AGENTS[key];
   if (!config) throw new Error(`未知的 agent: "${key}"。請在 _utils.js 的 AGENTS 中註冊。`);
-  return createInstaller(config);
+  return createInstaller(config, targetPath);
 }
 
 /**
@@ -137,7 +178,12 @@ export function runAsMain(installFn, callerUrl) {
     process.exit(1);
   });
 
-  installFn().then((result) => {
+  const targetPath = parseProjectPath();
+  const actualInstallFn = targetPath
+    ? createInstallerFromFile(callerUrl, targetPath)
+    : installFn;
+
+  actualInstallFn().then((result) => {
     if (!result.success) process.exit(1);
   }).catch((error) => {
     console.error(`❌ [${agentName}] 安裝失敗:`, error.message || error);

package/gemini-extension.json

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

package/package.json

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