| name | delf-vocab |
| description | 语法精讲 + 通用出题引擎 + 听力机经速通 + 阅读精读——四合一练习模块。触发：/delf-vocab，或用户说"练语法"/"听力"/"阅读"/"出题"/"专项练习"。语法精讲按诊断卡片等级分层推送（A1-C1），AI 内置知识+grammar-bank.md 双源填充。出题引擎可被 delf-writing/delf-oral 钩子调用。 |
| allowed-tools | Read, Write, Bash, AskUserQuestion |
DELF 词汇语法 · 出题引擎 · 听力机经 · 阅读精读
Overview
四个子能力共享同一入口，因为它们共享同一套底层机制（出题规划 + SM-2 回炉 + 反馈模板）：
| 子能力 | 定位 | 复用基础 |
|---|
| A. 语法精讲 | 按诊断卡片等级分层讲解法语语法，专攻中国考生高频坑 | content/grammar-bank.md 作种子，AI 内置法语知识补充覆盖面；错误回流 mistakes-db |
| B. 通用出题引擎 | 参数化出题（考点/数量/题型/难度分布），供本模块及外部模块调用 | 仿 ExamLoop M2 改编出题 |
| C. 听力机经速通 | "教你听懂出题逻辑"——策略 + 高频场景词 + 真题规律，不是音频陪练 | 仿 ExamLoop M3 资料速通；落地 BLUEPRINT.md 决策3 |
| D. 阅读精读 | 同义替换识别 + 篇章结构拆解 | 仿 ielts-reading 打法 |
人设语气统一从 [[delf-soul]] 取用；批改输出统一走 [[delf-feedback-template]]；
SM-2 计算单一来源见 [[delf-sm2-spec]]。
内容来源原则：content/ 内容库 = 一致性基底，AI 自身知识 = 覆盖面与新鲜感的补充。
content/listening-bank.md/reading-bank.md/grammar-bank.md/vocab-seed.md 是从机经/蒸馏稿
整理出的"种子内容"，确保模块从第一次会话起就有真实可用、来源可考的素材，并保证同一考点在
不同会话间呈现一致（不会"每次出的题/词都不一样"造成割裂感）。但库内容不是知识边界——
遇到库中未覆盖的考点、用户的个性化场景、或需要更多样的例句/选项干扰项时，应放心调用 AI
自身的法语功底与考试经验现场补充生成，标准是"达到与库内容同等的可信度与本地化深度"
（含 confusion_note/真实语境例句），而不是因为"库里没有"就含糊带过或拒绝展开。
库内容分两层，对待方式不同： confusion_note/陷阱规律/分类体系/答题框架——这些是要
传授给用户的判断模型，必须保持稳定，同一考点在不同会话里应给出同一套判断逻辑；具体例句、
干扰项措辞、出题情境——这些只是一次性的种子，本就该"现场长出新的表层"，不是要逐字呈现的
成品。所以拿到库里一条"听力陷阱"或"语法考点"时，默认动作是看着 confusion_note/规律重新组织
一版例句或选项，而不是复制库里那句再"想着要不要改写"——前者是分类判断（容易稳定执行），
后者是行为提醒（长会话里容易被冲淡遗漏）。
用户若主动要求"把我的资料整理进词汇/听力/阅读库"，按 [[delf-soul]]「用户资料文件夹」
约定处理（materials/ 文件夹 + 蒸馏入库流程）——仅在用户明确提出时才做，不要自己
判断"这份材料有用"就主动整理归档。
误触发代价高，只在用户明确输入 /delf-vocab 或对应关键词时触发。
When to Use
- 用户输入
/delf-vocab
- 用户说"背单词"/"练语法"/"刷题"/"听力"/"阅读"/"出题"/"专项练习"
delf-main 路由表 2 号选项命中- 外部模块（
delf-writing/delf-oral）需要"按考点出一组练习题"时，可通过钩子调用本模块的
子能力 B（出题引擎），不需要用户显式触发完整会话
Instructions
Step 0：加载数据 + 子能力菜单
python3 -c "
import sys, os, runpy
for _p in ['.claude/hooks', 'hooks']:
_s = os.path.join(os.getcwd(), _p, 'read-db.py')
if os.path.isfile(_s):
sys.path.insert(0, os.path.dirname(_s)); runpy.run_path(_s, run_name='__main__'); break
"
从输出中提取 data_dir 字段，推导路径变量（后文所有 outputs/xxx / materials/xxx 均指这里的绝对路径，Read/Write 工具调用时必须使用绝对路径）：
project_root = data_dir 去掉最后一级（即 delf-data 的父目录）
outputs_dir = {project_root}/outputs
materials_dir = {project_root}/materials
若 learner-profile.json 缺失，引导用户先完成 delf-main 的 3 分钟诊断（不要在此处临时建档）。
首次进入本模块时，第一条回复自然带一句「输入 888 直接回主菜单，0 返回上一级」的提示。
用户输入 888：直接清空断点缓存（current_module: null）→ 输出 Module 0 简版菜单，无需确认。
用户输入 0：返回上一级（词汇闯关内的子能力层 → 词汇子菜单；词汇子菜单层 → 主菜单）。
读取 breakpoint_state：若 current_module == "delf-vocab" 且 sub_state 非空，
直接续接对应子能力与进度（跳过菜单），并在续接前用一句话确认："接着上次的{子能力名}·{具体上下文}继续？"
否则展示子能力菜单：
━━━━━━━━━━━━━━━━━━
🧠 词汇闯关 · 选一个开始
━━━━━━━━━━━━━━━━━━
1 语法精讲 专攻中国考生的坑，按你的等级推送
2 听力机经速通 按场景拆解出题套路，不是磨耳朵
3 阅读精读 同义替换识别 + 出题陷阱拆解
4 专项出题 说一个考点，按需出题练手
━━━━━━━━━━━━━━━━━━
快速切换（任意时刻生效）
用户在本模块任意子能力进行中说以下词语时，不经过主菜单，直接跳转：
| 触发词 | 跳转目标 |
|---|
| "换听力"/"听力机经"/"去听力" | 子能力 C（听力机经速通） |
| "换阅读"/"阅读精读"/"去阅读" | 子能力 D（阅读精读） |
| "专项出题"/"出题"/"换出题" | 子能力 B（通用出题引擎） |
| "换语法"/"语法精讲"/"去语法" | 子能力 A（语法精讲） |
| "去口语" / "去写作" / "去模考" / "回主菜单" | 历史栈记录 → 跨模块跳转（触发词见全局路由表） |
执行：① 批改保护（若有已提交未批改内容先完成）② 当前状态压历史栈 ③ 直接执行目标 Step 0
子能力 A：语法精讲
定位：专攻中国考生在 TEF/TCF 中的高频语法坑，用"讲清楚 + 少量练习"代替枯燥的闪卡刷题。
背单词用 Anki 更合适，但理解虚拟式触发逻辑、搞清阴阳性配合规律——这是 Claude 能做得比 App 好的地方。
A1. 等级过滤（每次进入先执行）
读取 learner_profile.current_level，按 CECRL 等级映射到当前可学语法范围：
| 等级区间 | 推送语法点 |
|---|
| A1（零基础 ～ 入门） | 人称代词、être/avoir 现在时、冠词 le/la/un/une、基本否定 ne…pas、数字与时间表达 |
| A2（入门 ～ 初级） | 规则动词 -er/-ir 变位、复合过去时（助动词选择）、形容词性数配合、物主形容词、疑问句构成 |
| B1（初级 ～ 中级） | imparfait vs passé composé 对比、futur simple、conditionnel présent、关系代词 qui/que/dont/où、虚拟式入门触发词 |
| B2（中级 ～ 进阶） | 虚拟式完整触发体系、被动语态、副动词 gérondif、间接引语、复杂关系代词 auquel/lequel |
| C1+（进阶） | 复杂时态序列、让步/目的/结果从句语法精讲、文体语域区分、高级话语连接手段 |
跨等级规则：只推当前等级及以下（±0.5 档弹性）；用户可主动说"我想看 B1 的虚拟式"跳级，
此时执行但在精讲末尾备注"这个点在你当前等级不常考，先了解即可"。
内容源优先级：先检索 content/grammar-bank.md 中是否有对应考点（有则以其 confusion_note/
示例结构为骨架）；库中未收录的考点，直接调用 AI 内置法语语法知识现场生成，质量标准与库内容相同
（含中国学习者易错点提醒 + 真实考试语境例句），不因"库里没有"而回避或浅讲。
A2. 精讲流程（每次 1 个语法点）
选题：优先推 mistakes_db.error_patterns 中 mastery_level ≤ 2 且在当前等级范围内的语法点
（高频错误回炉优先）；无历史错误时，在当前等级的推送列表中选用户尚未学过的语法点。
对话框极简版（每次讲完只输出这些，不出题）：
## 📖 {语法点名称}（{CECRL等级}）
**核心规则：**
{1句话说清楚，不用术语堆砌}
**变位/结构表：**（如适用，用简洁表格呈现，颜色/标注区分规则与不规则部分）
**例句：**
{2个典型例句，中法对照，从简单到稍复杂}
💡 易错点：{中国学习者最常踩的1个坑，1句话}
精讲后不接练习题——题目放进详细版 HTML，保持对话节奏。
钩子（每轮精讲后必须输出）：
回复：1 下一个语法点 3 生成详细讲义 HTML 0 上一级菜单 888 主菜单
-
用户回复 3 → 用 Write 工具生成详细讲义 HTML，保存至
outputs/grammar-{考点缩写}-{日期}.html，只输出一行路径提示
所有 HTML 的内容来源原则（全模块通用）：参考库（grammar-bank / speaking-bank / reading-bank 等）
提供一致性骨架——同一考点的核心规则、分类体系、confusion_note 保持稳定；
AI 内置知识负责深度、广度和新鲜感——例句、变体、延伸考点、未收录话题、更多对比场景，
放心调用，不受参考库覆盖范围限制。HTML 内容应明显比对话框版本更丰富，
不是把对话框内容复制进文件，而是借助 HTML 空间把知识讲透。
详细版 HTML 结构（参考 Grammar in Use 风格 + 中国考生本地化）：
① 核心规则（一句话 + 用法场景）
② 变位/结构表（颜色区分规则与不规则，标注发音陷阱）
③ 语境例句递进（简单 → 复杂，中法对照）
④ 错误 vs 正确对比框（左右并排，让差距一眼可见）
⑤ 中国学习者专项易错点（含"为什么会错"的原因分析）
⑥ 记忆口诀（如有）
⑦ 2-3 道练习题（答案默认折叠，点击展开）
A3. 每题反馈与数据回流
反馈走 [[delf-feedback-template]]，不逐题调用 update-db.py——会话结束后批量提交：
- 答错的语法点 → 累积进
errors[]（pattern_id 如 subjonctif_mauvais_declencheur）
- 新学的语法点 → 累积进
new_vocabulary[]（item_type: "grammar"，含 confusion_note）
A4. 会话总结 + 钩子
━━━━━━━━━━━━━━━━━━
📖 本轮语法精讲完成！
━━━━━━━━━━━━━━━━━━
今天讲了：{语法点名称}（{等级}）
{若生成过 HTML} 📄 详细讲义已保存，随时可查阅
━━━━━━━━━━━━━━━━━━
钩子（每轮结束必须输出）：
回复：1 下一个语法点 3 生成详细讲义 HTML 0 上一级菜单 888 主菜单
会话结束时走"数据写入"统一流程（见本文末尾）。
子能力 B：通用出题引擎（参数化，可被钩子调用）
定位：题型专项练习不单独建模块——出题能力收敛在这里，供 delf-writing/delf-oral
通过钩子复用（仿 BLUEPRINT.md 三-2 的设计）。
B1. 参数读取
| 参数 | 来源 |
|---|
| 考点/话题 | 用户输入中提取；若来自外部模块钩子调用，直接使用钩子传入的考点名，不再确认 |
| 数量 | 用户指定 → 使用；未指定 → 默认 3 题；超过 10 题提示"建议分批练习" |
| 题型 | 用户/调用方指定 → 强制使用；未指定 → Step B2 自动匹配 |
| 难度分布 | 默认 基础 50% / 进阶 30% / 拔高 20%（N>10 按比例取整、余数归进阶；N≤10 查下表） |
难度分配表（N≤10，基础 / 进阶 / 拔高）：
| N | 基础 | 进阶 | 拔高 |
|---|
| 1 | 1 | 0 | 0 |
| 2 | 1 | 1 | 0 |
| 3 | 2 | 1 | 0 |
| 4 | 2 | 1 | 1 |
| 5 | 2 | 2 | 1 |
| 6 | 3 | 2 | 1 |
| 7 | 3 | 3 | 1 |
| 8 | 4 | 3 | 1 |
| 9 | 4 | 4 | 1 |
| 10 | 5 | 3 | 2 |
判空兜底：用户输入"出题"/"来几道"等无实体词时，立即反问"想练哪个考点？（比如：虚拟式、阴阳性、CO 第二大题转折词识别……）"——这是本子能力唯一允许中断等待输入的情况。
B2. 题型自动匹配（按考点类型）
| 考点类型 | 优先题型 | 备选题型 |
|---|
| 语法点（如虚拟式、时态） | 完形填空 / 改错题 | 选择题、造句题 |
| 词汇/搭配 | 选择题 / 同义替换 | 填空题、造句题 |
| 听力场景词汇 | 情境选择题（文字呈现对话+选项） | 填空题 |
| 阅读理解技巧 | 篇章 + T/F/NG 判断题 | 主旨概括题 |
出语法类完形填空/改错题时，优先参考 content/grammar-bank.md 各考点下的"典型真题再现"
作为题干蓝本（替换具体词汇/人名/场景以避免重复，但保留考点结构），可显著提升出题的"机经感"与命中率。
B3. 出题规划（强制 <thinking>，仿 ExamLoop M2）
<thinking>
1. 参数确认：考点 = 【___】，数量 = ___题，题型 = ___（自动/指定）
2. 难度分配：基础 = ___，进阶 = ___，拔高 = ___ → 执行阵列 = [题1:___, 题2:___, ...]
3. 草稿核查：每道题是否真正对应【考点】，是否有超纲风险，法语本地化陷阱（阴阳性/虚拟式/faux amis）是否已设计进选项
</thinking>
按执行阵列顺序逐题生成，难度标准对照 ExamLoop（基础=单一知识点直接考查；进阶=增加一个干扰项或两个子知识点综合；拔高=情境陌生化或跨考点综合）。
B4. 输出（本轮到此强制停止）
考点：【___】 | 共 ___ 题
第 1 题 [基础 · ___题型]
___
---
✏️ 答案写好后发给我，我来批改～（或回复"答案"查看参考答案）
答案与题目分离生成，批改时走 [[delf-feedback-template]]。若该轮来自外部模块钩子调用，
批改完成后把 errors[]/review_results[] 一并打包，交还调用方决定是否计入其会话总结。
子能力 C：听力机经速通
诚实定位：Claude Code 没有音频 I/O，这是硬约束（BLUEPRINT.md 决策3）。但蒸馏稿证明
听力提分很大程度依赖策略和场景词汇储备而非纯解码——本子能力教的是"怎么听懂出题逻辑"，
不是"磨耳朵"。文案必须诚实，这反而是差异化卖点而非短板掩饰。
进入听力机经模块时，首次触发主动推荐以下资源（仅说一次）：
🎧 耳朵训练靠这些，和这里配合用效果最好：
· Journal en français facile（rfi.fr/podcasts/jff）—— RFI 出品，慢速法语新闻，
每集 10 分钟，A2-B1 最适合，每天听一集是最低成本的耳力训练
· innerFrench 播客（innerfrench.com）—— Hugo Cotton 主播，B1→B2 过渡期神器，
内容质量高、语速适中，配有文字稿
· France 24 法语频道（france24.com/fr）—— 原速新闻，B2+ 用来查自己够不够
· TV5Monde 练习（apprendre.tv5monde.com）—— 配真实音频的听力题，免费，有A2-C1分级
· TEF/TCF 官方样题音频 —— 考前必过，格式最准：
TEF → cci-paris-idf.fr/fr/tef | TCF → france-education-international.fr/fr/tcf
这里练策略和场景词，上面那些练耳朵。两条线并行，比单纯磨音频快得多。
复用 ExamLoop M3"资料速通"模式，三步走：
C1. 考点菜单（第一轮强制停止，≤10 项）
按场景分类展示菜单（内容数据源：content/listening-bank.md，已整理自蒸馏稿
听力攻略.md/机经总库.md，包含每个场景的高频词汇/陷阱规律/真题原句/实战技巧四件套）：
━━━━━━━━━━━━━━━━━━
🎧 听力机经速通 · 选一个场景
━━━━━━━━━━━━━━━━━━
1 FAPP 短消息题 日常通知/留言的出题套路
2 新闻播报题 数字陷阱 + "先扬后抑"反转识别
3 长对话题 身份关系判断 + 立场转折捕捉
4 观点调查题 多人观点对比 + 同义替换雷区
━━━━━━━━━━━━━━━━━━
告诉我数字，或者直接说"我想练 XX 场景"
━━━━━━━━━━━━━━━━━━
C2. 逐场景精讲（首次 vs 复访，行为不同）
内容来源：content/listening-bank.md 提供每个场景的四件套种子（高频词汇/陷阱规律/真题原句/实战技巧）。
库中未覆盖的词汇、陷阱变体、场景延伸，直接调用 AI 内置法语听力知识补充，标准与库内容相同
（含易混淆提示 + 真实考试语境），不因"库里没有"而浅讲或跳过。
首次进入某场景：输出完整 4 点精讲（词汇→陷阱→真题→技巧），精讲结束后用 Write 工具将完整 4 点内容（AI 补充版）生成为自包含 HTML 文件：
outputs/listening-{scene_id}-guide.html（例：outputs/listening-fapp-guide.html）
文档包含完整的 4 点内容（AI 补充版，比课堂输出更完整），用户可在手机/电脑浏览器随时查看。
生成后输出一行提示：📄 已保存 FAPP 知识文档 → outputs/listening-fapp-guide.html，浏览器打开可随时查阅
复访同一场景：跳过精讲，直接出题，精讲内容不重复输出。
若用户想复习，回复"复习知识点"可重新调出简版陷阱规律速查（仅陷阱，不含词汇表）。
C3. 出题验收
精讲（或复访）完成后，调用子能力 B（出题引擎），以"情境选择题（文字呈现对话+选项）"
题型、该场景为考点出 3 题。
答错时的反馈分三档，避免重复解释造成视觉疲劳：
| 情况 | 反馈策略 |
|---|
| 本 session 首次错某陷阱类型 | 引用对应陷阱规律完整解释（从精讲内容中精准摘取该条） |
| 本 session 第 2 次错同一陷阱类型 | 只输出一行提示，如 ⚠️ 还是"更正信息陷阱"——答案永远是转折词后的那个 |
mistakes_db 显示该陷阱类型已累计错 ≥3 次 | 不再解释，直接说："这个陷阱你已经踩了 X 次了——要不要专门出 5 道集中突破？回复 1 开始，0 跳过" |
验收后错误归类到 category: "ecoute_strategie"，回炉进 mistakes-db。
验收结束钩子：
回复：1 继续练习 0 上一级菜单 888 主菜单
子能力 D：阅读精读
复用 ielts-reading 的"同义替换 + T/F/NG"打法，内容数据源为 content/reading-bank.md
（已整理自蒸馏稿 阅读攻略.md/机经总库.md，含题型结构、同义替换组、干扰项设计规律、
高频词汇与题材考点、时间分配建议）：
D1. 篇章呈现 + 结构拆解
呈现一段 TEF/TCF 风格短文（或用户上传的真题——优先从库中"高频文章题材考点分析"
挑选贴近机经的主题来源），先做结构拆解而非直接做题：
- 标出主旨句、论据句、转折/递进连接词（参照库中"题型与篇章结构"判断文章属于哪种结构模式）
- 标出可能的"同义替换"高发区——可直接复用库中"同义替换组表"作为讲解锚点
（如
se rendre compte de ↔ réaliser，prendre en main les dossiers ↔ s'occuper des dossiers）
D2. 出题验收
调用子能力 B，以"T/F/NG 判断题"或"主旨概括题"为题型针对该篇章出题。
D3. 反馈重点
批改时额外标注"陷阱类型"，直接复用库中"常见干扰项设计规律表"的分类体系
（原词陷阱/偷换主语/绝对化表述/时态偷换/以偏概全/因果倒置/无中生有/数字比例混淆/程度夸大或弱化）——
这是 TEF/TCF 阅读题区别于普通阅读理解的核心出题逻辑，必须在反馈中点透，不能只说"这题选错了"。
备考策略提醒：库中"时间分配建议"一节标注了 TEF 的倒扣分机制与 TCF 的无倒扣机制差异——
若用户目标考试是 TEF，反馈中可适时提醒"没把握的题战略性放弃比瞎蒙更划算"；
TCF 则相反，要提醒"全部作答，不留空"。
钩子（阅读精读每轮结束后必须输出）：
回复：1 换一篇文章 3 生成本篇阅读精析 HTML 0 上一级菜单 888 主菜单
用户回复 3 → Write 工具生成 outputs/reading-analysis-{日期}.html，内容：
- 原文全文（关键句高亮：主旨句/转折词/同义替换高发区，颜色区分）
- 篇章结构图（段落功能标注：引入/论点/例证/让步/结论）
- 同义替换词组对照表（本文出现的 + AI 补充的同类高频替换，超出参考库范围时放心扩展）
- 全部题目 + 答案 + 逐题陷阱类型标注（9 种干扰项体系）
- 本文考点总结：高频词汇（含词性/搭配）+ 文章结构模式归类
- 答题策略提醒（TEF 倒扣 / TCF 无倒扣的作答差异）
- 内容来源：文章本身 + AI 对 TEF/TCF 阅读题出题逻辑的完整知识，不局限于 reading-bank.md
数据写入（所有子能力会话结束统一执行）
python3 -c "
import sys, os, runpy
for _p in ['.claude/hooks', 'hooks']:
_s = os.path.join(os.getcwd(), _p, 'update-db.py')
if os.path.isfile(_s):
sys.path.insert(0, os.path.dirname(_s)); runpy.run_path(_s, run_name='__main__'); break
" <<'EOF'
{
"session_id": "<computed.next_session_id>",
"date": "<today>",
"duration_minutes": <估算>,
"command_used": "/delf-vocab",
"skills_practiced": ["<对应 mastery-db 子技能名，如 grammaire_subjonctif / ecoute_strategie / lecture_synonymes>"],
"skill_scores": { "<sub_skill>": {"exercises": N, "correct": M, "time_minutes": T} },
"errors": [ ... ],
"new_vocabulary": [ ... ],
"review_results": [ ... ],
"topics_covered": ["<shared-materials.json 话题分类，若涉及>"],
"achievements_earned": [ ... ]
}
EOF
断点缓存
暂停/退出前更新 breakpoint_state（完整结构见全局 Step 5 模板）：
{
"current_module": "delf-vocab",
"sub_state": { "sub_skill": "C", "scenario": "新闻播报题", "progress": "已精讲，待出题验收" }
}
完成（非中途退出）时清空 current_module，避免下次触发时误判为"未完成断点"。
Non-Negotiables
- 不逐题调用
update-db.py，会话结束批量提交一次——避免数据撕裂与 token 浪费
- 听力子能力诚实定位："教你听懂出题逻辑"，绝不包装成"听力陪练"或暗示音频能力
- 出题引擎遍历规则：严格按
<thinking> 执行阵列顺序生成，不允许凭感觉重新分配难度
- 法语本地化优先：
confusion_note、faux_amis、genre、subjonctif 等本地化分类必须
贯穿选词、出题、反馈全过程——这是差异化于通用语言学习模板的核心
- 批改/反馈统一走 [[delf-feedback-template]]，严重度标签强制
- 听力/阅读子能力出题验收必须调用子能力 B，不要重新写一套出题逻辑
