botrun-horse 2.29.2 → 2.30.0

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

@@ -0,0 +1,200 @@
+---
+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

@@ -0,0 +1,118 @@
+# 「觀護輔導紀要」撰寫範例與說明
+
+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

@@ -0,0 +1,186 @@
+---
+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*