botrun-horse 2.29.2 → 2.31.0

package/botrun-c/.claude/skills//347/233/256/351/214/204/345/210/227/350/241/250/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: 目錄列表技能
+description: 樹狀結構目錄列表服務。當使用者需要「列出檔案」、「目錄結構」、「tree」、「ls」、「看有什麼檔案」時使用。零參數設計，完全沙盒化，自動列出工作目錄內容。(v5.1201.1500)
+allowed-tools: Bash
+---
+
+# 📁 目錄列表技能
+
+## 觸發條件
+- 使用者說「列出檔案」、「目錄結構」、「有什麼檔案」
+- 使用者說「tree」、「ls」、「dir」
+- 需要了解專案結構
+
+## 執行方式
+
+執行以下腳本列出目錄結構：
+
+```bash
+node $OFFICIAL_SKILLS_DIR/目錄列表技能/scripts/tree-view.mjs
+```
+
+## 輸出格式
+
+腳本會輸出樹狀結構的目錄列表：
+
+```
+📂 目錄結構 (/path/to/working/dir):
+
+├── 📁 src/
+│   ├── 📄 index.ts (1.5K)
+│   └── 📄 utils.ts (800B)
+└── 📄 package.json (2.1K)
+
+💡 格式說明：
+  📁 = 目錄
+  📄 = 檔案 (顯示大小)
+  自動略過: .開頭檔案、node_modules、dist、build、bak
+```
+
+## 注意事項
+- 此技能不接受任何參數（安全設計）
+- 只列出工作目錄（WORKING_DIR 環境變數或 process.cwd()）
+- 最多遞迴 10 層深度
+- 自動跳過隱藏檔案和常見的建置目錄
+
+## 範例
+
+使用者：「幫我看一下這個專案有什麼檔案」
+
+執行：
+```bash
+node $OFFICIAL_SKILLS_DIR/目錄列表技能/scripts/tree-view.mjs
+```

package/botrun-c/.claude/skills//347/233/256/351/214/204/345/210/227/350/241/250/346/212/200/350/203/275/scripts/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "tree-view-scripts",
+  "version": "1.0.0",
+  "description": "目錄列表技能腳本",
+  "type": "module",
+  "main": "tree-view.mjs",
+  "scripts": {
+    "test": "node tree-view.mjs"
+  },
+  "keywords": ["tree", "directory", "list"],
+  "author": "Botrun",
+  "license": "MIT"
+}

