SuperAPI AI 工具集

codebase-search

通用与其它

查看项目

更新于 10-15 19:54

技能介绍

用途:在陌生代码库中查找定义、调用点、导入或配置归属;追踪功能、缺陷或数据流;在重构前做影响分析;定位测试、示例或相关文件。支持按精确文本、概念功能、文件模式或结构语法搜索。

主要能力:先对请求分类(精确已知标记、概念功能、文件发现、结构查询、影响分析),再选择最小可靠搜索面:精确文本用 ripgrep,未知文件名用 glob 或文件列表,描述行为时用语义、符号或 AST 风格搜索,找到候选后再直接读文件,最后才参考 git 历史。找到归属文件后,阅读周边代码、相关调用点、导入、处理器、测试与配置,避免只凭单个匹配下结论。

使用方式:按调查模式组织流程,如缺陷排查按失败信号→抛出/日志点→调用路径→测试;功能走查按入口→服务/模型→副作用→测试;影响分析按定义→调用点→测试→接口边界;配置发现按配置文件→环境读取→加载/引导路径。仅在需要时加载参考文件:search-strategy-matrix.md、ripgrep-and-structural-patterns.md、investigation-playbooks.md。

适用场景:定位错误字符串、追踪 UserService.create 等符号的改动影响、理解功能流程、查找配置归属。

限制:若任务核心是根因分析、代码评审、重构或交付计划,应改用对应技能;git 历史仅作辅助,不能替代当前代码;一个匹配只是线索而非证据。具体命令示例与完整配方未在资料中提供。