steffen74/to-quiz

To quiz

為一個單元撰寫並發布測驗。請先閱讀 COURSE-CANVAS.md、PLAN.md、RESOURCES.md、DECISIONS.md、AGENTS.md 中的 ## Agentic course creation 章節，以及該單元涵蓋的教材（影片與任務）。接著載入 assumed-knowledge。

1. 工具與來源

AGENTS.md 中應有一行 - Quizzes: <source file>, tool <name>, connector <name|none>，該行應在 /setup-course 時設定。若缺少此行，請詢問一次，提供建議並寫入：

• 來源：私有課程儲存庫中的一個檔案，儲存所有題目及其選項、正確答案與解析（CSV 格式，欄位為 session, type, question, option_a, option_b, option_c[, option_d], correct, explanation，或與之對應的 Markdown）。測驗工具中的內容僅為副本，來源檔案才是唯一正本。
• 工具：每個課程選擇一個工具，例如 Microsoft Forms 或 Formbricks。評分為選用；多數影片檢查只需要答案的分佈情況以便課堂討論。

2. 撰寫題目

為該單元草擬三到五個題目，每個題目需包含：

• 一個關於學習者在課程前已接觸過的內容的問題：前一單元的影片與任務。絕不可問該單元本身介紹的內容。
• 三個或四個選項，其中一個正確；錯誤選項應是學習者實際上會有的誤解（可從 SIGNALS.md 取得），而非陷阱題。
• 一至兩句的解析，供教師在課堂上使用。
• 一個類型：video（影片）、task（任務）或 skill（技能），並標明其來源。

題目必須基於教材的實際內容。若題目來自無法觀看的影片，請在解析中註明 僅根據標題推測；教師需對照影片確認。

展示題目並等待教師確認。確認後將題目寫入來源檔案。

3. 在工具中建立

• 已連接工具的連接器：展示將要建立的測驗，等待確認，以草稿形式建立，並記錄其分享連結。請根據測驗來源，使用連接器本身的 schema 建構請求（閱讀其工具描述；schema 會隨版本變更），若連接器提供驗證工具，請先使用它進行驗證。
  • Formbricks 提供官方的 MCP 伺服器，支援 OAuth 登入（https://app.formbricks.com/api/mcp，或自託管時為 https://<domain>/api/mcp；工具包含 list_workspaces、validate_survey、create_survey）。若課程使用 Formbricks 但尚未連接，請提供以下指令讓教師加入至其代理（在 Claude Code 中：claude mcp add --transport http formbricks https://app.formbricks.com/api/mcp，然後透過 /mcp 登入）；請勿自行修改教師的代理設定。
  • Microsoft Forms 沒有建立測驗的 API 也沒有官方連接器；請使用下方的匯出方式。
• 無連接器：使用 scripts/export_quiz.py 從 CSV 來源匯出：
  • Formbricks：--format formbricks 會產生一個適用於 Management API 的問卷主體，並印出 curl 指令。教師需使用自己的環境變數中的 API 金鑰來執行該指令；切勿索取金鑰或將其寫入檔案。
  • Microsoft Forms：--format forms 會產生一個適用於 快速匯入 的 .docx 檔案以及一個答案金鑰。快速匯入不支援正確答案；教師需根據答案金鑰手動勾選（僅在啟用評分時需要）。
  • 其他工具：產生該工具可接受的最接近的匯入格式，或純文字列表供貼上。

答案與解析絕不可出現在參與者可見的檔案或公開位置。

4. 交接

將測驗連結記錄在 RESOURCES.md 中該單元對應的欄位（Quiz 欄）。投影片中應顯示連結（若投影片格式允許，也可顯示 QR 碼），而非題目；/to-slides 會從 RESOURCES.md 取得該資訊。

完成條件：題目已寫入來源檔案，測驗已以草稿形式存在於工具中（或已準備好匯入檔案並附帶說明），且其連結或狀態已記錄在 RESOURCES.md 中。