关于 gitnexus-guide
供代码理解、调试、影响分析和重构使用的 GitNexus 参考技能,介绍工具、资源与图谱结构,并按任务指引后续操作。
主要功能
- 01工具与资源参考
- 02查看仓库上下文
- 03代码图谱结构概览
- 04按任务指引技能
适用场景
- 01了解代码库的工作方式
- 02修改前追踪依赖
- 03查找调试工作流
MCP 相关
介绍 GitNexus 的 MCP 工具和资源,包括仓库上下文、图查询、影响分析与变更检测。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tony363/ superclaude --skill gitnexus-guide安装后在 Claude Code 中输入/gitnexus-guide确认已加载。
详细介绍
GitNexus 指南
GitNexus MCP 工具、资源和知识图谱架构的快速参考。
始终从这里开始
对于任何涉及代码理解、调试、影响分析或重构的任务:
- 读取
gitnexus://repo/{name}/context— 代码库概览 + 检查索引是否最新 - 将任务与下方的技能匹配,并阅读对应的技能文件
- 遵循该技能的工作流和检查清单
如果第 1 步提示索引已过期,请先在终端中运行
npx gitnexus analyze。
技能
| 任务 | 要阅读的技能 |
|---|---|
| 理解架构 / “X 是如何工作的?” | gitnexus-exploring |
| 影响范围 / “如果我更改 X,会有什么问题?” | gitnexus-impact-analysis |
| 追踪 Bug / “X 为什么会失败?” | gitnexus-debugging |
| 重命名 / 提取 / 拆分 / 重构 | gitnexus-refactoring |
| 工具、资源、架构参考 | gitnexus-guide(本文件) |
| 索引、状态、清理、Wiki CLI 命令 | gitnexus-cli |
工具参考
| 工具 | 提供的内容 |
|---|---|
query | 按流程分组的代码智能信息 — 与某个概念相关的执行流 |
context | 符号的全方位视图 — 分类引用、它参与的流程 |
impact | 符号的影响范围 — 深度为 1/2/3 时会破坏什么,并标注置信度 |
detect_changes | Git 差异影响 — 当前更改会影响什么 |
rename | 跨多个文件的协同重命名,并为编辑标注置信度 |
cypher | 原始图查询(请先阅读 gitnexus://repo/{name}/schema) |
list_repos | 发现已索引的代码库 |
资源参考
轻量级读取(约 100-500 个令牌),用于导航:
| 资源 | 内容 |
|---|---|
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 的图架构 |
图架构
节点: 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