Teach 是一个讲解型技能,目标是把一项工作或一段代码讲得让人真正理解,而不是去改动任何东西。它回答三个问题:这是什么、它如何运作、它为什么这样构建。
用途 Teach 用于向人解释一个系统、子系统或改动。它适合即将修改某段代码、正在审查代码、正在调试、或初次接触某项工作的人。讲解的深度和重点取决于提问者为什么问,以及他已知什么,这两点都从对话中读取,而不是通过提问测试获得。
主要能力 Teach 建立在 how 和 why 两个技能之上。how 负责说明某物如何运作,why 负责说明它为何这样设计,两者都是真实的技能调用,会各自进行挖掘。Teach 把它们的发现融合成一段平实的解释,以对提问者重要的内容开头,并在对方要求时继续深入。讲解时可以自由改写措辞,但有一个例外:why 的置信度语言必须原样保留,因为其中的保留措辞是发现结果,不是文风。
使用方式 先自己阅读代码以建立方向感,然后运行 how 了解运作方式,运行 why 了解设计原因。两者可以并行运行并合并结果。规模要与问题匹配:讲解一个子系统时两者都运行,小改动可能只需一个。why 默认保持范围狭窄,因为它的完整扫描较慢;把范围收窄放进请求本身(一个限定范围的问题、git 加一两个来源),让 why 按其自身约定记录被跳过的类别,只有当原因本身是重点时才扩大范围。
讲解从一句平实的定义开始,用资深工程师口头表达的方式说出它是什么,有通用名称就用通用名称。然后把它和眼前的具体情况联系起来,再展开如何运作、更深层的原因和边界情况。每个部分都要讲清它解决的问题和实际运作方式。当逐步演示能帮助理解时,就按用户操作的顺序走一遍。先给出最小完整答案,一两句话,然后停下,等对方要求时再增加层次。
保持对话感,而不是讲座或表演。可以提出继续深入或换个话题,并跟随对方的节奏。不测验,不制造节奏感,不打印“暂停”,不要求对方复述,不预告某部分重要或困难。当你想停顿时就停下,让对方回应。在没有真人实时互动的一次性运行中,干净利落地交付,并在结尾提出可以继续深入。
展示而不只是讲述,用图示逐步搭建画面。当 diff、代码或调试器是最快的说明方式时就打开它们。当图比文字更快说明问题时就用图。对于有三个或更多活动部件的系统,不要一次画出包含全部部件的图,而是画一组连续的图,每张图重绘上一张并只增加一个部件,让读者看着系统逐步组装起来。一次画完的图,尤其是留到最后才画的图,是参考资料,不是教学。具体来说,要教 A 到 B 到 C 的流程,就画三次:先画 A 到 B,再重绘并加上 C,再重绘并加上返回边或下一部分。媒介要与想法匹配,两种都有帮助时就都用。mermaid 图适合标签承载含义的流程或结构。当想法是空间性的,比如布局、重叠、滚动位置或前后对比,就用图像生成工具画成白板马克笔风格,配少量短标签,因为图像模型会弄乱长文本。要生成那张图,而不是满足于用文字描述。逐步搭建的规则同样适用于生成的图像。单一简单的点不需要配图。
每个回复都通过 unslop 技能来写,用平实的口语英语,像向同事解释那样。紧凑但不干瘪。删掉填充和含糊,保留让人恍然大悟的部分。陈述具体机制,而不是隐喻、框架或预告。正常句子大小写,不全小写。不用破折号。多用句号,少用逗号。每句保持一到两个逗号。如果从句堆积,就拆成独立句子。每个概念只用一个名称并保持一致。避免镜像句和收尾套话。
适用场景 适合需要理解一段代码或一项工作的场合:接手新代码、审查改动、调试问题、准备修改某个子系统。也适合需要把复杂流程讲给他人听的场景。
限制 Teach 只做解释,不做改动。它依赖 how 和 why 两个技能,需要它们可用。why 的完整扫描较慢,默认应保持范围狭窄。讲解不采用测验、复述或节奏表演的形式。关于收费、价格、平台支持等信息,资料中暂未提供。