隨堂測驗設計原則

給老師與後續 AI。新增課程（尤其 AI煉金術II）先讀本頁再動手，規格與 AI煉金術I 對齊。版本 2026.08.15。

下次怎麼接（複製給 AI）

請先讀 https://portal.robotcb.com/quiz/design（或本機 forum-prototype/deploy/quiz/DESIGN.md）。
這是 AI煉金術II 講義，路徑：……
請依同一規格出 6 題並上線（先不要做佔位題；講義沒寫好就不要加卡片）。

待辦：AI煉金術II 講義尚未完成，禁止上線入口與佔位題。講義到齊後才新增主題。

出題規格（AI煉金術系列）

總題數6 題
章節3 章 × 各 2 題（控場仍按章結算）
章名手速題／實戰題／壓軸複選
題型第 1–4 題單選；只有最後兩題複選
選項A–D；顏色 red／blue／yellow／green
points單選 1；複選 2（3 正 + 1 陷阱；集合全對才得分）
複選題幹開頭加【複選題】

計分（與題庫後台一致，不要改程式）

出題原則（從講義抽題）

  1. 先讀完整講義，用金句、比喻、檢查清單，不要用邊角 trivia。
  2. 錯誤選項要像有聽課才分得出來。
  3. 禁碰保證獲利、個股明牌、未揭露風險的績效。
  4. 題幹短、適合手機；用字與簡報一致。
  5. 講義沒寫好就不要做：不要上佔位題、不要先加控場卡片。

上線步驟

  1. 寫 seed JSON（結構同 AI煉金術I）。
  2. topics.py 的 TOPIC_DEFS 追加（min_questions: 6）。
  3. Portal 隨堂測驗加課程卡片，連到 /quiz/host?topic=該slug（兩份 index 同步）。
  4. scp 到 lidone /opt/robotcb/quiz/ 與 portal index。
  5. 換題：PYTHONPATH=/opt/robotcb/quiz .venv/bin/python scripts/reload_topic_bank.py <slug>。禁止呼叫會清掉所有房間的 reset-bank。
  6. restart robotcb-quiz、robotcb-portal；寫維修紀錄。

現況

已上線：可轉債、主動式基金、AI煉金術I（6 題）、到期賣回（5 題、末題複選）、券商API分享會（6 題、末兩題複選、現場頒前三名）、移動交易室（6 題、末兩題複選、現場頒前三名）。
未上線：AI煉金術II。

本機對照：forum-prototype/deploy/quiz/DESIGN.md