botrun-horse 2.30.0 → 2.34.0

package/modules/skill/prompts/zero-framework/smart-cache.md

@@ -0,0 +1,10 @@
+---
+name:           botrun-horse-smart-cache
+description:    零框架智慧快取 — System Prompt 快取清單注入、大模型語意比對取代完全命中、CSV 素材預快取轉換、民眾有感題目優先
+---
+
+./data 有一堆 CSV。然後我現在在 ./bb 底下有一個 gemini_search.mjs。它的快取是放在 ./ch 底下。現在快取的麻煩的點是這樣：它必須完全命中它才會拿快取，我不要完全命中才拿快取。我要你在 Gemini 搜尋的第一次的 prompt 裡面，就把 ./ch 的快取的所有檔案清單放到系統提示工程裡面，讓它知道我有哪些檔案在哪些路徑。然後如果它的輸出是說「我已經有快取」的時候，你就直接讀檔，讀那個檔案，然後直接回答就好了，就不要上網搜尋了。所以你這樣子就可以經過大模型比較聰明的，你就不用完全一樣的字你才有快取，而是在系統提示工程餵過去的時候...你要上網記得上網查一下 Gemini-3-Flash-Preview 的系統提示工程的格式，你不要亂弄。
+
+接下來你的快取，我想預先快取一堆的東西，就是 ./data 底下的 CSV 都是快取的素材來源。現在就麻煩大了，這些素材來源的欄位不統一，並不是檔名是相關性提問、內容是答案的格式。你幫我用一個 somehow 什麼方法，又快又準的把它轉換成我們的快取格式。我不知道你有什麼方法，反正你就把它搞定就對了。感謝。
+
+備註：請挑民眾有感的題目再做快取，新聞就放過它。

package/modules/skill/prompts/zero-framework/trigram-search.md

@@ -0,0 +1,12 @@
+---
+name:           botrun-horse-trigram-search
+description:    零框架 Trigram 全文檢索 CLI — MJS 自然語言拆解關鍵字、FTS5 Trigram 檢索 SQLite、Count 排序 XML 輸出、停用字過濾、給 Agentic AI 大模型調閱
+---
+
+我們現在要做的事情就是真的要去指導它怎麼 SELECT 出來。裡面分成幾個步驟，第一個步驟它必須去拆解你的自然語言，把它拆解成關鍵字。所以我會希望你去寫一個 MJS 的腳本，我們是 Trigram 的 T-R-I-G-R-A-M 的全文檢索或英文的全文檢索。反正你第一個腳本 MJS 你就幫我把它拆，拆成就無腦的拆，你不要用很聰明的方法，你就從第一個字、第二個字、第三個字就用 Trigram 這樣往下拆，英文也是一樣。我們就做成 SELECT 命令的拆解的程式碼了。這超級簡單的，你千萬不要把它想複雜。
+
+然後第二個是你就用 SELECT 命令去對它指定的 SQLite，你把整個 MJS 做成一個 CLI 可以給參數的。針對 SELECT 命令去 SELECT，SELECT 出來以後東西你就按照 Count 次數，就是把 Count 次數最小的放在最前面，零次就不用講了。關鍵字最少的那個資料你就把它放到最上面去，把它做一個 XML 的區隔的 Dump Print 出來。也就是說例如 Count 出現過一次的關鍵字擺第一個，它的資料到底是問是什麼、答是什麼，Data 是怎樣。然後 Count 5 的你就陸續擺，擺五個，它的問答是怎樣。
+
+超過某個 Count 次數的可能就太多了，就是那種關鍵字你就不要擺了，要不然你整個資料庫都進去了。你要注意停用字的問題，停用字要刪掉，「的」啊、「是」啊，這種停用字要刪掉。Count 超過某個 Threshold，這 Threshold 也是 CLI 參數可以指定就不要擺了。你 Dump 出來的就會是一個以 XML Tag 分開一個問答、一個問答的 Print 的資料格式。大模型拿到這個就超開心的了，因為大模型只要把自然語言丟給這個 CLI，它立刻就得到它應該從裡面找答案的內容了。
+
+你幫我做出來把它放在本案的適當目錄底下，要給 Agentic AI 大模型運用。

