graph-build

通过AST解析与SQLite构建代码知识图谱

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:graph-build。
它的用途是:通过AST解析与SQLite构建代码知识图谱
完整的 Skill 内容见:https://321skill.com/skills/graph-build-x/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘请使用graph-build分析当前项目的src目录,并告诉我哪个函数被调用的次数最多。’ 它会自动解析代码,构建知识图谱并查询数据库,返回函数调用次数的统计结果。或者,你可以说:‘帮我找出所有直接依赖UserService这个类的文件。’ 它能通过图谱关系快速给出依赖该类的文件列表。

介绍

graph-build Skill 旨在解决开发者难以系统化理解、分析和复用复杂代码库结构的问题。它通过解析代码的抽象语法树(AST),将代码中的类、函数、变量及其关系等关键信息提取并存储到SQLite数据库中,从而构建一个结构化的代码知识图谱。

使用时,开发者只需指定目标代码目录,该Skill便会自动调用tree-sitter进行语法解析,识别代码元素及其间的调用、继承等关系,并将这些信息持久化到本地SQLite数据库文件中。整个过程自动化,无需手动编写复杂的解析逻辑。

该Skill非常适合需要深入分析代码架构、进行代码审计、生成文档或构建代码智能辅助工具的全栈开发、后端开发及智能体开发者。对于维护大型遗留项目或进行技术调研的团队尤为有用。

建议在初次使用时,先在小规模、结构清晰的代码库上进行测试,以熟悉其输出格式。由于依赖tree-sitter的语法解析能力,对于非常小众或语法特性较新的编程语言,可能需要检查其支持度。生成的数据库文件路径建议纳入.gitignore,避免将可能包含代码信息的衍生数据误提交到版本库。

核心特点

与仅提供代码搜索或简单统计的工具不同,graph-build通过tree-sitter生成精准的AST,并构建出包含实体与关系的图结构,为基于代码关系的复杂查询(如影响范围分析、依赖追踪)提供了结构化数据基础。

注意事项

不适合用于分析非文本格式的二进制文件或对实时编码过程中的即时语法错误进行检测。

常见问题

graph-build支持哪些编程语言?

支持tree-sitter语法解析器覆盖的所有语言,如JavaScript、Python、Java、Go等,具体取决于本地安装的tree-sitter语法库。

生成的数据库可以用来做什么?

可用于代码可视化、自动化文档生成、架构异味检测、影响范围分析,或作为其他AI智能体分析代码结构的输入数据源。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/graph-build-x/raw/index.md 读取 graph-build 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。