teach
在此工作区内向用户教授一项新技能或概念。
- License 许可
- MIT
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- teach
- description
- 在此工作区内向用户教授一项新技能或概念。
- argument-hint
- What would you like to learn about?
- commit_version
- ad5400b930b297b0c0cb231ff1ffe42a7da666aa
- disable-model-invocation
- true
02 资源文件 5
- 参考文档agents/openai.yaml147 B
- 参考文档GLOSSARY-FORMAT.md2.1 KB
- 参考文档LEARNING-RECORD-FORMAT.md2.7 KB
- 参考文档MISSION-FORMAT.md1.6 KB
- 参考文档RESOURCES-FORMAT.md2.0 KB
03 SKILL.md 正文
用户请你教他们一些东西。这是一个有状态的请求——他们打算通过多个会话来学习这个主题。
教学工作区
把当前目录视为一个教学工作区。工作区路径(./lessons/ 及其他)都从 /teach 运行时所在的目录解析;只有 *-FORMAT.md 链接从本技能的文件夹解析。他们的学习状态记录在此目录中的多个文件里:
MISSION.md:一份记录用户对这个主题感兴趣之原因的文档。所有教学都应以此为依据。使用 MISSION-FORMAT.md 中的格式。./reference/*.html:参考资料目录。这些是从课程中提炼出来的压缩学习成果——速查表、参考算法、语法、瑜伽体式、术语表。它们是学习的原始单元。它们应当是打印效果良好、为快速查阅而设计的精美文档。RESOURCES.md:一份资源列表,可以用来为你的教学提供背景知识依据,或获取知识与智慧。使用 RESOURCES-FORMAT.md 中的格式。./learning-records/*.md:学习记录目录,记录用户学到了什么。它们大致相当于软件开发中的架构决策记录(ADR)——记录那些不易察觉的教训和关键洞察,这些内容日后可能需要修订,或用于推动未来的课程。它们应用于计算最近发展区。文件命名为0001-<dash-case-name>.md,编号逐次递增。使用 LEARNING-RECORD-FORMAT.md 中的格式。./lessons/*.html:课程目录。**课程(lesson)**是一份独立自足的 HTML 输出,只教一个与任务紧密相关、范围收窄的内容。它是此工作区中的基本教学单元。./assets/*:跨课程共享的可复用组件。参见资产。NOTES.md:供你记录用户偏好或工作笔记的草稿本。
理念
要做到深度学习,用户需要三样东西:
- 知识(Knowledge),从高质量、高可信度的资源中获取
- 技能(Skills),通过你基于这些知识设计的高度相关的互动课程来习得
- 智慧(Wisdom),来自与其他学习者及实践者的交流
在 RESOURCES.md 充实起来之前,你的重点应是寻找能帮助用户获取知识的高质量资源。绝不要轻信你的参数化知识。
有些主题可能更侧重技能而非知识。深入学习理论物理可能更偏重知识,而瑜伽则更偏重技能。
流畅度与存储强度
你应当注意区分两种类型的学习:
- 流畅强度(Fluency strength):当下的知识提取能力
- 存储强度(Storage strength):知识的长期保持能力
流畅度会给用户一种虚幻的掌握感,但存储强度才是真正的目标。试着通过“合意困难”来设计建立长期保持能力的课程:
- 使用提取练习(从记忆中回忆)
- 间隔练习(把练习分散到不同时间)
- 交错练习(在练习中混合不同但相关的主题——仅适用于技能练习)
课程
课程是你的主要产出:知识和技能正是通过这一单元传递给用户。每节课是一个独立的 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
用户有时会表达他们希望被如何教授,或有哪些事项需要你记住。这里就是记录这些偏好的地方,以便你在设计课程或与用户协作时回头查阅。
04 同仓库更多 Skills
skills-link
管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
writing-shape
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
writing-fragments
写作之 explore:开采原始碎片,还没有结构。
writing-for-agents
为 agents 编写文档。在创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
writing-beats
写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
wizard
生成一个交互式 bash 向导,引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘,或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。