用途
SOIL 教學簡報工作流技能旨在協助使用者製作具備教學力的 .pptx 簡報。它以李俊儀教授的 SOIL 教學心法為基礎，透過六顆引擎（概念定位、脈絡定位、頁面架構、認知編修、風格建構、簡報總導演）引導使用者從素材或主題出發，先想清楚教什麼，再安排怎麼教，最後處理怎麼呈現。
主要能力
- 六顆引擎工作流：依序進行概念定位、脈絡定位、頁面架構、認知編修、風格建構，最終輸出 .pptx 並做 QA。
- 四種工作模式：根據使用者狀況判斷，分為全流程模式（引擎 1→2→3→4→5→6）、診斷修改模式（引擎 4 為主，補頁面角色）、主題從頭開始模式（先協助蒐集資料再跑全流程）、風格定義模式（僅引擎 5）。
- 概念定位：產出總概念、三個子概念、三個常見誤解、帶走一句話、最小事實包、投影片與講稿分配。
- 脈絡定位：將簡報規劃為引起動機、維持注意、喚起行動三段節奏，並指定各段目的、內容、理解任務、建議頁數、入口出口及常見錯誤。
- 頁面架構：為每頁指定頁面角色（如封面頁、問題引入頁、迷思澄清頁、比較頁、流程頁、分類頁、案例頁、數據頁、總結頁、行動頁、過渡頁）、唯一主重點、建議頁型、理解任務、前後銜接、是否關鍵頁，並可標記幾何圖形需求與 AI 視覺素材需求（visuals 欄位，支援 illustration、background、hero、side_panel、section_divider、accent 六種 role）。
- 認知編修：用降雜訊、區塊化、增資訊、結構化、順脈絡、步驟化六個認知詞逐頁診斷與規劃，輸出認知編修報告（診斷修改模式）或作為生成指引（全流程模式）。
- 風格建構：分析參考簡報或依教學場景自動配置風格，產出配色、字型、字級、佈局偏好及 image_policy（圖像風格統一控管）。
- 簡報生成：使用 PptxGenJS 生成 .pptx，支援幾何圖形整合（透過 jh-math-geometry 渲染器或原生形狀備援）與 AI 視覺素材整合（透過內建 imagegen 或 draw.py 生成後以 base64 嵌入）。
使用方式
- 技能收到請求後，先以一個問題判斷工作模式（已有素材、已有簡報想修改、只有主題、想定義風格）。
- 進入各引擎前，補問該引擎所需的最少細節（如教學對象、上課時間、風格偏好）。
- 依序執行對應引擎，每階段產出文件並經使用者確認後再進入下一步。
- 最終以 PptxGenJS 腳本生成 .pptx，過程中可整合幾何圖形與 AI 視覺素材。
適用場景
適用於各級教學簡報製作，包括國中、國小、高中、大學、研究所、教師研習、通識跨領域等場景。可用於從零開始建立教學簡報、修改現有簡報以提升教學效果、定義可重複使用的簡報風格，或從主題出發蒐集資料後製作簡報。
限制
- 需具備 Node.js 環境以執行 PptxGenJS；AI 視覺素材生成需有內建 imagegen 或 draw.py（需 OPENAI_API_KEY），若皆無則以原生色塊形狀佔位。
- 幾何圖形渲染需安裝 jh-math-geometry 技能，否則僅能以 PptxGenJS 原生形狀繪製基本圖形。
- 診斷修改模式需能提取 .pptx 文字與視覺佈局（如使用 markitdown、thumbnail.py）。
- 教學對象、時間、風格偏好等細節會影響產出，需使用者提供或由系統自動決定。