关于 gitnexus-guide
gitnexus-guide 是 GitNexus 的工具、资源和知识图谱结构速查指南,面向使用代码图谱进行开发的人员。它按任务指引对应技能,并提供工具说明、资源路径和图谱查询示例。
主要功能
- 01按任务选择 GitNexus 技能
- 02查询代码执行流程与符号引用
- 03分析变更影响范围
- 04执行多文件协调重命名
- 05查阅图谱资源与 Cypher 模式
适用场景
- 01了解代码库架构或执行流程
- 02评估修改符号的影响范围
- 03排查故障或规划代码重构
MCP 相关
GitNexus 通过 MCP 工具提供代码查询、符号上下文、影响分析、重命名和 Cypher 图查询,并公开代码库上下文、流程及模式等资源。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mindfold-ai/ trellis --skill gitnexus-guide安装后在 Claude Code 中输入/gitnexus-guide确认已加载。
详细介绍
GitNexus 指南
GitNexus MCP 工具、资源和知识图谱架构的快速参考。
始终从这里开始
对于任何涉及代码理解、调试、影响分析或重构的任务:
- 读取
gitnexus://repo/{name}/context— 查看代码库概览并检查索引是否最新 - 将任务与下方的某项技能匹配,并读取该技能文件
- 遵循技能中的工作流和检查清单
如果第 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_changes | Git 差异影响分析 — 当前更改会影响什么 |
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 图架构 |
图架构
节点: 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