@ydarias: I've used this skill from @mattpocockuk and I may say I am pretty impressed with the good results. AI for more than cod…

I’ve used this skill from @mattpocockuk and I may say I am pretty impressed with the good results. AI for more than coding :-D

https://t.co/liSrYEvY0r

TL;DR: Ydarias 分享了他开源的 Teach 技能——一个有状态的 AI 教学技能，会创建使命、资源、课程、词汇表和速查表，并利用“最近发展区”原理持续跟踪学习进度。

从声乐教练到 AI 教学技能

前几天我意识到，我教东西已经教了 10 年了：我做了 6 年的声乐教练，然后做现在这份教开发者的工作也已经 4 年了。有一段时间我一直在想，如果我能把我所知道的关于教学的一切都放进一个技能（skill）里，让任何人都能学习任何东西，那该有多好。

前几天我坐长途巴士去伦敦，在路上写了一个 Teach 技能，结果发现它相当不错。它教会了我如何还原魔方，这是我一直想学但从来没时间也没动力去学的东西。但有了这个 Teach 技能，感觉就像有一个真正的老师，用我喜欢的方式教我，而且和我的目标完全一致。接下来我要向你展示我是怎么做到的。

有状态 vs 无状态技能

当我们讨论 Teach 技能时，关键概念在于：有些技能可以是有状态的（stateful），有些可以是无状态的（stateless）。

• 无状态技能：不会保留之前运行时的任何状态，对你之前做过的事情没有任何记忆。换句话说，无状态技能不会在文件系统上保存任何东西来帮助它之后从上次中断的地方继续。
• 有状态技能：会把东西保存到本地文件系统，或者保存到 MCP 服务器上，会保留笔记，以便之后追踪。

最初，我把 Teach 设想为一种无状态技能——你只需要说“教我这个”，然后它就会为你找到一些好的资源，并给你一个教授该内容的输出。但我意识到，我所做的所有好的教学都是有状态的：作为老师，我记得你学到了哪里，我知道你学了什么，我知道你接下来可以学什么，而且我有一堆优质资源，是从我过去教这个东西的时候记住的。所以，我决定 Teach 必须是一个有状态技能。

举个例子，如果你以前用过我的 skills 仓库，你就会知道 Grill Me 是完全无状态的。它只是就某个话题不停地拷问你，直到你准备好去实现为止。但 Grill with Docs 实际上是有状态的。换句话说，它会把一些本地 ADR（架构决策记录）保存下来，还会在仓库里保存一些其他东西，比如词汇表。所以 Grill with Docs 是有状态的，而且会随着时间变得更好，而 Grill Me 则是完全无状态的。这两者之间没有谁更好，只是在不同的场景下各有用途。所以在设计技能时，你需要仔细思考它们是需要无状态还是有状态。而 Teach 需要是有状态的。

安装与首次运行

安装这个技能的方法是：前往我的 skills 仓库，往下翻到这个快速入门（quick start），然后运行 skills.sh 安装程序，选择 Teach 技能。完成后，进入一个空目录，在你的编码代理（coding agent）中运行 Teach。

比如，在这个目录里——这是我的魔方目录——我输入了“教我如何还原魔方”。你会注意到，在我的学习过程中，它在这里创建了多少个文件。

第一步：创建使命（mission）

第一个创建的是使命文件。我相信，一个老师要想有效教学，你需要理解学生为什么想学这个东西。所以我让这个技能为你创建一个使命。这里是这样的：

“Matt 想要能够拿起一个打乱的三阶魔方，在无辅助的情况下至少还原一次。目标是完成还原本身，不是为了速度，不是为了理论。”

第二步：创建资源

接下来它会创建一组资源。它会搜索网络，寻找真正可靠的、高信任度的原始资源，用来制作课程。它会在你要求教某样东西的第一次运行时就完成这个，然后随着你继续学习，它会不断更新这些资源。

第三步：创建第一课

然后它会为你创建第一课。课程存储在 lessons 文件夹中，按这样的方式编号，每一课都是独立的 HTML 文件。HTML 比 markdown 丰富得多，它让内容表达力更强，互动性也更强。而这正是让学习体验如此出色的核心所在。

这是我的第一课：结构（anatomy）、符号（notation）和白十字（white cross）。它基本上只教你这个当下需要知道的东西。它给你图示，给你非常简单的解释，给你重点提示，还给你测验。我发现无论教什么，建立反馈循环都非常重要，而测验在这方面还算可以。如果没有更丰富的反馈循环，测验基本上就是好的选择。

