botrun-horse 2.30.0 → 2.34.0

package/botrun-c/.claude/skills/p320-moj-review/SKILL.md

@@ -1,200 +0,0 @@
----
-name: p320-moj-review
-description: 產生觀護輔導紀要（報表編號 320070）。使用於收到個案資料夾（含 PDF、DOCX、音訊等檔案）後，自動轉換為純文字並依官方格式撰寫觀護輔導紀要。
-allowed-tools: Bash
----
-
-# 觀護輔導紀要產生器
-
-接收個案資料夾，自動將所有文件（PDF、DOCX、音訊）轉為純文字，再依法務部觀護輔導紀要官方格式（報表編號 320070），逐項撰寫觀護輔導紀要。
-
-## 使用方式
-
-呼叫時需提供一個資料夾路徑，例如：
-
-```
-/p320-moj-review /path/to/case-folder
-```
-
-或在對話中指定：「幫我用 p320-moj-review 處理 /path/to/case-folder」
-
-## 執行流程
-
-### Phase 1：文件轉純文字
-
-掃描輸入資料夾中的所有檔案，依副檔名分派至對應 skill 進行轉換，將純文字結果統一輸出到 `{輸入資料夾}/純文字output/` 目錄。
-
-**檔案類型對應處理方式：**
-
-| 副檔名 | 使用的 Skill | 轉換指令 |
-|--------|-------------|---------|
-| `.pdf` | pdf-multimodal-processor | `uv run $OFFICIAL_SKILLS_DIR/pdf-multimodal-processor/scripts/process_pdf.py -i <FILE> -o <OUTPUT_DIR>` |
-| `.docx` | docx-to-markdown | `uv run $OFFICIAL_SKILLS_DIR/docx-to-markdown/scripts/convert_docx.py -i <FILE> -o <OUTPUT_DIR>` |
-| `.m4a`, `.mp3`, `.wav`, `.webm`, `.ogg`, `.aac`, `.flac`, `.opus`, `.mp4` | gemini-transcribe | `uv run $OFFICIAL_SKILLS_DIR/gemini-transcribe/scripts/transcribe.py -i <FILE> -o <OUTPUT_FILE>` |
-
-**執行步驟：**
-
-1. 建立輸出目錄 `{輸入資料夾}/純文字output/`
-2. 列出輸入資料夾內所有檔案（排除子目錄 `純文字output`）
-3. 依副檔名逐一呼叫對應 skill 的腳本，將結果輸出到 `純文字output/`
-   - PDF → 輸出 `.md` 檔
-   - DOCX → 輸出 `.md` 檔
-   - 音訊 → 輸出 `.md` 檔（使用 `-o` 指定輸出路徑）
-4. 若有不支援的副檔名，跳過並記錄警告
-
-### Phase 2：閱讀所有純文字資料
-
-讀取 `純文字output/` 目錄下的所有 `.md` 和 `.json` 檔案，理解個案的完整背景資訊。
-
-### Phase 3：逐項撰寫觀護輔導紀要
-
-依照 `references/guideline.md` 中附表 5 的格式，為以下每一個項目建立一個 todo，逐項撰寫。每個項目撰寫時，產出一個 note 檔案到 `{輸入資料夾}/notes/` 目錄。
-
-**撰寫項目清單（共 16 項）：**
-
-#### 一、穩定動態風險說明（6 項）
-
-| # | 項目 | Note 檔名 | 撰寫重點 |
-|---|------|----------|---------|
-| 1 | 工作或收入情形 | `note-01-工作收入.md` | 就學、就業、收入財務狀況 |
-| 2 | 壓力適應情形 | `note-02-壓力適應.md` | 目前壓力負荷、韌性及衝動控制力 |
-| 3 | 負向情緒情形 | `note-03-負向情緒.md` | 遭遇情緒挫折及解決方式 |
-| 4 | 穩定復歸情形 | `note-04-穩定復歸.md` | 生活動態、身心健康、同儕交往、生活居住、刑案紀錄、藥酒濫用、休閒活動、社福資源（無變動可略式記載） |
-| 5 | 遵守事項情形 | `note-05-遵守事項.md` | 身心治療、輔導教育、法治教育、義務勞務等處分之履行狀況 |
-| 6 | 其他穩定風險 | `note-06-其他穩定風險.md` | 經觀護人、主任觀護人、檢察官評估認與再犯風險相關之事項 |
-
-#### 二、急性動態風險說明（6 項）
-
-| # | 項目 | Note 檔名 | 撰寫重點 |
-|---|------|----------|---------|
-| 7 | 列管核心問題 | `note-07-列管核心.md` | 暴力、身心狀況、性偏差等問題 |
-| 8 | 社會支持問題 | `note-08-社會支持.md` | 支持網絡減少、與不良行為者往還 |
-| 9 | 觀護治療問題 | `note-09-觀護治療.md` | 拒絕觀護或治療、無故未到 |
-| 10 | 認知能力問題 | `note-10-認知能力.md` | 認知扭曲、敵意、接近被害人、性幻想 |
-| 11 | 衝動犯罪問題 | `note-11-衝動犯罪.md` | 再犯罪偵審進度 |
-| 12 | 其他急性風險 | `note-12-其他急性風險.md` | 經觀護人、主任觀護人、檢察官評估認與再犯風險相關之事項 |
-
-#### 三、執行保護管束者之意見（4 項）
-
-| # | 項目 | Note 檔名 | 撰寫重點 |
-|---|------|----------|---------|
-| 13 | 評估再犯風險 | `note-13-再犯風險評估.md` | 高/中/低，須附理由說明 |
-| 14 | 列管案件別 | `note-14-列管案件別.md` | 核心/非核心，須附判斷依據 |
-| 15 | 社會復歸需求 | `note-15-社會復歸需求.md` | 媒合就業、支持系統、居住處所、遷移戶籍等所需資源 |
-| 16 | 後續處遇計畫 | `note-16-後續處遇計畫.md` | 轉介單、再犯預防命令、管區報到單等具體計畫 |
-
-**每個 Note 的撰寫規範：**
-
-- 標題：項目名稱
-- 內容：基於 `純文字output/` 中的原始資料，擇要摘述與該項目相關的事實
-- 語氣：觀護人專業紀錄語氣，客觀、簡潔
-- 若原始資料中無相關資訊，記載「本次約談未涉及此項目」或「依現有資料無相關記載」
-- 每個 note 完成後，將對應的 todo 標記為完成
-
-### Phase 4：整合產出觀護輔導紀要
-
-將所有 note 整合為最終的觀護輔導紀要，輸出到 `{輸入資料夾}/觀護輔導紀要.md`。
-
-**輸出格式範本：**
-
-```markdown
-# 觀護輔導紀要
-
-**報表編號**: 320070
-**進行日期**: {日期}
-**進行項目**: 約談
-**案號**: {從資料中提取}
-**個案姓名**: {從資料中提取}
-**股別**: {從資料中提取}
-
----
-
-## 一、穩定動態風險說明
-
-### 1. 工作或收入情形
-{整合 note-01 內容}
-
-### 2. 壓力適應情形
-{整合 note-02 內容}
-
-### 3. 負向情緒情形
-{整合 note-03 內容}
-
-### 4. 穩定復歸情形
-{整合 note-04 內容}
-
-### 5. 遵守事項情形
-{整合 note-05 內容}
-
-### 6. 其他
-{整合 note-06 內容}
-
-## 二、急性動態風險說明
-
-### 1. 列管核心問題
-{整合 note-07 內容}
-
-### 2. 社會支持問題
-{整合 note-08 內容}
-
-### 3. 觀護治療問題
-{整合 note-09 內容}
-
-### 4. 認知能力問題
-{整合 note-10 內容}
-
-### 5. 衝動犯罪問題
-{整合 note-11 內容}
-
-### 6. 其他
-{整合 note-12 內容}
-
-## 三、執行保護管束者之意見
-
-### 1. 評估再犯風險
-{整合 note-13 內容}
-
-### 2. 列管案件別
-{整合 note-14 內容}
-
-### 3. 社會復歸需求
-{整合 note-15 內容}
-
-### 4. 後續處遇計畫
-{整合 note-16 內容}
-
----
-
-觀護人：_______________
-```
-
-## 重要原則
-
-- **以原始資料為準**：所有撰寫內容必須基於 `純文字output/` 中的事實，不得捏造。
-- **擇要紀錄**：依案件需求擇要記載，無需逐項詳填，無資料時可略式記載。
-- **風險導向**：以再犯風險為撰寫核心，聚焦風險-需求-策略（RNR）架構。
-- **避免重複**：各項目之間避免重複記載相同事實。
-- **專業語氣**：使用觀護人專業紀錄用語，客觀、中立、簡潔。
-
-## 輸出檔案結構
-
-處理完成後，輸入資料夾結構如下：
-
-```
-case-folder/
-├── (原始檔案: .pdf, .docx, .m4a, ...)
-├── 純文字output/
-│   ├── 文件A.md
-│   ├── 文件B.md
-│   └── 錄音C.md
-├── notes/
-│   ├── note-01-工作收入.md
-│   ├── note-02-壓力適應.md
-│   ├── ...
-│   └── note-16-後續處遇計畫.md
-└── 觀護輔導紀要.md          ← 最終產出
-```
-
-## 參考資料
-
-- **`references/guideline.md`** — 法務部「觀護輔導紀要」撰寫範例與說明全文，含附表 5 格式定義

