SuperAPI AI 工具集

how

编程与开发

查看项目

更新于 11-19 04:05

技能介绍

用途

该技能用于回答“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 规则中的对应行,规则缺失时使用默认值。该资料未提供收费、价格、具体运行平台或效果保证等信息,暂未提供。