package/modules/skill/prompts/zero-framework/tts-format.md

@@ -0,0 +1,6 @@
+---
+name:           botrun-horse-tts-format
+description:    零框架 TTS 適配 — 回答限制 500 字以內、禁止 Markdown、口語化語氣、適配語音合成 Avatar 播報
+---
+
+最後回答不要超過 500 字。不要 Markdown。是口語，口語聲音的回答方式。

package/modules/skill/prompts/zero-framework/watermelon-sqlite.md

@@ -0,0 +1,8 @@
+---
+name:           botrun-horse-watermelon-sqlite
+description:    零框架波西瓜 SQLite 孵化 — CSV 匯入 SQLite、_meta 詮釋資料、FTS5 Trigram 全文索引、繁中英文檢索、Agentic AI 知識庫
+---
+
+請你幫我們做一件事，第一個是請你把這些 CSV 都放到 ./db/ 的一個 SQLite 的 database 裡面，單一檔案就好。這是第一步驟。然後下一步驟請你製作一個 _meta，就是詮釋資料。這個裡面是未來小模型只要 SELECT * FROM _meta，它就要可以去相關的 schema 有哪些東西，要能夠一次性地讓模型理解要怎麼 SELECT 的技巧跟技術。好，然後再接下來，我們這個是一個 Agentic AI 的系統，所以你幫忙孵這個 SQLite，我們叫它波西瓜。孵化出來以後，未來我們還會增加一些網路上關於淨零的新聞，零碳排的那種淨零綠生活、淨零時代、綠色技能，這些新聞可能到時候部長問答的時候會用到，所以你也幫我做一個簡單的表，裡面先幫我上網抓一些 2026 年 2 月或 3 月的新聞，抓個 10 個好了，把它先當個 sample 放進去。
+
+未來用的時候，我們會希望用 Trigram，T-R-I-G-R-A-M，這個 Trigram 會建立一個 Index 是 FTS5 的 Index。建立好以後，就可以透過全文檢索把使用者自然語言提問在裡面檢索出相對應的內容給大模型回答了。英文要能夠檢索，所以你的 Index 要有英文的檢索能力。然後 Index 要有 Trigram 的檢索能力，因為是繁體中文。這些都建好以後你就會有一個 SQLite 了。你幫我先把這個 SQLite 建立起來以後，我們要準備用 Agentic AI 對它做掃描測試，謝謝。

package/{bin/commands/writing.mjs → modules/writing/command.mjs}

@@ -1,5 +1,5 @@
 // bin/commands/writing.mjs — writing 指令群組（generate）
