SuperAPI AI 工具集

gs-how

编程与开发

查看项目

更新于 11-15 17:33

技能介绍

gs-how 是一个面向代码库理解的技能,主要用于回答“X 是如何工作的”这类问题,产出适合资深工程师上手子系统的架构级解释。其目标是帮助读者建立可用的心智模型,而不是像带注释的源码那样事无巨细。

主要能力与使用方式:

  • 按复杂度选择路径:若问题范围简单(单个模块、小工具、窄问题如“函数 X 如何工作”),不启动探索者,直接用一个解释者一次性完成探索与解释;若复杂(跨多个文件或服务的子系统、横切特性、完整架构概览),则先分解为 2 至 4 个角度并行探索,再综合所有发现由一个解释者统一输出。存在歧义时说明理解并继续,用户可纠正。

  • 子代理与模型选择:通过运行环境的子代理工具,以只读方式运行探索者和解释者。若用户指定模型则使用指定模型;否则探索者使用快速且能力强的模型,解释者使用环境可用的最强模型。若环境无模型选择,使用会话模型;若无子代理工具,则在当前会话中按相同提示自行完成探索与解释,并说明这一点。

  • 输出结构:解释采用预定义章节,按需取舍,包括 Overview、Key Concepts、How It Works、Where Things Live、Gotchas。展示时仅做清晰度或上下文方面的微调,不进行实质性重写。

适用场景:代码走读、变更前理解现有逻辑、回答模块归属与分层问题(如“这个应该放在哪里”“哪个模块负责”)、子系统架构概览。

限制:资料未提供具体安装命令、收费信息、支持平台或效果数据;其行为依赖运行环境是否支持子代理工具与模型选择,缺失时降级为单会话执行。