用途:GitNexus Guide 是 GitNexus 的快速参考,汇总全部 GitNexus MCP 工具、资源与知识图谱 schema。涉及代码理解、调试、影响分析或重构时,建议先读取 gitnexus://repo/{name}/context 获取代码库概览并检查索引新鲜度,再按任务匹配对应技能文件并遵循其工作流与清单;若提示索引过期,先在终端运行 node .gitnexus/run.cjs analyze。
主要能力:工具包括 query(按流程分组的代码智能)、context(符号 360 度视图)、impact(符号爆炸半径)、trace(两符号间最短路径)、detect_changes(Git diff 影响)、rename(多文件协调重命名)、cypher(原始图查询)、explain(持久化污点发现)、pdg_query(控制/数据依赖)、check(图不变量检查)、route_map、shape_check、api_impact、tool_map、group_list、group_sync、list_repos 等。资源提供 context、clusters、processes、schema 等轻量读取。
使用方式:list_repos 分页,默认 limit 50、最大 200,配合 offset 与 nextOffset 枚举全部仓库。explain 与 pdg_query 需先以 analyze --pdg 建立索引,否则返回无对应层的提示。trace 可用 from_uid/to_uid 或 from_file/to_file 消歧,maxDepth 默认 10、最大 30。写 Cypher 前先读 gitnexus://repo/{name}/schema。
适用场景:架构理解、影响分析、缺陷追踪、重构、API 路由与响应形状检查、跨仓库契约追踪(实验性)。
限制:污点分析不建模闭包/回调、属性/字段与隐式流,跨函数发现为函数级 TAINT_PATH 跳转,未发现不等于安全;pdg_query 仅过程内;跨仓库 trace 为实验性,最多跨越一个 ContractLink 边界。