@moon791017/neo-skills 1.0.25 → 1.0.27

package/bin/_cli-utils.js

@@ -0,0 +1,32 @@
+import { parseArgs } from 'node:util';
+
+/**
+ * 集中設定全域錯誤攔截，確保非預期錯誤不會靜默失敗
+ */
+export function setupGlobalErrorHandlers() {
+  process.on('uncaughtException', (err) => {
+    console.error('💥 [Fatal Error]:', err);
+    process.exit(1);
+  });
+  process.on('unhandledRejection', (reason) => {
+    console.error('💥 [Unhandled Rejection]:', reason);
+    process.exit(1);
+  });
+}
+
+/**
+ * 解析 CLI 參數，支援 --ai-agent, --project-path, --instructions
+ * 允許使用等號賦值 (e.g. --ai-agent=claude) 或空格 (e.g. --ai-agent claude)
+ * @returns {{ [key: string]: string | boolean | undefined }} 解析後的參數物件
+ */
+export function parseCliArgs() {
+  const { values } = parseArgs({
+    options: {
+      'ai-agent': { type: 'string' },
+      'project-path': { type: 'string' },
+      'instructions': { type: 'string' },
+    },
+    strict: false // 允許未定義的參數，避免因為傳入未知的 flag 導致 crash
+  });
+  return values;
+}

package/bin/_utils.js

@@ -71,7 +71,7 @@ export const AGENTS = {
  * @param {object} config - AGENTS 中的 agent 設定物件
  * @param {string} [targetPath] - 使用者透過 --project-path 指定的自訂根目錄
  */
-export function createInstaller({ name: agentName, homePath, projectPath, hint }, targetPath) {
+export function createInstaller({ name: agentName, homePath, projectPath, hint }, cliBasePath) {
   return async function install() {
     console.log(`🚀 [${agentName}] 開始同步 Neo Skills...`);
 
@@ -84,9 +84,9 @@ export function createInstaller({ name: agentName, homePath, projectPath, hint }
     }
 
     // 根目錄：--project-path 優先，否則 $HOME
-    const baseDir = targetPath ? resolve(targetPath) : homedir();
+    const baseDir = cliBasePath ? resolve(cliBasePath) : homedir();
     // 子目錄：專案層級有獨立路徑時採用 projectPath，否則用預設的 homePath
-    const subDir = targetPath && projectPath ? projectPath : homePath;
+    const subDir = cliBasePath && projectPath ? projectPath : homePath;
     const targetSkillsDir = join(baseDir, subDir);
 
     console.log(`📁 來源路徑: ${sourceDir}`);
@@ -111,7 +111,7 @@ export function createInstaller({ name: agentName, homePath, projectPath, hint }
       return { success: true, message: '沒有任何檔案被複製' };
     }
 
-    const displayPath = targetPath || homePath;
+    const displayPath = cliBasePath || homePath;
     const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${displayPath}`;
     console.log(`✅ [${agentName}] 安裝成功！${msg}`);
     if (hint) console.log(`💡 提示: ${hint}`);

package/bin/install-skills.js

@@ -14,34 +14,15 @@
  *                           省略時安裝至全域路徑。
  */
 import { AGENTS, createInstaller } from './_utils.js';
+import { setupGlobalErrorHandlers, parseCliArgs } from './_cli-utils.js';
 
-/**
- * 從 process.argv 解析指定 flag 的值。
- * 例如 parseArg('--ai-agent') 在 argv 含 ['--ai-agent', 'claude'] 時回傳 'claude'。
- * @param {string} flag
- * @returns {string | undefined}
- */
-function parseArg(flag) {
-  const idx = process.argv.indexOf(flag);
-  if (idx === -1 || idx + 1 >= process.argv.length) return undefined;
-  return process.argv[idx + 1];
-}
-
-// 全域錯誤攔截，確保非預期錯誤不會靜默失敗
-process.on('uncaughtException', (err) => {
-  console.error('💥 [Fatal Error]:', err);
-  process.exit(1);
-});
-process.on('unhandledRejection', (reason) => {
-  console.error('💥 [Unhandled Rejection]:', reason);
-  process.exit(1);
-});
+setupGlobalErrorHandlers();
 
 async function main() {
-  // 先統一解析 CLI 參數，後續分支都使用同一份輸入來源，
-  // 避免在不同模式中重複讀取 process.argv。
-  const agentKey = parseArg('--ai-agent');
-  const projectPath = parseArg('--project-path');
+  // 統一解析 CLI 參數
+  const args = parseCliArgs();
+  const agentKey = args['ai-agent'];
+  const projectPath = args['project-path'];
 
   // ── 模式一：指定單一 agent ──
   if (agentKey) {

package/bin/install-system-instructions.js

@@ -19,17 +19,9 @@ import { homedir } from 'node:os';
 
 import { AGENTS } from './_utils.js';
 import { INSTRUCTIONS } from './_system-instructions.js';
+import { setupGlobalErrorHandlers, parseCliArgs } from './_cli-utils.js';
 
-/**
- * 從 process.argv 解析指定 flag 的值。
- * @param {string} flag
- * @returns {string | undefined}
- */
-function parseArg(flag) {
-  const idx = process.argv.indexOf(flag);
-  if (idx === -1 || idx + 1 >= process.argv.length) return undefined;
-  return process.argv[idx + 1];
-}
+setupGlobalErrorHandlers();
 
 /**
  * 產生提示詞的起始標記。
@@ -56,16 +48,6 @@ function wrapContent(key, content) {
   return `${startMarker(key)}\n${content}\n${endMarker(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);
-});
-
 /**
  * 對單一 agent 執行系統提示詞安裝。
  *
@@ -127,9 +109,10 @@ async function installForAgent(agentKey, agentConfig, instructionsKey, instructi
 }
 
 async function main() {
-  const agentKey = parseArg('--ai-agent');
-  const projectPath = parseArg('--project-path');
-  const instructionsKey = parseArg('--instructions');
+  const args = parseCliArgs();
+  const agentKey = args['ai-agent'];
+  const projectPath = args['project-path'];
+  const instructionsKey = args['instructions'];
 
   // ── 驗證 --instructions（兩種模式皆需要）──
   if (!instructionsKey) {