用途
该技能用于回答“how does X work”(X 是如何工作的)一类问题:通过探索代码库,产出面向资深工程师接手子系统级别的架构说明,帮助形成可用的心智模型,而不会写成逐行注释源码的程度。也适用于改动代码前的走读,以及放置、归属、分层类问题,例如“这段代码应该放在哪”“应该由谁维护”“属于哪一层”。
主要能力
技能首先评估问题复杂度,并在范围含糊时说明自己的理解再开始探索,用户可随时纠正方向。
简单问题(单个模块、小型工具,或“函数 X 如何工作”这类窄问题)不派探索代理,由一个解释子代理在单次流程中同时完成探索与解释。
复杂问题(跨多个文件或服务的子系统、横切功能、整体架构概览)先并行派出探索代理,再交给解释代理汇总。系统会把问题拆成 2 到 4 个互不重叠的探索角度,在一条消息中同时启动所有探索代理。
在模棱两可时,默认走简单路径。
使用方式
技能内部通过 Task 子代理执行,均为只读模式。探索代理使用通用子代理类型,模型取规则中 how explorer 行的值,缺省为 grok-4.7-xhigh-fast;解释与汇总代理同样使用通用子代理类型,模型取 how explainer 行的值,缺省为 claude-opus-5-5-max。若规则行缺失则用默认值,若值为 auto 或 inherit-parent 则保持模型不设置。若 Task 工具拒绝某个模型标识,则回退到默认值并说明;若默认值也被拒绝,则按错误信息中同系列最接近的有效标识处理。
每个探索代理接收带各自角度的探索提示词。复杂问题在所有探索代理返回后,再启动一个汇总代理,把全部发现合并为一份解释。最后把解释代理的输出呈现给用户,可做澄清性的轻量编辑或补充对话上下文,但不应大幅改写。
输出格式
解释内容使用解释提示词中定义的分区,不适用的分区会省略,包括:概述(Overview)、关键概念(Key Concepts)、工作原理(How It Works)、代码位置(Where Things Live)、注意事项(Gotchas)。
适用场景
- 接手不熟悉的子系统前快速建立架构理解
- 修改代码前走读相关实现
- 判断新代码或模块应放在哪一层、由哪个部分负责
- 需要跨文件、跨服务的整体说明
限制
技能全程只读,不修改代码。模型配置依赖 pstack-models.mdc 规则中的对应行,规则缺失时使用默认值。该资料未提供收费、价格、具体运行平台或效果保证等信息,暂未提供。