gitnexus-guide

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

GitNexus Guide

GitNexus 使用指南

Quick reference for all GitNexus MCP tools, resources, and the knowledge graph schema.

所有GitNexus MCP工具、资源和知识图谱Schema的快速参考。

Always Start Here

始终从这里开始

For any task involving code understanding, debugging, impact analysis, or refactoring:

Read
gitnexus://repo/{name}/context
— codebase overview + check index freshness
Match your task to a skill below and read that skill file
Follow the skill's workflow and checklist

If step 1 warns the index is stale, run
npx gitnexus analyze
in the terminal first.

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

查看
gitnexus://repo/{name}/context
—— 代码库概览 + 检查索引新鲜度
将你的任务与下方的技能匹配，并阅读对应的技能文件
遵循技能的工作流和检查清单

如果步骤1提示索引已过期，请先在终端中运行
npx gitnexus analyze
。

Skills

技能列表

Task	Skill to read
Understand architecture / "How does X work?"	`gitnexus-exploring`
Blast radius / "What breaks if I change X?"	`gitnexus-impact-analysis`
Trace bugs / "Why is X failing?"	`gitnexus-debugging`
Rename / extract / split / refactor	`gitnexus-refactoring`
Tools, resources, schema reference	`gitnexus-guide` (this file)
Index, status, clean, wiki CLI commands	`gitnexus-cli`

任务	需阅读的技能文件
理解架构 / “X是如何工作的？”	`gitnexus-exploring`
影响范围 / “如果我修改X，会有哪些东西被破坏？”	`gitnexus-impact-analysis`
追踪Bug / “X为什么会失败？”	`gitnexus-debugging`
重命名 / 提取 / 拆分 / 重构	`gitnexus-refactoring`
工具、资源、Schema参考	`gitnexus-guide` (本文件)
索引、状态、清理、Wiki CLI命令	`gitnexus-cli`

Tools Reference

工具参考

Tool	What it gives you
`query`	Process-grouped code intelligence — execution flows related to a concept
`context`	360-degree symbol view — categorized refs, processes it participates in
`impact`	Symbol blast radius — what breaks at depth 1/2/3 with confidence
`detect_changes`	Git-diff impact — what do your current changes affect
`rename`	Multi-file coordinated rename with confidence-tagged edits
`cypher`	Raw graph queries (read `gitnexus://repo/{name}/schema` first)
`list_repos`	Discover indexed repos

工具	功能说明
`query`	按流程分组的代码智能 —— 与某个概念相关的执行流
`context`	360度符号视图 —— 分类后的引用、参与的流程
`impact`	符号影响范围 —— 深度1/2/3级别的受影响对象及置信度
`detect_changes`	Git差异影响分析 —— 当前修改会影响哪些内容
`rename`	多文件协同重命名，附带置信度标记的编辑
`cypher`	原生图谱查询（请先查看 `gitnexus://repo/{name}/schema` ）
`list_repos`	发现已索引的代码库

Resources Reference

资源参考

Lightweight reads (~100-500 tokens) for navigation:

Resource	Content
`gitnexus://repo/{name}/context`	Stats, staleness check
`gitnexus://repo/{name}/clusters`	All functional areas with cohesion scores
`gitnexus://repo/{name}/cluster/{clusterName}`	Area members
`gitnexus://repo/{name}/processes`	All execution flows
`gitnexus://repo/{name}/process/{processName}`	Step-by-step trace
`gitnexus://repo/{name}/schema`	Graph schema for Cypher

轻量级阅读内容（约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

Graph Schema

图谱Schema

Nodes: File, Function, Class, Interface, Method, Community, Process Edges (via 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

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