/teach-me — 基于证据的课程生成器
为任何用户想要学习的主题生成自定进度的 Markdown 课程 + 自包含的 HTML 迷你课程。专为成人学习者设计(CEFR B1 阅读水平,无需先验知识),基于认知心理学和教学设计研究。
何时使用
- 用户调用
/teach-me <topic>(或无参数 — 询问主题) - 用户说“教我关于 X”、“我想学习 X”、“深入探讨 X”、“创建关于 X 的课程”、“和我一起学习 X”
- 跳过以下情况:快速事实性问题(“X 是什么” — 直接回答)、代码帮助、调试、文档查找、库 API 问题(改用
context7)
教学法基础(开始工作前阅读)
该技能基于经过充分验证的学习科学。以下规则不是可协商的默认值 — 它们是用户付费所获得的:
- 具体先于抽象(Goldstone, Fyfe 等)。每章在提出任何抽象定义之前,先以一个具体的可观察实例开头。
- 检索练习优于重读(Roediger & Karpicke; Rowland 2014 年元分析)。每章以 3-5 个自由回忆提示 + 1 个跨章节回访结束。
- 通过有意的回访实现间隔接触(Cepeda 等,2006 年)。每个主要概念在后续 ≥2 章中被使用(而非重新定义)。
- 工作示例 + 后向淡出(Sweller, Renkl & Atkinson)。早期章节:完整的工作示例。中期:逐步留空的步骤。后期:仅提示。
- 认知负荷理论(Sweller, Mayer)。每章最多约 4 个新命名概念。一次只增加一个难度维度。
- 分块/卡片(Mayer & Pilegard)。章节是 250-500 字的卡片组,每张卡片一个概念,每张卡片一个图表。
- 图表优先的视觉连贯性(Mayer 多媒体原则)。关系性概念必须使用图表。无装饰性图像。标签内联在图表上,而非单独图例。
- 类比卫生(Gentner 结构映射)。每个类比在 2 个句子内附上明确的“此处在何处失效”声明。
- 术语门(Nathan/Koedinger 专家盲点研究)。每个技术术语在首次使用时定义,或链接到来自早期章节的词条条目。没有例外,即使是“常见”术语。
- 受限的自我解释提示(Chi 等; Bisra 等,2018 年,g≈0.55)。在卡片之间:“完成这个句子:X 之所以有效是因为 ___”,并提供带切换按钮的模型答案。
- 面向 B1 读者的简单语言。平均句子 ≤18 个词,最多 25 个。每个句子 ≤1 个从句。被动语态 ≤10%。主动语态。第二人称。无习语。
- 建立在学习者已知的内容上(Ausubel)。预面试捕获用户已知领域;写作指南将其转化为类比库。
- 展示状态变化,而非叙述它们(Larkin & Simon 1987; Tversky & Morrison 2002 理解原则; Wong/Leahy/Marcus/Sweller 2012 瞬时信息效应; Tufte 小倍数; Mayer 的分块原则)。当行文需要逐步描述连续状态时(“首先发生这个,然后发生那个,碰撞之后……”),使用一个 2-5 面板的
<div class="state-sequence">代替。每个面板具有相同形状,标注差异,标题 = 触发条件 + 不变特征。读者看到演变过程;他们不会读一个故事。
已被反驳 — 切勿使用: 学习风格(VAK)、一万小时定律框架、游戏化连续打卡/徽章、用于“提高参与度”的装饰性图像、“右脑/左脑”、“数字原住民”。
流程
digraph teach_me {
rankdir=TB;
"解析调用" [shape=box];
"已存在文件夹?" [shape=diamond];
"输出位置" [shape=box];
"预面试" [shape=box];
"研究(4 个并行代理)" [shape=box];
"综合并撰写 OUTLINE.md" [shape=box];
"用户选择章节" [shape=box];
"撰写 WRITING_GUIDE.md" [shape=box];
"章节生成(并行批次)" [shape=box];
"一致性检查" [shape=box];
"构建 index.html" [shape=box];
"打开文件夹和浏览器" [shape=doublecircle];
"解析调用" -> "已存在文件夹?";
"已存在文件夹?" -> "输出位置" [label="否"];
"已存在文件夹?" -> "输出位置" [label="扩展 / 重新开始 / 取消"];
"输出位置" -> "预面试";
"预面试" -> "研究(4 个并行代理)";
"研究(4 个并行代理)" -> "综合并撰写 OUTLINE.md";
"综合并撰写 OUTLINE.md" -> "用户选择章节";
"用户选择章节" -> "撰写 WRITING_GUIDE.md";
"撰写 WRITING_GUIDE.md" -> "章节生成(并行批次)";
"章节生成(并行批次)" -> "一致性检查";
"一致性检查" -> "构建 index.html";
"构建 index.html" -> "打开文件夹和浏览器";
}
不要跳过任何阶段。 使用 TaskCreate 跟踪进度,以便用户了解您所处位置。
阶段 0 — 解析调用
- 从参数中获取主题。如果没有参数,回复:“你想学习什么主题?可以是技术性的(库、语言、概念)或非技术性的(哲学、领域、技能)。” 然后等待。
- 主题验证防护:
- 如果主题是有害的(武器合成、恶意黑客攻击目标、非法行为)— 简要拒绝并停止。不进行说教。
- 如果主题过于宽泛(
编程、科学、一切)— 要求用户通过 2-3 个具体示例来缩小范围:“这太宽泛了。是否要缩小到像‘TypeScript 中的异步编程模式’或‘编译器如何工作’这样的范围?” 等待一个更窄的答案。 - 如果主题模糊但可处理(
AI、数据库)— 继续;面试中的自由格式范围问题将进一步缩小。
- 计算 slug:小写,将非字母数字字符替换为
-,折叠重复的-,修剪。示例:Asynchronous Programming→asynchronous-programming。
阶段 1 — 检查已存在的文件夹
- 从记忆中读取输出位置(有关如何存储,请参见阶段 2)。如果记忆中还没有位置,则将此检查推迟到阶段 2 收集位置之后。
- 检查
<output-location>/learn-<slug>/是否已存在。 - 如果存在,通过
AskUserQuestion提供三个选项:- 扩展 — 添加新章节、使用新的样式注释重新生成特定章节、或刷新研究并重新选择。
- 重新开始 — 将现有文件夹重命名为
learn-<slug>-archived-YYYY-MM-DD/并继续新课程。 - 取消 — 停止。
- 如果选择 扩展:子选项 — (a) 添加关于新子主题的章节(跳过研究,使用先前的 OUTLINE.md 作为上下文),(b) 使用新的注释重新生成特定章节编号(跳过这些章节的写作阶段),(c) 刷新研究并重新选择章节(完整重新运行,合并先前的 OUTLINE.md)。
- 切勿破坏性地覆盖先前课程。
阶段 2 — 输出位置
- 在记忆中搜索标记为
teach-me-output-location或类似的条目。使用Glob搜索C:/Users/AlemTuzlak/.claude/projects/F--projects/memory/*.md并使用Grep搜索teach-me。 - 如果找到且路径仍然存在,则使用它。简要说明:“正在写入
<path>。” - 如果未找到,通过
AskUserQuestion询问:- 使用
F:/projects/learning/(如果缺失则创建文件夹)— 推荐。 - 使用当前工作目录(
./)。 - 指定其他路径 — 用户通过“其他”提供。
- 使用
- 在用户回答后,询问:“保存此位置以用于未来的
/teach-me运行吗?” — 通过AskUserQuestion回答是/否。 - 如果是,写入一个记忆文件
teach_me_output_location.md,包含前导数据type: user和正文中的路径。在MEMORY.md中添加一行。 - 现在使用解析后的位置重试阶段 1 的已存在文件夹检查。
阶段 3 — 预面试
分两轮询问:
第一轮 — 单个 AskUserQuestion,包含 4 个结构化问题
Q1 [当前知识]:您对 <topic> 已经了解多少?
- 从未听说过
- 知道术语,无实践经验
- 已经构建过基本的东西
- 中级从业者
Q2 [最终目标熟练程度]:您希望达到什么水平?
- 仅概念性概述
- 能够构建基本的东西
- 能够构建生产级的东西
- 能够教导他人
Q3 [深度预算]:您想要多少内容?
- 快速入门(约 3-5 章)
- 标准(约 6-10 章)
- 深入探索(所有研究内容,10-15+ 章)
Q4 [练习量]:想要多少动手练习?
- 轻量(以阅读为主)
- 标准(阅读 + 检索 + 偶尔练习)
- 繁重(每章都有工作示例和练习)
第二轮 — 单个纯文本消息回复
发送此确切消息(替换 <topic>):
在我开始研究之前,还有两件事:
1. 您已经精通什么? 列出您投入过大量时间的所有语言、框架、领域、爱好 — 例如“TypeScript, React, 音乐理论, 烹饪, 国际象棋”。我会将这些用作类比来源,将新概念锚定在您已知的内容上。
2. 在 内是否有特定角度,还是我应该广泛覆盖?说“让我惊喜”以获得全面覆盖。
等待一个包含两者的单一回复。宽松解析 — 接受逗号分隔列表、项目符号列表或自由格式。
将答案持久化到一个工作结构中(稍后您会将其写入 OUTLINE.md 和 WRITING_GUIDE.md 中)。
阶段 4 — 研究(4 个并行代理)
分派一个批处理 Agent 调用,包含 4 个 general-purpose 子代理。它们并行运行。每个代理获得一个自包含的简要说明,并报告一个结构化的报告。
通道 A — 权威内容。 查找关于 <topic> 的最佳文章、教程、会议演讲和论文。使用 WebSearch + WebFetch 获取信号最强的结果。返回 8-15 个结果,每个附上一行“阅读原因”,标记为 [article|tutorial|talk|paper]。
通道 B — 小众影响者和从业者。 查找在 <topic> 领域知名的特定人物 — 不是技术名人,而是拥有个人博客/新闻通讯/Twitter、在该小众领域深入钻研的从业者。返回 4-8 个结果,包含:姓名、个人渠道(博客 URL)、代表性文章 URL、以及一行说明他们为何值得关注。跳过任何产出仅为公司营销的人。
通道 C — 权威参考。 官方文档、规范、参考实现、权威教科书。如果 <topic> 是一个库/框架/CLI 工具,使用 context7 MCP(resolve-library-id 然后 query-docs)获取当前权威文档。返回 3-8 个来源,包含版本信息。
通道 D — 子主题全景和规范语言。 调研主题以生成一个子主题树,每个子主题附有一行描述(通常 8-15 个子主题)。建议一个教学顺序(先决条件优先,高级内容最后)。如果主题是技术性的,确定官方文档使用/生产中最常见的规范语言(例如 Temporal → TypeScript 或 Go;LangGraph → Python)。明确说明:“规范语言:X,因为 Y。”
每个代理的报告限制在 800 字以内,并结构化。所有 4 个代理返回后,进行综合分析。
阶段 5 — 大纲和章节选择
- 编写
<output-location>/learn-<slug>/OUTLINE.md,结构如下:
# 学习 <Topic>
## 您的目标(已记录)
- **当前水平**:<来自 Q1 的答案>
- **目标熟练程度**:<来自 Q2 的答案>
- **深度**:<来自 Q3 的答案>
- **练习量**:<来自 Q4 的答案>
- **已知领域(类比库)**:<来自第二轮的逗号分隔列表>
- **范围/角度**:<来自第二轮的答案>
## 子主题全景(来自研究)
1. <子主题 1> — <一行描述>
2. <子主题 2> — <一行描述>
...
## 建议顺序
一个尊重先决条件的顺序,并为每一步提供理由。
## 推荐章节(约 N 章,基于您的深度预算)
编号列表形式的建议章节。每个条目:简短标题 + 覆盖内容的一行说明 + 估计的卡片数(每章 5-9 张)。
## 规范语言(仅限技术主题)
<语言和一行理由>
## 推荐来源
- [来源 1](url) — [类型] — 阅读原因
...
## 值得关注的小众影响者
- **姓名** — [博客 url] — 代表性文章:[文章 url] — 一行说明为何值得关注
...
- 自动打开文件:
Bash code --new-window "<absolute-path-to-OUTLINE.md>"。 - 回复用户,使用此确切消息(适当替换):
我已将大纲写入
<绝对路径>并为您打开。回复要编写的章节:
all— 编写所有推荐的章节1,3,5-7— 特定章节或范围- 自由格式 — 用您自己的语言描述要关注的内容
reshape— 在提交前告诉我添加、删除、合并或重新排序的内容如果您选择
reshape,我将采纳您的注释,修改 OUTLINE.md,保存,重新打开,并再次询问。循环直到确认。
- 如果用户说
reshape,采纳他们的注释,修改 OUTLINE.md,保存,重新打开,再次询问。循环直到确认。 - 将选择解析为最终的排序章节列表
picks = [...]。
阶段 6 — 编写 WRITING_GUIDE.md
编写 <output-location>/learn-<slug>/WRITING_GUIDE.md。此文件是所有章节编写代理和一致性检查代理的共享简要说明。它必须全面且具体。
使用 <skill-dir>/assets/templates/WRITING_GUIDE.template.md 处的模板作为起点 — 将用户记录的面试答案替换到占位符中({{TOPIC}}、{{CURRENT_LEVEL}}、{{TARGET_PROFICIENCY}}、{{PRACTICE_LOAD}}、{{KNOWN_DOMAINS}}、{{SCOPE}}、{{CANONICAL_LANGUAGE}})。
同时指向章节编写者在 <skill-dir>/assets/COMPONENTS.md 处的组件库参考 — 他们应在编写前浏览。提示卡片、图表卡片、比较块、选项卡、统计卡片、平台标签和步骤列表都可用;有些是从 Markdown 约定自动生成的,其余的是 Markdown 内部的显式 HTML。
验证生成的文件强制实施了此 SKILL.md 顶部“教学法基础”部分中列出的所有 12 条教学法规则。如果指南中缺少任何规则,请在继续之前添加。
阶段 7 — 章节生成(并行批次)
以 每轮 3-5 个编写子代理的并行批次 生成选定的章节,跨顺序轮次进行。
每轮:
- ...