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-5/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'使用 graph-build 分析当前项目的代码,构建知识图谱并存储到 SQLite',它会自动扫描项目中的所有源码文件,通过 tree-sitter 解析出每个文件的 AST,提取函数、类、变量、导入等节点及其调用关系,将结果存入本地 graph.db 文件。之后你可以查询'展示所有未被引用的函数'或'找出 main 函数的所有调用链',快速定位冗余代码或理解流程。

介绍

graph-build 解决的是代码理解与结构化分析的问题。在大型项目中,手动梳理函数调用关系、类继承链、变量依赖等非常耗时,且容易遗漏。该工具通过 tree-sitter 解析源代码生成抽象语法树(AST),并持久化到 SQLite 数据库中,构建出可查询的代码知识图谱,帮助开发者快速掌握项目架构。

使用方式非常简单:安装后,在项目根目录运行 graph-build 命令,它会自动扫描支持的编程语言文件,提取关键节点(函数、类、接口、变量等)及其关联关系,存入本地 SQLite 文件。之后你可以通过 SQL 查询或内置 CLI 命令进行检索,例如查找某个函数的所有调用方、识别未引用的代码段等。增量更新也受支持,只重新解析变更的文件。

最适合后端开发、智能体开发、运维工程师等需要频繁阅读和理解陌生代码库的技术人员。尤其适合代码重构、代码审查、遗留系统分析、知识库搭建等场景。对于大型 monorepo 或多语言项目,graph-build 的跨语言 AST 支持能提供统一的图谱视图。

使用前建议先安装好相应语言的 tree-sitter 解析器,并确保项目文件编码规范。初次构建大型项目可能耗时较长,建议在非高峰期执行。图谱数据存储在本地,不依赖外部服务,适合离线环境。注意它不自动分析运行时行为,仅基于静态语法结构。

核心特点

与同类工具相比,graph-build 使用 tree-sitter 解析语法树,支持多种编程语言(如 Python、JavaScript、Go、Rust 等),并将结果持久化到 SQLite 数据库,便于增量更新和自定义查询,而非仅输出临时 JSON 或内存图。

注意事项

不适合需要运行时数据或动态调用信息的场景,且大型项目首次构建可能较慢。

常见问题

支持哪些编程语言?

取决于 tree-sitter 的解析器,常见语言如 Python、JavaScript、TypeScript、Go、Rust、C/C++ 等均支持,具体可查看 tree-sitter 官方支持的语法列表。

能否增量更新?

可以,graph-build 会检测文件修改时间,只重新解析变更的文件,避免全量重建。

给 AI 助手的安装指引

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

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