我们再往下看，这里有符号说明，有常见陷阱，还有你的第一个技巧。所以它既在给我所需的知识，也在鼓励我培养所需的技能——这两者是略有不同的。

学习记录与动态课程调整

技能本身也知道这一点。当我完成课程并说“是的，我能做出白十字了”之后，它就会把这个记录到学习记录（learning record）里。这些学习记录是代理在我汇报学习进展时创建的非常简单的记录。这样它就能追踪我的进展，就像真正的老师一样，然后根据我的需要来调整下一课。

这是这门课程后面部分的一个讲解。我想它是在根据我的需求，随着学习的推进来逐步构建一门课程。这次这个呢，它已经开始添加一些小引用了。还有更多的测验。我觉得这个布局看起来真的很舒服，也很实用。我在构建这个技能的过程中也在完善它。

社区板块

所以我在底部加了这个小的“社区”板块。它试图帮你找到可以提问的社区。因为，没错，你可以在这里获得知识和技能，但你真正培养智慧的唯一方式是实际与他人社区互动，在现实世界中检验你的想法。

参考文档

它还为你生成参考资料。这是我注意到自己需要的东西。

词汇表（glossary）

这个词汇表包含了结构、符号、握持手法、daisy 之类的——所有我们学过的奇怪术语都会进到词汇表里。这非常有用，尤其是如果你用它来学习编程语言之类的。这也意味着未来的课程可以更简洁，因为它们可以直接引用词汇表中的术语，如果你感到困惑可以回头查阅。

速查表（cheat sheet）

它还会为你创建速查表。这就是一张还原卡，基本上把整个还原流程都给我了。如果我想要一个单一的地方来查看如何还原魔方，这就是我该去的地方。

notes.md

最后，解释一下这个 notes.md 文件——这是代理记录我的任何偏好、记录任何注意事项的地方，基本上就是代理自己的内部笔记。

与 AI 老师协作：一个具体例子

现在想象一下，我坐下来开始一次会话，基本上想把自上次会话以来我做的事情告诉老师。所以我只说一句“teach”，然后补充道：

我现在基本上能还原魔方了，除了角循环（corner cycle），那个我还没完全记到肌肉记忆里。

让我们看看它会说什么。

当然，由于这是一个空上下文，它首先会检查我的教学工作区的状态。它会检查所有的还原卡，看看我已经学到了哪里。现在它对我的感受给出了一个相当准确的诊断。它说角循环这个概念本身是明白的——那是一个特定的算法——但它是还没达到肌肉记忆的那个。

让我看一下之前的一节记忆课程，以匹配整体风格。我们基本上把代理变成了一个老师，你得像对待任何一对一老师那样与它协作。你告诉它你遇到了什么问题，它就会设计课程来找到解决方案。

顺便说一下，我这里使用的模型是 Opus 4.8，中等强度（medium effort）。

最近发展区

它还使用了一个关键的教学术语——最近发展区（zone of proximal development）。“一个算法，纯粹的肌肉记忆训练。”

最近发展区是我痴迷的一个核心教学理念。它的核心思想是：你应该总是在一个人受到恰到好处挑战但不会感到畏惧的区域里教他。这意味着每节课都必须简洁、紧凑，并且精确地定位在那个最近发展区里。这样学生既不会觉得无聊，也不会被吓到。

我们可以看到它现在已经创建了这节课——角循环课。它为我们生成了这样一节精准的课。它基本上就是把它分解开来，给予更多关注，给我新的心智模型。“一个四步口诀，重复两遍。”嗯，这很方便。

然后我会跟着这节课走一遍。哦，看看这个。天哪，快看这个。它居然给了我一个可以交互的点击练习！好的，是 U R U' L' U R' U' L。天哪，看这个。它还有引导模式！我可以关掉那个。哦，这也太酷了吧。你看到 HTML 带来的好处了吧？我们拥有浏览器的全部能力来玩转这些东西。

现在你明白这些课程是什么样了。它们很短，非常聚焦，精确地告诉你现在该练什么。这同时也意味着，因为所有东西都保存到了文件系统上，我可以清空这个对话，每次我再次运行 teach 时，它都拥有让我保持在最近发展区所需的所有上下文。

