SuperAPI AI 工具集

gitnexus-guide

编程与开发

查看项目

更新于 10-16 09:17

技能介绍

GitNexus Guide 是关于 GitNexus 本身的快速参考,用于回答用户提出的与 GitNexus 相关的问题,例如可用工具有哪些、如何查询知识图谱、MCP 资源、图谱 schema 或工作流参考。

用途 它汇总了所有 GitNexus MCP 工具、资源和知识图谱 schema,并给出处理代码理解、调试、影响分析或重构任务时的统一起点与技能索引。

推荐起点 对于任何涉及代码理解、调试、影响分析或重构的任务,文档建议:

  1. 读取 gitnexus://repo/{name}/context —— 获取代码库概览并检查索引新鲜度;
  2. 将任务匹配到下表中的某个技能并读取该技能文件;
  3. 按照该技能的工作流与检查清单执行。 如果第 1 步提示索引已过期(stale),需要先在终端运行:node .gitnexus/run.cjs 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:发现已索引仓库(分页——limit/offset)。

list_repos 的分页 list_repos 采用分页,以避免大型注册表被 MCP/LLM 的 token 限制截断。它接受可选的 limit(默认 50,最大 200)和 offset,返回结构如下: { "repositories": [ { "name": "...", "path": "...", "indexedAt": "...", "lastCommit": "...", "stats": { } } ], "pagination": { "total": 437, "limit": 50, "offset": 0, "returned": 50, "hasMore": true, "nextOffset": 50 } } 要枚举全部仓库,持续调用并把 offset 设为 pagination.nextOffset,直到 hasMore 为 false: list_repos {} → repos 1–50, nextOffset 50, hasMore true list_repos { offset: 50 } → repos 51–100, nextOffset 100, hasMore true … list_repos { offset: 400 } → repos 401–437, hasMore false (done) 说明:offset ≥ total 返回空页(仍会报告 total)。超出范围或格式错误的 limit/offset(非整数、limit 不在 [1, 200]、offset < 0)会被明确报错拒绝——limit 超过最大值会被拒绝,而不是静默截断上限。排序是确定性的(先按小写名称,再按路径),因此在注册表不变时分页不会跳过或重复条目。

资源参考 以下为用于导航的轻量读取(约 100–500 tokens):

  • 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。 示例查询: MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"}) RETURN caller.name, caller.filePath

适用场景 适用于询问 GitNexus 本身的能力与用法,包括可用工具、知识图谱查询方式、MCP 资源、图谱 schema、工作流参考与技能选择。

限制 资料未提供 GitNexus 的安装方式、收费与价格信息、支持平台、具体运行效果或使用步骤细节,这些内容暂未提供。