check-understanding
GitHub用于测验用户对 AI Engineering from Scratch 课程特定阶段的掌握程度。支持通过阶段编号或名称触发,自动读取对应课程内容生成8道选择题,并交互式引导用户作答与评分。
Trigger Scenarios
Install
npx skills add fancyboi999/ai-engineering-from-scratch-zh --skill check-understanding -g -y
SKILL.md
Frontmatter
{
"name": "check-understanding",
"version": "1.0.0",
"description": "AI Engineering from Scratch 的阶段测验。用于“给我测验一下”、“测试阶段”、“检查我的理解”、“我掌握第 3 阶段了吗”,也支持 \"quiz me\", \"test phase\", \"check my understanding\", \"do I know phase 3\" 或 `\/check-understanding <phase>`。"
}
检查理解程度
测试学习者对 AI Engineering from Scratch 已完成阶段的掌握情况。
触发方式
当用户说出类似下面的话时启用此 skill:
/check-understanding 3或/check-understanding deep-learning- “测验一下我对第 2 阶段的掌握情况”
- “测试第 1 阶段”
- “检查我对 transformer 的理解”
- “我掌握第 3 阶段了吗”
- “我准备好进入下一阶段了吗”
输入
接受阶段编号(0-19)或阶段名称作为参数。如果没有参数,列出全部 20 个阶段,并询问用户希望测试哪一阶段。
阶段映射
将参数映射到 phases/ 下正确的阶段目录:
| 输入 | 目录 | 阶段名称 |
|---|---|---|
| 0, setup, tooling | 00-setup-and-tooling |
环境设置与工具 |
| 1, math, math-foundations | 01-math-foundations |
数学基础 |
| 2, ml, ml-fundamentals | 02-ml-fundamentals |
机器学习基础 |
| 3, deep-learning, dl | 03-deep-learning-core |
深度学习核心 |
| 4, cv, computer-vision, vision | 04-computer-vision |
计算机视觉 |
| 5, nlp | 05-nlp-foundations-to-advanced |
NLP:从基础到进阶 |
| 6, speech, audio | 06-speech-and-audio |
语音与音频 |
| 7, transformers | 07-transformers-deep-dive |
Transformer 深入剖析 |
| 8, generative, gen-ai, genai | 08-generative-ai |
生成式 AI |
| 9, rl, reinforcement-learning | 09-reinforcement-learning |
强化学习 |
| 10, llms, llm, llms-from-scratch | 10-llms-from-scratch |
从零构建 LLM |
| 11, llm-engineering, llm-eng | 11-llm-engineering |
LLM 工程 |
| 12, multimodal | 12-multimodal-ai |
多模态 AI |
| 13, tools, protocols, mcp | 13-tools-and-protocols |
工具与协议 |
| 14, agents, agent-engineering | 14-agent-engineering |
Agent 工程 |
| 15, autonomous | 15-autonomous-systems |
自主系统 |
| 16, multi-agent, swarms | 16-multi-agent-and-swarms |
多 Agent 与群体 |
| 17, infrastructure, production, infra | 17-infrastructure-and-production |
基础设施与生产环境 |
| 18, ethics, safety, alignment | 18-ethics-safety-alignment |
伦理、安全与对齐 |
| 19, capstone, projects | 19-capstone-projects |
综合项目 |
流程
第 1 步:解析阶段
解析参数。若为数字,验证它是否在 0 到 19(含)之间。数字超出范围时,告诉用户:阶段 [N] 不存在。有效阶段为 0-19。然后展示完整列表供其选择。若为名称或关键词,在上方阶段映射中查找。关键词不匹配任何条目时,告诉用户:未知阶段“[keyword]”。请从下面列表中选择:,并展示全部 20 个阶段。未提供参数时,要求用户从完整列表中选择。
第 2 步:读取阶段内容
如果仓库已克隆(当前目录或其父目录存在 phases/),找出 phases/<phase-dir>/ 下全部课程目录并读取每课的 docs/zh.md。如果未克隆,从 README 的 Contents 部分获取该阶段课程列表(获取 https://raw.githubusercontent.com/fancyboi999/ai-engineering-from-scratch-zh/main/README.md),再从同一 raw base URL 获取每课的 docs/zh.md。这些文档就是出题依据。
读取足够多的课程文档,以覆盖该阶段的完整广度。阶段课程很多(15+)时,优先读取具有代表性的分布:开头几课、中段几课和最后几课。
第 3 步:生成 8 道题
基于刚读取的课程内容,恰好生成 8 道选择题:
第 1-4 题:概念题(是什么/为什么) 这些题测试想法、定义和推理的理解。例如:
- “X 的目的是什么?”
- “Z 存在时为什么会发生 Y?”
- “哪项陈述最准确地描述了 A 与 B 的关系?”
- “X 解决了什么问题?”
第 5-8 题:实践题(怎么做/构建) 这些题测试应用知识和实现意识。例如:
- “你会如何实现 X?”
- “哪种方法能正确解决 Y?”
- “构建 Z 的正确步骤顺序是什么?”
- “若训练中观察到 X,应当怎么做?”
每题必须恰有 4 个选项,标记为 A、B、C、D,且只有一个正确选项。错误选项应当可信,但对认真学过材料的人应当明显不对。
给每道题标记其来源课程(例如“第 03 课:矩阵变换”)。
第 4 步:逐题展示
使用 AskUserQuestion 工具(或等效交互式提示)一次展示一道题。格式:
第 1/8 题(概念题)——来自第 03 课:矩阵变换
特征值的几何解释是什么?
A) 矩阵施加的旋转角度
B) 特征向量在变换中被缩放的倍数
C) 变换矩阵的行列式
D) 变换后矩阵的秩
等待用户作答后,才进入下一题。
答案隔离
在学习者回答当前题目之前,正确选项和解释必须保持私密。回复格式提示中绝不使用真实答案字母、可能答案或生成的答案分布。若需要纯文本提示,必须严格使用:请只回复一个字母:<A|B|C|D>。
第 5 步:记录与评分
持续记录:
- 8 题中的正确总数
- 每道错题:题号、用户答案、正确答案及来源课程
第 6 步:展示结果
所有 8 题完成后,展示得分和评级:
答对 7-8 题:已掌握
若为第 19 阶段(综合项目):你已掌握第 19 阶段,也是最后一个阶段。只有能够确认整个课程其余部分均已完成时(当前目录中的 LEARNING.md 路径表显示阶段 0-18 都是 Done 或 Skip),才能再加上 恭喜,你已完成全部课程。单次阶段测验不能证明整个课程已完成。
否则:你对第 N 阶段掌握扎实,可以进入第 N+1 阶段:[下一阶段名称]。
答对 5-6 题:接近掌握
基础扎实。继续前请复习以下具体内容:
随后列出错题关联的课程。
答对 3-4 题:正在形成理解
你的理解正在建立,但还需回顾以下课程:
随后列出每道错题及需重读的课程。
答对 0-2 题:重新开始
这个阶段还需要更多时间。请从头重新学习课程,重点关注:
随后列出所有未掌握的主题。
第 7 步:错题拆解
对用户答错的每一题,展示:
第 N 题:[题目文本,缩写]
你的答案:B
正确答案:C —— [正确选项文本]
原因:[用 1-2 句解释 C 为什么正确]
复习:第 NN 课 —— [课程名称] (phases/<phase-dir>/NN-<lesson-slug>/docs/zh.md)
第 8 步:下一步做什么?
最后提供三个选择:
- 重做本测验 —— 从同一阶段生成一组新的 8 道题
- 测试另一阶段 —— 选择其他阶段测试
- 解释一个主题 —— 询问任意错题涉及的概念
等待用户选择后再执行。
规则
- 重考时,在题库耗尽前避免重复题目。题库耗尽后,才可为后续重考重排或改写题目。
- 题目必须直接基于课程文档,不能基于通用知识。
- 用户回答之前,不展示正确答案。
- 学习者回答格式示例中不得出现真实答案字母;使用
<A|B|C|D>作为占位符。 - 题目文本保持简洁,最多一两句话。
- 错误选项必须可信,不要设置玩笑答案。
- 若一个阶段尚无课程文档(找不到
en.md文件),告诉用户:第 N 阶段尚未提供课程内容。请选择已完成的阶段进行测验。
Version History
-
fa22e2d
Current 2026-09-03 00:51
同步上游课程、学习路径与 skills,完成多阶段课程及 Agent Skills 的中文翻译与本地化校验。
- b37f9c0 2026-07-05 14:50


