english-exam-generator

name	english-exam-generator
description	英语试卷生成器 - 智能交互式英语测试系统。通过对话收集用户需求，利用AI能力自动生成高质量英语试题，或处理用户提供的自定义题目，生成交互式在线试卷网站（中文界面，美观现代）。支持单选/多选/填空/阅读理解等多种题型，具有计时、即时评分、对错检查功能。当用户需要：(1) 创建英语练习试卷 (2) 生成在线英语测试 (3) 提供英语题目进行练习 (4) 需要带计时和评分的英语考试系统 (5) 想要AI帮忙出英语题时触发此Skill

英语试卷生成器 Skill

核心理念

这是一个交互式智能出题系统。当用户触发此Skill时，你需要：

1. ✅ 与用户对话 - 收集考试需求
2. ✅ 智能出题 - 使用AI能力生成高质量题目（或处理用户提供的题目）
3. ✅ 生成网页 - 输出美观的中文界面试卷
4. ✅ 启动服务 - 让用户立即开始答题

---

🎯 工作流程（必须按顺序执行）

Phase 1: 需求收集（与用户对话）

当用户说类似以下的话时触发此Skill：

• "帮我生成一个英语试卷"
• "我想做个英语测试"
• "帮我出一些英语题"
• "我有一些英语题目想做"
• "创建一个英语练习"

必须询问的问题（使用AskUserQuestion工具）：

问题1：题型选择

您希望包含哪些题型？（可多选）
选项：
A. 单选题（推荐）
B. 多选题
C. 填空题
D. 阅读理解
E. 混合所有类型（推荐新手）

问题2：题目来源

您希望如何提供题目？
A. 由AI根据我的要求自动智能生成（推荐）
B. 我自己有题目要提供（请粘贴）

如果选择B，请用户提供题目内容。

问题3：基本参数

请设置考试参数：
- 题目数量：（默认10题，范围1-50）
- 考试时间：（默认30分钟，范围1-180分钟）
- 难度等级：初级 / 中级 / 高级

💡 提示：对于新用户，建议使用默认值或推荐"混合题型+AI生成+中级难度"。

---

Phase 2: 题目生成/处理

场景A：用户选择AI自动生成

你的任务：

1. 根据用户选择的题型和难度，调用AI能力生成高质量的英语题目
2. 将生成的题目转换为标准JSON格式（见下方格式规范）
3. 确保题目难度符合用户要求
4. 题目内容必须是英文，但题目说明可以是中英双语

AI出题示例（你应该这样生成）：

// 单选题示例
{
  "type": "multiple_choice",
  "question": "What is the past tense of 'go'?",
  "options": ["goed", "gone", "went", "going"],
  "answer": "went"
}

// 填空题示例
{
  "type": "fill_blank",
  "question": "She ___ (go) to school every day.",
  "answer": "goes"
}

// 阅读理解示例
{
  "type": "reading_comprehension",
  "passage": "Climate change is one of the most pressing issues...",
  "questions": [
    {
      "question": "文章中提到的气候变化的主要原因是什么？",
      "options": ["自然周期", "人类活动", "太阳辐射", "火山爆发"],
      "answer": "人类活动"
    }
  ]
}

出题质量要求：

• ✅ 题目语法正确
• ✅ 选项干扰项合理
• ✅ 难度匹配用户选择
• ✅ 涵盖不同知识点（词汇、语法、阅读等）

场景B：用户提供自定义题目

你的任务：

1. 接收用户提供的题目（可能是文本、图片描述等）
2. 解析并转换为标准JSON格式
3. 验证格式正确性
4. 如有问题，主动询问用户确认

---

Phase 3: 生成试卷网页

步骤1：准备HTML文件

使用Skill自带的模板文件作为基础：

路径：assets/exam-generator.html

步骤2：注入题目数据

修改HTML文件第626行的EXAM_DATA数组，填入生成的题目JSON。

---

Phase 4: 启动服务

# 启动服务器
./start.sh [端口号]

# 或手动启动
python3 -m http.server 8080

# 访问 http://localhost:8080/assets/exam-generator.html

---

📋 题目JSON格式规范

单选题 (multiple_choice)

{
  "type": "multiple_choice",
  "question": "英文问题文本",
  "options": ["选项A", "选项B", "选项C", "选项D"],
  "answer": "正确答案文本"
}

多选题 (multiple_select)

{
  "type": "multiple_select",
  "question": "英文问题（提示多选）",
  "options": ["选项A", "选项B", "选项C", "选项D"],
  "answer": ["正确答案1", "正确答案2"]
}

填空题 (fill_blank)

{
  "type": "fill_blank",
  "question": "She ___ (go) to school every day.",
  "answer": "goes"
}

