# Lesson Quiz

> 针对单个 Claude Code tutorial lesson（01-10）进行 10 题互动测验，评分并标出薄弱点。用于用户明确要求单课测验、lesson quiz 或 MCP / hooks / skills 等主题练习；不用于整套教程评估，也不用于只解释某个主题。

- Skill: `lhfer/lesson-quiz` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add lhfer/lesson-quiz`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lhfer/lesson-quiz/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: lhfer (https://skillmd.com/u/lhfer)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lhfer/lesson-quiz

---


# 课程测验（Lesson Quiz）

这是一个针对单个 Claude Code lesson 的完整互动测验 skill，用于检查用户对某一课的理解程度。它只测一个 lesson，不用于整套教程的水平评估；整套评估请使用 `self-assessment`。

## 前置条件与护栏

本 skill 需要能读取教程仓库中的 `01-slash-commands/` 到 `10-cli/` 目录，以及本 skill 自带的 `references/question-bank.md`。

- 先确认目标 lesson 的 `README.md` 存在；如果不存在，停止并提醒用户检查仓库结构。
- **不要临时编题。** 只使用 `references/question-bank.md` 中该 lesson 的预置题；如果题库缺失，直接说明并停止。
- **准确计分。** 每题选项会随机打乱，必须记录正确选项在打乱后的新位置，再据此判分。
- **先确认测验时机。** `Before` / `During` / `After` 会影响结果解释，不能跳过。

## 使用说明

### Step 1: 确认 lesson

如果用户提供了参数，就映射到 lesson 目录：

- `01` / `slash-commands` / `commands` → `01-slash-commands`
- `02` / `memory` → `02-memory`
- `03` / `skills` → `03-skills`
- `04` / `subagents` / `agents` → `04-subagents`
- `05` / `mcp` → `05-mcp`
- `06` / `hooks` → `06-hooks`
- `07` / `plugins` → `07-plugins`
- `08` / `checkpoints` / `checkpoint` → `08-checkpoints`
- `09` / `advanced` / `advanced-features` → `09-advanced-features`
- `10` / `cli` → `10-cli`

如果用户没提供参数，使用 AskUserQuestion 分 2-3 轮让用户选择 lesson。

---

### Step 2: 读取 lesson 与题库

先读取：

- `<lesson-directory>/README.md`
- `references/question-bank.md`

只读取当前选中 lesson 的 `README.md`，不要为了测一个 lesson 一次性加载全部 10 个 lesson。题库中每个 lesson 应有 10 道预置题；如果该 lesson 题目不足，停止并报告题库需要维护，不要根据 README 临时补题。

---

### Step 3: 询问测验时机

用 AskUserQuestion 询问用户当前是在：

1. `学前（pre-test）`
2. `学习中（progress check）`
3. `学后（mastery check）`

不同 timing 会影响结果解读。

---

### Step 4: 出题

- 每次固定 10 题
- 每轮 2 题，共 5 轮
- 混合概念题和实践题
- 每题使用 AskUserQuestion，提供 3-4 个选项
- 每轮用户答完后，立即给出本轮逐题反馈：是否答对；如果答错，给出正确答案和简短解释
- 每题展示前必须随机打乱选项顺序，不要照搬题库里的 A/B/C/D 顺序，也不要固定把正确答案放在第一项
- 打乱后要记录正确答案对应的新位置，最终评分按打乱后的真实答案判定

每题必须包含这些信息：

- `category`
- `question`
- `options`
- `correct`
- `explanation`
- `review`

记录用户答案；每轮反馈不替代最终结果，所有 5 轮结束后仍要统一评分。

---

### Step 5: 评分与结果输出

每题答对记 1 分，总分 10 分。

等级：

- 9-10：Mastered
- 7-8：Proficient
- 5-6：Developing
- 3-4：Beginning
- 0-2：Not yet

输出格式使用 `references/results-template.md`。填充模板里的占位符，保留分数行、单题结果表、错题复盘、按时机给出的反馈和推荐下一步。

---

### Step 6: 根据 timing 解释结果

#### 如果是学前测验

- 把成绩解释为“学习前基线”
- 强调用户接下来应重点关注哪些主题

#### 如果是学习中检查

- 把成绩解释为“阶段性进度检查”
- 明确哪些点已经掌握、哪些点要补

#### 如果是学后测验

- 把成绩解释为“lesson mastery check（课程掌握度检查）”
- 如果分数高，建议进入下一课
- 如果分数一般，列出明确回看点

---

### Step 7: 提供后续动作

最后再用 AskUserQuestion 让用户选择：

1. `重新测本课`
2. `测另一课`
3. `解释我没掌握的主题`
4. `结束`

如果选第三项，先问错题编号，再读取该 lesson README 的相关部分，用中文解释并给例子。

## 验收标准

一次完整测验必须满足：

- 已解析且只解析了一个 lesson（01-10）
- 已通过 AskUserQuestion 获取 `Before` / `During` / `After` 测验时机
- 已从 `references/question-bank.md` 取出该 lesson 的 10 道题
- 已按 5 轮、每轮 2 题展示，并对每题选项随机打乱
- 已按打乱后的真实正确位置计分，最终分数为 0-10 的整数
- 最终报告包含 `Score: N/10`、10 行单题结果、每道错题的正确答案与复习建议
- 已提供“重新测本课 / 测另一课 / 解释我没掌握的主题 / 结束”后续选择

## 边界情况

- 无效 lesson 参数：展示可用 lesson 列表并让用户重新选择。
- 用户中途退出：给出已答题目的部分结果，分母用已答题数，不要写成 10 分满分。
- 目标 `README.md` 不存在：停止并提示检查仓库结构。
- 题库缺失：停止并说明缺少该 lesson 的题目，不要编造题目。

## 输出要求

- 中文表达清晰
- 保留关键英文术语
- 错题解释必须具体
- 复习建议要明确到 lesson 或章节
- 不要把测验做成泛泛聊天