用途
GitNexus Exploring 用于在用户询问代码如何工作、想了解项目架构、追踪执行流程,或需要探索不熟悉的代码区域时,帮助理解代码库。典型触发示例包括:“认证是如何工作的?”“项目结构是什么?”“展示主要组件”“数据库逻辑在哪里?”以及理解此前未见过的代码。
主要能力
该技能提供两类能力:资源读取与工具调用。
资源读取:
- gitnexus://repos:发现已索引的仓库。
- gitnexus://repo/{name}/context:代码库概览,并检查索引是否过期(约 150 tokens)。
- gitnexus://repo/{name}/clusters:所有功能区域及其内聚分数(约 300 tokens)。
- gitnexus://repo/{name}/cluster/{name}:某功能区域的成员及其文件路径(约 500 tokens)。
- gitnexus://repo/{name}/process/{name}:逐步执行追踪(约 200 tokens)。
工具调用:
- gitnexus_query:查找与某个概念相关的执行流程。例如 gitnexus_query({query: "payment processing"}) 会返回 CheckoutFlow、RefundFlow、WebhookHandler 等流程,以及按流程分组并带文件位置的符号。
- gitnexus_context:获取某个符号的 360 度视图。例如 gitnexus_context({name: "validateUser"}) 会返回入站调用(loginHandler、apiMiddleware)、出站调用(checkToken、getUserById)以及该符号所属的流程(LoginFlow 第 2/5 步、TokenRefresh 第 1/3 步)。
使用方式
推荐工作流:
- 读取 gitnexus://repos,发现已索引的仓库。
- 读取 gitnexus://repo/{name}/context,获取代码库概览并检查索引是否过期。
- 调用 gitnexus_query({query: "<你想理解的内容>"}),查找相关执行流程。
- 调用 gitnexus_context({name: "<符号>"}),深入查看特定符号。
- 读取 gitnexus://repo/{name}/process/{name},追踪完整执行流程。
如果第 2 步提示“Index is stale”(索引过期),需在终端运行 npx gitnexus analyze 重新分析。
检查清单:
- 读取 gitnexus://repo/{name}/context
- 对想理解的概念执行 gitnexus_query
- 查看返回的流程(执行流)
- 对关键符号执行 gitnexus_context,查看调用者与被调用者
- 读取 process 资源以获取完整执行追踪
- 阅读源文件以了解实现细节
适用场景
适合在以下情况使用:需要快速理解陌生代码库的整体结构;需要定位某个功能概念(如支付处理)涉及哪些执行流程;需要查看某个函数或符号的调用关系;需要按步骤追踪一条完整执行链路。
限制
使用前需要仓库已被 GitNexus 索引;若索引过期,必须先运行 npx gitnexus analyze。该技能依赖 GitNexus 提供的资源与工具,具体可用性取决于索引状态。关于收费、价格、平台支持范围等信息,资料中暂未提供。