explore

GitNexus 探索

仅限 CLI——不存在 MCP 服务。切勿对 gitnexus:// URI 使用 readMcpResource。

使用 GitNexus 知识图谱追踪执行流程，并了解代码的工作方式。

自我演进的技能：此技能会在使用过程中不断改进。如果指令有误、参数发生变化，或需要采用变通方法，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

适用场景

• “X 是如何工作的？”
• “Y 的执行流程是什么？”
• “请带我了解 Z 子系统”
• 在修改代码前探索不熟悉的代码区域

工作流

步骤 0：预检——确保 CLI 可调用

gitnexus 二进制文件通过 npm/mise 安装。如果当前项目未启用 node，mise shim 可能会失效。运行任何 gitnexus 命令前，请先执行此预检：

# Test if gitnexus is actually callable (not just a broken shim)
gitnexus --version 2>/dev/null || mise use [email protected]

以下所有命令均从仓库根目录运行。如果工作区中为多个仓库建立了索引，请添加 --repo <repo-name> 指定目标。否则 --repo 为可选参数。

步骤 1：过期时自动重新建立索引

gitnexus status

如果索引已过期（已索引的提交 ≠ HEAD），请自动重新建立索引后再继续——不要询问用户：

gitnexus analyze

然后再次检查状态，确认索引是最新的。

步骤 2：查找执行流程

gitnexus query "<concept>" --limit 5

此命令会返回与相关概念相关、按排名排列的执行流程（处理链）。

步骤 3：获取符号的 360° 视图

对于找到的每个相关符号：

gitnexus context "<symbol>" --content

其中会显示：

• 调用方——调用此符号的对象
• 被调用方——此符号调用的对象
• 流程——此符号参与的执行流程
• 源代码——实际代码（使用 --content）

如果返回多个候选项，请通过以下方式消除歧义：

gitnexus context "<symbol>" --uid "<full-uid>" --content
# or
gitnexus context "<symbol>" --file "<file-path>" --content

步骤 4：读取源文件

使用 Read 工具检查 GitNexus 确认的行号处的源文件。

步骤 5：综合说明

清晰地说明以下内容：

• 内容——用途和职责
• 执行流程——数据如何在系统中流转
• 依赖关系——它依赖什么，以及哪些内容依赖它
• 关键文件——最值得了解的重要文件

示例

用户：“kintsugi 缺口修复是如何工作的？”

gitnexus query "kintsugi gap repair" --limit 5
gitnexus context "KintsugiReconciler" --content
gitnexus context "discover_shards" --content

然后读取相关源文件并综合说明。

执行后复盘

此技能执行完毕后，请在结束任务前进行复盘：

0. 定位自身。——找到此 SKILL.md 的规范路径，然后再进行编辑。
1. 出了什么问题？——修复导致问题的指令。
2. 哪些做得比预期更好？——将其列为推荐实践。
3. 哪些内容发生了变化？——修复任何与实际情况不符的脚本、引用或依赖项。
4. 记录下来。——在演进日志中记录触发原因、修复内容和证据。

不要拖延。下一次调用会继承你留下的一切。