graph-build
基于tree-sitter AST构建代码知识图谱
安装使用
复制下面这段提示词发给你的 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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/graph-build-x-7/raw/index.md(查看排版版本)