teach 用于被要求深入讲解某个变更或子系统时。它不修改任何东西,只负责让人真正理解:先说明这是什么,再讲它如何运作,最后解释为什么这样设计。
用法上,teach 建立在 how 和 why 两个技能之上。先自己读代码定位工作内容及其影响范围,再运行 how 了解运作方式、运行 why 了解设计原因,两者可并行执行后合并结果。规模随问题而定:子系统通常两者都跑,小改动可能一个就够。why 默认收窄范围,因为全量扫描较慢,收窄方式写在提问里(限定问题、git 加一两个来源),仅在原因本身是重点时才放宽。
讲解时先给一句平实定义,用资深工程师的口吻说出它一般是什么,再联系眼前的具体场景,然后展开运作方式、深层原因和边界情况。先给最小完整答案,一两句即可,对方追问再逐层加深。不打印框架标签,不列函数和常量当讲解,不搞测验或节奏表演。
能展示就不只叙述:打开 diff、代码或调试器;涉及三个以上部件时,画一系列逐步叠加的图,而不是一张全量图。流程或结构用 mermaid,空间类概念(布局、重叠、滚动位置、前后对比)用图像生成工具画白板风格图。
限制:不改变代码;why 的全量扫描较慢;图像模型对长文本易出错,故图中只用少量短标签。输出为解释本身,不是关于做了什么的报告。