@moon791017/neo-skills 1.0.22 → 1.0.24

package/README.md

@@ -2,6 +2,9 @@
 
 [![test-on-develop](https://github.com/Benknightdark/neo-skills/actions/workflows/test-on-develop.yml/badge.svg)](https://github.com/Benknightdark/neo-skills/actions/workflows/test-on-develop.yml)
 
+![Neo Skills banner](https://raw.githubusercontent.com/Benknightdark/neo-skills/refs/heads/develop/images/banner.png)
+
+
 **Neo Skills** 是專為現代 **AI Agent** 設計的**全方位能力擴充套件**。本專案透過標準化的通訊架構，為 AI 代理安裝可插拔的「技能模組 (Skills)」，使其不僅僅是一個聊天機器人，而是能轉化為具備「感知-推理-行動」能力的**多領域專家**。
 
 無論是 DevOps 自動化、軟體架構設計，或是未來的資料分析與專案管理，Neo Skills 都能透過掛載不同的知識庫與工具，讓 AI 成為您最強大的全能助手。
@@ -144,15 +147,15 @@ npx -p @moon791017/neo-skills install-skills -y
 **語法：**
 
 ```
-install-system-instructions --ai-agent <name> --instructions <key> [--project-path <path>]
+install-system-instructions --instructions <key> [--ai-agent <name>] [--project-path <path>]
 ```
 
 **參數：**
 
 | 參數 | 必填 | 說明 |
 | :--- | :---: | :--- |
-| `--ai-agent <name>` | ✅ | 指定目標 Agent（`claude` / `copilot` / `codex`）。 |
 | `--instructions <key>` | ✅ | 指定要安裝的系統提示詞（見下方種類表）。 |
+| `--ai-agent <name>` | 否 | 指定目標 Agent（`claude` / `copilot` / `codex`）。省略時安裝至全部。 |
 | `--project-path <path>` | 否 | 指定專案根目錄。省略時安裝至 `$HOME` 全域路徑。 |
 
 **指導檔路徑對照：**
@@ -172,6 +175,14 @@ install-system-instructions --ai-agent <name> --instructions <key> [--project-pa
 **範例：**
 
 ```bash
+# 一次安裝至全部 Agent 的全域指導檔
+npx -p @moon791017/neo-skills install-system-instructions \
+  --instructions technical-co-founder -y
+
+# 安裝至指定 Agent 的全域指導檔 (~/.claude/CLAUDE.md)
+npx -p @moon791017/neo-skills install-system-instructions \
+  --ai-agent claude --instructions technical-co-founder -y
+
 # 安裝至專案的 CLAUDE.md
 npx -p @moon791017/neo-skills install-system-instructions \
   --ai-agent claude --instructions technical-co-founder --project-path /my/project -y
@@ -179,10 +190,6 @@ npx -p @moon791017/neo-skills install-system-instructions \
 # 安裝至專案的 .github/copilot-instructions.md
 npx -p @moon791017/neo-skills install-system-instructions \
   --ai-agent copilot --instructions technical-co-founder --project-path /my/project -y
-
-# 安裝至全域 (~/.claude/CLAUDE.md)
-npx -p @moon791017/neo-skills install-system-instructions \
-  --ai-agent claude --instructions technical-co-founder -y
 ```
 
 > **💡** 重複執行相同指令不會重複寫入，系統會自動偵測並跳過已安裝的提示詞。

package/bin/_system-instructions.js

@@ -1,4 +1,7 @@
-export const technicalCoFounderInstructions = `Role:
+export const technicalCoFounderInstructions = `
+When generating commit messages, do not include 'Co-authored-by' or any AI attribution trailers.
+
+Role:
 You are now my Technical Co-Founder. Your job is to help me build a real product I can use, share, or launch. Handle all the building, but keep me in the loop and in control.
 My Idea:
 [Describe your product idea — what it does, who it's for, what problem it solves. Explain it like you'd tell a friend.]

package/bin/install-system-instructions.js

@@ -3,11 +3,13 @@
  * Neo Skills — 系統提示詞安裝程式
  *
  * 用法：
+ *   install-system-instructions --instructions technical-co-founder
  *   install-system-instructions --ai-agent claude --instructions technical-co-founder
  *   install-system-instructions --ai-agent copilot --instructions technical-co-founder --project-path .
  *
  * 參數：
- *   --ai-agent <name>         指定目標 AI Agent（可用值見 _utils.js 的 AGENTS）。必填。
+ *   --ai-agent <name>         指定目標 AI Agent（可用值見 _utils.js 的 AGENTS）。
+ *                              省略時安裝至全部已註冊 agent。
  *   --instructions <key>      指定要安裝的系統提示詞（可用值見 _system-instructions.js 的 INSTRUCTIONS）。必填。
  *   --project-path <path>     指定專案根目錄作為安裝基底（取代 $HOME）。省略時安裝至全域路徑。
  */
@@ -64,45 +66,23 @@ process.on('unhandledRejection', (reason) => {
   process.exit(1);
 });
 
-async function main() {
-  const agentKey = parseArg('--ai-agent');
-  const projectPath = parseArg('--project-path');
-  const instructionsKey = parseArg('--instructions');
-
-  // ── 驗證 --ai-agent ──
-  if (!agentKey) {
-    const valid = Object.keys(AGENTS).join(', ');
-    console.error(`❌ 缺少必填參數 --ai-agent。可用選項: ${valid}`);
-    process.exit(1);
-  }
-
-  const agentConfig = AGENTS[agentKey];
-  if (!agentConfig) {
-    const valid = Object.keys(AGENTS).join(', ');
-    console.error(`❌ 未知的 agent: "${agentKey}"。可用選項: ${valid}`);
-    process.exit(1);
-  }
-
+/**
+ * 對單一 agent 執行系統提示詞安裝。
+ *
+ * @param {string} agentKey - AGENTS 中的 key
+ * @param {object} agentConfig - AGENTS[agentKey]
+ * @param {string} instructionsKey - INSTRUCTIONS 中的 key
+ * @param {object} instruction - INSTRUCTIONS[instructionsKey]
+ * @param {string | undefined} projectPath - 使用者指定的專案路徑
+ * @returns {Promise<{success: boolean, message: string}>}
+ */
+async function installForAgent(agentKey, agentConfig, instructionsKey, instruction, projectPath) {
   if (!agentConfig.instructionFile) {
-    console.error(`❌ agent "${agentKey}" 未設定 instructionFile。`);
-    process.exit(1);
+    const msg = `agent "${agentKey}" 未設定 instructionFile，跳過。`;
+    console.warn(`⚠️ ${msg}`);
+    return { success: true, message: msg };
   }
 
-  // ── 驗證 --instructions ──
-  if (!instructionsKey) {
-    const valid = Object.keys(INSTRUCTIONS).join(', ');
-    console.error(`❌ 缺少必填參數 --instructions。可用選項: ${valid}`);
-    process.exit(1);
-  }
-
-  const instruction = INSTRUCTIONS[instructionsKey];
-  if (!instruction) {
-    const valid = Object.keys(INSTRUCTIONS).join(', ');
-    console.error(`❌ 未知的 instructions: "${instructionsKey}"。可用選項: ${valid}`);
-    process.exit(1);
-  }
-
-  // ── 決定指導檔路徑 ──
   const { instructionFile } = agentConfig;
   const baseDir = projectPath ? resolve(projectPath) : homedir();
   const subPath = projectPath && instructionFile.projectPath
@@ -113,10 +93,8 @@ async function main() {
   console.log(`🚀 [${agentConfig.name}] 開始安裝系統提示詞: ${instruction.name}`);
   console.log(`🎯 目標檔案: ${targetFile}`);
 
-  // ── 組裝標記包裹的提示詞內容 ──
   const wrappedContent = wrapContent(instructionsKey, instruction.content);
 
-  // ── 檢查指導檔是否已存在 ──
   let fileExists = false;
   try {
     await access(targetFile);
@@ -126,27 +104,104 @@ async function main() {
   }
 
   if (fileExists) {
-    // 讀取現有內容
     const existing = await readFile(targetFile, 'utf8');
 
-    // 冪等性檢查：如果已包含相同提示詞的標記，則跳過
     if (existing.includes(startMarker(instructionsKey))) {
-      console.log(`⏭️  指導檔中已包含 "${instruction.name}" 提示詞，跳過安裝。`);
-      return;
+      const msg = `指導檔中已包含 "${instruction.name}" 提示詞，跳過安裝。`;
+      console.log(`⏭️  ${msg}`);
+      return { success: true, message: msg };
     }
 
-    // 附加至最下方
     const newContent = existing.trimEnd() + '\n\n' + wrappedContent + '\n';
     await writeFile(targetFile, newContent, 'utf8');
-    console.log(`✅ [${agentConfig.name}] 已將 "${instruction.name}" 附加至既有指導檔。`);
-  } else {
-    // 建立目錄結構
-    await mkdir(dirname(targetFile), { recursive: true });
-
-    // 建立新檔案並寫入
-    await writeFile(targetFile, wrappedContent + '\n', 'utf8');
-    console.log(`✅ [${agentConfig.name}] 已建立指導檔並寫入 "${instruction.name}" 提示詞。`);
+    const msg = `已將 "${instruction.name}" 附加至既有指導檔。`;
+    console.log(`✅ [${agentConfig.name}] ${msg}`);
+    return { success: true, message: msg };
   }
+
+  await mkdir(dirname(targetFile), { recursive: true });
+  await writeFile(targetFile, wrappedContent + '\n', 'utf8');
+  const msg = `已建立指導檔並寫入 "${instruction.name}" 提示詞。`;
+  console.log(`✅ [${agentConfig.name}] ${msg}`);
+  return { success: true, message: msg };
+}
+
+async function main() {
+  const agentKey = parseArg('--ai-agent');
+  const projectPath = parseArg('--project-path');
+  const instructionsKey = parseArg('--instructions');
+
+  // ── 驗證 --instructions（兩種模式皆需要）──
+  if (!instructionsKey) {
+    const valid = Object.keys(INSTRUCTIONS).join(', ');
+    console.error(`❌ 缺少必填參數 --instructions。可用選項: ${valid}`);
+    process.exit(1);
+  }
+
+  const instruction = INSTRUCTIONS[instructionsKey];
+  if (!instruction) {
+    const valid = Object.keys(INSTRUCTIONS).join(', ');
+    console.error(`❌ 未知的 instructions: "${instructionsKey}"。可用選項: ${valid}`);
+    process.exit(1);
+  }
+
+  // ── 模式一：指定單一 agent ──
+  if (agentKey) {
+    const agentConfig = AGENTS[agentKey];
+    if (!agentConfig) {
+      const valid = Object.keys(AGENTS).join(', ');
+      console.error(`❌ 未知的 agent: "${agentKey}"。可用選項: ${valid}`);
+      process.exit(1);
+    }
+
+    if (!agentConfig.instructionFile) {
+      console.error(`❌ agent "${agentKey}" 未設定 instructionFile。`);
+      process.exit(1);
+    }
+
+    const result = await installForAgent(agentKey, agentConfig, instructionsKey, instruction, projectPath);
+    if (!result.success) process.exit(1);
+    return;
+  }
+
+  // ── 模式二：安裝至全部 agent ──
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║   🧠 Neo Skills — 系統提示詞安裝程式    ║');
+  console.log('╚══════════════════════════════════════════╝');
+  console.log('');
+
+  const results = [];
+
+  for (const [key, config] of Object.entries(AGENTS)) {
+    console.log(`━━━ 正在安裝: ${config.name} ━━━`);
+    try {
+      const result = await installForAgent(key, config, instructionsKey, instruction, projectPath);
+      results.push({ name: config.name, ...result });
+    } catch (error) {
+      console.error(`❌ [${config.name}] 安裝失敗:`, error.message || error);
+      results.push({ name: config.name, success: false, message: error.message || String(error) });
+    }
+    console.log('');
+  }
+
+  // 彙總報告
+  console.log('══════════════════════════════════════════');
+  console.log('📊 安裝結果彙總:');
+  const failed = results.filter(r => !r.success);
+
+  for (const r of results) {
+    console.log(`  ${r.success ? '✅' : '❌'} ${r.name}: ${r.message}`);
+  }
+
+  console.log('');
+  console.log(`成功: ${results.length - failed.length} / ${results.length}`);
+
+  if (failed.length > 0) {
+    console.log(`失敗: ${failed.length} — ${failed.map(r => r.name).join(', ')}`);
+    process.exit(1);
+  }
+
+  console.log('🎉 全部安裝完成！');
 }
 
 main();