SuperAPI AI 工具集

graph-search

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:在代码知识图谱中按名称搜索代码实体,用于通过函数名、类名或限定路径定位代码位置。它查询的是 .gauntlet/graph.db 文件,而非直接扫描源码。

主要能力:接受搜索词,运行查询脚本:python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_query.py --action search --query "<term>" --limit 20。可用 --kind Function 只搜函数,--kind Class 只搜类。结果展示限定名、文件路径、行号与相关性评分,最多为 --limit 条,并会询问是否读取排名第一的结果源码文件。查询智能会识别模式:PascalCase(如 UserService)提升类与类型结果,snake_case(如 get_users)提升函数结果,点号路径(如 app.models.User)提升限定名匹配。

使用前提:图必须先构建。若 .gauntlet/graph.db 不存在,应提示运行 graph-build 技能,而非静默失败。若查询返回 count: 0,只有在 graph_query.py --action status 显示 node_count 大于零时,才能报告为“不在图中”;未构建的图或用未启用 tree-sitter 构建的图会对任何查询都返回零,此零结果不能说明代码库中没有该实体。

不适用场景:图缺失或过期时(应先用 gauntlet:graph-build);评估某次变更的影响范围时(应使用 pensive:blast-radius)。

限制:资料未提供该工具的收费、价格、支持平台与具体安装步骤,暂未提供。