teach 是一个讲解型技能,用途是解释一项工作成果——它是什么、如何运作、为什么这样构建——并用一段平实的说明让对方真正理解。目标不是改动任何东西,而是让理解发生。
主要能力方面,teach 建立在 how 和 why 两个技能之上。它先对工作内容本身及其影响范围形成整体认识,然后分别运行 how 来弄清运作机制、运行 why 来弄清设计缘由;这两个是真实的技能调用,会自行深入挖掘。teach 再把它们的发现融合成一段清晰的解释,从对提问者最重要的内容讲起,对方追问时再深入。讲解可以自由改写措辞,但有一项例外:why 输出的置信度措辞必须原样保留,因为其中的保留和限定本身是研究结论,不是文风。
讲解方式上,先给出通俗定义,用资深工程师口头介绍的方式说出这个东西是什么、常见叫法是什么,再把它与眼前的具体场景联系起来,然后展开运作方式、更深层原因和边界情况。对每一部分都讲清它解决的问题以及实际如何运作。先给出最小完整的答案,一两句话,然后停下,等对方追问再逐层补充,避免大段文字。讲解保持对话感,不测验、不搞节奏表演,也不打印“重点”“关键洞察”“TL;DR”之类的框架标签,不预告接下来要讲什么。
呈现手段上,强调展示而非仅叙述:能打开 diff、代码或调试器时就直接打开;图示比文字更快传达时就用图。对于有三个及以上组成部分的内容,不要一次画出全部,而应画一组连续的图,每张在前一张基础上只增加一个部分,让读者看着系统逐步搭建起来;最后才给出的一张全貌图属于参考资料,不算讲解。流程图或结构用带标签的 mermaid 图较合适;涉及空间关系(布局、重叠、滚动位置、前后对比)时,用图像生成工具画白板马克笔风格的简图,配少量短标签。有一个简单要点时不需要配图。
使用方式上,teach 的讲解深度取决于对方为什么问(即将修改它、审查它、调试它、初次接触)以及对方已知什么,这两点从对话中读取,而不是去考问对方。明显已经掌握的内容跳过,把深度放在问题所在处。默认把 why 的范围收窄,因为完整扫描较慢;收窄方式写进提问本身(限定范围的问题、git 加一两个来源),让 why 按其自身约定记录被跳过的类别,只有当“原因”本身就是重点时才扩大范围。
适用场景包括:接手或修改一段不熟悉的代码、审查某次改动、调试某个子系统、初次学习某个概念。限制与注意事项:它不改变任何内容,只做解释;不测验、不要求复述;不重复 how 和 why 已经完成的挖掘工作。该资料未提供安装命令、具体调用方式、平台支持及收费信息。