pstack-teach 是一个用于 Pstack 任务中的教学技能,核心目标是用平实语言解释代码是什么、如何运作以及为何如此设计,让使用者真正理解,而不改变任何代码。
用途:该技能面向即将修改、审查、调试或初次接触某段代码的使用者。它根据对话中透露的提问原因和已有知识,决定使用者应当理解哪些关键点,跳过已知内容,将深度放在问题所在处。
主要能力:pstack-teach 建立在 /pstack-how 和 /pstack-why 两个技能之上。它先自行阅读代码定位方向,再通过 /pstack-swarm 并行调用 /pstack-how(了解如何运作)和 /pstack-why(了解为何如此设计),并将两者结果融合成一段连贯的讲解。对于子系统可同时运行两者,小改动可能只需一个;/pstack-why 默认应保持窄范围,因为全量扫描较慢,窄范围应体现在提问本身(限定问题、git 加一两个来源),以便 /pstack-why 按其约定记录跳过的类别,仅在原因本身是重点时才扩大范围。讲解从简单定义开始,用资深工程师的口吻说出事物名称和一般含义,再联系当前案例,逐步展开如何运作、深层原因和边缘情况。它强调展示而非仅讲述,对于三个或更多移动部件的流程,不画一张包含全部部件的图,而是画一系列图,每张图重绘上一张并增加一个部件,让读者看到系统逐步组装。流程图或结构图可用 mermaid 图,空间性概念(布局、重叠、滚动位置、前后对比)可借助宿主图像生成工具,以白板马克笔风格绘制并配短标签。每个回答都经过 /pstack-unslop 技能处理,使用口语化英文,句子紧凑,机制具体,避免隐喻和填充词。
使用方式:资料未提供具体安装命令或调用步骤。从描述可知,在 Pstack 任务中调用该技能,它会自行阅读代码并调用 /pstack-how 和 /pstack-why。讲解以对话形式进行,先给出最小完整答案(一两句话),然后停止,按使用者要求再分层深入。不进行测验,不要求复述,不标记重点或难点,不打印框架标签。当没有实时人类时,一次性交付并在末尾提供深入选项。
适用场景:适用于需要理解代码运作与设计原因的任务,如修改前理解、代码审查、调试、初次接触新代码库。
限制:资料未提供收费、价格、平台或效果等信息。该技能依赖 /pstack-how、/pstack-why、/pstack-swarm 和 /pstack-unslop 等技能。讲解语言为英文。图像生成取决于宿主是否具备相应工具。回复布局可能限制每轮图片数量(如 /reply-shape),需遵守并逐轮继续系列图。