@moon791017/neo-skills 1.0.17 → 1.0.18

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 三種安裝指令皆支援 `--target-path` 參數，可指定安裝的根目錄（取代預設的 `$HOME`）。技能子目錄（如 `.claude/skills`）會自動附加：
+
+```bash
+# 安裝至 /my/project/.claude/skills
+npx -p @moon791017/neo-skills install-claude-skills --target-path /my/project
+
+# 安裝至 /my/project/.copilot/skills
+npx -p @moon791017/neo-skills install-copilot-skills --target-path /my/project
+
+# 安裝至 /my/project/.codex/skills
+npx -p @moon791017/neo-skills install-codex-skills --target-path /my/project
+```
+
+若未指定 `--target-path`，則使用預設根目錄 `$HOME`（即 `~/.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

@@ -43,6 +43,16 @@ export const AGENTS = {
   // },
 };
 
+/**
+ * 從 CLI 參數解析 --target-path 值
+ * @returns {string | undefined}
+ */
+function parseTargetPath() {
+  const idx = process.argv.indexOf('--target-path');
+  if (idx === -1 || idx + 1 >= process.argv.length) return undefined;
+  return process.argv[idx + 1];
+}
+
 /**
  * 從檔名解析 agent key: install-{key}-skills.js → key
  */
@@ -55,8 +65,10 @@ function extractAgentKey(importMetaUrl) {
 
 /**
  * 根據 agent config 建立 installer 函式
+ * @param {object} config - agent 設定
+ * @param {string} [targetPath] - 使用者透過 --target-path 指定的自訂路徑
  */
-export function createInstaller({ name: agentName, targetSubDir, hint }) {
+export function createInstaller({ name: agentName, targetSubDir, hint }, targetPath) {
   return async function install() {
     console.log(`🚀 [${agentName}] 開始同步 Neo Skills...`);
 
@@ -68,7 +80,8 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
       return { success: false, message: msg };
     }
 
-    const targetSkillsDir = join(homedir(), targetSubDir);
+    const baseDir = targetPath ? resolve(targetPath) : homedir();
+    const targetSkillsDir = join(baseDir, targetSubDir);
 
     console.log(`📁 來源路徑: ${sourceDir}`);
     console.log(`🎯 目標路徑: ${targetSkillsDir}`);
@@ -92,7 +105,8 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
       return { success: true, message: '沒有任何檔案被複製' };
     }
 
-    const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${targetSubDir}`;
+    const displayPath = targetPath || targetSubDir;
+    const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${displayPath}`;
     console.log(`✅ [${agentName}] 安裝成功！${msg}`);
     if (hint) console.log(`💡 提示: ${hint}`);
     return { success: true, message: msg };
@@ -102,12 +116,13 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
 /**
  * 從呼叫端的檔名自動解析 agent，建立對應的 installer。
  * @param {string} importMetaUrl - 呼叫端的 import.meta.url
+ * @param {string} [targetPath] - 使用者透過 --target-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 +152,12 @@ export function runAsMain(installFn, callerUrl) {
     process.exit(1);
   });
 
-  installFn().then((result) => {
+  const targetPath = parseTargetPath();
+  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.0",
   "mcpServers": {
     "neo-skills": {
       "command": "node",

package/package.json

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