fw1201 教學小程式
產出可本機開啟的互動教學網頁。適用 Codex 與 Claude Code，繁體中文輸出。
開始前
讀取 共用工作方式。檢查目前工作區的 teacher-profile.md；本次要求優先於對話脈絡、設定檔及預設。已提供的資訊不要重問。
任務要求
依目的選 quiz、flashcard、lottery、timer，使用實際題目與資料。驗證答案、計分、空清單與鍵盤操作。學生姓名不傳外部服務；文字以安全節點呈現。先本機驗證，部署使用已授權的目的地。
工作流程
- 確認使用者要完成的成果，讀取素材與必要教學脈絡。
- 依上述任務要求提出具體內容，保留來源與待確認事項。需要重大選擇時提供可評估的草稿。
- 讀取本技能的
schemas/輸入規格與examples/範例；以實際內容建立 JSON。範例中的資料不得混入正式成品。 - 從任意工作目錄使用下列 CLI。先驗證，再生成，最後檢查成品及驗證紀錄。
# SKILL_DIR 為本技能安裝目錄；TASK_DIR 為目前工作區的任務輸出目錄。
python3 "$SKILL_DIR/scripts/generate_mini_app.py" --input "$TASK_DIR/input.json" --validate-only
python3 "$SKILL_DIR/scripts/generate_mini_app.py" --input "$TASK_DIR/input.json" --output "$TASK_DIR/output.html"
# 僅在明確需要展示時使用；輸出標示為範例。
python3 "$SKILL_DIR/scripts/generate_mini_app.py" --example --output "$TASK_DIR/example.html"
安裝依賴
python3 -m venv .venv
.venv/bin/python -m pip install -r "$SKILL_DIR/requirements.txt"
執行生成器時可將上方 python3 換成虛擬環境的 Python。舊版只傳主題或科目的呼叫不再生成固定範例；依 schema 填入實際內容。
交付檢查
核對年段、科目與實際內容；不把未查證的資料寫成事實。確認學生可見成品未混入內部答案或理由。提供成品路徑與尚待教師確認項目，未執行的外部操作不標記完成。