-import { timer, jsonOut, readStdin } from '../../lib/core/cli-utils.mjs';
+import { timer, jsonOut, readStdin } from '../_core/cli-utils.mjs';
 
 export async function cmdWritingGenerate(flags) {
   const elapsed = timer();
@@ -7,7 +7,7 @@ export async function cmdWritingGenerate(flags) {
   const project = flags.project || 'nstc';
   const concurrency = parseInt(flags.concurrency) || 10;
 
-  const { GENERATORS, TOP5_OVERRIDES } = await import('../../lib/writing/generators/nstc-generators.mjs');
+  const { GENERATORS, TOP5_OVERRIDES } = await import('./generators/nstc-generators.mjs');
 
   let ids = null;
   if (flags.ids === '-' || (flags.ids === true && !process.stdin.isTTY)) {
@@ -17,7 +17,7 @@ export async function cmdWritingGenerate(flags) {
     ids = flags.ids.split(',').map(Number).filter(Boolean);
   }
 
-  const { generateAll } = await import('../../lib/writing/generate.mjs');
+  const { generateAll } = await import('./generate.mjs');
   const result = await generateAll({
     concurrency, ids, project,
     generators: GENERATORS,

package/{lib → modules}/writing/generate.mjs

@@ -7,8 +7,8 @@ import { renderPdf } from './renderer.mjs';
 import {
   loadDag, loadState, saveState, initState,
   markRunning, markDone, markFailed, getReady, formatStatus,
-} from '../core/dag.mjs';
-import * as paths from '../core/paths.mjs';
+} from '../_core/dag.mjs';
+import * as paths from '../_core/paths.mjs';
 
 /**
  * @param {object} opts

package/modules/writing/index.mjs

@@ -0,0 +1,38 @@
+// modules/writing/index.mjs — 公文撰寫模組自動註冊介面
+// Convention: 每個 modules/<name>/index.mjs 都 export { name, schema, handler }
+
+export const name = 'writing';
+
+export const schema = {
+  name: 'writing',
+  description: '公文撰寫（生成 PDF）',
+  requires_sqlite: false,
+  subcommands: {
+    generate: '平行生成 PDF 文件（DAG 依賴感知批次處理）',
+  },
+  options: {
+    '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
+    '--concurrency=N': { type: 'integer', default: 10, description: '平行並發數' },
+    '--ids=1,2,3': { type: 'string', description: '指定文件 ID（逗號分隔）' },
+    '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
+  },
+  examples: [
+    'bh writing generate --project=nstc',
+    'bh writing generate --project=nstc --ids=1,2,3',
+  ],
+};
+
+export async function handler(subcommand, positionals, flags) {
+  const { cmdWritingGenerate } = await import('./command.mjs');
+  switch (subcommand) {
+    case 'generate': await cmdWritingGenerate(flags); break;
+    default:
+      if (!subcommand) {
+        const { showCommandHelp } = await import('../../bin/commands/help.mjs');
+        showCommandHelp('writing', { writing: schema });
+      } else {
+        process.stderr.write(`writing: 未知子指令 ${subcommand}\n`);
+        process.exit(1);
+      }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botrun-horse",
-  "version": "2.30.0",
+  "version": "2.34.0",
   "description": "多專案文件處理系統 CLI — AI 技能管理、文件擷取、公文撰寫",
   "type": "module",
   "bin": {
@@ -32,7 +32,9 @@
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.30",
     "@google/genai": "^1.43.0",
+    "@hono/node-server": "^1.19.11",
     "@opencode-ai/sdk": "^1.2.15",
+    "hono": "^4.12.5",
     "openai": "^6.25.0",
     "pdfkit": "^0.17.2",
     "undici": "^7.22.0"

package/parallel-dag-todo-list/imagen-module.md

@@ -0,0 +1,51 @@
+# DAG Todo: modules/imagen — Gemini 繪圖模組
+
+## 依賴圖（→ 表示依賴）
+
+```
+[T1] imagen-client.mjs  ──→ (無依賴，核心 library)
+[T2] test/imagen/*.test.mjs ──→ T1
+[T3] command.mjs (CLI) ──→ T1
+[T4] server.mjs (Hono API) ──→ T1
+[T5] index.mjs (模組註冊) ──→ T3, T4
+[T6] npm install hono ──→ (無依賴)
+[T7] 整合測試 + CLI 驗證 ──→ T2, T3, T4, T5, T6
+[T8] bump + commit ──→ T7
+```
+
+## 任務清單
+
+| ID | 任務 | 狀態 | 依賴 |
+|----|------|------|------|
+| T1 | `modules/imagen/imagen-client.mjs` — 核心繪圖 library（生成/編輯/多輪 session） | **done** | — |
+| T2 | `test/imagen/*.test.mjs` — BDD/TDD 測試（17 pass / 0 fail） | **done** | T1 |
+| T3 | `modules/imagen/command.mjs` — CLI 指令（bh imagen generate/edit/serve） | **done** | T1 |
+| T4 | `modules/imagen/server.mjs` — Hono API 伺服器 | **done** | T1 |
+| T5 | `modules/imagen/index.mjs` — 模組自動註冊 | **done** | T3, T4 |
+| T6 | `npm install hono @hono/node-server` | **done** | — |
+| T7 | 整合測試 + CLI 驗證（17 test pass, help 正常） | **done** | T2-T6 |
+| T8 | bump version + commit（v2.34.0, 839ffd5） | **done** | T7 |
+
+## 架構設計
+
+```
+modules/imagen/
+  index.mjs            ← { name, schema, handler } 自動註冊
+  command.mjs           ← CLI: bh imagen generate|edit|serve
+  server.mjs            ← Hono API: POST /api/imagen/generate, /api/imagen/edit
+  imagen-client.mjs     ← 核心：generateImage(), editImage(), createSession()
+```
+
+## API 規格
+
+### CLI
+- `bh imagen generate "一隻貓坐在月亮上"` → 輸出 PNG 檔案
+- `bh imagen generate "prompt" --model=gemini-3-pro-image-preview --size=512px --aspect=16:9`
+- `bh imagen edit input.png "把背景換成海灘"` → 輸出編輯後 PNG
+- `bh imagen serve --port=3000` → 啟動 Hono API
+
+### Hono API
+- `POST /api/imagen/generate` — `{ prompt, model?, size?, aspect? }` → PNG
+- `POST /api/imagen/edit` — `{ prompt, image(base64), model? }` → PNG
+- `POST /api/imagen/session` — `{ sessionId?, prompt, image?(base64) }` → `{ sessionId, image(base64) }`
+- `GET /health` → `{ status: "ok" }`

package/bin/commands/schema.mjs

@@ -1,254 +0,0 @@
-// bin/commands/schema.mjs — 所有指令的結構化 schema（AI/LLM 友善）
-// 集中管理：方便 AI agent 讀取完整指令清單
-
-export const COMMANDS = {
-  doc: {
-    name: 'doc',
-    description: '文件處理（拆頁、轉文字、入庫）— 支援 PDF 與 Office 全系列',
-    requires_sqlite: false,
-    subcommands: {
-      split: '通用 PDF 拆頁（每頁輸出為獨立 PDF）',
-      text: 'PDF 轉純文字（保留頁碼與排版，不需先拆頁）',
-      ingest: 'PDF/Office 入庫流水線（轉文字 → SQLite FTS5）[需 --experimental-sqlite]',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--dir=<路徑>': { type: 'string', description: '掃描單一目錄內所有文件' },
-      '--dirs=<路徑1,路徑2>': { type: 'string', description: '掃描多個目錄（逗號分隔）' },
-      '--outdir=<路徑>': { type: 'string', description: '拆頁輸出目錄（split 指令用）' },
-      '--split-pdf': { type: 'boolean', default: false, description: '[ingest] 同時拆頁成獨立 PDF' },
-      '--recursive': { type: 'boolean', default: false, description: '遞迴掃描子目錄' },
-      '--force': { type: 'boolean', default: false, description: '強制重新入庫（忽略斷點續作紀錄）' },
-      '--concurrency=N': { type: 'integer', default: 5, description: '平行處理數' },
-      '--quiet': { type: 'boolean', default: false, description: '靜默模式（不輸出進度到 stderr，GNU parallel 友善）' },
-      '--print0': { type: 'boolean', default: false, description: 'NUL 分隔路徑輸出（與 xargs -0 相容）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh doc split file1.pdf file2.pdf --project=nstc',
-      'bh doc text --dir=projects/nstc/output/pdfs',
-      'node --experimental-sqlite bin/bh.mjs doc ingest --dir=projects/nstc/pdfs --project=nstc',
-      'node --experimental-sqlite bin/bh.mjs doc ingest --dirs=pdfs/,docs/ --project=nstc --recursive',
-      'node --experimental-sqlite bin/bh.mjs doc ingest file.docx report.xlsx --project=nstc',
-      'node --experimental-sqlite bin/bh.mjs doc ingest --dir=pdfs/ --force --split-pdf --project=nstc',
-      'ls pdfs/*.pdf | node --experimental-sqlite bin/bh.mjs doc ingest --project=nstc',
-      'find . -name "*.pdf" -print0 | xargs -0 -P 4 node bin/bh.mjs doc text --quiet',
-    ],
-  },
-  writing: {
-    name: 'writing',
-    description: '公文撰寫（生成 PDF）',
-    requires_sqlite: false,
-    subcommands: {
-      generate: '平行生成 PDF 文件（DAG 依賴感知批次處理）',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--concurrency=N': { type: 'integer', default: 10, description: '平行並發數' },
-      '--ids=1,2,3': { type: 'string', description: '指定文件 ID（逗號分隔）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh writing generate --project=nstc',
-      'bh writing generate --project=nstc --ids=1,2,3',
-    ],
-  },
-  dag: {
-    name: 'dag',
-    description: 'DAG 依賴追蹤管理',
-    requires_sqlite: false,
-    subcommands: {
-      init: '初始化 DAG 狀態',
-      status: '顯示整體 DAG 進度摘要',
-      ready: '列出目前可執行的任務',
-      list: '列出所有任務及其狀態',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh dag init --project=nstc',
-      'bh dag status --project=nstc',
-      'bh dag ready --format=json --project=nstc',
-    ],
-  },
-  search: {
-    name: 'search',
-    description: 'FTS5 trigram 全文檢索',
-    requires_sqlite: true,
-    subcommands: { query: '搜尋關鍵字' },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--db=<DB路徑>': { type: 'string', description: 'SQLite 資料庫路徑' },
-      '--limit=N': { type: 'integer', description: '限制結果數量' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: ['bh search query "研究計畫" --project=nstc'],
-  },
-  db: {
-    name: 'db',
-    description: 'SQLite 資料庫管理',
-    requires_sqlite: true,
-    subcommands: {
-      stats: '顯示 DB 統計',
-      docs: '列出所有文件 metadata',
-      'pages <doc_id>': '列出指定文件的所有頁面',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--db=<DB路徑>': { type: 'string', description: 'SQLite 路徑' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: ['bh db stats --project=nstc', 'bh db docs --format=json --project=nstc'],
-  },
-  gemini: {
-    name: 'gemini',
-    description: 'Gemini 3 Flash Preview AI 提問（thinking + grounding + url context）',
-    requires_sqlite: false,
-    subcommands: { ask: '向 Gemini 提問（預設啟用深度思考、搜尋接地、URL 擷取）' },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--provider=<名稱>': { type: 'string', default: 'auto', description: 'LLM provider (auto|gemini|gemini-api)' },
-      '--thinking=<等級>': { type: 'string', default: 'MEDIUM', description: '思考等級 (NONE|MINIMAL|LOW|MEDIUM|HIGH)' },
-      '--system-prompt=<文字>': { type: 'string', default: '', description: '系統提示詞' },
-      '--no-grounding': { type: 'boolean', default: false, description: '停用 Google Search 接地' },
-      '--no-url-context': { type: 'boolean', default: false, description: '停用 URL 內容擷取' },
-      '--no-stream': { type: 'boolean', default: false, description: '停用串流（等待完整回應）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh gemini ask "量子糾纏的原理是什麼？"',
-      'bh gemini ask "2026 台灣經濟預測" --format=json',
-      'echo "解釋 AI" | bh gemini ask',
-    ],
-  },
-  nchc: {
-    name: 'nchc',
-    description: '國網 GenAI AI 提問（Mistral 系列，OpenAI 相容介面）',
-    requires_sqlite: false,
-    subcommands: {
-      ask: '向國網 GenAI 提問（支援串流輸出）',
-      agent: '啟動 Agentic AI 代理（工具呼叫、多輪對話）',
-      code: '啟動 Agentic Coding 代理（@opencode-ai/sdk + 675B，需 opencode CLI）',
-      models: '列出可用模型',
-    },
-    options: {
-      '--model=<名稱>': { type: 'string', default: 'Mistral-Large-3-675B-Instruct-2512', description: '模型名稱' },
-      '--system-prompt=<文字>': { type: 'string', default: '', description: '系統提示詞' },
-      '--max-tokens=N': { type: 'integer', default: 8192, description: '最大輸出 tokens' },
-      '--temperature=N': { type: 'number', default: 0.7, description: '溫度（0.0~1.0）' },
-      '--no-stream': { type: 'boolean', default: false, description: '停用串流' },
-      '--max-turns=N': { type: 'integer', default: 20, description: '[agent] 最大迴圈次數' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh nchc ask "台灣半導體產業分析"',
-      'bh nchc agent "列出 lib/ 目錄下所有 .mjs 檔案並說明架構"',
-      'bh nchc models',
-    ],
-  },
-  openrouter: {
-    name: 'openrouter',
-    description: 'OpenRouter AI 提問（400+ 模型，支援網路搜尋）',
-    requires_sqlite: false,
-    subcommands: {
-      ask: '向 OpenRouter 任意模型提問（支援串流 + 網路搜尋）',
-      models: '列出常用模型（含網路搜尋支援說明）',
-    },
-    options: {
-      '--model=<名稱>': { type: 'string', default: 'openai/gpt-4o-mini', description: '模型名稱（任意 OpenRouter 模型 ID，可加 :online 後綴）' },
-      '--web-search': { type: 'boolean', default: false, description: '啟用網路搜尋（plugins: web，適用所有模型）' },
-      '--max-results=N': { type: 'integer', default: 5, description: '搜尋最大結果數（--web-search 時有效）' },
-      '--system-prompt=<文字>': { type: 'string', default: '', description: '系統提示詞' },
-      '--max-tokens=N': { type: 'integer', default: 8192, description: '最大輸出 tokens' },
-      '--temperature=N': { type: 'number', default: 0.7, description: '溫度（0.0~2.0）' },
-      '--no-stream': { type: 'boolean', default: false, description: '停用串流（等待完整回應）' },
-      '--quiet': { type: 'boolean', default: false, description: '靜默模式（不輸出進度到 stderr，GNU parallel 友善）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式（json 含 sources、usage、perf，適合 Agentic AI）' },
-    },
-    examples: [
-      'bh openrouter ask "台灣今日重要新聞" --web-search',
-      'bh openrouter ask "分析 React vs Vue" --model=anthropic/claude-sonnet-4-6',
-      'bh openrouter ask "最新 AI 研究" --model=perplexity/sonar-pro --format=json',
-      'echo "解釋量子糾纏" | bh openrouter ask --model=openai/gpt-4o',
-      'bh openrouter ask "整理今天新聞" --web-search --quiet --format=json | jq .text',
-      'bh openrouter models',
-    ],
-  },
-  legal: {
-    name: 'legal',
-    description: '法律查詢（AI Router + 兩步驟提示工程 + SQLite 快取）[需 --experimental-sqlite]',
-    requires_sqlite: true,
-    subcommands: {
-      ask: '法律問題查詢（Mistral 14B 路由 → 快取命中或 Gemini Pro 搜尋法規 → 法律分析）',
-      cache: '快取管理（list: 列出快取, stats: 統計）',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'legal-cache', description: '專案名稱（決定 SQLite 路徑）' },
-      '--skip-cache': { type: 'boolean', default: false, description: '強制跳過快取，直接呼叫大模型' },
-      '--skip-save': { type: 'boolean', default: false, description: '不將結果存入快取' },
-      '--limit=N': { type: 'integer', default: 20, description: '[cache list] 顯示筆數上限' },
-      '--quiet': { type: 'boolean', default: false, description: '靜默模式（不輸出進度到 stderr）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'node --experimental-sqlite bin/bh.mjs legal ask "房東可以隨意趕走我嗎？"',
-      'node --experimental-sqlite bin/bh.mjs legal ask "勞工被無故解雇有哪些保護？" --format=json',
-      'echo "我的房東說要漲租金，我有辦法拒絕嗎？" | node --experimental-sqlite bin/bh.mjs legal ask',
-      'node --experimental-sqlite bin/bh.mjs legal cache list --project=legal-cache',
-      'node --experimental-sqlite bin/bh.mjs legal cache stats',
-      'node --experimental-sqlite bin/bh.mjs legal ask "問題" --skip-cache --project=legal-cache',
-    ],
-  },
-  skill: {
-    name: 'skill',
-    description: '技能管理（無參數=全列出，帶關鍵字=模糊搜尋）— 零框架技能系列',
-    requires_sqlite: false,
-    subcommands: {
-      '(無)': '列出所有技能（依系列分組）',
-      '<關鍵字>': '模糊搜尋技能（加權全文比對）',
-      list: '列出所有技能（同無參數）',
-      show: '顯示指定技能全文（支援智慧 fallback 搜尋）',
-      search: '模糊搜尋技能（同 <關鍵字>）',
-    },
-    options: {
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-      '--quiet': { type: 'boolean', default: false, description: '靜默模式' },
-    },
-    examples: [
-      'bh skill                         # 列出全部技能',
-      'bh skill 零幻覺                   # 模糊搜尋「零幻覺」',
-      'bh skill show botrun-horse-coding',
-      'bh skill show botrun-horse-coding | pbcopy',
-      'bh skill show botrun-horse-coding --format=json',
-      'bh skill search 換位思考',
-      'bh skill show 切片               # 智慧 fallback：slug 不存在 → 自動搜尋',
-    ],
-  },
-  portal: {
-    name: 'portal',
-    description: '智慧入口（預留）',
-    requires_sqlite: false,
-    subcommands: { status: '顯示入口狀態' },
-    options: {},
-    examples: ['bh portal status'],
-  },
-  ocr: {
-    name: 'ocr',
-    description: 'OCR 辨識（預留）',
-    requires_sqlite: false,
-    subcommands: { scan: '掃描文件' },
-    options: {},
-    examples: ['bh ocr scan file.pdf'],
-  },
-  commands: {
-    name: 'commands',
-    description: '列出所有指令的結構化 schema（AI/LLM 友善）',
-    requires_sqlite: false,
-    options: {
-      '--format=json|text': { type: 'string', default: 'json', description: '輸出格式' },
-    },
-    examples: ['bh commands', "bh commands --format=json | jq 'keys'"],
-  },
-};

package/botrun-c/.claude/skills/DOCX/351/226/261/350/256/200/346/212/200/350/203/275/SKILL.md

@@ -1,103 +0,0 @@
----
-name: DOCX閱讀技能
-description: 將 DOCX 文件轉換為 Markdown 格式並閱讀內容。當使用者需要「讀取 DOCX」、「閱讀 Word 文件」、「轉換 DOCX」、「DOCX 內容」時使用。使用 mammoth.js 進行高品質轉換。(v1.0.0)
-allowed-tools: Bash,Read
----
-
-# DOCX 閱讀技能（v1.0.0）
-
-## 功能說明
-
-將 DOCX 文件轉換為 Markdown 格式，方便 AI 閱讀和分析：
-
-| 功能 | 說明 |
-|------|------|
-| **DOCX 轉 Markdown** | 使用 mammoth.js 高品質轉換 |
-| **保留格式** | 標題、段落、列表、表格 |
-| **批次處理** | 支援轉換多個檔案 |
-
-## 觸發條件
-
-- 使用者需要閱讀 DOCX/Word 文件
-- 檔案副檔名為 `.docx`
-- Google Drive 同步的 DOCX 需要轉換
-
----
-
-## 執行流程
-
-### Step 1：轉換單一 DOCX 檔案
-
-```bash
-node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
-  --input "/path/to/file.docx" \
-  --output "/path/to/output.md"
-```
-
-**參數說明：**
-- `--input` - DOCX 檔案路徑（必填）
-- `--output` - 輸出 Markdown 路徑（選填，預設同目錄）
-
-### Step 2：讀取轉換後的 Markdown
-
-使用 Read 工具讀取轉換後的 `.md` 檔案。
-
----
-
-## 腳本參考
-
-### docx-to-markdown.mjs
-
-```bash
-# 基本用法
-node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
-  --input "/mnt/data/user/file.docx"
-
-# 指定輸出路徑
-node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
-  --input "/mnt/data/user/file.docx" \
-  --output "/mnt/data/user/file.md"
-
-# 直接輸出到 stdout（不存檔）
-node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
-  --input "/mnt/data/user/file.docx" \
-  --stdout
-```
-
-**輸出格式：**
-```json
-{
-  "success": true,
-  "input": "/path/to/input.docx",
-  "output": "/path/to/output.md",
-  "size": 1234,
-  "preview": "前 500 字預覽..."
-}
-```
-
----
-
-## 範例對話
-
-**使用者：** 幫我讀取 gdrive 裡的 DOCX 檔案
-
-**AI：** 好的，讓我先將 DOCX 轉換為 Markdown 格式。
-
-```bash
-node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
-  --input "/tmp/$USER_ID/gdrive/folderId/original/file.docx" \
-  --output "/tmp/$USER_ID/gdrive/folderId/converted/file.md"
-```
-
-轉換成功！讓我讀取內容：
-
-（使用 Read 工具讀取 .md 檔案）
-
----
-
-## 技術細節
-
-- **轉換引擎**：mammoth.js（純 JavaScript）
-- **輸出格式**：Markdown（GitHub Flavored）
-- **支援元素**：標題、段落、粗體、斜體、列表、表格、超連結
-- **限制**：複雜圖表可能無法完美轉換