claude-howto 的 Lesson Quiz 技能拆解：用 10 道互动题检验单课掌握度的完整实现方案

claude-howto 的 Lesson Quiz 技能拆解用 10 道互动题检验单课掌握度的完整实现方案【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto本教程围绕开源仓库 claude-howto 内.claude/skills/lesson-quiz/SKILL.md定义的lesson-quiz技能展开它针对01-slash-commands/到10-cli/的十个分课教程用一套基于题库question bank、回合制交互AskUserQuestion、选项乱序与精确计分的流程测试学习者在某一节课上的掌握程度并输出带等级评分、逐题反馈与复习指引的报告。读完本文你将掌握该技能从「课程解析 → 时间点选择 → 五轮十题 → 计分出报告 → 跟进复习」的完整调用协议、背后的题库数据结构以及如何把它与仓库中的self-assessment技能正确区分使用。一、技能定位一次只考一节课而不是整本教程lesson-quiz的定位在 SKILL.md 的 frontmatterdescription中被精确限定为Test a learner on a single Claude Code tutorial lesson (01-10) with 10 questions, scoring answers and flagging weak spots. Use before, during, or after a lesson.Dont use for whole-tutorial assessment or explaining a topic instead of testing it.这段描述同时划定了两个行为边界值得开发者注意粒度为单课技能只服务01到10中的某一课输入参数对应一个课程目录考而非讲它只负责出题、计分与定位薄弱点不承担「解释某节课」的职责——凡是触发意图偏向讲解例如 explain hooks to me、what is MCP的请求都不应触发本技能而应回到对应课程 README 的阅读路径上。其版本信息记录在 metadata 中version: 1.1.0effort: high作者 Luong NGUYEN。仓库为该技能配套了完整资源均在.claude/skills/lesson-quiz/下路径作用SKILL.md技能主文档步骤、计分规则、验收标准、边界与错误处理README.md面向使用者的简要说明亮点、何时使用、用法与输出概览references/question-bank.md题库唯一事实来源每课 10 题共 100 题references/results-template.md结果报告模板评分行、逐题表格、错题回顾块等这种「主文档 说明 README references 子目录」的组织方式本身也是本仓库 03-skills 所讲授的渐进式披露progressive disclosure结构的直接实例——主 SKILL.md 保持精简大体积参考材料全部下沉到references/按需加载。二、Prerequisites 与 Guardrails技能运行的硬性前提在进入任何步骤之前SKILL.md 的 Prerequisites 明确了环境要求已检出本教程仓库使得课程目录01-slash-commands/…10-cli/及各自的README.md可读本技能目录下存在 references/question-bank.md它是所有题目的唯一来源。在此基础上SKILL.md 定义了三条不可违背的 Guardrails护栏这也是保证结果可信的关键设计绝不自行发明题目或答案——只能从题库中抽取所选课程对应的题目若题库缺该课程的条目如实告知而不是编题计分必须精确——每题乱序后须跟踪正确选项所在的新位置依据该位置校验作答绝不能靠猜测打分打分前必须先确认时机——课前pre、课中during、课后after会改变结果的呈现框架见第七节该环节不可跳过。从仓库证据看题库文件的末尾标注了其版本依据Last Updated: August 19, 2026Claude Code Version: 2.1.235即题库内容会随 Claude Code 的版本演进持续校准。三、Step 1课程解析Lesson Mapping——参数到目录的一一映射当用户以参数方式发起例如/lesson-quiz hooks或/lesson-quiz 03时技能首先将别名映射到课程目录参数别名解析到的课程目录01、slash-commands、commands01-slash-commands02、memory02-memory03、skills03-skills04、subagents、agents04-subagents05、mcp05-mcp06、hooks06-hooks07、plugins07-plugins08、checkpoints、checkpoint08-checkpoints09、advanced、advanced-features09-advanced-features10、cli10-cli若调用时未提供参数则技能通过 AskUserQuestion 弹出课程选择。值得注意的是由于 AskUserQuestion 单次最多 4 个选项SKILL.md 将 10 门课拆成了三段式选择交互Question 14 选项Slash Commands (01)、Memory (02)、Skills (03)、Subagents (04)Question 24 选项MCP (05)、Hooks (06)、Plugins (07)、More lessons...Question 3当用户选择 More lessons... 后弹出3 选项Checkpoints (08)、Advanced Features (09)、CLI Reference (10)。每一门课的选项都附上了该课主题的提示性摘要例如 Hooks (06) — Event automation, PreToolUse, exit codes, JSON I/O便于用户凭兴趣快速定位。这三个选项与仓库中的十个课程目录一一对应01-slash-commands、02-memory、03-skills、04-subagents、05-mcp、06-hooks、07-plugins、08-checkpoints、09-advanced-features、10-cli。四、Step 2上下文预算约束——只读一课不读十课课程确定后技能进入「刷新上下文」环节读取lesson-directory/README.md并从题库中取出该课的 10 道预置题。这里有一条值得实战项目借鉴的上下文预算纪律To stay within the context budget, read only the one selected lessons README — not all ten.仓库十个课程 README 合计约 1.2 万行例如 06-hooks/README.md 超 1500 行、09-advanced-features/README.md 超 2700 行若全部加载将迅速消耗上下文窗口。一次性只读一课的约束正是渐进式披露思想在运行时上下文管理上的体现——同时这也与 03 课所讲的「SKILL.md 应精简、大材料下沉 references」互为印证。读取完毕后技能先核对目标课程目录是否真实存在。若缺失不虚构题目而是按第九节的错误处理路径提醒用户检查仓库结构。五、Step 3 4时机确认 五轮十题交互协议5.1 Timing 时机确认正式答题前技能使用 AskUserQuestionheader 为 Timing询问一次测试时机Before (pre-test)还没读这节课检验既有知识During (progress check)读到一半中途自检After (mastery check)学完本课验证是否真正掌握。该选择不参与计分但直接决定结果报告中对分数的解释口径见第七节 results-template 解析。5.2 出题节奏5 轮 × 每轮 2 题技能以每轮 2 题、共 5 轮的节奏呈现 10 道题。每轮作答结束后立即给出逐题反馈——对错判定答错时展示正确答案与简短解释——随后进入下一轮。这种「小批量 即时反馈」的设计避免了一次性轰炸 10 道题造成的认知过载也保持了对话的节奏感。5.3 选项乱序Shuffle是硬性要求SKILL.md 用CRITICAL强调了乱序规则每道题都必须随机打乱选项顺序后再通过 AskUserQuestion 呈现不能按题库中 A、B、C、D 的原序展示不能把正确答案固定放在第一位每题使用不同的随机排列且必须记录正确答案被打乱后的新位置以此作为计分依据。例如题库中正确答案为 A 的题目展示时可能是 C、A、D、B此时正确答案位于第 2 位。这条规则的用意在于消除「选 A 固定正确的惯性」和「位置泄漏」其精确计分的要求Guardrail 第 2 条也与此呼应——乱序与准确跟踪必须成对出现否则无法对错题给出可信判定。5.4 题目的数据结构题库 question-bank.md 中每题包含 6 个字段字段含义categoryconceptual概念理解或 practical实操应用question题干options3-4 个选项其中标定一个正确项correct正确选项的标签A/B/C/Dexplanation为何该答案正确review指向对应课程 README 中应复习的小节以下是该文件第 1 课Slash Commands的真实题目节选用于体会两种 category 的差别Q1conceptualClaude Code 中有哪四种斜杠命令类型正确答案 A内建命令如/help、/compact、技能SKILL.md 文件、插件命令plugin-name:command命名空间、MCP prompts/mcp__server__prompt复习指向01 课 README 的 Types of Slash Commands 一节。Q2practical如何把用户提供的全部参数传给一个 skill正确答案 B使用$ARGUMENTS——它捕获命令名之后的全部文本如需位置参数则用$0、$1等复习指向01 课 README 的 Argument handling 一节。这些题目所指向的实操细节可在 01-slash-commands/README.md 的「Arguments」「Dynamic Context with Shell Commands」等小节中溯源验证。类似地第 6 课Hooks的题面则紧密对应 06-hooks/README.md 中 Exit Codes、JSON Input、Matcher Patterns 等真实小节——例如退出码 2 表示阻塞性错误、PreToolUse 可通过 stdout 输出带updatedInput的 JSON 修改工具入参等都是该课程文档与题库互相印证的产物。六、Step 5计分与评级全部 5 轮结束后进入计分环节。计分规则极为直白每题答对 1 分满分 10 分。成绩映射为五档等级Grade Scale分数等级含义9-10Mastered掌握出色7-8Proficient掌握良好存在少量缺口5-6Developing理解基础需要复习3-4Beginning缺口明显建议复习0-2Not yet建议从本课开头重新学习结果的呈现必须严格遵循 references/results-template.md 所定义的结构将本次运行数据填入其中方括号占位符内。报告的固定骨架如下## Lesson Quiz Results: [Lesson Name]——标题含课程名Score lineScore: N/10 等级标签如Score: 7/10 — ProficientQuiz timing行标注本次为课前/课中/课后Question breakdown行分别统计概念题与实操题各答对几道Per-Question Results表列固定为# | Category | Question (short) | Your Answer | Result10 行逐一列出Incorrect Answers — Review These块对每道错题展示题干全文、你的作答、正确答案、解释与应复习的课程小节Timing-specific message按 pre-test / during / after 三套文案之一输出。例如 pre-test 会强调这份基线成绩应指导你重点学习错题主题学完本课后重测以量化进步after 场景若为 7-8 分会建议复习错题要点后重测9-10 分则判定已掌握可进入下一课Recommended Next Steps基于分数与时机给出后续动作并附是否重测/换课/讲解错题的收尾询问。模板中对 recommended steps 还有一条精细规则Mastered → 沿 LEARNING-ROADMAP.md 或课程次序进入下一课Proficient → 复习指定小节后重测Developing 及以下 → 整课重读并聚焦薄弱类别。七、Step 6收尾跟进Follow-up结果展示完毕后技能用 AskUserQuestion 给出四个后续出口Retake this quiz——重考当前课回到 Step 4且跳过时机提问沿用原 timingQuiz another lesson——换一门课回到 Step 1 重新做课程解析Explain a topic I missed——询问题号后从对应课程 README 中读取相关小节做带示例的讲解Done——结束本次测验会话。由此形成一条可循环的学习闭环测验 → 报告 → 复习 → 重测或换课且「讲解错题」被明确设计成发生在测验结束之后而非测验途中再次呼应了考而非讲的定位。八、验收标准Acceptance Criteria什么是一次合格运行的判据SKILL.md 在展示最终结果前要求逐条核对以下验收标准任何一次完整的测验运行都必须全部满足在提问任何题目之前已唯一确定一门课01-10通过 AskUserQuestion 捕获了时机上下文before / during / after呈现了题库中该课的10 道题按 5 轮 × 每题 2 道组织且每题选项均已乱序每道作答都依据已跟踪的正确位置判分产出 0-10 的整数分数输出了## Lesson Quiz Results报告含分数行Score: N/10 等级、逐题结果表、对每道错题的 Incorrect Answers — Review These 块以及时机相关的消息提供了后续出口重测 / 换课 / 讲解 / 结束。SKILL.md 还给出了验收样例以锚定行为一次 7/10 的 Hooks 课后after测验报告须断言Score: 7/10 — Proficient列出全部 10 行结果并把答错的 3 题展开为「正确答案 解释 复习指引」。九、边界情况与错误处理Edge Cases Error Handling该技能为四类异常情况预设了明确的处置路径无效的课程参数参数无法匹配任何课程时展示合法课程清单并请用户从中选择中途退出用户在任何一轮表示想停止时仅就已作答题目给出部分结果——分数按「已答对数 / 已答数」计而不是硬性套用满分 10 分课程 README 不存在目标路径没有 README.md 时告知用户并建议核对仓库结构不得以虚构内容继续题库缺少该课条目references/question-bank.md中无该课题目时明确告知并停止绝不临时编题填补空缺。这四条与开篇 Guardrails 高度呼应共同构成了该技能宁可中断不可造假的可靠性底线。十、Validation触发与不触发——与 self-assessment 的边界SKILL.md 末尾提供了一组可复用的冒烟测试句式用于验证技能分类器是否工作正确**应当触发Should trigger**的典型表述包括quiz me on hookslesson quiztest my knowledge of lesson 3practice quiz for MCPdo I understand skillsquiz me on slash commandslesson-quiz 06test me on checkpointshow well do I know the CLIquiz me before I start the memory lesson**不应触发Should NOT trigger**的表述则包括assess my overall level——应改走/self-assessment技能explain hooks to me——这是讲解请求create a hook——这是创作/实操请求what is MCP——这是概念问答review my code——这属于代码审查。边界设计的对比对象是仓库中并列存在的 .claude/skills/self-assessment/SKILL.md版本 2.3.0。两者的分工可以这样概括lesson-quiz单课纵深测试10 题/课解决我到底掌握了这一课的哪些知识点self-assessment横跨 10 个功能领域的全景测评Quick 8 题约 2 分钟 / Deep 5 轮约 5 分钟满分 20产出分主题技能画像、缺口清单与个性化学习路径。一个测验意图若未指定到具体某课如 find my level、where should I start或需要跨 10 大主题给出总评与路线图就应落入 self-assessment 的触发范围而不是 lesson-quiz。二者互补覆盖了单点精测与全景评估两种学习诊断场景。十一、在仓库中的完整配套与落地建议11.1 学习配套lesson-quiz 直接服务于本仓库十课教程的学习闭环。学习者可以在每课阅读前、阅读中或阅读后执行测验。若要给测验结果挂接后续学习可将错题指向与各课 README 的对应小节联动第 1 课答错$ARGUMENTS、file引用相关题 → 回到 01-slash-commands/README.md 的「Arguments」「File References」小节该目录下的 commit.md、optimize.md 等命令文件就是现成的 skill 实践样本第 2 课答错记忆层级相关题 → 回到 02-memory/README.md 的「Memory Hierarchy in Claude Code」「Modular Rules System」等小节目录内的 project-CLAUDE.md、personal-CLAUDE.md 是真实 CLAUDE.md 样例第 5 课答错传输方式/MCP 配置题 → 回到 05-mcp/README.md并对照目录下 github-mcp.json、database-mcp.json 等真实配置第 8 课答错 checkpoint 恢复相关题 → 回到 08-checkpoints/README.md其中 checkpoint-examples.md 提供了可直接演练的工作流样例。11.2 设计上的可借鉴点抛开具体的题面lesson-quiz 对「如何为教学型技能做设计」给出了几条可以迁移到其他 Agent 技能上的模式题库与逻辑分离主 SKILL.md 只描述流程与规则题目全部外置到 references便于在不改动逻辑的前提下扩充题库验收标准显式化把一次合格运行写成可逐条勾选的判据降低 LLM 执行漂移风险Guardrails 前置在指令正文前用强约束不得编题、不得猜分、不得跳步圈定行为边界失败优先的安全默认README 缺失或题库缺条目时选择中断而非补造保证输出永远可追溯至真实仓库内容触发边界成文用 Should/Should NOT 句式固化意图分类测试为技能注册与回归提供依据。十二、小结从测验工具到可信的学习诊断lesson-quiz的价值不仅在于出 10 道题而在于它把一次测验固化为可审计、可复现、不编造的流程课程解析有唯一映射题目只来自 references/question-bank.md选项乱序但正确位置被精确跟踪分数经五档等级解释后落入 references/results-template.md 定义的标准化报告并最终导向明确的复习与跟进动作。它与 self-assessment 一精测单课、一全景评估共同构成了 claude-howto 仓库学习路径上的两套诊断工具——前者回答这一课我懂了吗后者回答我该往哪学。当你在仓库中需要验证自己对某一主题如 hooks、MCP 或 CLI的理解时直接使用/lesson-quiz lesson跟随五轮节奏作答再根据报告中的 Incorrect Answers — Review These 块回到对应课程的 README 小节即可。这个闭环就是该技能在本仓库教程体系中的核心使用方式。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考