graph-build

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

安装使用

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

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

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

使用示例

“请使用graph-build技能分析当前目录下的src文件夹,并生成代码知识图谱。”,它会自动调用tree-sitter解析所有源代码文件,提取函数、类和调用关系,并将这些信息结构化地存入一个SQLite数据库文件中,供你后续查询和分析。

介绍

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

使用时,开发者只需指定目标代码目录,该Skill便会自动调用tree-sitter进行语法解析,提取关键代码实体和关系,并生成或更新本地的SQLite知识图谱数据库。整个过程自动化,无需手动编写解析规则。

该Skill非常适合需要深入分析代码架构、进行代码审计、或为大型项目构建内部文档和智能搜索工具的全栈开发、后端开发和智能体开发者。它尤其有助于处理遗留系统或陌生的开源项目。

建议在初次使用前,确保目标代码语言是tree-sitter支持的主流语言(如JavaScript、Python、Go等)。由于解析过程可能消耗一定计算资源,对于超大型代码库,建议分模块或分批次进行处理。生成的SQLite数据库文件可以方便地集成到其他数据分析或可视化工具中。

核心特点

与仅提供代码统计或简单依赖分析的同类工具不同,graph-build通过精确的AST解析生成细粒度的实体关系图谱,并直接输出结构化的SQLite数据库,便于开发者进行复杂的自定义查询和二次开发,而非仅提供预设的报告。

注意事项

不适合用于分析非文本格式的二进制文件或tree-sitter尚未支持的小众编程语言。

常见问题

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

支持tree-sitter语法解析器所覆盖的主流语言,如JavaScript、TypeScript、Python、Java、Go等,具体取决于安装的tree-sitter语言包。

生成的SQLite数据库包含哪些信息?

通常包含代码文件、函数、类、变量、导入/导出关系以及它们之间的调用、继承、引用等关系,具体字段取决于解析器的实现。

给 AI 助手的安装指引

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

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