英语试卷生成器

小学一年级英语单元测试卷自动生成工具。根据主题配置文件，生成包含听力+笔试的 100 分交互式 HTML 试卷。

脚本与资源路径

所有 Python 脚本位于 {skill_dir}/scripts/，其中 {skill_dir} 为本 SKILL.md 所在目录。

参考配置示例位于 {skill_dir}/references/：

• config_animal.py — Animal 主题
• config_food.py — Food 主题

依赖安装：pip install edge-tts

工作流（共 4 步）

步骤 1：确认或创建配置文件

• 若用户已有 config_xxx.py，直接使用
• 若需新建主题，读取 references/ 下的示例作为参考，帮用户创建 config_xxx.py
• 配置文件放在 英语试卷/{Topic}/config_{topic}.py

步骤 2：运行阶段一 — 生成题目并导出句子

执行命令：

cd "{skill_dir}/scripts" && python build.py --config "<配置文件路径>" --output "<输出目录>" --phase1

输出文件：

• _exam_data.pkl — 试卷数据（二进制，供阶段二使用）
• review_sentences.json — 所有生成的英文句子（供审核）

步骤 3：🔴 必做 — 审核并修正句子

此步骤不可跳过，这是本 Skill 的核心价值：用大模型的语义理解能力保证句子质量。

1. 读取输出目录下的 review_sentences.json
2. 逐句审核每个句子，判断标准如下：

语义合理性（最重要） — 根据单词的语义类别判断句型搭配：

| 单词类别 | 适合句型 | 不适合句型 |

|---------|---------|-----------|

| 可携带物品 (pencil, ruler, schoolbag) | This is a... / I have a... | — |

| 固定设施 (blackboard, window, door, desk, chair) | Look at the... / Open the... / Clean the... | This is a... / I have a... |

| 场所/建筑 (school) | Look at the... | This is a... / I have a... / It's on the desk. |

示例：

• ❌ "This is a school." → school 是场所，不能指着说
• ❌ "I have a window." → window 是固定设施，不可"拥有"
• ✅ "Look at the school." → 合理的指示句
• ✅ "Open the window." → 合理的动作句
• ✅ "This is a pencil." → 可以拿在手里指着说

语法正确性：a/an 使用、单复数匹配、主谓一致

一年级适用性：句子应简单，适合 6-7 岁学生

对话完整性：问答匹配（含 | 分隔的对话格式）

1. 对不合理的句子，在 JSON 中将 ok 改为 false，填写 reason 和修正后的 fixed 句子
• 修正时 必须保留原句中的核心单词（该单词是题目考察点）
• 修正应尽量小幅度，只改不合理的部分
• 对话（含 |）修正后仍保持 | 分隔格式

1. 保存修正后的 review_sentences.json

审核示例

原始：

{"id": "q3.sentences.school.0", "sentence": "This is a school.", "ok": true, "reason": "", "fixed": ""}

修正后：

{"id": "q3.sentences.school.0", "sentence": "This is a school.", "ok": false, "reason": "school是场所/建筑，不能用 This is 指着说", "fixed": "Look at the school."}

步骤 4：运行阶段二 — 渲染 HTML + 生成音频

执行命令：

cd "{skill_dir}/scripts" && python build.py --config "<配置文件路径>" --output "<输出目录>" --phase2

此步骤自动完成：

• 加载阶段一的 exam 数据
• 应用审核修正的句子
• 渲染完整 HTML 试卷
• 生成 8 段听力音频并嵌入 HTML
• 清理中间文件

完成

最终在输出目录生成 Unit{N}_{Topic}_交互考试.html 文件，用浏览器预览确认效果。

注意事项

• 步骤 3 不可跳过 — 审核时需考虑单词语义类别与句型搭配是否合理
• 若某个单词只剩 "Look at the {word}." 一个可用句型，也是可接受的
• 每次生成的试卷是随机的，同一配置多次生成结果不同
• 音频生成需要网络连接（使用 edge-tts 服务）