SuperAPI AI 工具集

teach

编程与开发

查看项目

更新于 10-28 17:12

技能介绍

teach 是一个用于 Pstack 任务的技能,主要用途是解释一个东西“是什么、怎么运作、为什么这样建”,用一段平实的讲述、按对方的节奏进行。它的目标是让人理解,而不是改变任何东西。

用途与定位:teach 不是独立完成全部调查,而是叠加在 /how 与 /why 之上。先自行读代码了解工作涉及什么、会触碰什么,然后调用 /how 获得“怎么运作”、调用 /why 获得“为什么这样”,把两者发现融合成一份统一、通俗的解释。

主要能力:

  1. 依据对话里的提问动机(即将修改它、审查它、调试它、刚接触它)和对方已有知识,决定对方应该带走哪几件事,跳过对方明显已知的内容,把深度放在问题所在处。
  2. 通过 /swarm 并行运行 /how 与 /why 并合并结果;按问题规模匹配调用量,子系统级别可两个都跑,小改动可能一个就够。/why 默认收窄范围,因为完整扫描较慢;收窄放在提问本身(限定范围的问题、git 加一两个来源),让其按自身约定记录被跳过的类别,只有“原因”本身是重点时才扩大。
  3. 讲解结构:先给平实定义,说出名称与一般含义(像资深工程师口头解释那样,有常用名就说常用名),再联系眼前的具体案例(“在 X 中,我们用它来……”),然后展开怎么运作、更深层的原因、边界情况。每个部分都讲清它解决的问题和实际机制。必要时按对方操作过程逐步走一遍(例如打开长对话、向上滚动)。
  4. 呈现方式:先给最小完整答案(一两句话,不是密集段落)就停下,对方追问再加层,绝不堆大段文字。能看图更快就用图;对于三个以上活动部件的系统,不画一张全量图,而是画一系列逐步添加部件的图(如 A 到 B、再重画加 C、再重画加返回边)。流程或结构用 mermaid;空间类概念(布局、重叠、滚动位置、前后对比)在有图像生成工具时用白板马克笔风格生成图,配少量短标签。单一简单要点不需要图。
  5. 对话而非讲座:不测验、不演出节奏、不打印“暂停”、不要求复述、不宣布哪句是重点、不标注某部分重要或困难。想停的时候就停下让对方回应;一次性无人交互运行时,干净交付并把“可继续深入”的邀请放在最后。
  6. 文字风格:通过 /unslop 技能写成口语化平实英文,紧凑而不干瘪,删掉填充和模糊措辞,保留让人恍然大悟的部分;陈述具体机制而非比喻、框架或预告;正常句首大写,不用长破折号,多用句号,每句一到两个逗号,从句堆叠就拆句;一个概念只用一个名称;避免对仗句和漂亮的收尾语。

使用方式:在 Pstack 任务中调用该技能,并配合 /how、/why 使用;需要并行时可经 /swarm 调度两者。回复内容就是讲解本身,而不是关于自己做了什么或交付了什么的工作汇报:先给要点,再平实讲是什么、怎么运作、为什么,并给出值得用 /how 或 /why 继续追的线索。

适用场景:需要理解一段代码或子系统、准备修改或审查代码、调试前建立认知、新人上手理解某个机制时。

限制:资料未提供独立安装方式、收费、价格、支持平台或效果数据,这些暂未提供。资料未说明除 Pstack、/how、/why、/swarm、/unslop 之外的依赖条件。