graph-search
通过FTS5全文搜索代码知识图谱
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:graph-search。 它的用途是:通过FTS5全文搜索代码知识图谱 完整的 Skill 内容见:https://321skill.com/skills/graph-search-x-4/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“搜索代码知识图谱中所有名为 'calculateTotal' 的函数,并返回它们所在的文件和模块。” 它会快速检索图谱,列出包含该函数的节点、文件路径、参数签名以及调用关系,帮助您理解该函数在项目中的使用场景。
介绍
graph-search 是一个专门用于搜索代码知识图谱的 AI Agent Skill。它利用 FTS5 全文搜索引擎,帮助开发者快速定位代码库中的函数、类、类型等结构元素,无需手动翻阅大量文件。当您需要理解大型项目、查找特定实现或进行代码审查时,此工具能显著提升效率。
使用方式简单:在支持 MCP 协议的 AI 编码助手(如 Claude、Cursor、Trae)中配置该 Skill 后,直接以自然语言描述要查找的内容,例如“搜索所有名为 calculateTotal 的函数”或“找到与订单处理相关的类”。它会返回匹配节点的名称、文件路径、所在模块以及关联的依赖关系,您还可以结合上下文进一步提问。
适合以下人群:后端开发人员需要快速熟悉复杂代码库;智能体开发者在构建代码分析工具时作为底层能力;全栈工程师在重构或 debug 时快速定位关键代码段。也适用于技术调研、代码审计等场景。
使用建议:确保已提前构建好代码知识图谱(如通过 clangd、pyright 等工具生成)。该 Skill 对图谱的完整性依赖较高,如果图谱中缺少某些文件或符号,则无法搜索到。另外,FTS5 全文搜索基于文本匹配,对于重名符号可能返回多个结果,建议结合类型或模块名进一步筛选。
核心特点
不同于通用代码搜索(如 grep 或 IDE 搜索),graph-search 专门针对预先构建的结构化代码知识图谱,支持按函数、类、类型等精确语义过滤,并利用 FTS5 实现高效全文检索,结果可直接关联到图谱中的依赖关系。
注意事项
需要预先构建完整的代码知识图谱,对新项目或未建立索引的代码无法直接搜索,且搜索性能受图谱大小影响。
常见问题
如何安装 graph-search?
通常通过 npm 安装:npm install graph-search,然后在 AI 编码助手的 MCP 配置中添加该工具。具体安装方式请参考仓库 README。
支持哪些语言或框架?
取决于构建代码知识图谱的工具,例如 Clang 对 C/C++、Pyright 对 Python 等。该 Skill 本身是语言无关的,只要图谱以 JSON 格式提供即可。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/graph-search-x-4/raw/index.md 读取 graph-search 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/graph-search-x-4/raw/index.md(查看排版版本)