SuperAPI AI 工具集

how

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:探索代码库并回答“X 如何运作”类问题,输出资深工程师接手子系统级别的架构说明,帮助建立可用的心智模型,而非逐行注释源码。适用于改动前先理解现有实现,以及模块放置、所有权归属和分层问题的判断。

两种模式。Explain(默认):探索代码库并给出清晰解释。Critique:先解释,再调用多个模型独立识别架构问题。

Explain 流程:先解析问题并判断复杂度。简单问题(单个模块、小型工具、窄范围函数)跳过探索代理,由单个解释代理一次性探索并解释;复杂问题(跨多文件或服务的子系统、横切功能、整体架构)先并行启动 2 至 4 个只读探索代理,按不同切面分工,再把发现交给解释代理综合,由解释代理解决重叠与矛盾,最后原样呈现给用户,可轻微润色但不重写。

输出结构通常包含:Overview(概述)、Key Concepts(关键概念)、How It Works(运作流程,用叙述而非伪代码,按需引用文件与函数)、Where Things Live(相关文件与目录)、Gotchas(非显而易见或容易踩坑之处)。并非每个问题都需要全部章节。

Critique 模式:先跑完整 Explain 流程,再启动三名批评者模型,各自获得解释、相关文件路径与评审标准,分别阅读实际代码。最后以务实负责人视角把发现分为 Act on(值得现在修)、Consider(真实关切但成本收益不明)、Noted(有效但低优先级)、Dismissed(错误、缺上下文或风格偏好)。呈现时先给解释,再给批评结论,使只想理解系统的人无需阅读批评部分。

限制:官方资料未提供具体安装、配置或命令信息;模型名称与代理参数属于技能内部定义,实际可用性取决于运行环境。默认输出要求简洁,最多五条要点,除非必要产物或模式需要更多。