按课程阶段出题检测掌握度（8 题单选、逐题作答…

当学习者说"quiz me / test phase / check my understanding / do I know phase N"时，针对已完成课程阶段生成 8 道单选题并评分、给出错题复习定位。

适用场景

解决思路

1. 解析参数：接受 phase 编号（0-19）或名称/关键词；若未提供参数，列出全部 20 个 phase 让用户选择。
2. 若参数是数字，校验其是否在 0-19（含）之间；超出范围时回复 "Phase [N] does not exist. Valid phases are 0-19." 并展示完整列表让用户重选。
3. 若参数是名称或关键词，在 Phase Map 中查找；查不到时回复 "Unknown phase '[keyword]'. Pick from the list below:" 并列出全部 20 个 phase。
4. 用 Phase Map 把输入映射到 phases/ 下的对应目录（如 3、deep-learning、dl -> `03-deep-learning-core`；7、transformers -> `07-transformers-deep-dive`；19、capstone、projects -> `19-capstone-projects`）。
5. 读取阶段内容：若仓库已克隆（当前目录或其上级存在 `phases/` 目录），找出 `phases/<phase-dir>/` 下所有 lesson 目录并逐个读取 `docs/en.md`；若未克隆，则先从 README 的 Contents 段（raw 地址 `https://raw.githubusercontent.com/rohitg00/ai-engineering-from-scratch/main/README.md`）获取该阶段的 lesson 列表，再用同一 raw 基址抓取每个 lesson 的 `docs/en.md`。
6. 确保覆盖整个阶段的广度；若某阶段 lesson 很多（15+），优先读有代表性的分布：最前几篇、中间几篇、最后几篇。
7. 生成恰好 8 道单选题，题目必须直接源自刚读到的 lesson 文档内容，不能靠通用知识。
8. 第 1-4 题考概念（What/Why），例如 X 的目的是什么、为什么 Z 时会发生 Y、A 与 B 的关系、X 解决什么问题。
9. 第 5-8 题考实践（How/Build），例如如何实现 X、哪种做法能正确解决 Y、构建 Z 的正确步骤顺序、训练中出现 X 时该怎么做。
10. 每题提供恰好 4 个选项 A、B、C、D，只有 1 个正确；错误选项要对学过材料的人显得合理但明确错误，禁止玩笑选项。
11. 为每题标注来源 lesson（例如 "Lesson 03: Matrix Transformations"）。
12. 用 AskUserQuestion 工具（或等价交互提示）逐题呈现，格式为 `Question 1/8 (Conceptual) -- from Lesson 03: Matrix Transformations` 加题干和 A-D 选项；等用户回答后再进入下一题。
13. 答题隔离：在用户回答当前题前，不透露正确选项与解释，不用真实答案字母、可能答案或答案分布做提示；需要纯文本提示时只写 `Reply with one letter: <A|B|C|D>.`。
14. 持续记分：统计 8 题中答对总数；每道错题记录题号、用户答案、正确答案、来源 lesson。
15. 8 题全部答完后展示分数与等级：7-8 correct: Mastered；5-6 correct: Almost；3-4 correct: Developing；0-2 correct: Start Over。
16. Mastered 分支：若阶段是 19（Capstone Projects），说 "You have mastered Phase 19, the final phase."，只有能验证整个课程已完成（当前目录 `LEARNING.md` 的 Path 表显示 Phase 0-18 为 Done 或 Skip）时才追加 "Congratulations, you have completed the entire curriculum."；其他阶段说 "You have a strong grasp of Phase N. You are ready to move on to Phase N+1: [next phase name]."
17. Almost 分支：说 "Solid foundation. Review these specific areas before moving on:"，并列出错题关联的 lesson。
18. Developing 分支：说 "You are building understanding but need to revisit some lessons:"，逐条列出错题及其需要重读的 lesson。
19. Start Over 分支：说 "This phase needs more time. Work through the lessons again from the beginning, focusing on:"，并列出所有错题主题。
20. 对每道错题输出解析，模板为：Question N、题目缩写、Your answer、Correct answer: C -- 正确选项文本、Why: 1-2 句说明为何 C 正确、Review: Lesson NN -- lesson 名称 (phases/<phase-dir>/NN-<lesson-slug>/docs/en.md)。
21. 结尾提供三个选项并等待用户选择后执行：1) Retake this quiz（从同一阶段重新生成 8 道全新题目）2) Try another phase（换一个阶段测试）3) Explain a topic（讲解错题中的任意概念）。
22. 重考时避免重复出题，直到题库耗尽；耗尽后可重排或改写题目。
23. 题干保持简洁，最多一到两句。
24. 若某阶段尚无可用的 `en.md` 文件，回复 "Phase N does not have lesson content yet. Pick a completed phase to quiz on."

适用边界 · 注意事项

• 该阶段还没有编写 lesson 文档（找不到 `en.md`）时无法出题。
• 不能凭一次 phase quiz 判定整个课程已完成，必须由 `LEARNING.md` 的 Path 表核实。
• 不适用于需要开放式解答或长篇讲解的场景，本流程只做 8 道单选题与评分。