mcpField
G
gitnexus-guide

gitnexus-guide

github.com/mindfold-ai开发15.1k87 次安装6 周前更新
代码仓库

关于 gitnexus-guide

gitnexus-guide 是 GitNexus 的工具、资源和知识图谱结构速查指南,面向使用代码图谱进行开发的人员。它按任务指引对应技能,并提供工具说明、资源路径和图谱查询示例。

主要功能

  1. 01按任务选择 GitNexus 技能
  2. 02查询代码执行流程与符号引用
  3. 03分析变更影响范围
  4. 04执行多文件协调重命名
  5. 05查阅图谱资源与 Cypher 模式

适用场景

  1. 01了解代码库架构或执行流程
  2. 02评估修改符号的影响范围
  3. 03排查故障或规划代码重构

MCP 相关

GitNexus 通过 MCP 工具提供代码查询、符号上下文、影响分析、重命名和 Cypher 图查询,并公开代码库上下文、流程及模式等资源。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mindfold-ai/trellis --skill gitnexus-guide

安装后在 Claude Code 中输入/gitnexus-guide确认已加载。

详细介绍

GitNexus 指南

GitNexus MCP 工具、资源和知识图谱架构的快速参考。

始终从这里开始

对于任何涉及代码理解、调试、影响分析或重构的任务:

  1. 读取 gitnexus://repo/{name}/context — 查看代码库概览并检查索引是否最新
  2. 将任务与下方的某项技能匹配,并读取该技能文件
  3. 遵循技能中的工作流和检查清单

如果第 1 步提示索引已过时,请先在终端运行 node .gitnexus/run.cjs analyze。

技能

任务要读取的技能
了解架构 / “X 是如何工作的?”gitnexus-exploring
影响范围 / “更改 X 会导致什么问题?”gitnexus-impact-analysis
追踪 Bug / “X 为什么会失败?”gitnexus-debugging
重命名 / 提取 / 拆分 / 重构gitnexus-refactoring
工具、资源、架构参考gitnexus-guide(本文件)
索引、状态、清理、wiki CLI 命令gitnexus-cli

工具参考

工具提供的内容
query按流程分组的代码智能信息 — 与某个概念相关的执行流
context符号的 360 度视图 — 分类引用,以及符号参与的流程
impact符号的影响范围 — 深度为 1/2/3 时可能受影响的内容及置信度
detect_changesGit 差异影响分析 — 当前更改会影响什么
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}/schemaCypher 图架构

图架构

节点: 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

评论

支持 Markdown