技能本身的结构

让我们简单看一下技能本身。它其实相当简单，尽管它是我编写的较长的技能之一。

“用户要求你教他们某样东西。这是一个有状态请求。他们打算在多次会话中学习这个主题。”

它会进入教学工作区的结构——这个我们之前已经看过了——这里有一段分节的教学理念。我真的定义了 AI 应该用来思考的术语。它应该从这些角度来思考：

• 知识：从高质量、高信任度的资源中给予他们知识；
• 技能：高度相关的互动课程——以及实际培养技能；
• 智慧：来自与其他学习者和实践者互动的智慧。

我们再往下看，这里涉及课程本身的形态。我们还讨论过使命（mission.md）、最近发展区、获取知识和技能的方式，以及获取智慧——基本上就是当学习者准备好走向世界时，一旦他们拥有了知识和技能，你如何将他们交付给社区。

“当用户提出一个似乎需要智慧的问题时，你的默认姿态应该是尝试回答，但最终要委派给社区。”

我想通过这个 Teach 技能达成的目标，不是让你一直依赖代理来学习所有东西。而是真正给你所需的技能，让你有信心走出去与社区互动，把你送向这个世界。这就是这件事的梦想。

这里还有更多关于参考文档（reference documents）的内容，最后是关于 notes.md 的，但这个技能基本上就是这些了。还有一些配套的小文档，比如学习记录格式、使命格式、资源格式等等。

可能的工程应用

从工程角度来看，我能想象这个技能在让人入职一个代码库时非常有用。编写文档真的是件很痛苦的事，因为不仅需要保持文档更新，而且那些文档很可能超出了那个人的最近发展区。他们可能之前用过你的技术栈，可能只需要了解特定的问题领域；或者他们之前接触过该问题领域，但完全不知道 TypeScript 是什么或者类似的情况。

所以你可以这样理解 Teach：你让新人在他们自己的工作区开始，把他们指向代码库，教他们如何独立地学习如何和代码协作、有哪些概念，然后你猜怎么着？你以创纪录的速度获得了一名高效的员工。

对我个人而言，我很兴奋能在我的副业项目上使用它，在追求乐趣上，在学那些我以前不会去学的东西上——比如解开这个该死的魔方。我甚至可能会翻出一些旧的国际象棋资料，看看它能不能教我一两个开局。

开发者：AI 时代的先行者

最后我想讲一个我思考了很久的想法，我认为这个 Teach 技能真的证明了——或者说让我清楚地看到了——那就是：

我们，开发者社区，身处其中的工程师们，是第一批真正体验到 AI 在它真正擅长的领域能做什么的人。

AI 目前在写代码方面比其他几乎所有事情都强。有几个例外，但真的，AI 非常擅长写代码，而开发者拥有一个优势：我们是第一批真正在 AI 非常擅长的问题上测试它的人。这意味着我们是世界上真正最早了解 AI 的人（少数例外之外），是最早构建这些酷东西的人，这意味着我们是这个新领域的第一批行动者。

我们可以把在这里形成的想法变成技能，然后开始把它们带给世界。我认为这非常令人兴奋，这也是我接下来会继续探索的方向，而这个 Teach 技能就是那个方向的第一阶段。

所以，当你在使用 Clo Code 或 Codex 时遇到困难、失去动力，心里想着“天哪，这真烂”的时候，请想一想：你将能够把现在正在学习的技能，以及你与 AI 协作时建立的直觉，带到编码领域之外。我认为这不管未来工作形态如何，都会是一项极其宝贵的技能。我们终将都要与 AI 协作，而我们是第一批真正开始这样做的人。

获取方式

如果你喜欢我的技能，那你应该去 AI Hero /skills，然后订阅我的 Newsletter，这样每当我有新技能发布、或者做了任何改动时你都会收到通知，因为我确实经常改动这些技能。如果你想要关于如何使用我的技能进行工程开发以及其他用途的最新信息，那就去看看吧。

但总的来说，感谢观看。我迫不及待想看到你们正在学习的语言——编程语言或人类语言——以及你们正在培养的新技能。我还打算让这个东西教我声乐和声。这也是我一直想掌握但一直不太擅长的技能。我真的等不及要自己用起来，也很期待看到你们怎么用它。

Source: @ydarias: I’ve used this skill from @mattpocockuk and I may say I am pretty impressed with the good results. AI for more than cod…