SuperAPI AI 工具集

graph-query

编程与开发

查看项目

更新于 10-15 19:54

技能介绍

用途:当用户询问代码库或 wiki 中事物之间的关系时使用,例如什么连接了两个东西、某功能如何端到端运作、什么依赖什么。图谱由 /graph(graphify)在代码与已提交的 wiki/ 之上构建,本技能只读取它。

主要能力:回答关系与解释类问题,输出固定结构:Graph answer 标题、Answer 纯文字说明、Path / nodes used 列出的边、Citations 每条 EXTRACTED 边的 source_location(path:line)、Gaps 列出图谱未覆盖的部分。每条结论都追溯到图谱边,图谱没有的内容会明确说明,不会凭记忆补全。

使用方式:先确认 graphify-out/graph.json 存在,缺失则停止并提示“No graph yet — run /graph first to build it.”,不要用训练数据回答或重新读文件。按问题选择命令:广泛关联查询用 graphify query "<question>";追踪链路用 graphify query "<question>" --dfs(可用 --budget N 限定);最短路径用 graphify path "A" "B";解释某概念或节点用 graphify explain "X"。若需要多跳或节点查找,可使用 graphify MCP 服务器(python3 -m graphify.serve graphify-out/graph.json → query_graph, get_node, get_neighbors, shortest_path, god_nodes, graph_stats)。

限制与规则:绝不虚构边;查询无结果的部分列入 Gaps,说明图谱未覆盖。graphify 将每条边标记为 EXTRACTED(源码中字面存在)、INFERRED(推断)或 AMBIGUOUS(不确定),只有 EXTRACTED 可作为事实呈现,其余需明确标注。图谱仅覆盖代码与已提交(去标识化)的 wiki/,按设计排除 raw/、.env、.tmp/ 与密钥;超出范围的问题应说明不在图谱中。本技能为 L1 只读:不构建、不提交、不外发、不写文件;重建图谱应使用 /graph。

适用场景:代码库或 wiki 中的依赖关系、调用链、模块连接、最短路径与概念解释。局限:答案质量取决于图谱是否已构建及其覆盖范围;无法从图谱外推。