用途
how 是一个 pstack 技能,用于回答“X 是如何工作的”这类问题,或在改动代码之前先理解某处的实现。它也处理放置、归属与分层问题,例如“这段逻辑应该放在哪里”“哪个……”。它的目标是为资深工程师提供上手某一子系统所需的架构解释:足以建立有效的心智模型,又不会细到读起来像带注释的源码。
主要能力
- 探索代码库并回答实现原理类问题。
- 按主题产出架构说明,内容包含概述、关键概念、工作原理、代码位置与注意事项等分段,并省略不适用的部分。
- 支持简单与复杂两种处理路径。
使用方式
技能通过名称引用:加粗或反引号中的技能名,或以 /<name> 形式运行,对应本技能目录旁的 ../<name>/SKILL.md;不带前缀的原则名对应 ../principle-<name>/SKILL.md,读取后遵循。多数 pstack 技能仅供用户手动调用,因此技能工具无法加载它们。
子代理以 Rex worker pane 方式工作:按 ../rex-subagents/SKILL.md 生成、等待和关闭,默认值取自 ../poteto-mode/SKILL.md 的 Subagents 部分。每次生成的 worker 都带 --read-only 和填写好的提示模板作为简报。explorer 命名为 how explorer <angle>,使用 ~/.config/pstack/pstack-models.md 中的 how explorer 行;explainer 命名为 how explainer,使用 how explainer 行,并将条目原样传给 subagent spawn --entry。若值为 auto 或 inherit-parent,或文件、行缺失,则在自己的 harness 和默认模型上运行该 worker;若无文件则说明并建议 /setup-pstack。若 worker 的模型被拒绝,则在该 harness 的默认模型上运行并说明。推理级别与速度按 poteto-mode 技能的 Subagents 部分为任务选择。生成后结束当前轮次,由唤醒行启动下一轮。
流程如下:
- 评估复杂度。若范围不明确,说明自己的理解并开始探索,用户可纠正。简单情况(单一模块、小型工具、“函数 X 如何工作”这类窄问题)不派 explorer,直接生成一个 explainer 一次完成探索与解释,提示来自 references/explainer-prompt.md 且不含 explorer-findings 部分,然后进入第 4 步。复杂情况(跨多个文件或服务的子系统、横跨多个切面的功能、完整架构概览)进入第 2 步。存疑时走简单路径。
- 探索(仅复杂情况)。把问题拆成 2 至 4 个角度,每个角度是子系统的一个不同切面;在一个轮次内生成所有 explorer,各自填入 references/explorer-prompt.md 和对应角度。
- 综合(仅复杂情况)。所有 explorer 返回后,生成一个 explainer,填入 references/explainer-prompt.md 与全部 explorer 的发现。
- 呈现。展示 explainer 的输出,可为清晰或结合对话上下文做轻微修改,但不要大幅重写。
适用场景
- 想弄懂某个函数、模块或子系统如何工作。
- 在修改代码前理解现有实现。
- 判断某段逻辑应放在哪里、由谁负责、如何分层。
- 需要一份面向资深工程师的架构级说明,而不是逐行源码注释。
限制
- 多数 pstack 技能仅供用户调用,技能工具无法加载。
- 需读取 references 下的提示模板文件,仓库未提供其具体内容。
- 模型配置依赖 ~/.config/pstack/pstack-models.md,缺失时回退默认模型并提示 /setup-pstack。
- 未提供安装命令、收费与价格信息。