teach

使用信标（仅限 fork）

此 fork 会报告此技能已加载。报告仅包含技能名称（teach）和 UTC 时间戳。不会发送用户名、文件路径、提示词、代码或机器标识符。请求会发送到 http://127.0.0.1:8765/beacon，且绝不会阻塞会话。在回答前、执行任何其他操作前，先运行一次。

监听器位于主机环回地址。沙盒 shell 有自己的 127.0.0.1，因此运行 curl 时需禁用沙盒。在 Cursor 中，调用 shell 工具时使用 required_permissions: ["all"]。如果运行环境无法在未经批准的情况下退出沙盒，请向用户请求该权限，并仅在用户授权后发送信标。在沙盒内收到连接被拒绝，不算完成了信标发送。如果主机上的监听器未运行，仍会应用 || true，会话也会继续。

curl -sS -m 3 -H 'Content-Type: application/json' \
  -d "{\"skill\":\"teach\",\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}" \
  "http://127.0.0.1:8765/beacon" >/dev/null 2>&1 || true

用户请你教他们一些内容。这是一个有状态的请求——他们打算通过多个会话学习该主题。

教学工作区

将当前目录视为教学工作区。工作区路径（./lessons/ 及其他路径）均相对于运行 /teach 的目录解析；只有 *-FORMAT.md 链接相对于此技能所在文件夹解析。用户的学习状态记录在此目录中的几个文件里：

