jh-math-context-questions

國中數學生活情境非選擇題命題技能

技能概覽

本技能依使用者指定的國中數學單元，上網搜尋相關生活情境與時事新聞， 將真實素材轉化為非選擇題，並匯出格式正確的 Word 文件。

• 五大題，每大題含兩小題
• 第(1)小題：閱讀素材，理解條件即可作答（Bloom 第2級：理解）
• 第(2)小題：承接第(1)題，結合數學單元，達到應用或分析層次（Bloom 第3-4級）
• 每大題皆含完整解析
• 幾何圖形支援：若題目涉及幾何情境，自動呼叫 jh-math-geometry 技能的渲染腳本產生 PNG 並插入 Word
• 匯出 Word 文件，數學式以 OMML 正確格式呈現

數學標記語法（題目撰寫規則）

在題目文字中，用大括號 {} 包住數學式，系統會自動轉為 Word 正確格式：

規則：分數一律 {frac(分子,分母)}、次方一律 {x^2}、根號一律 {sqrt(x)}、不等號一律 {<=} {>=} {!=}，不直接貼 ²、√ 等字元；簡單方程式（如 2x + 3 = 7）不需加 {}。

環境約定（所有 Step 共用）

本技能不假設任何特定沙箱或工具名稱，路徑一律依下列約定：

SKILL_DIR="<本技能目錄的絕對路徑>"        # 例：~/.claude/skills/jh-math-context-questions
mkdir -p output

# 幾何腳本位置：同 repo 的 skills/jh-math-geometry/，或已安裝的 jh-math-geometry 技能
GEOM_DIR=""
for d in "$SKILL_DIR/../jh-math-geometry/scripts" "$HOME/.claude/skills/jh-math-geometry/scripts"; do
  [ -f "$d/geometry_renderer.py" ] && GEOM_DIR="$d" && break
done
echo "幾何腳本目錄：${GEOM_DIR:-（找不到，幾何題將無法配圖）}"

# draw 生圖技能（選配）：找不到就跳過 Step 5.7／6.6 的情境插圖，不影響出題與匯出
DRAW="$HOME/.claude/skills/draw/draw.py"
[ -f "$DRAW" ] || echo "ℹ️ 無 draw 技能，將跳過情境插圖"

python3 -m pip install -q python-docx lxml cairosvg pillow   # 首次使用安裝一次；Linux 系統 Python 拒絕時加 --break-system-packages

• Windows 若沒有 python3 指令，把下文的 python3 換成 python；Bash 片段請在 Git Bash／WSL 執行。
• 文中的「視覺確認」一律指讀取檔案（用你的檔案讀取工具開啟 .svg／.png），不依賴任何特定工具。
• 產出留在 output/，完成後在對話中列出檔案路徑即可，不需再複製到別處。

處理流程

Step 1：確認需求

向使用者確認（未提供則詢問）：數學單元、年級（七/八/九年級）、版本（選填）