package/botrun-c/.claude/skills/p320-moj-review/references/guideline.md

@@ -1,118 +0,0 @@
-# 「觀護輔導紀要」撰寫範例與說明
-
-114 年 0 月 00 日核定
-
-## 一、目的
-
-為標準化觀護人「觀護輔導紀要」記載項目，補充「執行觀護案件手冊」，俾利觀護處遇計畫之擬定、再犯風險智慧輔助系統之研發，精簡觀護人填寫約談、訪視輔導紀要之負擔，建立以再犯風險為重心之撰寫策略，提供「風險-需求-策略」之紀錄格式，俾利各地方檢察署觀護人依循。
-
-## 二、評估再犯風險(Risk)
-
-### (一) 靜態再犯風險因子
-
-1. 受保護管束人於保護管束開始前，即已存在之再犯風險因子，於保護管束期間內並不會改變。
-2. 紀錄頻率：保護管束期間彙整一次，依執行觀護案件手冊規定，於案件分案後 3 個月內擬定分類分級處遇措施之前，完成靜態再犯風險因子之彙整。
-3. 紀錄方式：
-   - 觀護人首次訪視之「訪視報告表」（附表 1）或新案收案之「觀護輔導紀要」（附表 2），可援引監所、判決書記載，並可依輔助人力之專業，組成觀護團隊共同完成。
-   - 保護管束期間，觀護人如發現變動，得隨時於「觀護輔導紀要」中記載。
-4. 紀錄內容：觀護人依案件需求，擇要紀錄下列與再犯風險相關之事項
-   - (1) 暴力、衝動行為及前科史（含性偏差行為史）。
-   - (2) 身心健康就醫史。
-   - (3) 偏差同儕史：交友、社會影響及參與幫派組織情形。
-   - (4) 生活史：過去成長背景、生活居住狀況及活動領域。
-   - (5) 家庭關係史：父母子女及親密關係、家庭支持情形。
-   - (6) 藥酒濫用史：施用毒品及酒精使用情況及紀錄。
-   - (7) 工作史：具備之工作技能、工作經歷及收入財務情形。
-   - (8) 教育史：智識程度、專業能力與學歷。
-   - (9) 休閒活動史：高風險活動及場所、偏差嗜好。
-   - (10) 社福資源接觸史：過去或現在持續運用之社福資源。
-   - (11) 其他經觀護人、主任觀護人、檢察官評估，認與再犯風險相關之事項。
-
-### (二) 穩定動態再犯風險因子
-
-1. 受保護管束人於保護管束期間內，不易產生劇烈變動之再犯風險因子。
-2. 紀錄頻率：
-   - 保護管束案件非列管核心期間，每三月至少更新乙次（其他月份之報到，則以再犯風險智慧輔助系統、約談報告表、部頒量表等方式呈現）。
-   - 保護管束案件列管核心期間，每月併同急性動態再犯風險因子更新乙次。
-3. 紀錄方式：觀護人「觀護輔導紀要」（附表 3）、「訪視報告表」（附表 4），可依輔助人力之專業，組成觀護團隊共同完成。
-4. 紀錄內容：觀護人依案件需求，擇要紀錄下列與再犯風險相關之事項
-   - (1) 工作或收入情形：就學、就業、收入財務狀況。
-   - (2) 壓力適應情形：目前壓力負荷、韌性及衝動控制力等。
-   - (3) 負向情緒情形：遭遇情緒挫折及解決方式等。
-   - (4) 穩定復歸情形：如近期生活動態、身心健康、同儕交往、生活居住、刑案紀錄、藥酒濫用、休閒活動、社福資源等，如無變動，可略式記載。
-   - (5) 遵守事項情形：如身心治療、輔導教育、法治教育、義務勞務等處分之履行狀況。
-   - (6) 其他經觀護人、主任觀護人、檢察官評估，認與再犯風險相關之事項。
-5. 全案交付榮譽觀護人案件，至少每半年需回地檢署約談報到 1 次，其觀護輔導紀要紀錄頻率，從其規定。
-6. 轉介心理師及社工師追輔案件，心理師及社工師處遇期間，不另填寫觀護輔導紀要。
-
-### (三) 急性動態再犯風險因子
-
-1. 受保護管束人保護管束期間，產生劇烈變動之再犯風險因子。
-2. 紀錄頻率：保護管束案件列管核心期間，每月至少更新乙次（該月份其餘報到，則以再犯風險智慧輔助系統、約談報告表、部頒量表等方式呈現）。
-3. 紀錄方式：觀護人「觀護輔導紀要」（附表 5 之 1、2）、「訪視報告表」（附表 6），可依輔助人力之專業，組成觀護團隊共同完成。
-4. 紀錄內容：觀護人依案件需求，擇要紀錄下列與再犯風險相關之事項
-   - (1) 列管核心問題：如暴力、身心狀況、性偏差等問題。
-   - (2) 社會支持問題：支持網絡減少、與不良行為者往還等。
-   - (3) 觀護治療問題：拒絕觀護或治療、無故未到等。
-   - (4) 認知能力問題：認知扭曲、敵意、接近被害人、性幻想等。
-   - (5) 衝動犯罪問題：再犯罪偵審進度等。
-   - (6) 其他經觀護人、主任觀護人、檢察官評估，認與再犯風險相關之事項。
-
-### (四) 分級分類
-
-撰寫觀護輔導紀要可搭配分級分類表、部頒量表、再犯風險智慧輔助系統等工具，當次之觀護輔導紀要以避免重複記載為原則。
-
-## 三、復歸社會之需求(Need)
-
-為減少受保護管束人再犯或降低相關風險，由觀護人（或輔助人力）彙整個案所需資源，提出問題解決方式（如媒合就業、支持系統、居住處所、遷移戶籍等）。
-
-## 四、提出處遇計畫(Responsivity)
-
-觀護人提出轉介單、再犯預防命令、管區報到單或撤銷保護管束報告書，並由觀護人（或輔助人力）監督、輔導並執行完成各項處遇計畫。
-
-## 五、修訂
-
-觀護輔導紀要記載之再犯風險因子撰寫策略、更新頻率、填寫方式等事宜，得適時檢討修正之。
-
----
-
-## 附表 5：觀護輔導紀要（報表編號:320070）
-
-### 表頭欄位
-
-| 欄位 | 說明 |
-|------|------|
-| 進行日期 | 約談或訪視日期 |
-| 進行項目 | 約談 |
-| 案號 | 案件編號 |
-| 個案姓名 | 受保護管束人姓名 |
-| 股別 | 承辦股別 |
-
-### 紀要內容（擇要紀錄）
-
-#### 一、穩定動態風險說明
-
-1. **工作或收入情形**：就學、就業、收入財務狀況。
-2. **壓力適應情形**：目前壓力負荷、韌性及衝動控制力等。
-3. **負向情緒情形**：遭遇情緒挫折及解決方式等。
-4. **穩定復歸情形**：如近期生活動態、身心健康、同儕交往、生活居住、刑案紀錄、藥酒濫用、休閒活動、社福資源等，如無變動，可略式記載。
-5. **遵守事項情形**：如身心治療、輔導教育、法治教育、義務勞務等處分之履行狀況。
-6. **其他**：經觀護人、主任觀護人、檢察官評估，認與再犯風險相關之事項。
-
-#### 二、急性動態風險說明
-
-1. **列管核心問題**：如暴力、身心狀況、性偏差等問題。
-2. **社會支持問題**：支持網絡減少、與不良行為者往還等。
-3. **觀護治療問題**：拒絕觀護或治療、無故未到等。
-4. **認知能力問題**：認知扭曲、敵意、接近被害人、性幻想等。
-5. **衝動犯罪問題**：再犯罪偵審進度等。
-6. **其他**：經觀護人、主任觀護人、檢察官評估，認與再犯風險相關之事項。
-
-#### 三、執行保護管束者之意見
-
-1. **評估再犯風險**：高/中/低
-2. **列管案件別**：核心/非核心
-3. **社會復歸需求**：（觀護人填寫）
-4. **後續處遇計畫**：（觀護人填寫）
-
-簽章：觀護人

