SuperAPI AI 工具集

graphify-integration

编程与开发

查看项目

更新于 10-15 23:43

技能介绍

用途:把“改动某文件会影响什么”从猜测变成查询。Cavekit 仅在知识图谱可用时使用它,流水线不依赖它。

安装(可选): pip install graphifyy graphify build . # writes graphify-out/graph.json 若文件缺失,该技能返回空操作,所有调用方回退到 grep + ripgrep 搜索。

图结构:NetworkX node-link JSON。节点为符号(函数、类、模块)。边包含:type(DEPENDS_ON | IMPORTS | CALLS | EXTENDS | IMPLEMENTS)、confidence(EXTRACTED 高 | INFERRED 中 | AMBIGUOUS 低)、community(簇 ID,用于把大图切分为可读片段)。

CLI(通过 cavekit-tools): cavekit-tools.cjs graph-status # is the graph present? cavekit-tools.cjs graph-query --term auth # search by name substring cavekit-tools.cjs graph-dependents --file X # who imports/calls this? cavekit-tools.cjs graph-summary # top-level community list 这些子命令为可选扩展,基础 cavekit-tools.cjs 不含它们,仅在 graphify-out/graph.json 存在时激活。

各阶段用法:Draft(/ck:sketch)查询已有符号,避免新 kit 名与现有代码冲突;Map(/ck:map)用 community ID 把任务划分为连贯层级,受影响符号无共享边的两个任务可并行;Research(ck:researcher)先查已有再取外部,图能回答就跳过网络;Build(/ck:make)只加载当前任务文件的子图,上下文更小、更快更省;Review/Inspect 计算 diff 的影响半径,触及文件 ∪ 传递依赖 = 审查范围。

限制:低置信度边(AMBIGUOUS)未经核实不可当作事实;影响半径含 AMBIGUOUS 边时回退 grep 确认。图缺失时所有 graph-* 查询返回 {"available": false, "fallback": "grep"},调用方检查 available 后回退 Grep + Read,不抛错,属降级而非失败。