quiz-generator

# 随堂测验生成器 本 skill 面向中文交互，用于生成教育培训领域的自测选择题 HTML 页面，并支持从错题记录生成复习测验页面。 ## 工作流程 1. 确认用户需要的课题（如"矩阵行列式计算"）和题目数量（默认 8 题）。 2. 调用 `scripts/generate_quiz.py` 生成测验 HTML 文件。需要提供： - `questions`：JSON 数组，每道题包含 `question`, `options`（4个选项数组）, `answer`（正确选项索引 0-3） - `title`：测验标题，如"矩阵行列式 — 随堂测验" - `output`：输出 HTML 文件路径 3. 生成页面批改后会把主题、批改时间、答错或未作答题目、当时选择的选项和正确选项写入浏览器 localStorage，并提供"复制给 Agent 保存"按钮。 4. 当用户发送 `save_quiz_record` payload 时，使用 `scripts/save_record.py` 校验并保存到 `records/`。 5. 如用户需要复习功能，调用 `scripts/generate_review.py` 从 records 生成复习 HTML；默认尽量从不同记录文件轮流抽取错题凑满 10 道，并在题干标注来源主题、时间和文件名。 6. 将生成的 HTML 文件通过 `chat_send_file` 发送给用户。 ## 课题示例 以下是一个可直接使用的课题示例——矩阵行列式计算，包含 8 道选择题： ```json { "title": "矩阵行列式 — 随堂测验", "questions": [ { "question": "行列式 | 2 1; 3 4 | 的值是多少？", "options": ["5", "8", "11", "10"], "answer": 0 }, { "question": "若 A 是 3×3 方阵且 det(A) = -2，则 det(2A) = ？", "options": ["-16", "-4", "-8", "-2"], "answer": 0 }, { "question": "下列哪个矩阵的行列式一定为 0？", "options": ["单位矩阵", "上三角矩阵", "有两行成比例的矩阵", "正交矩阵"], "answer": 2 }, { "question": "若 A 可逆，det(A⁻¹) 与 det(A) 的关系是？", "options": ["相等", "互为相反数", "互为倒数", "无关"], "answer": 2 }, { "question": "det(AB) 等于？", "options": ["det(A) + det(B)", "det(A) · det(B)", "det(A) / det(B)", "det(A) - det(B)"], "answer": 1 }, { "question": "行列式 | 1 0 0; 0 2 0; 0 0 3 | 的值是？", "options": ["0", "1", "5", "6"], "answer": 3 }, { "question": "交换矩阵的两行，其行列式会？", "options": ["不变", "变为相反数", "变为倒数", "变为 0"], "answer": 1 }, { "question": "若 A 的某一行全为 0，则 det(A) = ？", "options": ["1", "0", "无法确定", "等于该行元素之和"], "answer": 1 } ] } ``` ## 调用方式 ```bash python /data/agent_data/skills/quiz-generator/scripts/generate_quiz.py \ --title "矩阵行列式 — 随堂测验" \ --questions '[{"question":"...","options":["A","B","C","D"],"answer":0}]' \ --output /data/agent_data/workspace/quiz.html ``` 脚本参数说明： - `--title`：测验标题 - `--questions`：JSON 格式的题目数组（需用单引号包裹、内部 JSON 用双引号） - `--output`：输出 HTML 文件路径，默认输出到当前工作目录的 `quiz.html` 生成错题复习页： ```bash python /data/agent_data/skills/quiz-generator/scripts/generate_review.py \ --records-dir /data/agent_data/skills/quiz-generator/records \ --output /data/agent_data/workspace/review.html \ --title "错题复习测验" ``` 保存用户从页面复制来的错题记录： ```bash python /data/agent_data/skills/quiz-generator/scripts/save_record.py \ --input /data/agent_data/workspace/quiz-record.json ``` ## 输出 脚本生成一个完全自包含的 Single HTML 文件，打开后： 1. 页面显示所有选择题，每题 4 个单选选项 2. 用户逐题选择答案 3. 点击底部"批改"按钮 4. 系统自动对比正确答案： - **绿色背景**：选对的选项 - **红色背景**：选错的选项，同时绿色标出正确答案 - 顶部显示得分（如 6/8） 5. 可点击"重新作答"清除所有选择重新来 6. 若存在错题或未作答题，可点击"复制给 Agent 保存"生成 payload；该记录包含主题、时间、题目、当时选择和正确答案 7. Agent 将记录保存到 `records/` 后，可生成新的复习测验 HTML ## 注意事项 - 题目数据由 AI 根据课题知识生成，确保答案正确 - 每题 4 个选项，正确答案索引为 0-3 - HTML 页面无需网络连接，可直接在浏览器中离线使用 - 单文件 HTML 无法直接写入 Agent 运行环境中的 `records/` 目录；必须由用户复制 payload 或下载 JSON 后交给 Agent 保存 - 如需生成其他课题的测验，AI 应根据该领域的知识自行编写题目和答案