package/botrun-c/.claude/skills/pdf-multimodal-processor/SKILL.md

@@ -1,186 +0,0 @@
----
-name: pdf-multimodal-processor
-description: 智慧 PDF 文字提取：先用 pdfplumber 提取原生文字，掃描頁才走 OCR API。支援多頁 PDF 處理。
-allowed-tools: Bash
----
-
-# PDF 多模態處理器
-
-智慧 PDF 文字提取工具。先使用 pdfplumber 嘗試提取原生文字，僅對掃描頁（無法提取文字的頁面）才轉圖片走 OCR API，大幅提升處理效率。
-
-## 功能特色
-
-- 智慧判斷：逐頁偵測是否為掃描頁（`page.chars == 0`）
-- 原生文字頁直接提取，跳過圖片轉換和 OCR API
-- 掃描頁自動轉換為圖片並走座標感知 ML OCR API
-- 多頁結果整合為單一 JSON 檔案，每頁標記提取方式
-- 支援繁體中文、簡體中文、英文等多語言
-
-## 使用方式
-
-```bash
-uv run $OFFICIAL_SKILLS_DIR/pdf-multimodal-processor/scripts/process_pdf.py \
-  --input <PDF_PATH_OR_DIR> \
-  --output <OUTPUT_DIR>
-```
-
-### 參數說明
-
-| 參數 | 縮寫 | 必填 | 說明 |
-|------|------|------|------|
-| `--input` | `-i` | 是 | 輸入 PDF 檔案或目錄（可指定多個） |
-| `--output` | `-o` | 是 | 輸出目錄 |
-| `--dpi` | `-d` | 否 | 圖片解析度，預設 200（OCR 建議最低 150） |
-| `--quality` | `-q` | 否 | JPEG 品質，預設 85（搭配 optimize 壓縮） |
-
-### 範例
-
-**批次處理多個 PDF（推薦）：**
-```bash
-uv run $OFFICIAL_SKILLS_DIR/pdf-multimodal-processor/scripts/process_pdf.py \
-  -i /path/to/文件A.pdf /path/to/文件B.pdf /path/to/文件C.pdf \
-  -o /path/to/output/
-```
-
-**處理單個 PDF：**
-```bash
-uv run $OFFICIAL_SKILLS_DIR/pdf-multimodal-processor/scripts/process_pdf.py \
-  -i /path/to/申請書.pdf \
-  -o /path/to/output/
-```
-
-**指定 DPI 和品質：**
-```bash
-uv run $OFFICIAL_SKILLS_DIR/pdf-multimodal-processor/scripts/process_pdf.py \
-  -i /path/to/a.pdf /path/to/b.pdf \
-  -o /path/to/output/ \
-  --dpi 400 \
-  --quality 90
-```
-
-## 處理流程
-
-```
-PDF 文件
-    │
-    ▼
-┌───────────────────────────────┐
-│ 1. pdfplumber 逐頁分析         │
-│    判斷：len(page.chars) == 0  │
-└───────────────────────────────┘
-    │                    │
-    │ 有文字              │ 掃描頁
-    ▼                    ▼
-┌───────────────┐  ┌────────────────────┐
-│ 直接提取文字   │  │ 轉圖片 → OCR API   │
-│ extract_text  │  │ (pdf2image + OCR)  │
-│ method:native │  │ method: ocr        │
-└───────────────┘  └────────────────────┘
-    │                    │
-    └────────┬───────────┘
-             ▼
-┌───────────────────────────────┐
-│ 3. 合併 JSON                   │
-│    每頁標記 extraction_method  │
-│    輸出 JSON + Markdown        │
-└───────────────────────────────┘
-```
-
-## 輸出檔案
-
-處理完成後會產生：
-
-```
-data/output/
-├── 申請書.json              # OCR 結果 JSON（含結構化資料）
-├── 申請書.md                # 純文字內容（full_text）
-└── [img]申請書/             # PDF 轉出的圖片
-    ├── 申請書_page_1.jpg
-    ├── 申請書_page_2.jpg
-    └── 申請書_page_3.jpg
-```
-
-## 輸出 JSON 結構
-
-```json
-{
-  "source_file": "申請書.pdf",
-  "file_type": "pdf",
-  "total_pages": 3,
-  "processed_at": "2026-01-15T12:00:00Z",
-  "pages": [
-    {
-      "page": 1,
-      "extraction_method": "native",
-      "text": "原生提取的文字..."
-    },
-    {
-      "page": 2,
-      "extraction_method": "ocr",
-      "image_file": "申請書_page_2.jpg",
-      "ocr_result": {
-        "status": "succeeded",
-        "text": "OCR 辨識的文字...",
-        "lines": [
-          {
-            "text": "辨識的文字行...",
-            "boundingBox": [x1, y1, x2, y2, ...]
-          }
-        ]
-      }
-    }
-  ],
-  "full_text": "所有頁面合併的純文字"
-}
-```
-
-## API 說明
-
-使用座標感知 ML OCR API（非同步）：
-- **端點**: `https://app.botrun.ai/azure-ocr-api`
-- **提交**: POST `/vision/v3.2/read/analyze`
-- **取得結果**: GET `/vision/v3.2/read/analyzeResults/{operation-id}`
-- **等待機制**: 最多 4 次輪詢，每次間隔 15 秒
-
-## 支援的檔案格式
-
-| 格式 | 副檔名 |
-|------|--------|
-| PDF | .pdf |
-
-> 若需處理單張圖片，請使用 `gcp-coord-ml-ocr` skill。
-
-## 環境需求
-
-- Python 3.8+
-- 網路連線（需存取座標感知 ML OCR API）
-- 使用 `uv run` 執行（自動安裝依賴）
-
-## 依賴套件
-
-腳本使用 PEP 723 inline script metadata，`uv run` 會自動安裝：
-- `requests>=2.28.0`
-- `pdf2image>=1.17.0`
-- `Pillow>=10.0.0`
-- `pdfplumber>=0.10.0`
-
-## 故障排除
-
-### PDF 轉圖片失敗
-
-確保已安裝 poppler：
-```bash
-# macOS
-brew install poppler
-
-# Ubuntu/Debian
-sudo apt-get install poppler-utils
-```
-
-### OCR 請求超時
-
-API 預設等待 60 秒（4 次輪詢 × 15 秒），若 PDF 頁數過多可能需要更長時間。
-
----
-
-*Version: 2.0.0*