graph-build
通过解析代码AST构建知识图谱,辅助理解复杂项目结构。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:graph-build。 它的用途是:通过解析代码AST构建知识图谱,辅助理解复杂项目结构。 完整的 Skill 内容见:https://321skill.com/skills/graph-build-x-3/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请使用graph-build分析当前项目的src目录,帮我找出所有未被任何其他函数调用的工具函数。’,它会运行解析器构建知识图谱,并查询数据库,列出那些在调用关系中处于‘孤立’状态的函数,帮助你识别可能 dead code。或者,你可以说:‘我想了解这个React组件库的组件间继承关系’,它会生成图谱并可视化或输出关系列表。
介绍
graph-build Skill 旨在解决开发者在面对大型或陌生代码库时,难以快速理解其整体架构、模块依赖和核心逻辑的问题。它通过解析代码的抽象语法树(AST),将代码元素(如函数、类、变量)及其关系结构化地存储到SQLite数据库中,从而构建一个可视、可查询的代码知识图谱。
使用时,您只需指定目标代码目录,该Skill便会自动调用tree-sitter解析多种编程语言,提取关键代码实体和它们之间的调用、继承等关系,并生成一个本地的知识图谱数据库。整个过程无需复杂的配置,即可将代码转换为结构化的数据。
它非常适合需要深入分析代码库的开发者,例如接手遗留系统、进行代码审计、研究开源项目,或为团队构建内部代码知识库。全栈开发、后端开发以及负责代码质量和架构评审的工程师都能从中受益。
建议在初次分析大型项目前,先在一个小型或熟悉的项目上试用,以了解其输出格式和查询方式。请注意,它主要提供静态分析,对于高度动态或依赖运行时信息的代码,图谱可能不完整。定期更新图谱以同步代码变更,能保持信息的有效性。
核心特点
与同类代码分析工具相比,它不局限于生成调用图或度量报告,而是构建一个可持久化查询的代码知识图谱数据库,支持更灵活、深度的代码关系探索和自定义分析。
注意事项
不适合分析严重依赖动态特性、反射或运行时生成的代码,图谱可能无法完整反映其真实结构。
常见问题
graph-build支持哪些编程语言?
基于tree-sitter,支持其语法解析器覆盖的语言,如JavaScript、Python、Java、Go等,具体取决于安装的tree-sitter语言包。
生成的图谱数据如何查询和使用?
数据存储在SQLite中,您可以使用任何SQLite客户端或编写脚本执行SQL查询,来分析函数调用链、查找特定模式的代码等。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/graph-build-x-3/raw/index.md 读取 graph-build 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/graph-build-x-3/raw/index.md(查看排版版本)