这门课怎么教
这门课从第 6 课起按一套核过来源的教法写：先撞问题再给词，一课只带走三块，图不超过五个节点，每个词走完类比、图、例子、白话、术语五步，读完能下一条命令。
- 三个组块
- ADEPT
- 先问题后概念
怎么读：你不用学这一页，它是给我自己的尺子。想知道为什么某课这样排，或想批评某课，来这里对表。
你 9 月 11 日晚说：只把东西写上来谁都会，要展现逻辑、要图、要关联、要和旧做法对比、要关键词、要重点，不然读起来累。我派 Grok 去核了十二个公认最会解释复杂东西的人的真实手法，和八条有出处的学习科学结论，压成一套模板。这一页是那套模板，末尾是这门课自己对照的差距。
来源均由 Grok 于 2026-09-11 打开一手页核实，标“未核”的没写进结论。
十二个解释者，各一招
Section titled “十二个解释者，各一招”最会讲复杂东西的人，到底在做什么？
Bartosz Ciechanowski一次只拆一个子系统；术语和颜色绑定；明说“不必背名字”；动图静读也能懂。一课只拆 AIOS 的一层；关键词固定色。代表作《机械表》2022
Julia Evans一页一个出人意料的真事实；列表只收最常用的几条，不是全表。每课三张事实卡，不要二十个并列概念。wizardzines
3Blue1Brown先给直觉再给符号；一集一个本质动作。先画“请求怎么走”，再给术语。线性代数的本质，2016
Kalid AzadADEPT：类比、图、例子、白话、术语，先糊后清晰，术语放最后。每个核心词五步走完，缺一不可。BetterExplained
Bret Victor正文必须能静读；探索是加深不是门槛；在具体与抽象之间上得去下得来。默认静态，点一下只下钻一层。Explorable Explanations，2011
Simon Brown（C4）架构图四级缩放；多数团队前两级就够；每张图有标题、图例、带动词的有向关系。给你只画谁用系统、七台机上跑什么进程两级。c4model.com
Simon Wardley先画地形再谈战略：用户需求在上，横轴是从独特到商品的演化。开源页必须标：偏自研还是偏现成，该造还是该用。Wardley Maps
Martin Kleppmann比较多种设计与取舍，不教某个工具的配置；每章一张地图式目录。每个概念：问题、至少两种做法、我们选哪个付什么代价。《数据密集型应用系统设计》
Jeff Dean“每个人都该知道的数字”加信封背面算账：两种设计各花多少。给你五个数量级：本机、局域网、跨机、跨人确认、跨日批次，用来否决蠢命令。LADIS 2009 讲稿
Andrej Karpathy从零把一个能跑的东西逐步拼出来，每步只加一个机制。不空讲运行时，跟一条真实请求走：入口、席位、工具、写回。Zero to Hero
fast.ai先给完整能用的系统，再一层层剥开；始终用例子。第 1 课先让你看见下一条命令会碰到哪四个部件。course.fast.ai
Stripe 与 Cloudflare 博客先讲具体事故或旧系统的失败，再讲设计选择，用一个数收口。开源页禁止变成仓库清单：旧约束、新选择、一个数、抄哪一层。API 版本化 2017；Pingora 2022
他们没有一个人从定义开始；都从一个具体的东西开始，术语最后才出现。
八条学习科学硬结论，各配一个动作
Section titled “八条学习科学硬结论，各配一个动作”哪些做法有实验证据，不是老师的偏好？
| 结论 | 出处 | 课上动作 |
|---|---|---|
| 注意焦点约 3 到 5 项，不是 7 | Cowan 2001、2010 | 一屏、一张图、一节课同时亮着的新块不超过 4 |
| 词加相关图优于只靠词；装饰图无效；图文要靠近 | Mayer 多媒体原则 | 每个关键词配一张图，说明紧贴图 |
| 测验优于重读；间隔拉大记得更久 | Roediger 与 Karpicke 2006；Cepeda 2006 | 每课末三道回忆题；下一课开头揭答案；同一张词卡跨课重复 |
| 新手看逐步解完的例子优于自己盲解；图文分离会毁掉样例 | Sweller 1988；Ward 与 Sweller 1990 | 给一条坏命令和一条好命令，逐步标错在哪一层 |
| 先具体后抽象 | Victor 的抽象之梯 | 先写“你对某台机上的席位说了这句话”，再抽象成“调度” |
| 渐进披露：先给最常用的少数；超过两层人会迷路 | Nielsen 2006 | 正文只留决策需要的；细节用展开，不超过两层 |
| 对事实问“为什么成立”比再读一遍记得牢 | Pressley 1988 | 每个新词跟一句“去掉它会坏哪件事” |
| 先撞问题再讲规范解，迁移更好；但要给样例，不是丢去自学 | Kapur 2008、2014 | 课头九十秒只放一个失败场景，再出现概念名 |
测验、图文相邻、先问题后概念，这三条有实验，不是风格。
一课模板：二十分钟手机阅读
Section titled “一课模板：二十分钟手机阅读”正文 1800 到 2500 汉字，再长必累。一课只让你带走三个组块。
- 本课命令，30 秒一句：读完你可以下的那条命令。
- 先撞的问题，2 分钟一个具体失败，还没有术语。
- 新旧对照，2 分钟三列：旧做法、新做法、你现在改下什么令。
- 架构图，3 分钟不超过五个节点；有图例；线上有动词。
- 一个核心词走 ADEPT，4 分钟类比、图、例子、白话、术语。
- 工作样例，3 分钟坏命令到好命令，逐步标错层。
- 开源，可空，2 分钟没有下面那三样就删整节。
- 关键词卡，2 分钟本课最多三张，七个字段。
- 检索，2 分钟三问，当页不给答案，下一课揭。
- 只要记住，30 秒重复那三个组块。
跨课：第 n 课开头用 60 秒复述第 n 减 1 课的三问。
手机上的图，五条硬规矩
Section titled “手机上的图，五条硬规矩”- 节点一屏不超过五个超过就拆成总图加下钻。可见层级两层，第三层点击后才出现。
- 竖向为主，用户或目标在上禁止必须横滑才能读懂。线单向，标动词：调用、写入、调度，不写“使用”。
- 语义色不超过三种信息不只靠颜色，必须有图例。本课程：前几课的词、本课的词或已有、还没有。
- 标签不小于 16 像素缩到手机宽度后仍要达标。图的画布宽度不超过手机屏，节点少而大。
- 默认可静读点击等于下钻一级，不是拖拽宇宙图。跨课总图每课只高亮三四个节点，其余变灰。
关键词卡的七个字段
Section titled “关键词卡的七个字段”少一个就不是卡：词；一句白话；替代了什么旧做法；在我们这是什么；课次；你可以下的命令；边界，它不是什么。
调度（示例）把任务派到空闲席位，避免两人做同一件。“群里谁空谁接”。七台 Mac 上的席位编排，不是模型本身。第 3 课 · 命令：“同一任务只许一个席位认领，冲突写进日志” · 不是：“让模型更聪明”
- 百科堆砌：正确但无主线，一课超过四个新块。
- GitHub 墙：项目名加星数加一句简介。
- 先定义后问题：开头就是术语。
- 一张图超过七个节点，或必须捏放才能看清。
- 图文分裂：图在上，说明在两屏外。
- 全课同一缩放：上下文和实现细节平铺。
- 没有新旧对照、没有检索：读完像又看了一遍 wiki。
开源消化页必须多出的三样
Section titled “开源消化页必须多出的三样”列表谁都会写。一页若要留，三样都要有，缺一样就删：
- 演化位置偏独特自研还是偏现成商品；我们该造、该买、还是该忽略。
- 对照我们的现状抄哪一层（协议、调度模型、界面），明确不抄哪一层。
- 一个数加一条令例如“复用连接省掉一次握手”；读完要么下命令，要么写拒绝理由。
这门课对照自己
Section titled “这门课对照自己”按这把尺子，现在的课差在哪？
第 1 到 5 课：先定义后问题，一课十几个新块，没有图，没有检索。第 6 课起按模板写；第 1 到 5 课先补 30 秒版止血，第 7 课后逐课重写。反模式 1、3、7 全中。
第 6 课初版：正文约四千字，关键词卡十张，关联图七个节点。已改：正文压到两千五以内，词卡三张七字段，图不超过五个节点，偏航指标移到第 7 课。三个组块的上限、Cowan 的 3 到 5。
开源板块二十页：八项模板加“先记三样”，仍是按项目罗列。每页顶部改成三样：演化位置、抄与不抄、一个数一条令。Wardley 加 Kleppmann 加 Dean 那三条。
检索题当页给答案。三问先不给答案，下一课开头揭；忍不住可以点开。Roediger：测验优于重读，答案太近等于重读。
尺子在这，课改到哪一步也写在这；你觉得哪课还累，按这七条反模式指出来。
全部由 Grok Build 于 2026-09-11 打开一手页核实；原始核证稿存集团记录。未核：Paivio 1971 原书全文、Bruner 1966 页码、iOS 人机界面指南的精确磅值。
- Ciechanowski，Mechanical Watch。ciechanow.ski · Julia Evans，How I write useful programming comics。jvns.ca
- 3Blue1Brown，Essence of linear algebra。3blue1brown.com · Kalid Azad，ADEPT。betterexplained.com
- Bret Victor，Explorable Explanations 与 Ladder of Abstraction。worrydream.com
- Simon Brown，C4 model。c4model.com · Simon Wardley，On being lost。medium.com
- Kleppmann，DDIA。dataintensive.net · Jeff Dean，LADIS 2009。cornell.edu
- Karpathy，Zero to Hero。karpathy.ai · fast.ai。course.fast.ai
- Stripe，APIs as infrastructure，2017。stripe.com · Cloudflare，How we built Pingora，2022。blog.cloudflare.com
- Cowan 2001、2010；Mayer 多媒体原则；Roediger 与 Karpicke 检索练习综述；Cepeda 2006 间隔效应；Sweller 1988 认知负荷；Pressley 1988 精细化提问；Nielsen 2006 渐进披露；Kapur 2008、2014 生产性失败。链接见集团记录中的核证稿。