jh-math-geometry

國中數學幾何圖形技能（jh-math-geometry）

技能概覽

本技能生成適合試卷、簡報、教材的幾何 SVG 圖形，並輸出為 PNG 圖片檔， 可直接插入 Word 文件或 PowerPoint 投影片。

環境約定（任何使用前先做）：

• 腳本在本技能目錄（這份 SKILL.md 所在資料夾）的 scripts/，以 $GEOM_DIR 代表
• 產出一律放當前工作目錄的 output/geometry_output/
• Windows 若無 python3 指令請改用 python；Bash 片段請在 Git Bash／WSL 執行

GEOM_DIR="<本技能目錄的絕對路徑>/scripts"   # 例：~/.claude/skills/jh-math-geometry/scripts
mkdir -p output/geometry_output
python3 -m pip install -q cairosvg python-docx python-pptx   # 首次使用安裝一次；Linux 系統 Python 拒絕時加 --break-system-packages

---

處理流程

Step 1：理解需求

根據使用者的描述，判斷需要哪些圖形。若不確定，先快速確認：

• 哪個單元（三角形/四邊形/圓/立體...）？
• 需要標哪些字母/數字？
• 是否有特殊標記（直角符號、等邊刻度、角弧）？
• 輸出目標：Word、PPTX 或純圖片下載？

Step 2：建立圖形規格 JSON

依需求建立 spec，儲存至 output/geometry_spec.json：

{
  "figures": [
    {
      "id": "fig1",
      "type": "triangle",
      "config": {
        "subtype": "right",
        "vertex_labels": ["A", "B", "C"],
        "right_angle_at": "C",
        "side_labels": {"AB": "5", "BC": "3", "CA": "4"}
      },
      "canvas": {"width": 280, "height": 220}
    }
  ],
  "options": {"format": "png", "dpi": 150}
}

詳細參數見本技能目錄下的 references/figure-catalog.md（讀取該檔案）。

Step 3：執行渲染

python3 "$GEOM_DIR/geometry_renderer.py" output/geometry_spec.json output/geometry_output/
ls output/geometry_output/

Step 4：視覺確認

讀取產生的 .svg（或 .png）檔案確認圖形是否正確。 若有錯誤（標籤偏移、比例不佳），調整 config 後重新執行。

Step 5：輸出

純圖片

PNG 已在 output/geometry_output/<id>.png，直接告知使用者路徑。

插入 Word

python3 - <<EOF
from docx import Document
from docx.shared import Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH
import sys; sys.path.insert(0, "$GEOM_DIR")
from insert_to_docx import insert_figure, figures_from_manifest

doc = Document()   # 或 Document('existing.docx')
figures_from_manifest('output/geometry_output/manifest.json', doc, width_cm=7.0)
doc.save('output/geometry.docx')
print("✅ output/geometry.docx")
EOF

插入 PowerPoint

python3 - <<EOF
from pptx import Presentation
import sys; sys.path.insert(0, "$GEOM_DIR")
from insert_to_pptx import figures_from_manifest

prs = Presentation()   # 或 Presentation('existing.pptx')
figures_from_manifest('output/geometry_output/manifest.json', prs,
                      mode='individual', title_prefix='幾何圖形')
prs.save('output/geometry.pptx')
print("✅ output/geometry.pptx")
EOF