skill
teaching-exam-skills
國中數學命題/審題/幾何配圖/形成性評量小遊戲 — 可供 AI agent 使用的 Agent Skills 集（繁體中文）
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/mathruffian-dot/teaching-exam-skills itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 21, 2026教學出題技能集（Teaching & Exam Skills）
一組可重用的 Agent Skills，專注於國中數學命題、審題、幾何配圖與形成性評量小遊戲。
每個技能皆為獨立資料夾，內含一份 SKILL.md（含 YAML frontmatter 描述觸發時機），可供 Claude Code 或任何支援 Agent Skills 規格的 AI agent 直接讀取使用。
所有技能皆以繁體中文設計，題目對齊修訂版 Bloom 認知層次。
📦 包含的技能
| 技能 | 用途 | 額外檔案 |
|---|---|---|
jh-math-exam | 國中數學段考出題與審題專家。設計七/八/九年級段考試題、審題、建立雙向細目表、Bloom 認知層次分析，產出標準版面的題目卷與答案卷。 | —（Bloom 準則、細目表格式、Word 版面規格皆內嵌於 SKILL.md） |
jh-math-context-questions | 國中數學「生活情境非選擇題」命題。結合時事／生活情境，產出 Bloom 應用／分析層次的兩小題式非選題（共五大題，含詳解），匯出 Word（數學式用 OMML 呈現）。 | —（Word 版面規格內嵌於 SKILL.md） |
jh-math-geometry | 國中數學幾何圖形 SVG 產生器。三角形、四邊形、圓、坐標平面、立體圖、三角形三心等，可匯出 Word／PPT。可被出題技能呼叫配圖。 | scripts/、references/ |
teaching-minigames | 把教材重點轉成形成性評量小遊戲，發佈為可分享 HTML + QR Code。 | references/ |
🚀 給其他 Agent 使用
這是一個純技能資料夾結構。最簡單的用法：
git clone https://github.com/mathruffian-dot/teaching-exam-skills.git
然後讓你的 agent 讀取對應的 skills/<技能名>/SKILL.md。每份 SKILL.md 的 frontmatter 都描述了觸發情境與操作步驟。
所有 SKILL.md 皆為平台中立寫法：技能自身資源以「本技能目錄」為準、產出一律放當前工作目錄的 output/、跨技能引用（出題技能呼叫 jh-math-geometry）會先找同 repo 的 skills/jh-math-geometry/，再找已安裝的技能目錄。Windows（Git Bash／WSL）與 macOS／Linux 皆可執行。
安裝到 Claude Code（個人技能目錄）
# macOS / Linux
cp -r teaching-exam-skills/skills/* ~/.claude/skills/
# Windows (PowerShell)
Copy-Item teaching-exam-skills/skills/* $HOME/.claude/skills/ -Recurse
⚠️ 使用前注意（外部依賴）
| 技能 | 依賴 | 說明 |
|---|---|---|
jh-math-context-questions | draw 技能（選配） | 情境插圖呼叫 ~/.claude/skills/draw/draw.py（gpt-image-2 生圖），與 SKILL.md 內的 $DRAW 一致。本 repo 未含此腳本；若無 draw 技能則跳過配圖，其餘流程不受影響，或自行替換為你的生圖工具。 |
jh-math-context-questions / jh-math-exam | Python + python-docx、lxml | Word 匯出腳本 generate_exam_docx.py 不在 repo 內，由 agent 依 SKILL.md Step 6 的版面規格與內附的 OMML 轉換函式自行撰寫到 output/。 |
jh-math-geometry | Python | scripts/ 內為 SVG 轉檔與插入 Word/PPT 的腳本，需 Python 環境。 |
teaching-minigames | GitHub Token | 發佈到 GitHub Pages 時需使用者自備 Personal Access Token（repo 權限）。Token 由使用者即時提供，不會被儲存。 |
📄 授權
MIT License，詳見 LICENSE。歡迎自由使用與修改。