botrun-horse 2.29.2 → 2.30.0

package/botrun-c/.claude/skills//345/244/232/346/250/241/346/205/213/351/226/261/350/256/200/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: 多模態閱讀技能
+description: Vertex AI 多模態閱讀服務（Claude Haiku 4.5 台灣端點）。當使用者需要「閱讀 PDF」、「分析圖片」、「看影片」、「聽音訊」時使用。支援 PDF/TXT/PNG/JPG/WebP/MP4/MP3 等格式，最多 30 個檔案，支援 glob 模式。(v5.1201.1500)
+allowed-tools: Bash
+---
+
+# 📚 多模態閱讀技能
+
+## 觸發條件
+- 使用者說「閱讀 PDF」、「分析圖片」、「看這個檔案」
+- 使用者上傳 PDF、圖片、影片、音訊檔案
+- 需要理解文件、圖片、影片或音訊內容
+
+## 執行方式
+
+執行以下腳本進行多模態閱讀：
+
+```bash
+node $OFFICIAL_SKILLS_DIR/多模態閱讀技能/scripts/multimodal-read.mjs "檔案路徑"
+```
+
+### 進階選項
+
+```bash
+# 讀取單一檔案
+node .../multimodal-read.mjs "document.pdf"
+
+# 讀取多個檔案
+node .../multimodal-read.mjs "page1.pdf" "page2.pdf"
+
+# 使用 glob 模式
+node .../multimodal-read.mjs "uploads/*.pdf"
+node .../multimodal-read.mjs "images/*.png"
+
+# 自訂問題
+node .../multimodal-read.mjs "report.pdf" --prompt "這份報告的重點摘要是什麼？"
+```
+
+## 輸出格式
+
+腳本會輸出 Markdown 格式的分析結果：
+
+```markdown
+## 多模態閱讀結果
+
+**統計資訊：**
+- 總檔案數: 3
+- 成功: 3
+- 失敗: 0
+
+### document.pdf
+
+[Claude 對文件內容的分析...]
+
+### image.png
+
+[Claude 對圖片內容的分析...]
+```
+
+## 支援的檔案格式
+
+| 類型 | 格式 |
+|------|------|
+| 文件 | PDF, TXT |
+| 圖片 | PNG, JPG, JPEG, WebP |
+| 影片 | MP4, MOV, WebM, MPEG, FLV, WMV, 3GP |
+| 音訊 | MP3, WAV, AAC, FLAC, M4A, Opus |
+
+## 技術特性
+- **模型**: Claude Haiku 4.5（Vertex AI 台灣端點）
+- **最大檔案數**: 30 個（安全限制）
+- **平行處理**: 所有檔案同時處理
+- **Glob 支援**: 萬用字元模式匹配
+
+## 環境需求
+- GOOGLE_CLOUD_PROJECT（預設: botrun-c）
+- Google Cloud 認證（gcloud auth）
+
+## 範例
+
+使用者：「幫我分析這份 PDF 的內容」
+
+執行：
+```bash
+node $OFFICIAL_SKILLS_DIR/多模態閱讀技能/scripts/multimodal-read.mjs "uploads/document.pdf"
+```

