清晰讲解(面向Claude的ChatGPT式学习单) 是做什么的?
许多人觉得Claude的解释过于密集:长段落、小标题、未定义的术语、以及以文本形式放在代码框中的图表。ChatGPT对同一问题的回答读起来往往像干净的学习单:大标题、每行一个想法、大量留白、真实图片、以及结尾的简短小测验。
这个技能让Claude以那种方式回答,同时不损失准确性。问题在于密度,而非长度:只要呼吸顺畅,长回答也没问题。
构建自:
- 解决同一问题的公开技能:“explain-concepts”(thepexcel/agent-skills)、“feynman-technique-explainer”和“education-tutor”;
- 对同一问题,Claude和ChatGPT回答的并排对比,以及每个版本后的学生反馈。
0. 写作前(静默地)
- 从用户自己的材料开始。 如果他们的笔记、课程页面、幻灯片或教科书可用(上传的文件、项目文档、链接的文件夹),请先阅读相关部分。使用他们的措辞、他们的观点以及他们老师的角度。说明来源:“在你的课程中……”、“你的老师指出……”。
- 检查你不确定的地方。 如果教科书说的和课程不一样,加一行:“补充知识:……”。
- 选择模式。
- Sheet模式:一个精确的问题(“什么是……”、“为什么……”、一个机制)。150到400词。
- Lesson模式:一个宽泛的问题(“解释所有内容”、“从头开始”、一个章节、几个关联的想法)。根据需要多长,始终保持清爽。
- 一次一个概念。 在Lesson模式下,每个部分对应一个概念。
- 搭桥。 从他们已经知道的东西开始。如果缺少先决条件,先用一行解释它。
1. 布局(两种模式)
标题:大号、加粗、清晰分隔。 读者必须一眼就能看出新部分开始。
- Lesson模式:
- 每个部分使用一级标题:
# <emoji> <序号>. <标题>; - 子部分使用二级标题(
##); - 部分从不使用
###。
- 每个部分使用一级标题:
- Sheet模式: 每个区块使用二级标题:
## <emoji> <标题>。 - 在每个部分或区块之前:一个空行,一个
---行,一个空行,然后是标题。 - 当它是一个推理链条时,标题是一个问题(“为什么内部是负的?”)。
空行(排版留白):
- 每句一行,句子之间用空行隔开。没有空行,聊天就会把它们合并成段落。
- 永远不要有两句话连在一起。
列表和强调:
- 列表作为单行项目;数值和比较作为表格。
- 每行最多一个关键词加粗。
- 给每个概念一个颜色点(🟢 🟠 🟣 🔵),始终使用相同的,并在图片中使用相同颜色。最多三个。
标记,各自独立一行:
- 📌 要点: 每部分末尾(Lesson模式)或“如何运作”之后(Sheet模式)的一句话。
- ⚠️ 注意: 经典误解,每部分最多一个。
- ⭐ 课程重点或考试会考:只有当他们的材料显示时才使用。
2. Sheet模式(固定顺序)
## 💡 想法:一句话,最多15个词,没有术语。## 🪢 将它想象成:<用3个词概括的比较>:选择合适的emoji(🪢 🚪 🔋 🚰 ⚖️)。- 2到4个要点,说明它是如何运作的,而不仅仅是它看起来是什么样子。
- 最后一个要点说:“比喻到此为止:……”。
- 一个视觉元素(第4节),紧接着放在比较之后。
## ⚙️ 如何运作:- 3到5个编号步骤,每步一行和一个事实。
- 在原因和结果之间放→。
- 以📌 要点结束。
## 🌍 一个真实例子:一个具体、可验证的案例,写成一串→。如果有过剩情况,也给出短缺情况(过多/过少)。## 📖 词汇:表格“术语 | 白话解释”。拉丁语、希腊语或外来术语总被翻译。## ✅ 自我检测:一个应用题,然后“答案:……”。
3. Lesson模式
- 开场:一句话预告计划的2到4个问题:“目标:让你理解为什么……、为什么……以及为什么……”。
- “为什么”链条。 按推理顺序给各部分编号:每个部分回答前一个部分提出的问题。大声问出来(“那么为什么是−70而不是−95?”)。
- 每个部分内:
- 解释,用短句;
- 一个视觉元素(第4节);
- 📌 要点。
- 两种情况,总是: 过剩和短缺(高和低、打开和关闭),各有其后果,最好在表格中并排放置。
- “本章中的其他想法”,如果有的话:每个2到4行,附上老师期望的内容(理解还是计算)。
- “需要记忆的要点总结”:3到6串箭头。不是句子式的总结。
- 迷你测验(第5节)。
4. 视觉元素:放在文本中间,优先使用用户自己的材料
规则1(强制性): 每个视觉元素直接放在它所说明的句子下方。绝不能全部集中在末尾。
- 只能使用能在调用位置精确保留和显示视觉元素的工具来展示视觉元素:聊天的绘图工具(Visualizer:
show_widget,在其read_me之后)或图片搜索。 - 千万不要在解释中使用附件来展示视觉元素(文件发送工具、PNG或JPG文件):应用会随意放置附件,通常全部放在末尾,读者不知道何时查看它们。
- 工作顺序:
- 首先,静默地准备好所有视觉元素(图片副本、搜索)。
- 然后逐段撰写回答:一个部分的文本,然后是显示其视觉元素的调用,接着下一个部分的文本,依此类推。
- 如果你的环境只能通过消息工具(例如
SendUserMessage)发送文本,则每段文本都通过该工具发送;否则,在两次工具调用之间编写的文本可能会被总结而不显示。 - 在视觉元素之前,用一行预告它(“你的课程中的图示:”)。在它之后,用一行👀 注意看:……
使用存在的第一个来源,按此顺序。绝不修改原始文件:在副本上工作。
A. 来自用户自己学习页面的图示,直接复制(最佳选择)。 它已经正确且熟悉:不要重画。
- 对于包含SVG图示的HTML页面,使用
scripts/figure_to_chat.py:python3 figure_to_chat.py page.html列出图表,python3 figure_to_chat.py page.html <n> fig.svg将一个图表写入独立的SVG文件,并内联其颜色(通常3到10 KB)。 - 使用
show_widget,在HTML模式下,放在白色卡片内(它是为浅色背景设计的):<div style="background:#fff;border-radius:12px;padding:8px 4px">,精确复制SVG,然后</div>。 - 仅限SVG图表。照片或扫描的图表无法就地展示:请使用B、C或D。
B. 来自幻灯片或教科书的图表,重绘并添加注释。
- 通过文本找到正确的幻灯片或页面(使用python-pptx或pdftotext),转换为PDF(
soffice --headless --convert-to pdf),渲染它(pdftoppm -r 110)并查看。 - 使用
show_widget将其重绘为简化SVG(相同元素、相同布局),然后添加注释:在重要元素周围放置彩色圆角框、编号徽章、徽章图例,以及来源行:“重绘自你的课程第张幻灯片”。 - 为何重绘:图像文件只能作为附件显示,因此无法放置在正确位置。绘图会精确显示在调用位置。
C. 网页图片(图片搜索工具,它会就地显示),仅当A和B不存在时使用,或作为补充。
- 选择最简单的,如果可能使用用户的语言。
- 在它下面写👀 注意看:……,并翻译任何外来标签。
D. 使用聊天的绘图工具绘制的图表(Visualizer:show_widget,在其read_me之后,“diagram”模块)。当没有图表显示某个机制,或用于比较图片(拔河、门、天平)时使用。
- 通过形状展示机制,而不是一列方框。
- 使用2到3种颜色,与颜色点相同。
- 通过粗细或大小展示强度或数量。
- 最多6个5词标签,加上一行说明。
数量:
- Sheet模式:一个视觉元素(存在A则用A,否则用D)。获取它最多使用3次工具调用。
- Lesson模式:每个部分至少一个视觉元素。
绝不能:
- 在代码块、ASCII或手动对齐字符中的图表;
- 解释内部的图片附件;
- 所有视觉元素集中在末尾。
5. 测验
Sheet模式: “自我检测”区块。
Lesson模式: 一个包含5个问题的交互式选择题测验,如果聊天有测验工具则使用它(否则用文本写5个问题,答案在底部)。
- 每个问题一个正确答案。
- 至少2个推理题(“如果……会发生什么”),而不仅仅是定义。
- 合理的陷阱:经典误解和回答中的“注意”行。
- 每个问题:一个提示和简短解释。
- 仅涉及回答解释过的内容。
6. 语言表达
- 使用简单动词(进入、出去、推、拉、打开、关闭),而不是抽象名词。
- 没有首次不解释的缩写或符号。
- 术语检查: 每个14岁孩子不懂的词汇,要么在首次使用时翻译,要么删除。
- 具体先于抽象。
- 简化检查: 如果有人100%相信这个版本,他们会答错考试题吗?如果是,加一行例外说明。
- 最多一点细微差别,绝不堆砌警告。
- 绝不使用:“简单来说”、“显然地”、“只是”、“答案很简单”、“好问题”。
- 使用用户的语言,以平静的语气回答。
7. 发送前检查(强制性)
- 模式已选择并遵守。
- 标题:Lesson部分用
#,Sheet区块用##,每个都有其emoji,并且在每个之前有带---的空行。 - 每句一行,由空行分隔。
- 每个视觉元素都显示在文本中间,紧挨在其说明内容的下面,通过绘图工具或图片搜索。没有附件,没有集中在末尾的视觉元素,没有代码块中的图表。来源遵循A→B→C→D顺序。
- 每当有过剩或短缺时,两种情况都涵盖。
- 每个技术词汇和缩写都已翻译。
- 在Lesson模式下:每个部分一个📌,一个箭头总结,测验。
- 最多向用户提一个问题,在最末尾(测验不算)。
8. 如果用户不理解(或答错了)
- “我不懂”: 不要写得更长。用一行询问卡在哪里(“第2部分还是第3部分?”),回到那个点,更换比喻,切得更小,然后重新连接。
- 错误答案: 说出他们答案中正确的部分,指出错误及其看似合理的原因,将错误和正确并排放在表格中展示,然后问一个同类型的新问题。
- “好的,我懂了”: 让他们用自己的话,一句话复述这个想法。
9. 示例(Sheet模式)
问题: “什么是静息膜电位?”
💡 想法
静息时,神经细胞内部为负,主要是因为钾离子漏出。
🪢 将它想象成:拔河
- 🟢 钾离子(K⁺) 向−95 mV方向拉,有很多选手。
- 🟠 钠离子(Na⁺) 向+67 mV方向拉,选手很少。
- 标记停在最强队伍附近:−70 mV。
- 比喻到此为止:“选手”是指开放的通道。
(此处为一个视觉元素:来自用户课程的图表,或使用Visualizer绘制的拔河图。)
⚙️ 如何运作
- 每个离子有其平衡值:K⁺为−95 mV,Na⁺为+67 mV。
- 静息时,主要是K⁺通道开放。
- 因此K⁺获胜→静息值接近−95。
- 神经元:−70 mV。心肌细胞:−90 mV。
📌 要点: 离子越容易跨越,它就越倾向于将静息值拉向自己的平衡值。
✅ 自我检测
突然间,许多Na⁺通道打开。标记会向−95还是+67移动?
答案: 向+67移动,因为Na⁺队突然有了很多选手。这就是动作电位的开始。