用途
how 用于回答“X 是如何工作的”这类问题，也用于在修改代码之前进行代码走读，以及处理放置、归属与分层相关的问题，例如“这段逻辑应该放在哪里”“该由谁负责”。它的目标是产出面向资深工程师的架构讲解：当一位资深工程师刚接手某个子系统时，这份讲解足以帮助其建立可用的心智模型，但又不会详细到像逐行注释的源码。
主要能力
- 评估问题复杂度，并据此选择简单路径或复杂路径。
- 简单路径：不派探索者，直接由一个讲解者一次性完成探索与解释。
- 复杂路径：将问题拆解为 2 至 4 个角度，每个角度是子系统的一个独立切片，并行派探索者；待全部返回后，再由一个讲解者综合所有发现。
- 输出按需使用以下章节：概览、关键概念、工作原理、代码位置、注意事项；不适用的章节会被丢弃。
使用方式
在 Codex 上，需先阅读平台映射（包括其各技能说明），再遵循本技能。在 GitHub Copilot 上同样需先阅读平台映射及其各技能说明。
复杂度判断：如果范围不明确，先说明自己的理解再探索，用户可以纠正方向。简单情况指单个模块、小型工具，或诸如“函数 X 是如何工作的”这类窄范围问题；此时不派探索者，直接由一个讲解者探索并解释，讲解者基于 references/explainer-prompt.md 构建，但不含探索者发现部分。复杂情况指跨多个文件或服务的子系统、横切特性，或完整的架构概览；此时先探索再综合。拿不准时走简单路径。
探索（仅复杂情况）：把问题拆解为 2 至 4 个角度，每个角度是子系统的一个独立切片；在单条消息中派出所有探索者，每个探索者使用 references/explorer-prompt.md 并填入其角度。
综合（仅复杂情况）：所有探索者返回后，派出一个讲解者，使用 references/explainer-prompt.md 并填入每位探索者的发现。
呈现：呈现讲解者的输出。为清晰或结合对话上下文做轻微编辑是可以的，但不要大幅重写。
子代理与模型
每次派生都是一个 Agent 子代理，subagent_type 为 "general-purpose"，readonly 为 true。探索者使用 pstack-models.md 中的 how explorer 行（默认在 Models 中），每个讲解者使用 how explainer 行（默认在 Models 中）。将 model 设为该行的值；如果该表或该行缺失，则使用默认值。当值为 auto 或 inherit-parent 时，不设置 model。如果 Agent 工具拒绝某个 slug，则使用默认值并说明；如果它拒绝默认值，则使用其错误消息中同一家族最接近的有效 slug。
角色默认值从 plugins/pstack/models.json 打戳（在那里编辑，重新运行 tools/generate.mjs）。pstack-models.md 覆盖表中匹配的角色行会在运行时覆盖每个默认值；/setup-pstack 会写入它，并按运行时列出其路径。how explorer 与 how explainer 的默认模型均为 opus。
推理强度
覆盖表中的角色值可以在模型名之后指定推理强度，例如 opus @xhigh。Claude Code 上的级别有：low、medium、high、xhigh、max，具体适用哪些取决于模型。不带 @ 的值采用该表的默认 effort 行（一个级别或 session），当该表没有该行时采用 session。session 不设置任何 effort，因此派发按常规进行。读取模型前先去掉后缀：inherit-parent 或 auto 在任何级别下仍然省略 model，模型名则作为 model 传入。在 Claude Code 上，级别会从原本要使用的 subagent_type 中挑选 effort 代理：pstack:poteto-agent 变为 subagent_type: "pstack:poteto-agent-<level>"；general-purpose 或无 subagent_type 变为 subagent_type: "pstack:effort-<level>"。effort 代理只设置 effort，因此传入的模型仍然决定模型。在 Codex 上，将级别作为 spawn_agent 的 reasoning_effort 传入，并保留常规指令。
适用场景
- 需要理解某个子系统或功能如何运作，以便安全地修改它。
- 需要判断某段逻辑应放在哪里、由谁负责、如何分层。
- 需要一份面向资深工程师的架构概览，而非逐行源码注释。
限制
- 在 Codex 与 GitHub Copilot 上使用前，必须先阅读平台映射及其各技能说明。
- 复杂度判断拿不准时应走简单路径。
- 呈现阶段只做轻微编辑，不应大幅重写讲解者输出。
- 关于收费、价格、平台支持范围等更多信息，资料中暂未提供。