用途:回答“X 是如何工作的”问题,在修改代码前做代码走读,并处理放置、归属与分层问题(例如“这段代码该放哪里”“哪一层负责什么”)。目标是产出资深工程师接手某个子系统时所需的架构级解释,足以建立可用的心智模型,但不会细到像逐行注释的源码。
主要能力与流程:先评估复杂度。若范围含糊,先说明自己的理解再探索,用户可纠正。简单问题(单个模块、小型工具、窄问题如“函数 X 如何工作”)不派探索者,由一个解释者一次性探索并解释。复杂问题(跨多文件或服务的子系统、横切特性、整体架构概览)先并行派出探索者,再交给解释者综合。拿不准时走简单路径。
复杂路径:把问题拆成 2 到 4 个探索角度,每条是子系统的不同切片,在单条消息中同时派出所有探索者,参数为 subagent_type: generalPurpose、model 取 how explorer 行(默认 grok-4.7-xhigh-fast)、readonly: true,每个探索者使用 references/explorer-prompt.md 并填入其角度。全部返回后,再派一个 Task 子代理把发现综合成一份解释,参数为 subagent_type: generalPurpose、model 取 how explainer 行(默认 claude-opus-5-5-max)、readonly: true,提示词由 references/explainer-prompt.md 填入各探索者发现构成。
简单路径:派一个 Task 子代理一次性探索并解释,参数为 subagent_type: generalPurpose、model 取 how explainer 行(默认 claude-opus-5-5-max)、readonly: true,提示词由 references/explainer-prompt.md 构成,不含探索者发现部分。
模型配置:每个 spawn 对应 pstack-models.mdc 规则中的一行角色与一个默认值。把 model 设为该行的值;若规则或该行缺失则用默认值。当值为 auto 或 inherit-parent 时不设置 model。若 Task 工具拒绝某个 slug,改用默认值并说明;若默认值也被拒绝,则从错误信息中选同族最接近的有效 slug。
输出与限制:把解释者的输出呈现给用户,可为清晰或结合对话上下文做轻微编辑,但不要大幅重写。解释使用 references/explainer-prompt.md 定义的章节,不适用的章节省略:Overview、Key Concepts、How It Works、Where Things Live、Gotchas。资料未提供具体安装命令、收费方式与支持平台信息。