quiz-generator

name	quiz-generator
description	根据用户指定的知识课题（如矩阵行列式、微积分、英语语法等），生成5-10道选择题的单一HTML页面。页面自带前端自动批改、错题记录 payload 和复习入口：选择答案后点击"批改"，自动标出正确答案（绿色）和错误答案（红色），显示得分，并可复制答错题目、选项和时间记录给 Agent 保存到 records。用于教育培训场景下的随堂测验、自测练习、错题复习、作业布置。

随堂测验生成器

本 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 道选择题：

{
  "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
    }
  ]
}

调用方式

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

生成错题复习页：

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 "错题复习测验"

保存用户从页面复制来的错题记录：

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 应根据该领域的知识自行编写题目和答案