SuperAPI AI 工具集

code-graph

编程与开发

查看项目

更新于 10-16 07:19

技能介绍

用途:为目标项目构建、查询和增量更新持久化的代码知识图谱。它属于基础设施类技能,其他技能通过 query 消费该图谱,Flow Conductor 会在会话开始时检查图谱是否为最新。

主要能力:采用双层提取。结构层由 graphify 完成,基于 Tree-sitter 与 Louvain 聚类,输出 AST 节点、边、社区与置信度,结果确定;语义层由模型补充,描述用途、深度与影响,属于上下文判断。graphify 负责解析,模型只做标注,不得用 grep 猜测替换 graphify 的结构数据,也不得覆盖其边。

使用方式:提供三个操作,详细步骤见 build-steps.md。 /code-graph build —— 全量扫描并做语义标注; /code-graph query <subcommand> —— 只读查询,模式见 query-patterns.md; /code-graph update —— 借助 graphify 缓存做增量更新。 图谱已存在时优先用 update 而非 build。

存储:结构图位于 graphify-out/graph.json,来源为 graphify;语义层位于 .scratch/graph/annotations.json,来源为模型。不要将 graph.json 复制到 .scratch/,结构见 graph-schema.md。前置条件见 prerequisites.md,需通过 uv/pipx/pip 安装 graphifyy,用户拒绝时非阻塞。

适用场景:需要跨会话复用项目结构理解、供其他技能查询依赖与社区关系、以及架构健康检查时。Flow Conductor 的 aiops-graph.js 钩子在图谱过期时建议执行 /code-graph build;架构健康流程先运行 graph_build 阶段,缺失或过期则构建,新鲜则跳过,用户可拒绝。/improve-codebase-architecture 提供有机回退。

限制:graphify 是结构骨干,禁止基于 grep 猜测依赖;模型仅添加语义层。graphify 失败时非阻塞,警告后继续;置信度区分 EXTRACTED(1.0)、INFERRED(0.5)、AMBIGUOUS(0.2)。