英材施教-阅译悦学
Pipeline Overview
阶段0: 预处理 提取EPUB → 浏览内容 → 提取角色名 → 确认译名+产物目录+题数
阶段1: 翻译 并行翻译 → 译名检查 → 表达简化
阶段2: 词汇表 生成超纲词表 → 清理 → 补中文释义
阶段2.5: 词汇标记 扫描译文 → 标记词汇表单词 → 产出重点标记文件
阶段3: 阅读理解题 并行出题 → 拆分题目与答案
阶段4: 合并与格式转换 合并TXT/MD → 转换DOCX(可选)
目录结构
.trae/skills/英材施教-阅译悦学/
├── SKILL.md ← 本文件(总入口)
├── phases/ ← 各阶段详细指令
│ ├── 阶段0-预处理.md
│ ├── 阶段1-翻译.md
│ ├── 阶段2-词汇表.md
│ ├── 阶段2.5-标记词汇.md
│ ├── 阶段3-阅读理解题.md
│ └── 阶段4-合并与格式转换.md
└── tools/ ← 所有工具
├── extract_character_names.py
├── extract_epub_chapters.py
├── merge_files.py
├── merge_txt_to_docx.py
├── md_to_docx.py
├── merge_md_to_docx.py
├── mark_vocab_in_text.py
├── vocab_checker.py
├── clean_vocab.py
└── 高考英语词汇表_合并版.md
When to Use
- User asks to "英材施教" or "阅译悦学" process a text or book
- User needs: text → translate → simplify → vocab → reading questions → convert
文件命名规范(全程适用)
| 类型 | 命名示例 |
|---|---|
| 中文原文 | 00-标题页.txt |
| 英文翻译 | EN-00-Title-Page.txt |
| 词汇表原始 | EN-00-Title-Page_vocab.md |
| 词汇表清理版 | EN-00-Title-Page_vocab_cleaned.md |
| 词汇标记版 | EN-00-Title-Page-marked.txt |
工作流程
| 阶段 | 名称 | 主要产出 |
|---|---|---|
| 阶段0 | 预处理 | 角色名提取报告、译名对照表、确认产物目录与题数 |
| ✋ 确认点 | 用户确认译名 + 目录 + 题数 | 用户答复 |
| 阶段1 | 翻译 | EN-*.txt 英文章节文件 |
| 阶段2 | 词汇表 | *_vocab_cleaned.md 清理后词汇表 |
| 阶段2.5 | 词汇标记 | EN-*-marked.txt 重点标记文件 |
| 阶段3 | 阅读理解题 | Questions.md + Answer-Key.md |
| 阶段4 | 合并与格式转换 | *_merged.docx, *_merged.md |
进度追踪
进入阶段0之前,立即创建以下 TodoWrite 列表:
| # | 内容 | 初始状态 |
|---|------|---------|
| 1 | 阶段0:预处理 | in_progress |
| 2 | ✋ 确认点:译名 + 产物目录 + 题数 | pending |
| 3 | 阶段1:翻译 | pending |
| 4 | 阶段2:词汇表 | pending |
| 5 | 阶段2.5:词汇标记 | pending |
| 6 | 阶段3:阅读理解题 | pending |
| 7 | 阶段4:合并与格式转换(可选) | pending |
每完成一个阶段/确认点,用 TodoWrite(merge=true) 更新状态。
执行规则(必须遵守)
规则1:每次执行阶段前,必须先读取对应的 phases/ 文件
此规则不可跳过。 phases/ 目录下的每个 .md 文件包含该阶段的完整详细指令(包括 SubAgent 模板、命令示例、注意事项),主 SKILL.md 仅提供总览。
每个阶段对应的文件:
| 阶段 | 必须读取的文件 |
|---|---|
| 阶段0:预处理 | phases/阶段0-预处理.md |
| 阶段1:翻译 | phases/阶段1-翻译.md |
| 阶段2:词汇表 | phases/阶段2-词汇表.md |
| 阶段2.5:词汇标记 | phases/阶段2.5-标记词汇.md |
| 阶段3:阅读理解题 | phases/阶段3-阅读理解题.md |
| 阶段4:合并与格式转换 | phases/阶段4-合并与格式转换.md |
规则2:禁止跳过确认点
遇到确认点(✋)时,必须暂停,使用 AskUserQuestion 等待用户确认,获得答复后才能继续。
规则3:每阶段结束更新进度追踪
每完成一个阶段/确认点,用 TodoWrite(merge=true) 将对应项标记为 completed。
标准执行循环
loop:
1. 读取 phases/阶段X-xxx.md ← 必须先读!
2. 按文件中的详细指令执行本阶段任务
3. 若遇到✋确认点 → 暂停,AskUserQuestion 等用户确认
4. 用 TodoWrite(merge=true) 更新进度
5. 看文件末尾的"→ 下一阶段"指引,确定下一个文件
goto loop
Version History
| Version | Date | Changes |
|---|---|---|
| 2.3 | 2026-07-20 | Step 0.4 增加出题频率确认;新增 Phase 2.5 词汇标记 + tools/mark_vocab_in_text.py |
| 2.2 | 2026-07-20 | 更名为"英材施教-阅译悦学",更新描述定位,准备发布 |
| 2.1 | 2026-07-20 | 拆分为 phases/ 多文件结构,Step 0.4 合并问产物目录 |
| 2.0 | 2026-07-20 | 渐进式披露 + 工具自包含 |
| 1.0 | 2026-07-20 | 初始版本 |