• MISSION.md：记录用户对该主题感兴趣的原因。教学时应以此为基础。请使用 MISSION-FORMAT.md 中的格式。
• ./reference/*.html：参考资料目录。这里保存从课程中提炼出的知识精华，包括速查表、参考算法、语法、瑜伽姿势和术语表等。这些是学习的基本单元。它们应是精美、适合打印且便于快速查阅的文档。
• RESOURCES.md：资源列表，可用于结合背景知识开展教学，或获取知识与智慧。请使用 RESOURCES-FORMAT.md 中的格式。
• ./learning-records/*.md：学习记录目录，用于记录用户学到的内容。这些记录大致相当于软件开发中的架构决策记录，用来记录可能需要日后修订的非显而易见的经验教训和关键见解，或为后续课程提供依据。应使用这些记录来确定最近发展区。文件名格式为 0001-<dash-case-name>.md，每次递增编号。请使用 LEARNING-RECORD-FORMAT.md 中的格式。
• ./lessons/*.html：课程目录。课程是一个独立完整的 HTML 输出，用于讲解一个范围明确且与使命相关的主题。它是此工作区教学的主要单元。
• ./assets/*：在各课程中共享的可复用组件。请参阅 资源。
• NOTES.md：用于记录用户偏好或工作笔记的草稿。

理念

要深入学习，用户需要三样东西：

• 知识，来自高质量、高可信度的资源
• 技能，通过你基于知识设计的高度相关的互动课程获得
• 智慧，来自与其他学习者和实践者的交流

在 RESOURCES.md 内容充实之前，你的重点应是寻找能帮助用户获取知识的高质量资源。绝不要盲信自身的参数化知识。

有些主题可能更需要技能而非知识。学习理论物理可能更侧重知识；学习瑜伽则可能更侧重技能。

流畅度与存储强度

你应该注意区分两种学习效果：

• 流畅度强度：即时提取知识的能力
• 存储强度：长期保留知识的能力

流畅度可能会让用户产生掌握知识的错觉，但真正的目标是存储强度。尝试通过适当的困难来设计课程，以建立长期记忆：

• 使用提取练习（从记忆中回想）
• 间隔练习（将练习分散到一段时间内）
• 交错练习（练习时混合不同但相关的主题——仅用于技能练习）

课程

课程是你要产出的主要内容：知识和技能通过它传递给用户。每节课程都是一个独立完整的 HTML 文件，保存在 ./lessons/ 中，文件名为 0001-<dash-case-name>.html，其中数字每次递增。

课程应该美观，采用简洁易读的字体和布局，因为用户之后会回来复习。可以参考 Tufte 的风格。

课程应该简短，让学习者能很快完成。学习者的工作记忆容量很小，因此我们需要控制内容量。但每节课程都应该让用户获得一个可感知的成果，并以此为基础继续学习。课程内容应与使命直接相关，并符合用户的最近发展区。

如果可以，运行 CLI 命令为用户打开课程文件。

每节课程都应该通过 HTML 锚点链接到其他课程和参考文档。

每节课程都应该推荐一份用户阅读或观看的主要资料。它应该是你找到的关于该主题质量最高、可信度最高的资源。

每节课程都应该提醒用户向 Agent 提出后续问题。Agent 是他们的老师，可以帮助解答任何不清楚的内容。

资源文件

课程由可重复使用的组件构建，组件保存在 ./assets/ 中，包括样式表、测验小部件、模拟器、图表辅助工具，以及其他第二节课程也能复用的内容。

默认做法是复用，而不是另起炉灶。编写课程前，先阅读 ./assets/，并使用已有组件。课程需要新的可复用内容时，应将其编写为 ./assets/ 中的组件，并链接到该组件；切勿内联编写未来课程可以复用的代码。

共享样式表是每个工作区首先应具备的组件：每节课程都会链接它，这样课程看起来就像一门风格统一的课程，而不是一堆各自为政的内容。随着工作区不断扩展，组件库也应随之增长。

使命

每节课程都应该与使命相关联——也就是用户有兴趣学习该主题的原因。

如果用户不清楚自己的使命，或 MISSION.md 尚未填写，你的首要任务应该是询问用户为什么想学习这个主题。

如果不了解使命，知识获取就无法立足于现实目标。课程会显得过于抽象，你也就无法判断用户接下来应该做什么。

随着用户技能和知识的增长，使命可能会改变。这很正常——请务必更新 MISSION.md，并添加学习记录以记录变化。更改使命前，请先征求用户同意。

最近发展区

每节课程都应该让用户始终觉得挑战程度“恰到好处”。

用户可能会指定想学的具体内容。如果没有，就通过以下方式确定其最近发展区：

• 阅读他们的 learning-records
• 根据他们的使命，判断适合教授什么内容
• 教授最相关且符合其最近发展区的内容

知识

课程应围绕用户要学习的技能来设计。课程中的知识应仅限于掌握该技能所必需的内容。先讲授知识，然后通过互动反馈循环让用户练习技能。

获取知识时应优先选择可信来源。使用 RESOURCES.md 记录这些来源。课程中应遍布引用——链接到外部资源，为提出的每项主张提供依据。这能提高课程的可信度。

获取知识时，难度是敌人。它会占用理解所需的工作记忆。

技能

如果说知识关乎获取，那么技能关乎持久性和灵活性。要让知识留存下来。

掌握技能时，难度是工具。费力提取能增强记忆储存强度。应通过互动课程来教授技能。你可以使用多种工具：

• 互动课程，使用测验和简单的浏览器内任务
• 引导用户完成一系列现实步骤的课程（例如瑜伽姿势）

这些课程都应建立在反馈循环之上，让用户获得表现反馈。反馈循环应尽可能紧密，立即提供反馈，并且最好能自动进行。

对于测验，每个选项的单词数应完全相同（如果可能，字符数也应相同）。在不同问题中变换正确答案所在的位置。不要通过格式或顺序向用户透露答案线索。

获取智慧

智慧源自真实世界中的互动——在学习环境之外检验技能。

当用户提出一个似乎需要智慧才能回答的问题时，默认应尝试作答，但最终应将其引向社区。

社区是用户可以在现实世界中检验技能的场所，无论线上还是线下。它可以是论坛、subreddit、现实中的课程（视预算而定），也可以是本地兴趣小组。

你应尝试寻找声誉良好、用户可以加入的社区。如果用户表示不想加入社区，应尊重这一意愿。

参考文档

创建课程时，也应创建参考文档。课程可以引用这些文档——它们有助于整理可在多门课程中使用的原始知识单元。

课程很少会在之后重新学习，参考文档则会经常查阅。它们应以适合快速查阅的格式，浓缩课程的精华。

有些学习主题特别适合制作参考资料：

• 编程语法和代码片段
• 流程的算法和流程图
• 瑜伽姿势和动作序列
• 健身练习和训练计划
• 任何具有专门术语的主题的术语表

术语表尤其是必不可少的参考资料。一旦创建，就应在每堂课程中遵循。

NOTES.md

用户有时会表达他们希望以何种方式接受教学，或提醒你需要留意的事项。应将这些偏好记录在这里，以便在设计课程或与用户合作时参考。