SuperAPI AI 工具集

code-graph

编程与开发

查看项目

更新于 10-15 19:54

技能介绍

用途:Code Graph 是一个面向代码导航的图谱技能,核心原则是“图谱优先,文件其次”。在读取文件或使用 grep 之前,先查询代码图谱,用于符号查找、函数搜索、依赖分析和变更影响范围(blast radius)检测。图谱在思考与规划阶段同样适用,而字符串字面量、日志消息、配置值等代码结构之外的内容仍适合用 grep。

主要能力:通过 MCP 提供 14 个工具,支持 64 种语言、亚毫秒查询、零依赖。索引与状态类包括 index_repository、index_status、list_projects;查询与导航类包括 search_graph(按名称模糊查找符号)、search_code、get_code_snippet、get_graph_schema、query_graph;分析类包括 trace_call_path(追踪调用链)、detect_changes(识别变更文件与影响范围)、get_architecture(高层模块结构);管理类包括 delete_project、manage_adr、ingest_traces。

使用方式:MCP 服务器在项目根目录的 .mcp.json 中配置,命令为 codebase-memory-mcp。安装脚本位于 ~/.claude/install-graph-tools.sh。推荐工作流为:规划(get_architecture + search_graph)、定位(search_graph)、理解(get_code_snippet)、影响评估(detect_changes)、追踪(trace_call_path)、修改文件、再次用 detect_changes 验证。图谱通过三层自动保持新鲜:文件监视器、会话启动自动索引、提交后钩子;存储于 .code-graph/ 目录,仅在大型重构后需要手动执行 index_repository。

适用场景:查找函数或类定义、获取签名与文档、查找所有调用者、追踪依赖链、评估修改影响、理解项目架构、搜索代码模式。

限制:完整实现修改仍需读取对应文件;字符串与配置内容仍应用 grep;图谱陈旧警告需通过 index_status 检查。官方文本未提供收费、价格、平台或效果数据,暂未提供。