用途 该技能用于回答“X 是怎么工作的”这类代码理解问题,也适用于在修改某处代码之前做代码走读,以及处理代码放置、归属和分层问题,例如“这段代码应该放在哪里”“哪一层应当负责什么”。它的输出是一份架构级解释,目标是让读者建立对子系统的可用心智模型,达到高级工程师入职子系统时的理解程度,同时避免写成逐行注释源码。
主要能力 技能会组织子代理探索代码库并生成解释。所有子任务都通过 Task 工具发起,subagent_type 为 generalPurpose,readonly 为 true。探索者使用 pstack-models.mdc 规则中的 how explorer 行(默认 grok-4.7-xhigh-fast),解释者使用 how explainer 行(默认 claude-opus-5-5-xhigh)。模型应设为对应行的值;如果规则或行缺失,则使用默认值;如果该值为 auto 或 inherit-parent,则保持 model 未设置。如果 Task 工具拒绝某个 slug,应使用默认值并说明情况;如果默认值也被拒绝,则根据错误信息选择同一家族中最接近的有效 slug。每个子代理的推理级别以及快速或标准速度,应依据 poteto-mode 技能的 Subagents 部分按任务选择。
使用方式 第一步评估复杂度。如果范围不明确,先说明自己的理解再开始探索,用户可以纠正。简单情况指单个模块、小型工具或窄问题(如“函数 X 怎么工作”):不启动探索者,直接启动一个解释者,在单次过程中完成探索和解释,提示词基于 references/explainer-prompt.md,但不含 explorer-findings 部分,然后进入第四步。复杂情况指跨多个文件或服务的子系统、横切功能或完整架构概览:进入第二步。存在疑问时走简单路径。第二步仅用于复杂情况:将问题分解为 2 到 4 个角度,每个角度是子系统的不同切片;在一条消息中启动所有探索者,每个都使用 references/explorer-prompt.md 并填入对应角度。第三步仅用于复杂情况:所有探索者返回后,启动一个解释者,使用 references/explainer-prompt.md 并填入所有探索者的发现。第四步呈现解释者的输出;可以为清晰或结合对话上下文做轻微编辑,但不要大幅重写。
输出格式 解释使用 references/explainer-prompt.md 中定义的章节,并删除不适用的部分:Overview、Key Concepts、How It Works、Where Things Live、Gotchas。
适用场景 适合需要理解既有代码如何运作、在改动前建立架构认知、判断代码放置与分层归属的开发者。也适合需要以入职级视角快速了解某个子系统的场景。
限制 该技能依赖 references/explainer-prompt.md、references/explorer-prompt.md、pstack-models.mdc 规则和 poteto-mode 技能的 Subagents 部分;资料未提供这些文件的具体内容。模型默认值、回退与 slug 纠正逻辑依赖 Task 工具的行为,具体可用模型以环境配置为准。技能本身不修改代码,所有子代理均为只读。资料未说明该技能是否收费、支持哪些平台或具体安装命令,这些信息暂未提供。