SuperAPI AI 工具集

teaching-minigames

前端与建站

查看项目

更新于 10-16 00:20

技能介绍

用途:將教材自動轉換為「一重點一小遊戲」的形成性評量網頁,附 QR Code,方便教師在各種數位平台快速使用。

主要能力:讀取 PDF、圖片、.docx、純文字教材,萃取可獨立測驗的學習重點(命名為「重點N:標題」,建議 3~10 個),每個重點附核心概念與 2~4 個測驗素材。可依重點性質選擇遊戲類型:選擇題(game-mcq.html)、填充題(game-fill.html)、配對題(game-match.html)、是非題(game-tf.html)、排序題(game-order.html)、記憶翻牌(game-memory.html)。每個遊戲為完全獨立的單一 HTML 檔,CSS 與 JS 全部內嵌,不使用外部 CDN,離線可用;介面手機優先、字體 ≥16px、按鈕 min-height 44px,含標題、規則說明、即時回饋、得分進度與重玩按鈕。另產生 index.html 總索引頁,列出所有重點與連結並顯示 QR Code。

使用方式:流程為分析教材、提取重點清單並向使用者確認、製作各遊戲 HTML、打包索引頁、上傳 GitHub、啟用 GitHub Pages、回傳網址與 QR Code。上傳需使用者提供 GitHub Personal Access Token(需 repo 權限)、帳號名稱與 Repository 名稱(預設 teaching-games)。上傳以 Python 腳本呼叫 GitHub REST API,指令為:python3 /home/claude/github_upload.py --token "$TOKEN" --user "$GITHUB_USER" --repo "$REPO_NAME" --files-dir "/mnt/user-data/outputs/"。QR Code 以 api.qrserver.com 依 window.location.href 動態產生。

適用場景:教師將教材快速轉為課堂或課後形成性評量,難度以記憶與理解層次(Bloom's Level 1-2)為主。

限制:題目與答案須忠實來自教材,不可編造;每個遊戲至少 3 題(建議 4~6 題);遊戲介面語言跟隨教材語言;GitHub Pages 約需 1~3 分鐘上線,期間連結可能顯示 404。其餘細節(如各類型完整模板、上傳腳本全文)見技能內 references 文件,本資料未提供。