阅读理解 (reading_comprehension)

{
  "type": "reading_comprehension",
  "passage": "完整的英文文章内容...",
  "questions": [
    {
      "question": "问题1（中文或英文）",
      "options": ["A", "B", "C", "D"],
      "answer": "正确答案"
    }
  ]
}

---

🎨 界面特性

设计亮点

• ✨ 现代化UI - 清新青绿色调（#0D9488），卡片式设计，流畅动画
• 🇨🇳 全中文界面 - 除题目本身外，所有UI文字都是中文
• 📱 响应式布局 - 完美支持手机、平板、电脑
• ⏱️ 实时计时 - 显示已用时间，支持时间限制
• 📊 进度追踪 - 可视化答题进度条
• ✅❌ 即时反馈 - 正确绿色高亮，错误红色标记
• 🎉 成绩展示 - 百分制评分 + 等级评价 + 详细统计

设计理念

• 纯试卷模式 - 无配置页面，打开即答
• 对话式交互 - 像聊天一样简单，降低使用门槛
• 青绿色配色 - 清新护眼，告别俗套紫色渐变

---

💡 使用示例

示例1：完全交互式流程

用户: "我想做一个英语测试"

你:

1. 询问："您希望包含哪些题型？"
   • 用户选择："混合题型"
2. 询问："题目来源？"
   • 用户选择："AI自动生成"
3. 询问："参数设置？"
   • 用户回答："15道题，40分钟，中级难度"
4. 执行:
   • 调用AI生成15道混合型中级英语题
   • 更新HTML文件中的题目数据
   • 设置默认参数为15题、40分钟、中级
   • 启动服务器
5. 回复用户:

   ✅ 英语试卷已生成完成！
   
   📍 访问地址：http://localhost:8080/assets/exam-generator.html
   
   📝 试卷信息：
   - 题目数量：15道（混合题型）
   - 考试时间：40分钟
   - 难度等级：中级
   
   💡 使用方法：
   1. 打开上述链接
   2. 开始答题，系统会自动计时
   3. 完成后点击提交查看成绩
   
   祝您考试顺利！🍀
   

---

🔧 技术实现

前端技术栈

• HTML5 + CSS3 + JavaScript（纯前端，无依赖）
• Google Fonts (DM Sans + Fraunces)
• CSS Grid & Flexbox 布局
• CSS Animations & Transitions
• 响应式设计 (Mobile-first)

核心功能函数

函数名	功能
initExam()	初始化考试，加载EXAM_DATA
renderQuestions()	渲染题目界面
startTimer()	启动倒计时
submitExam()	提交并评分
showResults()	显示成绩报告
resetExam()	重置考试状态

---

🎓 出题指南（AI生成时参考）

初级难度 (Easy)

• 基础词汇（常用1000词）
• 简单时态（一般现在时、一般过去时）
• 基础语法（主谓一致、be动词）
• 日常话题（家庭、学校、食物）

中级难度 (Medium) ⭐ 推荐

• 中级词汇（常用3000词）
• 复杂时态（完成时、进行时）
• 从句（定语从句、状语从句）
• 虚拟语气、被动语态
• 学术/社会话题

高级难度 (Hard)

• 高级词汇（学术/专业词汇）
• 复杂语法结构
• 长难句理解
• 推理判断题
• 抽象概念/哲学话题

---

❓ 常见问题

Q: 可以离线使用吗？ A: 可以！HTML文件完全独立，只需浏览器即可运行。

Q: 如何保存答题记录？ A: 当前版本不支持保存，刷新后会重置。如需此功能可以后续扩展。

Q: 支持打印吗？ A: 支持！使用浏览器的打印功能(Ctrl+P/Cmd+P)即可打印试卷。

Q: 手机上可以使用吗？ A: 完美支持！采用响应式设计，手机体验同样流畅。

---

✨ 最佳实践

与用户交互时：

1. 友好耐心 - 引导用户明确需求
2. 主动建议 - 为新手推荐合理配置
3. 质量保证 - AI生成的题目必须经过验证
4. 及时反馈 - 每个步骤都要告知用户进展
5. 完整交付 - 不仅生成文件，还要启动服务并教会用户使用

生成题目时：

1. 难度准确 - 严格按照用户选择的难度级别
2. 覆盖全面 - 涵盖不同知识点
3. 选项合理 - 干扰项要有迷惑性但不荒谬
4. 语言地道 - 英语表达自然准确
5. 文化适宜 - 避免敏感或有争议的内容

---

记住：这个Skill的核心价值在于AI与用户的智能交互 + 高质量题目生成 + 美观易用的界面。不只是生成一个HTML文件，而是提供完整的英语学习体验！🎯