跳转到内容
pstack 中文学习站

how

你在看 pstack 0.15.17 时的版本,最新版在这里

探索代码库,回答「X 是怎么工作的」这类问题。讲解的深度,以资深工程师刚接手一个子系统时的需要为准。要足够建立一个能用的心智模型,又不能细到读起来像加了注释的源码。

下面每次启动都是一个 Task 子代理,subagent_type 为 generalPurpose,readonly 为 true。探索者用 pstack-models.mdc 这条 rule 里的 how explorer 那一行(默认 grok-4.7-xhigh-fast),每个讲解者用 how explainer 那一行(默认 claude-opus-5-5-xhigh)。把 model 设为那一行的值。rule 或那一行不存在时,设为默认值。值为 auto 或 inherit-parent 时,不设 model。Task 工具拒绝某个 slug 时,改用默认值,并说明这一点。Task 工具连默认值也拒绝时,从它的报错信息里挑同一系列中最接近的有效 slug。

范围不明确时,说出你的理解,然后开始探索。用户可以再调整方向。

  • 简单(单个模块、一个小工具,或「函数 X 是怎么工作的」这样的窄问题):不启动探索者。启动一个讲解者,一次完成探索和讲解。提示词用 references/explainer-prompt.md,去掉探索者 finding(探索中查到的事实和结论)那一节。转到第 4 步。
  • 复杂(跨多个文件或服务的子系统、横跨多处的功能、完整的架构总览):转到第 2 步。

拿不准时,走简单路径。

把问题拆成 2 到 4 个角度,每个角度对应子系统里不同的一块。在同一条消息里启动全部探索者,每个都带上 references/explorer-prompt.md,并填上各自的角度。

所有探索者都返回后,启动一个讲解者,用 references/explainer-prompt.md,并填入每个探索者的 finding。

把讲解者的输出呈现出来。为了更清楚,或为了补上对话里的上下文,可以小改。不要大幅改写。

讲解使用 references/explainer-prompt.md 里定义的几节,不适用的就去掉:概览、关键概念、工作原理、代码位置、容易踩的坑。