package/botrun-c/.claude/skills//345/244/232/346/250/241/346/205/213/351/226/261/350/256/200/346/212/200/350/203/275/scripts/multimodal-read.mjs

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+// 多模態閱讀腳本 - 使用 Vertex AI Claude
+// Usage: node multimodal-read.mjs "file.pdf" [--prompt "問題"]
+// 環境變數: GOOGLE_CLOUD_PROJECT, WORKING_DIR
+
+import Anthropic from '@anthropic-ai/vertex-sdk';
+import { existsSync, readFileSync, statSync } from 'fs';
+import { basename, resolve, isAbsolute, relative } from 'path';
+import { glob } from 'glob';
+
+// ============================================================================
+// 配置
+// ============================================================================
+
+const GOOGLE_CLOUD_PROJECT = process.env.GOOGLE_CLOUD_PROJECT || 'botrun-c';
+const VERTEX_AI_REGION = 'asia-east1';
+const CLAUDE_MODEL = 'claude-haiku-4-5@20251001';
+const WORKING_DIR = process.env.WORKING_DIR || process.cwd();
+const MAX_FILES = 30;
+
+// ============================================================================
+// 日誌
+// ============================================================================
+
+function log(...args) {
+  console.error('[Multimodal-Reader]', ...args);
+}
+
+// ============================================================================
+// Vertex AI 初始化
+// ============================================================================
+
+let client = null;
+
+try {
+  client = new Anthropic({
+    projectId: GOOGLE_CLOUD_PROJECT,
+    region: VERTEX_AI_REGION,
+  });
+  log('Vertex AI 初始化成功');
+} catch (error) {
+  log('Vertex AI 初始化失敗:', error.message);
+}
+
+// ============================================================================
+// 檔案類型判斷
+// ============================================================================
+
+function getContentType(fileName) {
+  const ext = fileName.toLowerCase().split('.').pop();
+
+  const contentTypes = {
+    // Images
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    webp: 'image/webp',
+    // Videos
+    flv: 'video/x-flv',
+    mov: 'video/quicktime',
+    mpeg: 'video/mpeg',
+    mpg: 'video/mpg',
+    mp4: 'video/mp4',
+    webm: 'video/webm',
+    wmv: 'video/wmv',
+    '3gp': 'video/3gpp',
+    // Audio
+    aac: 'audio/aac',
+    flac: 'audio/flac',
+    mp3: 'audio/mp3',
+    m4a: 'audio/m4a',
+    opus: 'audio/opus',
+    pcm: 'audio/pcm',
+    wav: 'audio/wav',
+    // Documents
+    pdf: 'application/pdf',
+    txt: 'text/plain',
+  };
+
+  return contentTypes[ext] || 'application/pdf';
+}
+
+// ============================================================================
+// 路徑驗證
+// ============================================================================
+
+function validateAndResolvePath(filePath) {
+  try {
+    const absolutePath = isAbsolute(filePath) ? filePath : resolve(WORKING_DIR, filePath);
+    const relativePath = relative(WORKING_DIR, absolutePath);
+
+    if (relativePath.startsWith('..') || isAbsolute(relativePath)) {
+      return { valid: false, error: `路徑遍歷偵測: ${filePath}` };
+    }
+
+    if (!existsSync(absolutePath)) {
+      return { valid: false, error: `檔案不存在: ${filePath}` };
+    }
+
+    const stats = statSync(absolutePath);
+    if (!stats.isFile()) {
+      return { valid: false, error: `不是檔案: ${filePath}` };
+    }
+
+    return { valid: true, resolvedPath: absolutePath };
+  } catch (error) {
+    return { valid: false, error: error.message };
+  }
+}
+
+// ============================================================================
+// 路徑解析（支援 glob）
+// ============================================================================
+
+async function resolveFilePaths(patterns) {
+  try {
+    const patternArray = Array.isArray(patterns) ? patterns : [patterns];
+    const allFiles = new Set();
+
+    for (const pattern of patternArray) {
+      if (pattern.includes('*') || pattern.includes('?') || pattern.includes('[')) {
+        const matches = await glob(pattern, {
+          cwd: WORKING_DIR,
+          absolute: true,
+          nodir: true,
+        });
+
+        for (const match of matches) {
+          const validation = validateAndResolvePath(match);
+          if (validation.valid) {
+            allFiles.add(validation.resolvedPath);
+          }
+        }
+      } else {
+        const validation = validateAndResolvePath(pattern);
+        if (validation.valid) {
+          allFiles.add(validation.resolvedPath);
+        } else {
+          return { success: false, error: validation.error };
+        }
+      }
+    }
+
+    const resolvedFiles = Array.from(allFiles);
+
+    if (resolvedFiles.length > MAX_FILES) {
+      return { success: false, error: `檔案太多: ${resolvedFiles.length}（最多 ${MAX_FILES}）` };
+    }
+
+    if (resolvedFiles.length === 0) {
+      return { success: false, error: '沒有檔案符合模式' };
+    }
+
+    return { success: true, filePaths: resolvedFiles };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+
+// ============================================================================
+// 讀取單一檔案
+// ============================================================================
+
+async function readSingleFile(filePath, prompt) {
+  const fileName = basename(filePath);
+
+  try {
+    if (!client) {
+      throw new Error('Vertex AI 未初始化');
+    }
+
+    // 讀取檔案並轉 base64
+    const buffer = readFileSync(filePath);
+    const base64Data = buffer.toString('base64');
+    const mediaType = getContentType(fileName);
+
+    log(`閱讀中: ${fileName} (${mediaType})`);
+
+    // 準備 content block
+    const userPrompt = prompt || '請詳細描述這份文件的所有內容，包含文字、圖片、圖表等所有視覺元素。';
+
+    let contentBlock;
+    if (mediaType.startsWith('image/')) {
+      contentBlock = {
+        type: 'image',
+        source: { type: 'base64', media_type: mediaType, data: base64Data },
+      };
+    } else {
+      contentBlock = {
+        type: 'document',
+        source: { type: 'base64', media_type: mediaType, data: base64Data },
+      };
+    }
+
+    // 呼叫 Vertex AI
+    const response = await client.messages.create({
+      model: CLAUDE_MODEL,
+      max_tokens: 4096,
+      messages: [
+        {
+          role: 'user',
+          content: [contentBlock, { type: 'text', text: userPrompt }],
+        },
+      ],
+    });
+
+    const textContent = response.content
+      .filter(block => block.type === 'text')
+      .map(block => block.text)
+      .join('\n');
+
+    log(`完成: ${fileName}`);
+
+    return { success: true, fileName, content: textContent };
+  } catch (error) {
+    log(`失敗: ${fileName}`, error.message);
+    return { success: false, fileName, error: error.message };
+  }
+}
+
+// ============================================================================
+// 讀取多個檔案
+// ============================================================================
+
+async function readMultipleFiles(filePaths, prompt) {
+  const promises = filePaths.map(p => readSingleFile(p, prompt));
+  const results = await Promise.all(promises);
+
+  const successCount = results.filter(r => r.success).length;
+  const failureCount = results.filter(r => !r.success).length;
+
+  return { results, totalFiles: results.length, successCount, failureCount };
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('❌ 請提供檔案路徑');
+    console.error('');
+    console.error('Usage: node multimodal-read.mjs "file.pdf" [--prompt "問題"]');
+    console.error('');
+    console.error('Examples:');
+    console.error('  node multimodal-read.mjs "document.pdf"');
+    console.error('  node multimodal-read.mjs "*.pdf" --prompt "摘要這些文件"');
+    process.exit(1);
+  }
+
+  // 解析參數
+  const filePaths = [];
+  let prompt = null;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--prompt') {
+      prompt = args[++i];
+    } else if (!args[i].startsWith('--')) {
+      filePaths.push(args[i]);
+    }
+  }
+
+  if (filePaths.length === 0) {
+    console.error('❌ 請提供至少一個檔案路徑');
+    process.exit(1);
+  }
+
+  // 檢查 Vertex AI
+  if (!client) {
+    console.error('❌ Vertex AI 未初始化，請檢查 Google Cloud 認證');
+    process.exit(1);
+  }
+
+  // 解析檔案路徑
+  const resolved = await resolveFilePaths(filePaths);
+  if (!resolved.success) {
+    console.error(`❌ ${resolved.error}`);
+    process.exit(1);
+  }
+
+  // 讀取檔案
+  const result = await readMultipleFiles(resolved.filePaths, prompt);
+
+  // 輸出結果
+  console.log(`## 多模態閱讀結果\n`);
+  console.log(`**統計資訊：**`);
+  console.log(`- 總檔案數: ${result.totalFiles}`);
+  console.log(`- 成功: ${result.successCount}`);
+  console.log(`- 失敗: ${result.failureCount}\n`);
+
+  for (const r of result.results) {
+    console.log(`### ${r.fileName}\n`);
+    if (r.success) {
+      console.log(r.content);
+    } else {
+      console.log(`❌ 錯誤: ${r.error}`);
+    }
+    console.log('');
+  }
+}
+
+main();

