SuperAPI AI 工具集

how

编程与开发

查看项目

更新于 10-16 10:54

技能介绍

How 是一个用于代码库理解的 Cursor 插件技能,主要用于回答“X 是怎么工作的?”这类问题,也适用于在修改某段代码之前进行代码走查,以及处理位置、归属与分层相关的疑问(例如“这段代码应该放在哪里”“哪一层负责什么”)。它的目标是产出架构层面的解释:既能帮助资深工程师在接手某个子系统时建立可用的心智模型,又不会详细到像逐行注释的源码。

工作方式

每次派发都通过 Task 子代理完成,使用 subagent_type: generalPurpose 和 readonly: true。

探索者(Explorer)使用 pstack-models.mdc 规则中的 how explorer 一行(默认 grok-4.7-xhigh-fast);每个解释者(Explainer)使用 how explainer 一行(默认 claude-opus-5-5-xhigh)。应将 model 设为该行的值;若规则或该行缺失,则使用默认值。当值为 auto 或 inherit-parent 时,不设置 model。如果 Task 工具拒绝了某个 slug,就改用默认值并说明这一点;如果默认值也被拒绝,则从其错误信息中选用同族中最接近的有效 slug。

流程

  1. 评估复杂度

如果范围不明确,先说明你的理解再开始探索,用户可以进行纠正。

简单情况(单个模块、小型工具、范围很窄的问题,例如“函数 X 是怎么工作的”):不使用探索者。直接派发一个解释者,在一次过程中完成探索与解释,基于 references/explainer-prompt.md 构建,但不包含 explorer-findings 部分。直接进入第 4 步。

复杂情况(跨多个文件或服务的子系统、横切功能、完整的架构概览):进入第 2 步。

有疑问时,走简单路径。

  1. 探索(仅复杂情况)

把问题拆解为 2 到 4 个角度,每个角度是该子系统的不同切片。在一条消息中同时派发所有探索者,每个都带上 references/explorer-prompt.md 并填入其对应角度。

  1. 综合(仅复杂情况)

所有探索者返回后,派发一个解释者,带上 references/explainer-prompt.md 并填入所有探索者的发现。

  1. 呈现

呈现解释者的输出。为清晰起见做轻度编辑,或补充来自对话的上下文是可以的,但不要大幅改写它。

输出格式

解释使用 references/explainer-prompt.md 中定义的章节,不适用于当前情况的章节可以省略:Overview、Key Concepts、How It Works、Where Things Live、Gotchas。

适用场景

  • 询问“X 是怎么工作的”,需要一个子系统的架构级理解。
  • 在改动某处代码前,希望先了解现状再做变更。
  • 需要判断某段逻辑或某个文件应该放在哪一层、归属于谁。

限制

  • 采用只读方式运行,不进行代码修改。
  • 具体模型取值依赖 pstack-models.mdc 规则中对应行的配置;规则或行缺失时回退默认值。
  • 简单问题与复杂问题的处理路径不同;有疑问时默认走简单路径。
  • 关于收费、价格、平台支持范围及具体效果,资料中暂未提供。