steffen74/to-quiz

测验任务

为一个单元编写并发布测验。读取 COURSE-CANVAS.md、PLAN.md、RESOURCES.md、DECISIONS.md、AGENTS.md 中的 ## 代理课程创建 章节，以及该单元之前的材料（测验所涵盖的视频和任务）。加载 assumed-knowledge。

1. 工具与源文件

AGENTS.md 中应包含一行 - 测验：<源文件>，工具 <名称>，连接器 <名称|无>，该行在 /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. 在工具中创建

• 已连接连接器（针对该工具）：展示将要创建的测验，等待同意，以草稿形式创建，并记录其分享链接。根据连接器自身的模式（阅读其工具描述；不同版本模式可能变化）从测验源文件构建请求，并在连接器具有验证工具时先使用它。
  • 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 写出适用于管理 API 的调查主体，并打印 curl 命令。教师使用自己的 API 密钥（来自环境变量）运行该命令；切勿索要密钥或将其写入文件。
  • Microsoft Forms：--format forms 写出一个用于 快速导入 的 .docx 文件和一个答案密钥。快速导入无法读取正确答案；教师从密钥中勾选正确答案（仅在使用评分时需要）。
  • 其他工具：写出它所能接受的最接近的导入格式，或一份可粘贴的纯文本列表。

答案和解释绝不出现在面向参与者的文件中或公共位置。

4. 交接

在 RESOURCES.md 中为该单元记录测验链接（Quiz 列）。幻灯片显示该链接（以及二维码，若幻灯片格式允许），而不是题目；/to-slides 从 RESOURCES.md 中获取链接。

当题目已写入源文件、测验已在工具中以草稿形式存在或导入文件已准备就绪并附带说明，且其链接或状态已记录在 RESOURCES.md 中时，任务完成。