@moon791017/neo-skills 1.0.38 → 1.0.39

package/README.md

@@ -186,6 +186,7 @@ install-system-instructions --instructions <key> [--ai-agent <name>] [--project-
 | `--instructions <key>` | ✅ | 指定要安裝的系統提示詞（見下方種類表）。 |
 | `--ai-agent <name>` | 否 | 指定目標 Agent（`claude` / `copilot` / `codex`）。省略時安裝至全部。 |
 | `--project-path <path>` | 否 | 指定專案根目錄。省略時安裝至 `$HOME` 全域路徑。 |
+| `--replace-all` | 否 | 若先前已安裝過該提示詞，則先將其移除後重裝。 |
 
 **指導檔路徑對照：**
 
@@ -222,7 +223,7 @@ npx -p @moon791017/neo-skills install-system-instructions \
   --ai-agent copilot --instructions technical-co-founder --project-path /my/project -y
 ```
 
-> **💡** 重複執行相同指令不會重複寫入，系統會自動偵測並跳過已安裝的提示詞。
+> **💡** 重複執行相同指令不會重複寫入，系統會自動偵測並跳過已安裝的提示詞。若您希望覆蓋或更新之前安裝的提示詞，可以加上 `--replace-all` 參數進行重裝。
 
 ## 💡 常用指令範例
 

package/bin/_cli-utils.js

@@ -25,6 +25,7 @@ export function parseCliArgs() {
       'ai-agent': { type: 'string' },
       'project-path': { type: 'string' },
       'instructions': { type: 'string' },
+      'replace-all': { type: 'boolean' },
     },
     strict: false // 允許未定義的參數，避免因為傳入未知的 flag 導致 crash
   });

package/bin/install-system-instructions.js

@@ -4,6 +4,7 @@
  *
  * 用法：
  *   install-system-instructions --instructions technical-co-founder
+ *   install-system-instructions --instructions technical-co-founder --replace-all
  *   install-system-instructions --ai-agent claude --instructions technical-co-founder
  *   install-system-instructions --ai-agent copilot --instructions technical-co-founder --project-path .
  *
@@ -12,6 +13,7 @@
  *                              省略時安裝至全部已註冊 agent。
  *   --instructions <key>      指定要安裝的系統提示詞（可用值見 _system-instructions.js 的 INSTRUCTIONS）。必填。
  *   --project-path <path>     指定專案根目錄作為安裝基底（取代 $HOME）。省略時安裝至全域路徑。
+ *   --replace-all             如果指定此參數，若先前已安裝過該提示詞，則會將其移除後重裝。
  */
 import { readFile, writeFile, mkdir, access } from 'node:fs/promises';
 import { join, resolve, dirname } from 'node:path';
@@ -58,7 +60,7 @@ function wrapContent(key, content) {
  * @param {string | undefined} projectPath - 使用者指定的專案路徑
  * @returns {Promise<{success: boolean, message: string}>}
  */
-async function installForAgent(agentKey, agentConfig, instructionsKey, instruction, projectPath) {
+async function installForAgent(agentKey, agentConfig, instructionsKey, instruction, projectPath, replaceAll) {
   if (!agentConfig.instructionFile) {
     const msg = `agent "${agentKey}" 未設定 instructionFile，跳過。`;
     console.warn(`⚠️ ${msg}`);
@@ -86,17 +88,26 @@ async function installForAgent(agentKey, agentConfig, instructionsKey, instructi
   }
 
   if (fileExists) {
-    const existing = await readFile(targetFile, 'utf8');
-
-    if (existing.includes(startMarker(instructionsKey))) {
+    let existing = await readFile(targetFile, 'utf8');
+    const hadInstructions = existing.includes(startMarker(instructionsKey));
+
+    if (replaceAll) {
+      const regex = new RegExp(`\\s*${startMarker(instructionsKey)}[\\s\\S]*?${endMarker(instructionsKey)}\\s*`, 'g');
+      if (hadInstructions) {
+        existing = existing.replace(regex, '').trimEnd();
+        console.log(`🧹 [${agentConfig.name}] 已移除舊的 "${instruction.name}" 提示詞。`);
+      }
+    } else if (hadInstructions) {
       const msg = `指導檔中已包含 "${instruction.name}" 提示詞，跳過安裝。`;
       console.log(`⏭️  ${msg}`);
       return { success: true, message: msg };
     }
 
-    const newContent = existing.trimEnd() + '\n\n' + wrappedContent + '\n';
+    const newContent = existing.trimEnd() ? existing.trimEnd() + '\n\n' + wrappedContent + '\n' : wrappedContent + '\n';
     await writeFile(targetFile, newContent, 'utf8');
-    const msg = `已將 "${instruction.name}" 附加至既有指導檔。`;
+    const msg = replaceAll && hadInstructions
+      ? `已重裝 "${instruction.name}" 系統提示詞。`
+      : `已將 "${instruction.name}" 附加至既有指導檔。`;
     console.log(`✅ [${agentConfig.name}] ${msg}`);
     return { success: true, message: msg };
   }
@@ -113,6 +124,7 @@ async function main() {
   const agentKey = args['ai-agent'];
   const projectPath = args['project-path'];
   const instructionsKey = args['instructions'];
+  const replaceAll = args['replace-all'];
 
   // ── 驗證 --instructions（兩種模式皆需要）──
   if (!instructionsKey) {
@@ -142,7 +154,7 @@ async function main() {
       process.exit(1);
     }
 
-    const result = await installForAgent(agentKey, agentConfig, instructionsKey, instruction, projectPath);
+    const result = await installForAgent(agentKey, agentConfig, instructionsKey, instruction, projectPath, replaceAll);
     if (!result.success) process.exit(1);
     return;
   }
@@ -158,7 +170,7 @@ async function main() {
   for (const [key, config] of Object.entries(AGENTS)) {
     console.log(`━━━ 正在安裝: ${config.name} ━━━`);
     try {
-      const result = await installForAgent(key, config, instructionsKey, instruction, projectPath);
+      const result = await installForAgent(key, config, instructionsKey, instruction, projectPath, replaceAll);
       results.push({ name: config.name, ...result });
     } catch (error) {
       console.error(`❌ [${config.name}] 安裝失敗:`, error.message || error);

package/package.json

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