SuperAPI AI 工具集

how

编程与开发

查看项目

更新于 11-06 21:02

技能介绍

用途

how 用于回答“X 是如何工作的”这类问题,也用于在修改代码之前做代码走查,以及处理放置、归属与分层相关的问题(例如“这段逻辑应该放在哪里”“哪一层负责什么”)。目标是产出资深工程师刚接手某个子系统时所需的那种架构解释:足以建立可用的心智模型,但不会详细到像带注释的源代码。

使用前提

每个会话中,在遵循本技能之前先读取一次宿主适配器。它负责把上游 Cursor 专属的工具、模型、路径与权限指令映射到你的宿主环境,并设定权限边界。

主要能力与执行方式

每次派发都是一个 Task 子代理,参数为 subagent_type: generalPurpose 和 readonly: true。探索者使用模型规则中的 how explorer 行(默认 inherit-parent),每个解释者使用 how explainer 行(默认 claude-opus-5-5-xhigh)。将 model 设为该行的值;如果规则或该行缺失,则使用默认值。当值为 auto 或 inherit-parent 时,不设置 model。如果 Task 工具拒绝某个 slug,改用默认值并说明;如果默认值也被拒绝,则从错误信息中选取同一家族中最接近的有效 slug。每个子代理的推理级别以及快速或标准速度,按 saltmode 技能的 Subagents 一节来选定。

1. 评估复杂度

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

  • 简单(单个模块、小型工具,或“函数 X 如何工作”这类窄问题):不使用探索者。派发一个解释者,在一次过程中完成探索与解释,基于 references/explainer-prompt.md 构建,但不含 explorer-findings 部分。然后进入第 4 步。
  • 复杂(跨多个文件或服务的子系统、横切特性、完整架构概览):进入第 2 步。

拿不准时,走简单路径。

2. 探索(仅复杂情况)

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

3. 综合(仅复杂情况)

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

4. 呈现

呈现解释者的输出。为清晰或补充对话上下文做轻微编辑是可以的,不要大幅重写。

输出格式

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

适用场景

  • 接手陌生子系统时快速建立架构认知。
  • 修改代码前理解现有实现与依赖关系。
  • 讨论新代码应放在哪一层、由谁负责。

限制

资料未提供该技能的具体安装命令、支持的宿主平台清单、收费或价格信息,也未说明其与 saltmode 技能之外的其他依赖关系。