package/botrun-c/.claude/skills//345/244/232/346/250/241/346/205/213/351/226/261/350/256/200/346/212/200/350/203/275/scripts/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "multimodal-read-scripts",
+  "version": "1.0.0",
+  "description": "多模態閱讀技能腳本",
+  "type": "module",
+  "main": "multimodal-read.mjs",
+  "scripts": {
+    "test": "echo 'Requires GOOGLE_CLOUD_PROJECT and files'"
+  },
+  "keywords": ["multimodal", "pdf", "image", "vertex-ai"],
+  "author": "Botrun",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/vertex-sdk": "^0.14.0",
+    "glob": "^11.0.0"
+  }
+}

package/botrun-c/.claude/skills//345/255/265/345/214/226/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: 孵化技能
+description: 透過對話建立、管理專案技能的 CRUD 工具
+triggers:
+  - 孵化技能
+  - 孵化
+  - 建立技能
+  - 新增技能
+  - 技能管理
+  - 管理技能
+  - create skill
+  - incubate skill
+version: 1.0.0
+---
+
+# 孵化技能
+
+你是一個技能孵化助手，可以幫助使用者透過對話建立和管理專案技能。
+
+## 安全限制
+
+**重要：你只能操作專案技能目錄（project skills），禁止修改全域技能或官方技能。**
+
+- ✅ 允許：`/mnt/data/{userId}/projects/{projectId}/.claude/skills/**`
+- ❌ 禁止：`/mnt/data/{userId}/.claude/skills/**`（全域技能）
+- ❌ 禁止：`~/.claude/skills/**`（官方技能）
+
+## 可用命令
+
+使用以下 Bash 命令操作技能（所有輸出為 JSON 格式）：
+
+### 1. 建立技能
+
+```bash
+node $OFFICIAL_SKILLS_DIR/孵化技能/scripts/skill-manager.mjs create \
+  --name "技能名稱" \
+  --description "技能描述" \
+  --triggers "觸發詞1,觸發詞2" \
+  --with-script
+```
+
+### 2. 讀取技能
+
+```bash
+node $OFFICIAL_SKILLS_DIR/孵化技能/scripts/skill-manager.mjs read \
+  --name "技能名稱" \
+  --full
+```
+
+### 3. 更新技能
+
+```bash
+node $OFFICIAL_SKILLS_DIR/孵化技能/scripts/skill-manager.mjs update \
+  --name "技能名稱" \
+  --description "新描述" \
+  --triggers "新觸發詞1,新觸發詞2" \
+  --instructions "新的指令內容"
+```
+
+### 4. 刪除技能
+
+```bash
+node $OFFICIAL_SKILLS_DIR/孵化技能/scripts/skill-manager.mjs delete \
+  --name "技能名稱" \
+  --confirm
+```
+
+### 5. 列出所有技能
+
+```bash
+node $OFFICIAL_SKILLS_DIR/孵化技能/scripts/skill-manager.mjs list
+node $OFFICIAL_SKILLS_DIR/孵化技能/scripts/skill-manager.mjs list --filter "關鍵字"
+```
+
+### 6. 重新命名技能
+
+```bash
+node $OFFICIAL_SKILLS_DIR/孵化技能/scripts/skill-manager.mjs rename \
+  --from "舊名稱" \
+  --to "新名稱"
+```
+
+## JSON 輸出格式
+
+所有命令輸出 JSON 格式：
+
+成功：
+```json
+{
+  "success": true,
+  "skill": { "name": "...", "description": "...", "triggers": [...] },
+  "files": ["SKILL.md", "scripts/main.mjs"]
+}
+```
+
+失敗：
+```json
+{
+  "success": false,
+  "error": "錯誤訊息"
+}
+```
+
+## 對話範例
+
+### 使用者說：「幫我建立一個新技能」
+
+1. 詢問技能名稱
+2. 詢問技能描述
+3. 詢問觸發詞
+4. 詢問是否需要腳本
+5. 執行 create 命令
+6. 回報建立結果
+
+### 使用者說：「列出我的技能」
+
+執行 list 命令並以表格格式顯示結果。
+
+### 使用者說：「刪除技能」
+
+1. 確認要刪除的技能名稱
+2. 警告使用者刪除操作不可逆
+3. 取得使用者確認後執行 delete 命令
+
+## 注意事項
+
+1. 技能名稱不可包含 `..`、`/`、`\` 等路徑字元
+2. 技能名稱不可以 `.` 開頭
+3. 技能名稱長度不可超過 100 字元
+4. 刪除操作需要使用者明確確認
+5. 所有輸出都是 JSON 格式，方便解析