Quiz Maker 測驗製作器 是做什麼的?
一份好的測驗同時完成兩項任務:它測試某人所知,並在他們答錯時立即教導。大多數自動生成的測驗只做到第一項——一個赤裸裸的問題、一個正確答案,沒有任何東西能幫助學習者理解為什麼。這個技能的目標就是做好第二項。每個問題都附帶一個學習者能確實理解的簡化解釋、若主題是量化性的則附帶其方程式或推導過程,以及一個真實的引用來源,讓他們可以深入探究並信任答案。
輸出是一個單一的互動式 HTML 檔案,使用者可以在瀏覽器中開啟,按照自己的節奏作答、自我檢查、揭示逐步推導並計算分數。它應該感覺像一個精心打造的學習工具,而不是一張列印輸出。
首要規則:在開始製作前先詢問難度
難度從根本上改變測驗的一切——詞彙、是否顯示推導或僅陳述結果、問題需要多少步驟、你假設讀者已了解多少。因此,在你了解等級之前,你無法寫出任何一個好問題。在生成測驗前,使用 AskUserQuestion 工具詢問使用者想要哪個等級,並提供以下五個選項:
- 基礎 (Foundational) — 初次接觸。平實語言、具體範例、最少術語、不經推導直接陳述結果。想像一個好奇的初學者或早期高中生。
- 中級 (Intermediate) — 熟悉基礎。引入標準術語和簡單的一兩步推理。想像一個程度好的高中生或大學低年級生。
- 進階 (Advanced) — 紮實的工作知識。多步驟問題、期望能流暢使用核心形式體系、顯示簡短推導。想像大學高年級生。
- 專家 (Expert) — 深厚掌握。非顯而易見的邊緣案例、概念之間的聯繫、期望完整的推導。想像研究所課程。
- 博士/研究 (PhD / Research) — 前沿。微妙的假設、當前的爭論、嚴謹的推導、主要文獻的引用。想像資格考或研究研討會。
如果使用者已在他們的消息中陳述了等級(例如「給我一個困難的博士級測驗……」),則將其對應到最接近的選項並確認,而非再次詢問。在詢問難度的同時,在同一次 AskUserQuestion 呼叫中一併確認主題(如果模糊的話)以及他們想要的題目數量(預設為 8 題)會更有效率——但難度是你絕對不能跳過的項目。
確定主題
在詢問前先評估情況。主題可能已從使用者的訊息、專案說明、資料夾中的檔案或目前的對話中顯而易見。如果使用者在專業領域工作(他們的個人資料或 CLAUDE.md 通常會說明),則在其領域中舉例,而不是使用通用範例——物理學家會得到反物質和截面,而不是「一個球滾下山坡」,除非他們要求的是球。僅在主題確實模糊不清或過於廣泛而無法製作連貫的測驗(「科學」太廣泛;「狹義相對論——時間膨脹和長度收縮」是一個測驗)時才要求澄清。
研究並引用——絕不虛構
每個解釋都帶有引用,而且引用必須是真實的。這是一個可以信賴的學習工具與一個聽起來合理但虛構的幻覺之間的區別。
對於技術、科學、醫學、歷史或快速變化的主題,請搜尋網路來佐證解釋並取得可驗證的來源——附有版本和章節的教科書、附有 DOI 的綜述文章、標準制定機構、信譽良好的參考網站。優先選擇主要和權威來源,而非部落格。記錄真實的 URL 或 DOI,使引用可以連結出去。
對於穩定的常識性主題,如果你有很高的信心(基本算術、定義明確的常識),可以直接從知識中引用標準參考文獻,而無需即時搜尋——但必須指明一個具體、可查核的來源(例如「Griffiths, Introduction to Electrodynamics, 第 4 版,§2.3」),絕不能使用模糊的「教科書」或虛構的頁碼。
如果你無法找到某個說法的真實來源,這是一個信號,表示該說法可能不可靠——圍繞你可以找到來源的內容重新措辭問題,而不是虛構引用。偽造引用比沒有引用更糟。
撰寫問題
目標是混合出真正能鍛鍊理解力、而不僅僅是回憶能力的題目。好的測驗傾向於提出讓學習者應用一個概念的問題。變化題型格式:
- 選擇題 (Multiple choice) 是骨幹——可自動評分,而錯誤選項是一個教學機會。讓誘答選項合理:每個錯誤答案應對應一個特定的常見錯誤或誤解,這樣選擇它就能告訴學習者一些事情。避免無意義的笑話選項和明顯的送分題。
- 數值/簡答題 (Numeric / short-answer) 適合量化主題——學習者自行運算,然後對照附有逐步解答的答案進行檢查。
- 開放式/推導題 (Open / derivation) 要求學習者進行推理或推導,然後揭示一個他們可以自我評估的模型答案。在較高難度時使用這些。
為每個問題撰寫:
- 清晰的提示 (prompt)。對任何數學內容使用 LaTeX(見格式章節)——行內用
\( ... \)或顯示用\[ ... \]。 - 對正確答案的簡化解釋 (simplified explanation) ——這個技能的核心。像一位好家教對所選等級的學生那樣解釋:平實、直接、建立在他們已知的基礎上。簡化語言,而非簡化正確性。
- 當問題涉及量化時,一個推導過程 (derivation):從基本原理到結果的有序步驟列表,每一步都是一小行推理加上其方程式。HTML 會一次一個區塊地揭示這些步驟,讓學習者可以在偷看之前先嘗試。
- 一個或多個引用來源 (citations),每個都帶有標籤和(理想情況下)URL/DOI。
根據難度校準深度:在基礎等級,你可以跳過推導,改用直覺類比;在博士等級,推導是嚴謹的,引用是主要來源。
建立互動式 HTML
使用捆綁的範本,而不是每次都手動製作一個頁面——它已處理好 MathJax 渲染、答案檢查、分數記錄、進度追蹤、可折疊的推導和引用連結,而且外觀乾淨。閱讀 references/html-format.md 了解完整的建置程序和確切的 QUIZ 資料結構,然後用你的問題填入範本的資料區塊。不要從頭重寫範本的 CSS/JS;你只需提供內容。
完成的頁面應讓學習者能夠:閱讀帶有正確渲染方程式的問題、選擇或揭示答案、獲得即時的正確/錯誤反饋、展開解釋和逐步推導、跟隨引用連結,以及看到一個持續更新的分數和最終的總結。頂端有一個難度徽章,讓他們知道正在參加什麼等級的測驗。
交付
將完成的測驗儲存為一個單獨的 .html 檔案,放在使用者偏好的技能輸出資料夾中(根據專案/記憶慣例),命名為描述性的名稱(quiz-<topic>-<difficulty>.html),並呈現給使用者,讓他們可以直接開啟。保持結尾訊息簡短——測驗本身會說明一切。主動提供調整難度、增加問題或縮小主題範圍的後續行動。
標示假設
如果你必須做出一個影響正確性的判斷——你假設了一個慣例(符號、單位、記號)、選擇了一個確有爭議觀點的某一方、或者無法完全驗證一個來源——請在交出測驗時簡短說明,以便使用者可以進行壓力測試。學習工具中的沉默假設會傳播到某人學到的東西中。