graph-build

基于tree-sitter AST构建代码知识图谱

代码质量 后端开发智能体开发全栈开发 构建知识图谱 通用 ★ 932 更新于 2026-08-01

安装使用

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

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

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

使用示例

'请使用graph-build工具分析当前React项目的代码依赖关系,构建知识图谱',它会自动扫描项目中的.jsx/.tsx文件,通过tree-sitter解析AST,提取组件、Hooks、Props等结构,并将调用关系存储到SQLite数据库中,最后输出一个可查询的依赖表。

介绍

graph-build 通过 tree-sitter 解析代码的抽象语法树(AST),将函数、类、变量、调用关系等结构化信息抽取并存入 SQLite 数据库,形成可查询的代码知识图谱。它解决的是大型项目中代码依赖关系混乱、理解成本高的问题,帮助开发者快速定位模块间的引用、继承和调用链路,从而提升代码审查、重构和文档生成的效率。

使用方法很简单:在项目根目录下运行 graph-build 命令,它会自动扫描支持的编程语言文件,解析 AST 并构建知识图谱。你可以通过 SQL 或内置查询接口检索特定函数被哪些函数调用、某个类继承了哪些基类、模块之间的依赖关系等。支持增量更新,只处理变更的文件,避免全量重建。

适合后端开发、智能体开发、全栈开发等需要深入理解代码结构的角色。尤其适用于维护大型代码库、进行代码重构、编写技术文档或培训新成员快速上手项目。对代码依赖关系可视化有需求的团队也能从中受益。

建议在项目规模适中(文件数万级别)时使用,因为 SQLite 单机存储对超大规模项目可能成为瓶颈。首次构建会消耗一定时间,建议在开发环境先运行,再结合 CI/CD 流程定期增量更新。注意确保 tree-sitter 解析器支持你所使用的语言扩展。

核心特点

与同类工具(如 CodeGraph、depends)相比,graph-build 基于 tree-sitter 提供精确的语法级分析,支持数十种编程语言,且使用 SQLite 持久化存储便于离线查询和增量更新,无需依赖外部图数据库。

注意事项

不适合需要实时在线协作或处理超大规模(百万级文件)代码库的场景,SQLite 单机存储和单线程解析限制了并发能力。

常见问题

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

支持所有 tree-sitter 官方及社区解析器覆盖的语言,包括 JavaScript、TypeScript、Python、Go、Rust、Java、C/C++ 等常见语言,具体列表可查看 tree-sitter 文档。

如何增量更新知识图谱?

运行 graph-build update 命令,它会自动比较文件修改时间戳,只重新解析变更的文件并更新 SQLite 数据库,无需全量重建。

给 AI 助手的安装指引

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

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