tw-edu-slides-creatorlisted
Install: claude install-skill FW1201/twa-edu-harness
# tw-edu-slides-creator v4.0
台灣 K-12 教育簡報生成 Skill。這版採用 `codex-ppt-skill` 的工作形式:每張投影片先生成為完整 16:9 圖片,再組裝成 `.pptx`,並把 `speech.md` 寫入 PowerPoint 講者備註。
本 skill 的差異不在輸出形式,而在內容框架:它仍負責把教材、課文、活動設計或教學目標轉成適合台灣課堂的簡報節奏,包含年級自適應、Bloom 分層、108 課綱對齊、示例優先、活動安排與教師講稿。
## Hard Constraints
- 使用 `codex-ppt-style` gate:來源整理 -> `outline.md` -> 視覺風格 -> 單頁樣張 -> 全量逐頁生成 -> QA -> `speech.md` -> PPTX 組裝。
- 未完成 outline / style / sample gate 前,不建立 final `deck_spec.json`、`speech.md`、正式 prompts、完整 slide images 或 `.pptx`,除非使用者明確要求跳過確認。
- 每張 final slide 都是一張完整 16:9 投影片圖片,放在 `origin_image/slide_XX.png`。
- 逐頁生成,不得把多張投影片塞進同一張圖片。
- 樣張通過後維持同一視覺身份;版面可以依教學目的變化。
- 所有中文字必須清楚、正確、可讀。若出現亂碼、截斷、過小或重疊,必須修復再組裝。
- 教學簡報不應只是教材摘錄。每張投影片都要服務一個教學行為:引入、示例、解析、練習、討論、統整、延伸。
- 對尚未掌握概念的學生,先示例再解析;不要直接用問題取代教學。
- 說明文字與對應圖像必須同頁相鄰,避免跨頁造成認知負擔。
- 裝飾性視覺一律降到最低;每個視覺元素都要回答「它幫助學生理解什麼?」
## Project Structure
```text
{base_dir}/{deck_name}/
├── origin_image/
│ ├── slide_01.png
│ ├── slide_02.png
│ └── ...
├── prompts/
│ ├── slide_01.json
│ └── ...
├── deck_spec.json
├── outline.md
├── speech.md
├── slide_jobs.json
├── slide_run_state.json
└── {deck_name}.pptx
```
If the user does not specify a destination, use `artifacts/教師/{deck_slug}/` inside the LLM Wiki workspace.
## Default Workflow
1. **Collect teaching context**
- Topic / 課文 / 教材 source.
- Grade band: 國小低 / 國小中高 / 國中 / 高中 / 大學.
- Subject and class duration.
- Learning objective, prior knowledge, assessment or activity needs.
- Whether teacher notes are needed. Defau