graph-build

通过解析代码AST,构建或更新代码知识图谱

安装使用

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

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

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

使用示例

“请使用graph-build分析当前项目的src目录,并生成代码知识图谱。”,它会调用该Skill,遍历指定目录下的源代码文件,利用tree-sitter解析AST,将提取出的实体和关系存入SQLite数据库。完成后,你可以通过查询该数据库来可视化模块间的依赖关系,或快速定位某个函数的调用链。

介绍

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

使用时,开发者只需指定目标代码目录,该Skill便会利用tree-sitter解析代码,自动生成或更新知识图谱。这通常通过一个简单的命令行接口完成,用户无需深入了解AST解析的底层细节。

该Skill非常适合需要深度理解、重构或维护复杂项目的开发者,尤其是全栈开发、后端开发和智能体开发者。他们可以利用图谱快速梳理代码结构、发现隐藏的依赖关系或进行影响范围分析。

建议在项目初期或进行大规模重构前使用,以便建立对代码库的宏观认知。需要注意的是,构建图谱的过程可能对大型项目有一定性能开销,建议在非关键开发时段进行。

核心特点

与仅提供静态代码分析或简单依赖图生成的工具不同,graph-build 深度集成了 tree-sitter 进行精准的AST解析,能够捕获更细粒度的代码语义关系(如函数内部调用、变量作用域),并将结果持久化到轻量级SQLite数据库,便于后续的复杂查询和可视化扩展。

注意事项

不适合需要实时分析代码变更或对构建速度有极高要求的持续集成场景。

常见问题

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

取决于tree-sitter的语法支持,通常包括主流语言如JavaScript、Python、Java、Go等。

生成的图谱数据如何查看?

数据存储在SQLite文件中,可以使用任何SQLite查看工具或自行编写查询脚本进行分析和可视化。

给 AI 助手的安装指引

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

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