CathyErer Frog and Toad Studio · 三件套工作流
本 skill 面向教 ESL G1（一年级）学生的老师。每个故事 = 一次课 = 一个三件套：
0M - <Chapter> 关键词地图.html— 投屏 lesson plan，锁定风格（奶油纸+手写风），5 个 tab（含 Vocabulary）0M - <Chapter> Workbook.docx— 单页学生练习0M - <Chapter> Workbook 答案版.docx— 答案版，答案红色加粗下划线
外加（按需）：课程总结与作业（微信版） 段落、Obsidian 同步。
运行前配置
不要写死或猜测用户电脑上的路径。先确定三个路径变量：
<SKILL_DIR>：当前SKILL.md所在的 Skill 文件夹，无需用户设置<COURSE_ROOT>：Frog and Toad 课程资料根目录<OBSIDIAN_DIR>：Obsidian 中的 Frog and Toad 课程追踪目录
首次运行时读取 <SKILL_DIR>/config.local.json。若文件不存在，参考
<SKILL_DIR>/config.example.json，向用户确认 <COURSE_ROOT> 和 <OBSIDIAN_DIR> 后创建本地配置。
找不到目录时必须询问用户，不得根据用户名或常见文件夹位置猜测。
模板、脚本和参考资料始终相对于 <SKILL_DIR> 定位。本地配置和生成的微信版课程总结不得提交到公开仓库。
文件夹与命名约定
素材库：<COURSE_ROOT>/
Frog and Toad精读课/
├── 1.days with frog and toad/ ← 课 01–05（Tomorrow/Kite/Shivers/Hat/Alone）
├── 2.frog and toad all year/ ← 课 06–10
├── 3.frog and toad together/ ← 课 11–15
├── 4.frog and toad are friends/ ← 课 16–20
│ ├── 1.Frog and Toad Are Friends.pdf ← 扫描版原书
│ └── 1-Spring/ ← 每章一个文件夹 <M-Chapter>/
│ ├── 01 - Spring 关键词地图.html
│ ├── 01 - Spring Workbook.docx
│ └── 01 - Spring Workbook 答案版.docx
Skill 文件夹：<SKILL_DIR>/。其中可保存本地生成的
课程总结与作业（微信版）.md 和可安装的 frog-and-toad-studio.skill；这两类本地文件不提交到公开仓库。
教学顺序 = 文件夹书序（Days with → All Year → Together → Are Friends），全系列课号 01–20。
Obsidian 库：<OBSIDIAN_DIR>/
00 - Frog and Toad 全系列课程地图.md— 20 课寓意 + inference 问题总表0N - <Book> 关键词地图.md— 每本书一份，每章一节（含 ✅三件套已生成 标记）0N - <Book>.md— 追踪笔记，升级日志加一行（带 wikilink）课程总结与作业（微信版）.md— 与<SKILL_DIR>/课程总结与作业（微信版）.md保持同步
工作流（7 步，顺序执行）
1. 读原文（扫描 PDF 无文字层）
用 pypdfium2 渲染成图再 Read（视觉转录）：
import pypdfium2 as pdfium
pdf = pdfium.PdfDocument("<book>.pdf")
for i, page in enumerate(pdf):
page.render(scale=1.5).to_pil().save(f"outputs目录/pXX.png")
每张 PNG 是一个跨页（2 个书页）。用 Read 工具逐张读图、逐字转录。引文必须逐字—— 后面 HTML/Workbook 里的所有 quote 都要能在原文找到（历史教训：dumb≠dump、 "I am feeling much better now"≠"I feel much better"、"on the front door"≠"at the front door"）。
2. 先列关键词，确认后再动手
绝不跳过：先把关键词列表发给用户确认，再开始生成（"先列出关键词，再来做"）。 粒度是「中间版」——历史校准中"字太多"和"这也太精简啦"都被反馈过，收敛后的标准：
- 寓意（英文 moral + 中文短释）
- 核心 inference 问题（Why did …? 一课一个，笑点藏在"说的和做的不一致"里）
- 关键词复述线：场景小标题 + emoji 开头的 bullet + 加粗关键词 + 简短逐字引文
- 动词词库（6 个，供 Workbook 填空）+ 寓意填空（2 个空）
若用户上传了手绘关键词地图，以用户的图为准挑关键词。
3. 生成关键词地图 HTML
复制 <SKILL_DIR>/assets/template_keyword_map.html，只换内容，绝不发明新版式。
五个 tab 固定：① Warm-up 读前（3 张 q-card：聊自己→标题猜想→带问题读）
② Vocabulary 10 个核心词汇（英文解释 + 中文解释 + 例句）
③ The Story Map 复述路线 ④ Characters 人物+情绪线 ⑤ Theme 寓意。
版式部件（按故事结构选用）：
.route路线卡：每一段都必须用<span>包住（flex 容器裸文本会错误换行——历史 bug）.mishap网格：3 项默认 / 4 项加.four/ 5 项加.five.idea/.we-know（红色手写金句）/.morning/.gold（金色寓意卡）/.sad-line.feel-line情绪线固定 6 站：📍节点卡（先读发生了什么）→ emoji → 心情标签.char-grid两张人物卡，各带一个句型支架.frame（"___ is ___ because ___."）
语言规则：中文都放 <span class="zh"> 里（EN only 按钮会隐藏）；正文关键词式精简；
标题区 moral-tag = 寓意；footer 写 Lesson N。
词汇规则：Vocabulary tab 的主数据来自 Obsidian 0N - <Book> 关键词地图.md 中每课的
10 个词汇（中英解释 + 例句） 模块；本地同步脚本为
<SKILL_DIR>/scripts/sync_vocabulary_to_html.py。
自检：Python HTMLParser 做标签平衡检查（历史上每次都查）。
4. 生成 Workbook 两件
用 <SKILL_DIR>/scripts/make_workbooks.py：照 EXAMPLE（Spring）的 shape 写新 config、
调 build(cfg, False/True, path) 生成学生版+答案版。规格已内置（Letter、Arial、
三列固定表格、红色答案、无 emoji）。四个 Part 固定：
Story Map 填动词（6 行，cue 逐字引文）→ Think! 推断题 → 寓意填空（2 空）→ Draw! 画图框+一句话。
自检：soffice 转 PDF 断言每个文件恰好 1 页（超页就精简 cue/closing 文字）。
5. 逐字核对
把 HTML + Workbook 里的每条引文与转录原文比对一遍。宁可删引号改叙述，不可改动原句。
6. Obsidian 同步（可选）
用户未使用 Obsidian 或未配置 <OBSIDIAN_DIR> 时跳过本步（此时第 3 步的词汇数据改为直接向用户确认）。
使用 config.local.json 中的 <OBSIDIAN_DIR>。同步前先确认该目录及目标笔记存在；
如果配置缺失或目录无效，停止并向用户确认，不得尝试其他 Obsidian Vault。
- 书的关键词地图笔记：追加/更新该章小节，标
✅三件套已生成，frontmatterlast_updated改今天 - 追踪笔记
0N - <Book>.md：升级日志加一行（日期 + 内容 + wikilink） - 若全书完成：写"全书五章完成 ✅"
7. 课程总结与作业（微信版，可选）
按用户需要生成。每课一段，纯文本（微信不渲染 markdown），格式固定：
【Frog and Toad 精读 · <Chapter> <中文名>】
📖 今天的故事：（3-5 句中文概述，穿插英文关键句/引文）
🎯 本课重点
· 寓意：<英文 moral> —— <中文>
· 思考题：<inference 问题>
· 重点动词：<6 个>
📝 课后作业
1️⃣ 复述：打开"关键词地图"，沿 Story Map 路线把故事讲一遍（用上重点动词）
2️⃣ 完成 <Chapter> Workbook（一页）
3️⃣ 预习《<下一章>》：<一句吊胃口的预告问题>
最后一课的第 3 项改为全系列复习。写入
<SKILL_DIR>/课程总结与作业（微信版）.md 对应段落，并同步到 <OBSIDIAN_DIR>。
参考资料
<SKILL_DIR>/config.example.json— 首次运行的路径配置示例<SKILL_DIR>/sync-config.md— 路径变量、资料分工和同步规则<SKILL_DIR>/sync-checklist.md— 每次检查/同步 Obsidian 时使用的固定清单<SKILL_DIR>/assets/template_keyword_map.html— 锁定的 HTML 模板（Spring 成品，含 .four/.five CSS）<SKILL_DIR>/scripts/make_workbooks.py— Workbook 生成器 + EXAMPLE config<SKILL_DIR>/scripts/sync_vocabulary_to_html.py— 从 Obsidian 关键词地图同步 Vocabulary tab 到 20 个 HTML<SKILL_DIR>/references/course-map.md— 全系列 20 课总表（寓意/思考题/动词词库），改总结或补课时查这里<SKILL_DIR>/skills/frog-and-toad-illustration-style/— 插画子 skill：画风规则 + 20 章提示词库（prompts/）+ 插图注入关键词地图 HTML 的锁定版式
交付清单（每章完成前过一遍）
- 关键词列表已经用户确认
- HTML 标签平衡，route 段都包了 span，中文都在 .zh 里，Vocabulary tab 有 10 个词汇卡
- Workbook + 答案版都是 1 页；答案红粗下划线；无 emoji
- 所有引文与原书逐字一致
- 章节文件夹三件套齐全，命名
0M - <Chapter> … - Obsidian 两个笔记已更新
- 把生成的文件交付给用户，说明简短