SuperAPI AI 工具集

gitnexus-guide

编程与开发

查看项目

更新于 10-16 02:16

技能介绍

GitNexus Guide 是 GitNexus 的速查与索引文档,面向需要了解 GitNexus 本身的场景,包括可用工具、如何查询知识图谱、MCP 资源、图谱 schema 以及工作流参考。

用途与定位

该文档是 GitNexus MCP 工具、资源和知识图谱 schema 的快速参考。当用户询问 GitNexus 本身时使用它。

开始流程

文档建议:对于任何涉及代码理解、调试、影响分析或重构的任务,应先读取 gitnexus://repo/{name}/context,获取代码库概览并检查索引新鲜度;然后把任务匹配到下面列出的技能文件并阅读该文件;最后遵循该技能的工作流和检查清单。如果第一步提示索引已过期,需先在终端运行 npx gitnexus analyze。

相关技能索引

文档按任务列出应阅读的技能:理解架构或回答“X 是如何工作的”对应 gitnexus-exploring;爆炸半径或“如果我修改 X 会破坏什么”对应 gitnexus-impact-analysis;追踪缺陷或“为什么 X 失败”对应 gitnexus-debugging;重命名、抽取、拆分或重构对应 gitnexus-refactoring;工具、资源、schema 参考对应 gitnexus-guide(即本文件);索引、状态、清理、wiki 等 CLI 命令对应 gitnexus-cli。

工具参考

文档列出以下工具及其作用:query 提供按进程分组的代码智能,即与某个概念相关的执行流;context 提供 360 度符号视图,包括分类引用及其参与的过程;impact 提供符号爆炸半径,即以置信度表示深度 1/2/3 的破坏范围;detect_changes 提供基于 Git diff 的影响分析,即当前改动会影响什么;rename 提供带置信度标注编辑的多文件协同重命名;cypher 提供原始图谱查询(需先读取 gitnexus://repo/{name}/schema);list_repos 用于发现已建立索引的仓库。

资源参考

文档列出用于导航的轻量读取资源(约 100-500 token):gitnexus://repo/{name}/context 提供统计信息与过期检查;gitnexus://repo/{name}/clusters 提供所有功能区域及其内聚分数;gitnexus://repo/{name}/cluster/{clusterName} 提供区域成员;gitnexus://repo/{name}/processes 提供所有执行流;gitnexus://repo/{name}/process/{processName} 提供逐步跟踪;gitnexus://repo/{name}/schema 提供用于 Cypher 的图谱 schema。

图谱 Schema

节点包括:File、Function、Class、Interface、Method、Community、Process。边通过 CodeRelation.type 表示,包括:CALLS、IMPORTS、EXTENDS、IMPLEMENTS、DEFINES、MEMBER_OF、STEP_IN_PROCESS。文档给出的 Cypher 示例为:MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"}) RETURN caller.name, caller.filePath。

限制与缺失信息

资料未提供 GitNexus Guide 的定价、收费方式、平台支持范围、性能指标或效果说明,这些内容暂未提供。资料也未说明安装方式,仅提到在索引过期时可运行 npx gitnexus analyze。