SuperAPI AI 工具集

codebase-search

编程与开发

查看项目

更新于 10-16 04:58

技能介绍

用途:该技能用于“改代码前的仓库导航”,回答“它在哪里、谁在用、我该先看什么”,即使请求没有出现“搜索”字样。不适合作为主流程的场景包括:已定位区域后的根因诊断、行为保持的重构或迁移规划、对具体 diff/PR 的评审、需要持久化全仓库结构图。

主要能力:将请求规范化为一个主搜索包,并给出仓库形态(app、infra、content、game、mixed、unknown)、搜索目标(locate、references、ownership、impact、archaeology)、范围提示与后续路由。可选六类包:exact-text(已知字符串、环境变量、路由、标志、错误文本)、symbol-indexed(定义、引用、调用点)、structural(语法形状,借助 ast-grep、Semgrep、Comby 等 AST 工具)、config-content(Terraform/Kubernetes、Markdown/MDX、Hugo/Next 内容、游戏配置与资产)、hosted-search(远程或跨仓库查找)、graph-path(依赖与路径追踪)。

使用方式:先选择能最快降低不确定性的较便宜包;读取前至少做一次范围收窄(按目录/包、文件类型,区分手写文件与生成/第三方目录,从入口、加载器、配置模式、测试、示例或构建脚本入手);匹配后只读最可能的定义/归属文件、1–3 个重要消费者,以及必要时的配置/测试/示例/构建文件;按“搜索简报、最佳入口、关键证据(path:line)、可能流程/归属、下一步路由”返回证据地图,而非终端输出。

适用场景:编辑前定位、影响面分析、配置/内容归属、结构模式盘点、仓库考古。限制与边界:搜索不再是瓶颈时应及时路由到调试、日志分析、重构、代码评审或 graphify;用正则近似结构匹配时需标注置信度;本页未提供安装方式、价格与具体命令示例,暂未提供。