botrun-horse 2.29.2 → 2.30.0

package/botrun-c/.claude/skills//345/255/265/345/214/226/346/212/200/350/203/275/scripts/skill-manager.mjs

@@ -0,0 +1,542 @@
+#!/usr/bin/env node
+/**
+ * 技能管理 CLI
+ *
+ * 提供技能的 CRUD 操作命令列介面
+ *
+ * 使用方式：
+ * node $SKILLS_DIR/孵化技能/scripts/skill-manager.mjs <command> [options]
+ *
+ * @version 1.0.0
+ */
+
+import { argv, env, exit } from 'process';
+import { mkdir, readdir, readFile, writeFile, rm, rename, cp, access, stat } from 'fs/promises';
+import { constants } from 'fs';
+import { join, dirname } from 'path';
+
+// ═══════════════════════════════════════════════════════════════
+// 配置（方案 A 簡化版）
+// ═══════════════════════════════════════════════════════════════
+
+// 🔧 新環境變數優先級邏輯：
+// 優先級 1：$USER_PROJECT_SKILLS_DIR（明確指定用戶專案技能目錄）
+// 優先級 2：自動計算（如果都未設置）
+const USER_ID = env.USER_ID || 'unknown';
+const PROJECT_ID = env.PROJECT_ID || 'default';
+const DATA_ROOT = env.DATA_ROOT || '';
+
+const SKILLS_DIR = env.USER_PROJECT_SKILLS_DIR ||
+  (DATA_ROOT ? `${DATA_ROOT}/${USER_ID}/projects/${PROJECT_ID}/.claude/skills` : '');
+
+// 官方技能目錄（唯讀）
+const OFFICIAL_SKILLS_DIR = env.OFFICIAL_SKILLS_DIR || '/.claude/skills';
+
+// ═══════════════════════════════════════════════════════════════
+// 輸出格式化
+// ═══════════════════════════════════════════════════════════════
+
+function output(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+function success(data) {
+  output({ success: true, ...data });
+}
+
+function error(message) {
+  output({ success: false, error: message });
+  exit(1);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 名稱驗證
+// ═══════════════════════════════════════════════════════════════
+
+const RESERVED_NAMES = [
+  'SKILL', 'node_modules', 'scripts', '.git', '.gitignore',
+  '.claude', 'package.json', 'README', 'LICENSE',
+];
+
+function validateName(name) {
+  if (!name || typeof name !== 'string' || name.trim() === '') {
+    return { valid: false, reason: '技能名稱不可為空' };
+  }
+
+  const trimmed = name.trim();
+
+  if (trimmed.includes('\0')) {
+    return { valid: false, reason: '名稱包含非法字元' };
+  }
+
+  if (trimmed.includes('..') || trimmed.includes('/') || trimmed.includes('\\')) {
+    return { valid: false, reason: '名稱禁止包含路徑字元' };
+  }
+
+  if (trimmed.startsWith('.')) {
+    return { valid: false, reason: '名稱禁止以 . 開頭' };
+  }
+
+  const dangerChars = [';', '|', '`', '$(', '&&', '||', '>', '<'];
+  for (const char of dangerChars) {
+    if (trimmed.includes(char)) {
+      return { valid: false, reason: `名稱禁止包含 ${char}` };
+    }
+  }
+
+  if (trimmed.length > 100) {
+    return { valid: false, reason: '名稱長度不可超過 100 字元' };
+  }
+
+  if (RESERVED_NAMES.map(n => n.toUpperCase()).includes(trimmed.toUpperCase())) {
+    return { valid: false, reason: `${trimmed} 是保留名稱` };
+  }
+
+  return { valid: true };
+}
+
+// ═══════════════════════════════════════════════════════════════
+// SKILL.md 解析與生成
+// ═══════════════════════════════════════════════════════════════
+
+function parseSkillMd(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) {
+    throw new Error('缺少 YAML frontmatter');
+  }
+
+  const yaml = match[1];
+  const instructions = content.slice(match[0].length).trim();
+
+  // 簡易 YAML 解析
+  const metadata = {};
+  const lines = yaml.split('\n');
+  let inArray = false;
+  let arrayKey = '';
+  let arrayValues = [];
+
+  for (const line of lines) {
+    if (inArray) {
+      if (line.match(/^\s+-\s+/)) {
+        arrayValues.push(line.replace(/^\s+-\s+/, '').trim());
+        continue;
+      } else {
+        metadata[arrayKey] = arrayValues;
+        inArray = false;
+        arrayValues = [];
+      }
+    }
+
+    const keyMatch = line.match(/^([a-zA-Z_][a-zA-Z0-9_]*):\s*(.*)/);
+    if (keyMatch) {
+      const key = keyMatch[1];
+      const value = keyMatch[2].trim();
+
+      if (value === '') {
+        arrayKey = key;
+        inArray = true;
+        arrayValues = [];
+      } else {
+        metadata[key] = value.replace(/^["']|["']$/g, '');
+      }
+    }
+  }
+
+  if (inArray && arrayValues.length > 0) {
+    metadata[arrayKey] = arrayValues;
+  }
+
+  return { metadata, instructions };
+}
+
+function generateSkillMd(metadata, instructions = '') {
+  let yaml = `name: ${metadata.name}\n`;
+  yaml += `description: ${metadata.description}\n`;
+
+  if (metadata.triggers && metadata.triggers.length > 0) {
+    yaml += 'triggers:\n';
+    for (const trigger of metadata.triggers) {
+      yaml += `  - ${trigger}\n`;
+    }
+  }
+
+  if (metadata.version) {
+    yaml += `version: ${metadata.version}\n`;
+  }
+
+  return `---\n${yaml}---\n\n${instructions}`;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 命令實作
+// ═══════════════════════════════════════════════════════════════
+
+async function cmdCreate(args) {
+  const name = args['--name'];
+  const description = args['--description'] || '新技能';
+  const triggersStr = args['--triggers'];
+  const withScript = args['--with-script'] === true;
+
+  if (!name) {
+    error('缺少必要參數：--name');
+  }
+
+  const validation = validateName(name);
+  if (!validation.valid) {
+    error(validation.reason);
+  }
+
+  const skillPath = join(SKILLS_DIR, name);
+
+  // 檢查是否已存在
+  try {
+    await access(skillPath, constants.F_OK);
+    error(`技能「${name}」已存在`);
+  } catch {
+    // 不存在，繼續
+  }
+
+  // 建立目錄
+  await mkdir(skillPath, { recursive: true });
+
+  const files = [];
+
+  // 生成 SKILL.md
+  const triggers = triggersStr ? triggersStr.split(',').map(t => t.trim()) : [];
+  const metadata = { name, description, triggers, version: '1.0.0' };
+  const skillMdContent = generateSkillMd(metadata, `# ${name}\n\n這是技能的指令內容。`);
+
+  await writeFile(join(skillPath, 'SKILL.md'), skillMdContent, 'utf-8');
+  files.push('SKILL.md');
+
+  // 建立腳本
+  if (withScript) {
+    const scriptsDir = join(skillPath, 'scripts');
+    await mkdir(scriptsDir, { recursive: true });
+    files.push('scripts/');
+
+    const scriptContent = `#!/usr/bin/env node
+/**
+ * ${name} 腳本
+ */
+console.log(JSON.stringify({ success: true, message: '技能執行完成' }));
+`;
+    await writeFile(join(scriptsDir, 'main.mjs'), scriptContent, 'utf-8');
+    files.push('scripts/main.mjs');
+  }
+
+  success({
+    skill: { name, path: skillPath, triggers },
+    files,
+  });
+}
+
+async function cmdRead(args) {
+  const name = args['--name'];
+  const full = args['--full'] === true;
+
+  if (!name) {
+    error('缺少必要參數：--name');
+  }
+
+  const skillPath = join(SKILLS_DIR, name);
+
+  try {
+    await access(skillPath, constants.R_OK);
+  } catch {
+    error(`技能「${name}」不存在`);
+  }
+
+  const content = await readFile(join(skillPath, 'SKILL.md'), 'utf-8');
+  const { metadata, instructions } = parseSkillMd(content);
+
+  const result = {
+    skill: {
+      name: metadata.name,
+      description: metadata.description,
+      triggers: metadata.triggers || [],
+      version: metadata.version,
+    },
+  };
+
+  if (full) {
+    result.content = content;
+  }
+
+  success(result);
+}
+
+async function cmdUpdate(args) {
+  const name = args['--name'];
+
+  if (!name) {
+    error('缺少必要參數：--name');
+  }
+
+  const skillPath = join(SKILLS_DIR, name);
+  const skillMdPath = join(skillPath, 'SKILL.md');
+
+  try {
+    await access(skillPath, constants.R_OK);
+  } catch {
+    error(`技能「${name}」不存在`);
+  }
+
+  const content = await readFile(skillMdPath, 'utf-8');
+  const { metadata, instructions } = parseSkillMd(content);
+
+  // 更新欄位
+  if (args['--description']) {
+    metadata.description = args['--description'];
+  }
+  if (args['--triggers']) {
+    metadata.triggers = args['--triggers'].split(',').map(t => t.trim());
+  }
+
+  let newInstructions = instructions;
+  if (args['--instructions']) {
+    newInstructions = args['--instructions'];
+  }
+
+  const newContent = generateSkillMd(metadata, newInstructions);
+  await writeFile(skillMdPath, newContent, 'utf-8');
+
+  success({ updated: true });
+}
+
+async function cmdDelete(args) {
+  const name = args['--name'];
+  const confirm = args['--confirm'] === true;
+
+  if (!name) {
+    error('缺少必要參數：--name');
+  }
+
+  if (!confirm) {
+    error('刪除操作需要 --confirm 參數');
+  }
+
+  const skillPath = join(SKILLS_DIR, name);
+
+  try {
+    await access(skillPath, constants.R_OK);
+  } catch {
+    error(`技能「${name}」不存在`);
+  }
+
+  await rm(skillPath, { recursive: true, force: true });
+
+  success({ deleted: true, name });
+}
+
+async function cmdList(args) {
+  const filter = args['--filter'];
+
+  let entries = [];
+  try {
+    entries = await readdir(SKILLS_DIR);
+  } catch {
+    success({ skills: [] });
+    return;
+  }
+
+  const skills = [];
+
+  for (const entry of entries) {
+    const skillPath = join(SKILLS_DIR, entry);
+
+    try {
+      const stats = await stat(skillPath);
+      if (!stats.isDirectory()) continue;
+
+      const content = await readFile(join(skillPath, 'SKILL.md'), 'utf-8');
+      const { metadata } = parseSkillMd(content);
+
+      // 過濾
+      if (filter) {
+        const lowerFilter = filter.toLowerCase();
+        const lowerName = (metadata.name || '').toLowerCase();
+        const lowerDesc = (metadata.description || '').toLowerCase();
+        if (!lowerName.includes(lowerFilter) && !lowerDesc.includes(lowerFilter)) {
+          continue;
+        }
+      }
+
+      skills.push({
+        name: metadata.name,
+        description: metadata.description,
+        triggers: metadata.triggers || [],
+        version: metadata.version,
+      });
+    } catch {
+      // 忽略無效技能
+    }
+  }
+
+  success({ skills });
+}
+
+async function cmdRename(args) {
+  const from = args['--from'];
+  const to = args['--to'];
+
+  if (!from || !to) {
+    error('缺少必要參數：--from 和 --to');
+  }
+
+  const validation = validateName(to);
+  if (!validation.valid) {
+    error(`新名稱無效：${validation.reason}`);
+  }
+
+  const oldPath = join(SKILLS_DIR, from);
+  const newPath = join(SKILLS_DIR, to);
+
+  try {
+    await access(oldPath, constants.R_OK);
+  } catch {
+    error(`技能「${from}」不存在`);
+  }
+
+  try {
+    await access(newPath, constants.F_OK);
+    error(`技能「${to}」已存在`);
+  } catch {
+    // 不存在，繼續
+  }
+
+  await rename(oldPath, newPath);
+
+  // 更新 SKILL.md 中的 name
+  try {
+    const content = await readFile(join(newPath, 'SKILL.md'), 'utf-8');
+    const { metadata, instructions } = parseSkillMd(content);
+    metadata.name = to;
+    const newContent = generateSkillMd(metadata, instructions);
+    await writeFile(join(newPath, 'SKILL.md'), newContent, 'utf-8');
+  } catch {
+    // 忽略
+  }
+
+  success({ renamed: true, from, to, newPath });
+}
+
+async function cmdHelp() {
+  const helpText = `
+技能管理 CLI
+
+Usage: node skill-manager.mjs <command> [options]
+
+Commands:
+  create    建立新技能
+  read      讀取技能資訊
+  update    更新技能
+  delete    刪除技能
+  list      列出所有技能
+  rename    重新命名技能
+  help      顯示此說明
+
+Options:
+  --name <name>         技能名稱
+  --description <desc>  技能描述
+  --triggers <t1,t2>    觸發詞（逗號分隔）
+  --with-script         建立腳本模板
+  --full                顯示完整內容
+  --filter <keyword>    過濾關鍵字
+  --from <old>          舊名稱（rename 用）
+  --to <new>            新名稱（rename 用）
+  --confirm             確認刪除操作
+  --instructions <text> 技能指令內容
+
+Examples:
+  node skill-manager.mjs create --name "我的技能" --description "這是描述"
+  node skill-manager.mjs read --name "我的技能" --full
+  node skill-manager.mjs update --name "我的技能" --description "新描述"
+  node skill-manager.mjs delete --name "我的技能" --confirm
+  node skill-manager.mjs list --filter "圖片"
+  node skill-manager.mjs rename --from "舊名稱" --to "新名稱"
+`;
+
+  console.log(helpText);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 參數解析
+// ═══════════════════════════════════════════════════════════════
+
+function parseArgs(args) {
+  const result = { _command: null };
+  let i = 0;
+
+  // 第一個非 -- 開頭的參數是命令
+  while (i < args.length) {
+    const arg = args[i];
+
+    if (!arg.startsWith('--')) {
+      if (!result._command) {
+        result._command = arg;
+      }
+      i++;
+      continue;
+    }
+
+    // 處理 --flag 或 --key value
+    if (i + 1 < args.length && !args[i + 1].startsWith('--')) {
+      result[arg] = args[i + 1];
+      i += 2;
+    } else {
+      result[arg] = true;
+      i++;
+    }
+  }
+
+  return result;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 主程式
+// ═══════════════════════════════════════════════════════════════
+
+async function main() {
+  // 檢查環境變數
+  if (!SKILLS_DIR) {
+    error('缺少環境變數 SKILLS_DIR');
+  }
+
+  const args = parseArgs(argv.slice(2));
+  const command = args._command || 'help';
+
+  try {
+    switch (command) {
+      case 'create':
+        await cmdCreate(args);
+        break;
+      case 'read':
+        await cmdRead(args);
+        break;
+      case 'update':
+        await cmdUpdate(args);
+        break;
+      case 'delete':
+        await cmdDelete(args);
+        break;
+      case 'list':
+        await cmdList(args);
+        break;
+      case 'rename':
+        await cmdRename(args);
+        break;
+      case 'help':
+      case '--help':
+      case '-h':
+        await cmdHelp();
+        break;
+      default:
+        error(`未知命令：${command}`);
+    }
+  } catch (err) {
+    error(err.message || String(err));
+  }
+}
+
+main();

package/botrun-c/.claude/skills//346/234/203/350/255/260/350/250/230/351/214/204/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: 會議記錄技能
+description: 整理會議相關的文字（可能是語音轉文字之後）
+---
+
+# 會議記錄整理原則
+
+## 語言要求
+- 必須使用臺灣繁體中文
+- 禁止使用簡體中文
+- 禁止使用中國大陸用語（如：智能→智慧、信息→資訊、視頻→影片）
+
+## 核心原則：讓未出席者完全理解
+
+你整理的會議記錄必須讓**沒有參加會議的人**看了就能完全理解：
+- 這場會議在討論什麼
+- 為什麼要討論這件事
+- 討論過程中有哪些觀點交鋒
+- 最後達成什麼結論或決議
+- 下一步要做什麼
+
+## 必須包含的結構
+
+### 1. 📋 會議基本資訊
+- 會議主題/目的
+- 與會者（如果有提及）
+- 會議時間（如果有提及）
+
+### 2. 🎯 會議背景與目標
+**這是最重要的部分！** 必須清楚說明：
+- **為什麼要開這場會議**：什麼事情促成了這次討論
+- **希望達成什麼目標**：會議想要解決什麼問題、達成什麼共識
+- **背景脈絡**：相關的前情提要、之前發生了什麼
+
+### 3. 💬 討論過程（按議題分段）
+每個議題必須完整呈現：
+- **議題名稱**：用具體明確的標題，不要用「議題一」這種空泛標題
+- **問題/需求說明**：這個議題要解決什麼問題
+- **討論脈絡**：
+  - 誰提出了什麼觀點
+  - 其他人如何回應
+  - 有沒有不同意見或疑慮
+  - 如何達成共識
+- **決議結果**：最後決定怎麼做、為什麼這樣決定
+
+### 4. 📊 具體內容整理
+如果會議中討論到具體的內容（如：報告架構、功能規劃、執行方案），必須：
+- 完整列出所有討論到的項目
+- 說明每個項目的目的或意義
+- 記錄任何修改建議及原因
+
+### 5. ✅ 結論與行動項目
+- **重要決議**：會議中做出的所有決定
+- **待辦事項**：誰要做什麼、什麼時候完成
+- **後續追蹤**：下次會議時間、需要確認的事項
+
+## 內容詳細度要求
+
+### ❌ 錯誤示範（太簡略）
+```
+### 評測報告討論
+- 決定製作評測報告
+- 報告包含技術分析
+```
+
+### ✅ 正確示範（完整詳細）
+```
+### 📊 為什麼要製作 AI 領袖評測報告
+
+**背景**：
+團隊觀察到市面上缺乏針對臺灣市場的 AI 技術評測資料，
+許多企業在選擇 AI 解決方案時沒有可靠的參考依據。
+
+**目標**：
+1. 建立臺灣第一份系統性的 AI 技術評測報告
+2. 透過報告推廣團隊的技術實力和專業形象
+3. 作為行銷素材吸引潛在客戶
+
+**討論過程**：
+- A 提出應該參考 Gartner 的魔力象限格式，因為企業決策者熟悉這種呈現方式
+- B 認為需要加入臺灣在地化的評測維度，例如中文處理能力
+- 團隊討論後同意兩者都要納入
+
+**決議**：
+確定製作評測報告，架構包含國際標準評測 + 臺灣在地化指標，
+預計下週完成初稿。
+```
+
+## 特別注意事項
+
+### 討論脈絡的一來一往
+當會議中有「為什麼要做這個」的討論時，必須完整記錄：
+- 誰提出這個想法
+- 為什麼提出這個想法（動機、觀察到的問題）
+- 其他人如何回應
+- 經過什麼討論達成共識
+
+### 目標與動機的完整說明
+任何專案、功能、報告的討論，都要說明：
+- **M（目標/Mission）是什麼**：要達成什麼
+- **為什麼設定這個目標**：背後的原因和期望
+- **如何衡量是否達成目標**：如果有討論到
+
+### 禁止的做法
+- ❌ 只列點不解釋
+- ❌ 省略討論過程只寫結論
+- ❌ 用「等等」、「其他」帶過內容
+- ❌ 把多個議題合併成一個模糊的段落
+- ❌ 省略「為什麼」只寫「做什麼」
+
+### 必須做到
+- ✅ 每個議題都有完整的背景說明
+- ✅ 討論過程要有脈絡，不只是列點
+- ✅ 用具體的標題，讓人一看就知道在講什麼
+- ✅ 適當使用 emoji 讓視覺更清晰
+- ✅ 去除語音辨識的錯字，調整成通順的書面語
+- ✅ 保留所有原始討論的意義，不可省略任何重要內容
+
+## 檢查清單
+
+整理完成後，請自我檢查：
+1. [ ] 沒有參加會議的人看得懂嗎？
+2. [ ] 每個討論議題都有說明「為什麼」嗎？
+3. [ ] 討論過程有呈現來龍去脈嗎？
+4. [ ] 所有重要的觀點和決議都有記錄嗎？
+5. [ ] 標題具體明確，不是空泛的「議題一」嗎？
+6. [ ] 內容詳細完整，沒有用「等等」帶過嗎？