SuperAPI AI 工具集

investigating-a-codebase

设计与创作

查看项目

更新于 10-15 21:36

技能介绍

用途:在规划或设计功能时,先摸清代码库现状,让设计决策基于事实而非假设。适用于验证设计假设(如“设计假定存在 auth.ts,需核实”)、查找可沿用的既有模式(如“当前如何处理 API 错误”)、定位功能或代码(如“用户认证实现在哪里”)、理解组件架构、明确确认某功能是否存在,以及防止对文件路径和结构产生幻觉。不适用于:外部文档可回答的问题、只需读一两个已知文件即可回答的问题、与当前代码库无关的通用编程问题。

主要能力与工作流:从入口点入手(main 文件、index、package.json、配置);用 Glob 模式、Grep 关键词、Read 文件等多种搜索策略;沿 import、引用、组件关系追踪;核实而非假设文件位置与结构;给出确定性结论——精确路径,或说明“未找到”及所用搜索策略。

验证设计假设:先提取设计所期望存在的内容,逐项搜索文件路径、函数、模式、依赖,再对比现实与预期,明确报告:已确认、存在差异、额外发现、缺失。

使用方式:若作为研究子代理运行,直接用 Read/Glob/Grep 及已有工具执行调查,不要派发或调用嵌套子代理。不要止步于首个结果,需多路径交叉验证,确认模式一致而非孤例,同时追踪使用与定义两侧。

报告发现:先给直接答案,再给支撑细节,附精确文件路径与行号、相关代码片段、依赖与版本、配置文件与当前设置、命名与结构及测试约定。对“未找到”要自信处理,说明搜索了什么、在哪里找过,并区分“不存在”与“未能定位”,可建议相关代码作为起点。

常见错误:假设文件位置(应先 Read/Glob 核实)、止步首个结果、位置含糊(应给 src/auth/index.ts:42 这类精确路径)、不记录搜索策略、混淆“未找到”类型、跳过设计假设对比、把假设当事实报告。

限制:资料未提供该技能的安装方式、依赖要求、支持平台或收费信息。