package/botrun-c/.claude/skills//347/233/256/351/214/204/345/210/227/350/241/250/346/212/200/350/203/275/scripts/tree-view.mjs

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * 目錄列表腳本 - 樹狀結構列出工作目錄
+ *
+ * Usage:
+ *   node tree-view.mjs
+ *
+ * 安全特性：
+ *   - 不接受任何參數（防止路徑遍歷）
+ *   - 只列出 WORKING_DIR 或 process.cwd()
+ *
+ * 環境變數：
+ *   WORKING_DIR - 工作目錄（預設：process.cwd()）
+ */
+
+import { readdirSync, statSync } from 'fs';
+import { join } from 'path';
+
+// ============================================================================
+// Core Functions
+// ============================================================================
+
+/**
+ * 建立目錄樹
+ * @param {string} dirPath - 目錄路徑
+ * @param {number} maxDepth - 最大深度
+ * @param {number} currentDepth - 當前深度
+ * @returns {Array} 樹狀結構
+ */
+function buildTree(dirPath, maxDepth = 10, currentDepth = 0) {
+  if (currentDepth >= maxDepth) {
+    return [];
+  }
+
+  try {
+    const entries = readdirSync(dirPath, { withFileTypes: true });
+    const nodes = [];
+
+    for (const entry of entries) {
+      // 跳過隱藏檔案和特定目錄
+      if (
+        entry.name.startsWith('.') ||
+        entry.name === 'node_modules' ||
+        entry.name === 'dist' ||
+        entry.name === 'build' ||
+        entry.name === 'bak'
+      ) {
+        continue;
+      }
+
+      const fullPath = join(dirPath, entry.name);
+
+      try {
+        const stats = statSync(fullPath);
+
+        if (entry.isDirectory()) {
+          const children = buildTree(fullPath, maxDepth, currentDepth + 1);
+          nodes.push({
+            n: entry.name,
+            t: 'd',
+            c: children.length > 0 ? children : undefined,
+          });
+        } else if (entry.isFile()) {
+          nodes.push({
+            n: entry.name,
+            t: 'f',
+            s: stats.size,
+          });
+        }
+      } catch {
+        // 跳過無法存取的檔案
+        continue;
+      }
+    }
+
+    // 排序：目錄在前，然後按名稱排序
+    return nodes.sort((a, b) => {
+      if (a.t !== b.t) {
+        return a.t === 'd' ? -1 : 1;
+      }
+      return a.n.localeCompare(b.n);
+    });
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * 格式化檔案大小
+ * @param {number} bytes - 位元組
+ * @returns {string} 格式化字串
+ */
+function formatSize(bytes) {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}K`;
+  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}G`;
+}
+
+/**
+ * 將樹轉換為文字格式
+ * @param {Array} nodes - 樹狀節點
+ * @param {string} prefix - 前綴
+ * @returns {string} 文字輸出
+ */
+function treeToText(nodes, prefix = '') {
+  let result = '';
+
+  nodes.forEach((node, index) => {
+    const isLastNode = index === nodes.length - 1;
+    const connector = isLastNode ? '└── ' : '├── ';
+    const icon = node.t === 'd' ? '📁 ' : '📄 ';
+    const sizeInfo = node.t === 'f' && node.s !== undefined ? ` (${formatSize(node.s)})` : '';
+
+    result += `${prefix}${connector}${icon}${node.n}${sizeInfo}\n`;
+
+    if (node.c && node.c.length > 0) {
+      const newPrefix = prefix + (isLastNode ? '    ' : '│   ');
+      result += treeToText(node.c, newPrefix);
+    }
+  });
+
+  return result;
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+function main() {
+  const workingDir = process.env.WORKING_DIR || process.cwd();
+
+  try {
+    const tree = buildTree(workingDir);
+    const textOutput = treeToText(tree);
+
+    console.log(`📂 目錄結構 (${workingDir}):\n`);
+    console.log(textOutput);
+    console.log(`💡 格式說明：`);
+    console.log(`  📁 = 目錄`);
+    console.log(`  📄 = 檔案 (顯示大小)`);
+    console.log(`  自動略過: .開頭檔案、node_modules、dist、build、bak`);
+  } catch (error) {
+    console.error(`❌ 無法列出目錄結構: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/botrun-c/.claude/skills//347/264/224/346/226/207/345/255/227/345/244/232/346/252/224/346/241/210/350/256/200/345/217/226/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: 純文字多檔案讀取技能
+description: 純文字多檔案閱讀服務。當使用者需要「讀取檔案」、「批次讀取」、「*.txt」、「**/*.md」等 glob 模式時使用。XML 標籤區隔不同檔案，防止路徑遍歷攻擊。(v5.1201.1500)
+allowed-tools: Bash
+---
+
+# 📖 純文字多檔案讀取技能
+
+## 觸發條件
+- 使用者說「讀取檔案」、「讀多個檔案」、「批次讀取」
+- 使用者提供 glob 模式如 `*.txt`、`**/*.md`、`src/**/*.ts`
+- 需要同時閱讀多個文字檔案
+
+## 執行方式
+
+執行以下腳本進行讀取：
+
+```bash
+node $OFFICIAL_SKILLS_DIR/純文字多檔案讀取技能/scripts/secure-read.mjs "檔案路徑或glob模式"
+```
+
+### 讀取多個檔案
+
+```bash
+# 讀取單一檔案
+node .../secure-read.mjs "README.md"
+
+# 讀取多個檔案
+node .../secure-read.mjs "README.md" "package.json"
+
+# 使用 glob 模式
+node .../secure-read.mjs "*.md"
+node .../secure-read.mjs "src/**/*.ts"
+node .../secure-read.mjs "docs/*.md" "*.json"
+```
+
+## 輸出格式
+
+腳本會輸出 XML 標籤包裝的檔案內容：
+
+```xml
+<files count="3">
+<file path="README.md">
+# Project Title
+This is the README content...
+</file>
+
+<file path="package.json">
+{
+  "name": "project",
+  "version": "1.0.0"
+}
+</file>
+
+<file path="src/index.ts">
+export function main() {
+  console.log('Hello');
+}
+</file>
+</files>
+```
+
+## 安全特性
+- 所有路徑都被限制在工作目錄內
+- 禁止路徑遍歷（禁止存取上層目錄）
+- 只能讀取檔案，不能讀取目錄
+- 自動去除重複的檔案
+
+## 支援的 glob 模式
+- `*`：匹配單一層級的任意字元（不含 `/`）
+- `**`：匹配任意層級的目錄
+- `?`：匹配單一字元
+- `[abc]`：匹配括號內的任一字元
+
+## 範例
+
+使用者：「幫我讀取 src 目錄下所有的 TypeScript 檔案」
+
+執行：
+```bash
+node $OFFICIAL_SKILLS_DIR/純文字多檔案讀取技能/scripts/secure-read.mjs "src/**/*.ts"
+```

package/botrun-c/.claude/skills//347/264/224/346/226/207/345/255/227/345/244/232/346/252/224/346/241/210/350/256/200/345/217/226/346/212/200/350/203/275/scripts/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "secure-read-scripts",
+  "version": "1.0.0",
+  "description": "安全讀取技能腳本",
+  "type": "module",
+  "main": "secure-read.mjs",
+  "scripts": {
+    "test": "node secure-read.mjs '*.json'"
+  },
+  "keywords": ["read", "glob", "security"],
+  "author": "Botrun",
+  "license": "MIT",
+  "dependencies": {
+    "glob": "^11.0.0"
+  }
+}

package/botrun-c/.claude/skills//347/264/224/346/226/207/345/255/227/345/244/232/346/252/224/346/241/210/350/256/200/345/217/226/346/212/200/350/203/275/scripts/secure-read.mjs

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+// 安全讀取腳本 - 多檔案讀取（支援 glob 模式）
+// Usage: node secure-read.mjs "file.txt"
+// Usage: node secure-read.mjs "pattern1" "pattern2"
+// 安全特性: 路徑沙盒化、只讀取檔案
+// 環境變數: WORKING_DIR - 工作目錄（預設：process.cwd()）
+
+import { existsSync, readFileSync, statSync } from 'fs';
+import { resolve, relative, isAbsolute, join } from 'path';
+import { glob } from 'glob';
+
+// ============================================================================
+// Configuration
+// ============================================================================
+
+const WORKING_DIR = process.env.WORKING_DIR || process.cwd();
+
+// ============================================================================
+// Path Validation
+// ============================================================================
+
+/**
+ * 驗證並解析路徑
+ * @param {string} filePath - 檔案路徑
+ * @returns {{valid: boolean, resolvedPath?: string, relativePath?: string, error?: string}}
+ */
+function validateAndResolvePath(filePath) {
+  try {
+    // Convert to absolute path
+    const absolutePath = isAbsolute(filePath) ? filePath : resolve(WORKING_DIR, filePath);
+
+    // Security: Ensure path is within working directory
+    if (!absolutePath.startsWith(WORKING_DIR)) {
+      return {
+        valid: false,
+        error: `路徑遍歷偵測: ${filePath} 在工作目錄之外`,
+      };
+    }
+
+    // Check if file exists
+    if (!existsSync(absolutePath)) {
+      return {
+        valid: false,
+        error: `檔案不存在: ${filePath}`,
+      };
+    }
+
+    // Check if it's a file (not a directory)
+    const stats = statSync(absolutePath);
+    if (!stats.isFile()) {
+      return {
+        valid: false,
+        error: `不是檔案: ${filePath}`,
+      };
+    }
+
+    // Get relative path for output
+    const relativePath = relative(WORKING_DIR, absolutePath);
+
+    return {
+      valid: true,
+      resolvedPath: absolutePath,
+      relativePath,
+    };
+  } catch (error) {
+    return {
+      valid: false,
+      error: error.message,
+    };
+  }
+}
+
+// ============================================================================
+// Glob Pattern Expansion
+// ============================================================================
+
+/**
+ * 展開 glob 模式
+ * @param {string[]} patterns - 模式陣列
+ * @returns {Promise<{success: boolean, files?: string[], error?: string}>}
+ */
+async function expandGlobPatterns(patterns) {
+  try {
+    const allFiles = [];
+
+    for (const pattern of patterns) {
+      // Resolve pattern relative to working directory
+      const absolutePattern = isAbsolute(pattern) ? pattern : join(WORKING_DIR, pattern);
+
+      // Security check: Pattern must be within working directory
+      if (!absolutePattern.startsWith(WORKING_DIR)) {
+        return {
+          success: false,
+          error: `模式嘗試路徑遍歷: ${pattern}`,
+        };
+      }
+
+      // Execute glob
+      const matches = await glob(pattern, {
+        cwd: WORKING_DIR,
+        absolute: false,
+        nodir: true, // Only files, not directories
+      });
+
+      allFiles.push(...matches);
+    }
+
+    // Remove duplicates
+    const uniqueFiles = Array.from(new Set(allFiles));
+
+    return {
+      success: true,
+      files: uniqueFiles,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error.message,
+    };
+  }
+}
+
+// ============================================================================
+// File Reading
+// ============================================================================
+
+/**
+ * 讀取單一檔案並格式化
+ * @param {string} filePath - 檔案路徑
+ * @returns {{success: boolean, content?: string, error?: string}}
+ */
+function readAndFormatFile(filePath) {
+  try {
+    const validation = validateAndResolvePath(filePath);
+
+    if (!validation.valid) {
+      return {
+        success: false,
+        error: validation.error,
+      };
+    }
+
+    const absolutePath = validation.resolvedPath;
+    const relativePath = validation.relativePath;
+
+    // Read file content
+    const content = readFileSync(absolutePath, 'utf-8');
+
+    // Format with XML tags
+    const formatted = `<file path="${relativePath}">
+${content}
+</file>`;
+
+    return {
+      success: true,
+      content: formatted,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error.message,
+    };
+  }
+}
+
+/**
+ * 讀取多個檔案
+ * @param {string[]} patterns - 模式陣列
+ * @returns {Promise<{success: boolean, content?: string, fileCount?: number, error?: string}>}
+ */
+async function readMultipleFiles(patterns) {
+  try {
+    // Expand glob patterns
+    const expansion = await expandGlobPatterns(patterns);
+
+    if (!expansion.success) {
+      return {
+        success: false,
+        error: expansion.error,
+      };
+    }
+
+    const files = expansion.files;
+
+    if (files.length === 0) {
+      return {
+        success: false,
+        error: '沒有檔案符合指定的模式',
+      };
+    }
+
+    // Read all files
+    const results = [];
+    const errors = [];
+
+    for (const file of files) {
+      const result = readAndFormatFile(file);
+
+      if (result.success) {
+        results.push(result.content);
+      } else {
+        errors.push(`${file}: ${result.error}`);
+      }
+    }
+
+    if (results.length === 0) {
+      return {
+        success: false,
+        error: `沒有檔案可以讀取。錯誤: ${errors.join(', ')}`,
+      };
+    }
+
+    // Combine all files with a wrapper
+    const combined = `<files count="${results.length}">
+${results.join('\n\n')}
+</files>`;
+
+    return {
+      success: true,
+      content: combined,
+      fileCount: results.length,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error.message,
+    };
+  }
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('❌ 請提供檔案路徑或 glob 模式');
+    console.error('');
+    console.error('Usage: node secure-read.mjs "pattern1" "pattern2" ...');
+    console.error('');
+    console.error('Examples:');
+    console.error('  node secure-read.mjs "README.md"');
+    console.error('  node secure-read.mjs "*.md" "*.json"');
+    console.error('  node secure-read.mjs "src/**/*.ts"');
+    process.exit(1);
+  }
+
+  const result = await readMultipleFiles(args);
+
+  if (result.success) {
+    console.log(result.content);
+  } else {
+    console.error(`❌ ${result.error}`);
+    process.exit(1);
+  }
+}
+
+main();