how

工作原理

探索代码库，回答“X 是如何工作的？”这类问题。提供架构层面的说明，帮助资深工程师了解某个子系统并建立可用的整体认知；不要写得像带注释的源代码那样详尽。

下面每个派生任务都指定了 pstack-models.mdc 规则中的角色行及默认值。将 model 设为该行的值；如果规则或该行不存在，则使用默认值。如果值为 auto 或 inherit-parent，则不设置 model。如果 Task 工具不接受某个模型标识符，则使用默认值并说明这一点。如果它不接受默认值，则根据其错误消息选择同一系列中最接近的有效标识符。

第 1 步：评估复杂度

如果范围不明确，请说明你的理解并进行探索。用户可以纠正方向。

• 简单（单个模块、小型工具、范围较窄的问题，例如“函数 X 是如何工作的”）：不使用探索器。由一个说明者一轮完成探索并作出解释。转到第 2b 步。
• 复杂（跨多个文件或服务的子系统、横切功能、完整架构概览）：先并行启动探索器，再交给说明者。转到第 2a 步。

如果拿不准，选择简单路径。

第 2a 步：探索（仅限复杂问题）

将问题拆分为 2 到 4 个探索角度，每个角度涵盖子系统的不同部分。通过一条消息启动所有探索器：

• subagent_type：generalPurpose
• model：how explorer 行的值，默认值为 grok-4.7-xhigh-fast
• readonly：true

每个探索器都使用 references/explorer-prompt.md 中的提示词，并填入对应的探索角度。然后转到第 3 步。

第 2b 步：直接说明（简单问题）

启动一个 Task 子 Agent，一轮完成探索并作出说明：

• subagent_type：generalPurpose
• model：how explainer 行的值，默认值为 claude-opus-5-5-max
• readonly：true

根据 references/explainer-prompt.md 构建提示词，但不包含探索结果部分。转到第 4 步。

第 3 步：综合（仅限复杂问题）

所有探索器返回结果后，启动一个 Task 子 Agent，将它们的发现综合为一份说明：

• subagent_type：generalPurpose
• model：how explainer 行的值，默认值为 claude-opus-5-5-max
• readonly：true

根据 references/explainer-prompt.md 构建提示词，并填入所有探索器的发现。

第 4 步：呈现

将说明者的输出呈现给用户。可以根据清晰度或对话背景稍作润色，但不要大幅改写。

输出格式

说明应使用 references/explainer-prompt.md 中定义的章节，并省略不适用的章节：概览、关键概念、工作原理、代码位置、注意事项。