| name | english-exam-generator |
| description | 英语试卷生成器 - 智能交互式英语测试系统。通过对话收集用户需求，利用AI能力自动生成高质量英语试题，或处理用户提供的自定义题目，生成交互式在线试卷网站（中文界面，美观现代）。支持单选/多选/填空/阅读理解等多种题型，具有计时、即时评分、对错检查功能。当用户需要：(1) 创建英语练习试卷 (2) 生成在线英语测试 (3) 提供英语题目进行练习 (4) 需要带计时和评分的英语考试系统 (5) 想要AI帮忙出英语题时触发此Skill |
英语试卷生成器 Skill
核心理念
这是一个交互式智能出题系统。当用户触发此Skill时，你需要：
- ✅ 与用户对话 - 收集考试需求
- ✅ 智能出题 - 使用AI能力生成高质量题目（或处理用户提供的题目）
- ✅ 生成网页 - 输出美观的中文界面试卷
- ✅ 启动服务 - 让用户立即开始答题
🎯 工作流程（必须按顺序执行）
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自动生成
你的任务：
- 根据用户选择的题型和难度，调用AI能力生成高质量的英语题目
- 将生成的题目转换为标准JSON格式（见下方格式规范）
- 确保题目难度符合用户要求
- 题目内容必须是英文，但题目说明可以是中英双语
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：用户提供自定义题目
你的任务：
- 接收用户提供的题目（可能是文本、图片描述等）
- 解析并转换为标准JSON格式
- 验证格式正确性
- 如有问题，主动询问用户确认
Phase 3: 生成试卷网页
步骤1：准备HTML文件
使用Skill自带的模板文件作为基础：
路径：assets/exam-generator.html
步骤2：注入题目数据
修改HTML文件第626行的EXAM_DATA数组，填入生成的题目JSON。
Phase 4: 启动服务
./start.sh [端口号]
python3 -m http.server 8080
📋 题目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：完全交互式流程
用户: "我想做一个英语测试"
你:
- 询问："您希望包含哪些题型？"
- 询问："题目来源？"
- 询问："参数设置？"
- 执行:
- 调用AI生成15道混合型中级英语题
- 更新HTML文件中的题目数据
- 设置默认参数为15题、40分钟、中级
- 启动服务器
- 回复用户:
✅ 英语试卷已生成完成！
📍 访问地址：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: 完美支持！采用响应式设计，手机体验同样流畅。
✨ 最佳实践
与用户交互时：
- 友好耐心 - 引导用户明确需求
- 主动建议 - 为新手推荐合理配置
- 质量保证 - AI生成的题目必须经过验证
- 及时反馈 - 每个步骤都要告知用户进展
- 完整交付 - 不仅生成文件，还要启动服务并教会用户使用
生成题目时：
- 难度准确 - 严格按照用户选择的难度级别
- 覆盖全面 - 涵盖不同知识点
- 选项合理 - 干扰项要有迷惑性但不荒谬
- 语言地道 - 英语表达自然准确
- 文化适宜 - 避免敏感或有争议的内容
记住：这个Skill的核心价值在于AI与用户的智能交互 + 高质量题目生成 + 美观易用的界面。不只是生成一个HTML文件，而是提供完整的英语学习体验！🎯
