SuperAPI AI 工具集

teach

写作与研究

查看项目

更新于 10-16 16:27

技能介绍

Teach 是一个用于讲解工作内容的技能,它的目标是让人真正理解一个东西,而不是去改动它。

用途 Teach 用来解释一个工作或代码库是什么、怎么运作、以及为什么这样设计。它适合的场合包括:即将修改某段代码、正在审查它、正在调试它,或者初次接触它。它会根据这些动机和你已经掌握的知识,来决定讲解的深度和重点。

主要能力 Teach 建立在 how 和 why 两个技能之上。它先自己读代码来建立基本方向,然后运行 how 了解实现方式,运行 why 了解设计原因。这两个是真实的技能调用,会各自进行挖掘。Teach 把它们的发现融合成一段平实的解释,以对提问者最重要的内容开头,在对方追问时再深入。它保留 why 的置信度措辞,因为这些保留意见本身是结论,不是风格问题。Teach 会决定对方应该带走理解的几个要点,跳过明显已经知道的内容,把深度放在问题所在处。默认情况下 why 的范围保持较窄,因为它的完整扫描较慢。

使用方式 讲解从通俗定义开始,用一个资深工程师口头会用的说法,说出这个东西是什么,如果有常用名就带上。然后把它和眼前的具体情况联系起来,再从那里展开:怎么运作、更深层的原因、边界情况。每一部分都要把思路讲得能让人一下子明白:它解决什么问题,实际是怎么运作的。当对方做某件事的过程能帮助理解时,就走一遍那个过程。列出函数和常量是参考资料,不是教学。

解释遵循最小完整回答优先:先给一两句话的最小完整答案,然后停下,等对方追问时再加层。保持对话感,而不是讲座或表演。可以提供继续深入或换话题的选项,由对方决定。不提问测验,不宣布某部分是重点或难点,只在会自然停顿的地方停下让对方回应。如果是无人交互的一次性运行,就把内容干净地讲完,把继续深入的建议放在结尾。

展示而不只是讲述。当 diff、代码或调试器是最快的理解途径时就打开它们。当画面比文字更快时就用图。对于有三个或以上活动部件的系统,不要一次画一张包含全部的图,而是画一组短系列图,每张在前一张基础上重画并只添加一个部分,让读者看着系统逐步拼装起来。例如讲解从 A 到 B 再到 C 的流程,画三次:先 A 到 B,再重画加上 C,再重画加上返回边或下一部分。mermaid 图适合标签承载含义的流程或结构。当想法是空间性的,比如布局、重叠、滚动位置或前后对比,就用图像生成工具画出白板手写风格的图,配少量短标签,因为图像模型处理长文字会出错。生成的图也要遵循逐步添加的规则。单一简单要点不需要配图。

所有回复都按照 unslop 技能的要求,用平实的口语英语写,像给同事解释一样。紧凑但不干瘪。删掉填充和含糊,保留让它一下子明白的部分。陈述具体机制,不用比喻、框架或预告。句首大写,不用全小写。不用破折号。多用句号,少用逗号,每句保持一到两个逗号。每个概念只用一个名字并保持一致。

适用场景

  • 准备修改某段代码前,先理解它是什么、怎么运作、为什么这样设计。
  • 审查代码时,理解其结构、流程和设计取舍。
  • 调试时,先建立对相关子系统的整体认识。
  • 初次接触一个项目或子系统时,快速获得平实可靠的介绍。

限制 Teach 只做解释,不改动任何东西。它不做测验,不制造节奏感,不把某部分标记为重要或困难。大多数 pstack 技能是用户专用的,技能工具无法加载它们。why 的完整扫描较慢,默认保持范围较窄。图示方式、具体代码展示方式需要根据实际情况判断,资料未提供统一模板。Teach 的具体安装命令、收费、价格和平台信息暂未提供。