Gortex 仓库代码智能代理

代理读代码时缺的那张图

让编码代理改一个函数，它通常只能打开文件、按名字 grep、再顺着 import 逐个文件猜。仓库稍大就会出现三类问题：一是找不到——同名符号散在多个目录，grep 返回几十条结果却分不清哪个是目标；二是看不清——改了 A 之后，哪些调用点会受影响、影响会沿调用链扩散多远，全靠人工回忆；三是不敢改——一次重构涉及多少文件、有没有测试兜底，代理往往给出一个看似合理但未经验证的方案。

这个技能做了什么

Gortex 把本地 git 仓库索引成一份本地代码图，符号、依赖与调用关系不再是文件里的文本，而是可查询的结构。索引完成后，代码智能能力被统一暴露出来，入口有四种：MCP（供具备 MCP 能力的编码代理直接调用）、CLI、API 和 Web UI。

具体能力覆盖了代理日常最需要的几类查询：

• 符号定位：按名称找到定义与引用，而不是一堆同名文本
• 调用链分析：从某个入口出发向上追溯，理清变更会传导到哪里
• 影响范围（blast radius）：在动手前估算一次改动牵连的文件与调用点数量
• 评审与重构辅助：为 review 和重构流程提供结构化的代码上下文

典型工作流是：先对仓库建立索引，然后在代理侧通过 MCP 工具发起符号或调用链查询，拿到结果后再决定改动范围——把“读代码猜关系”变成“查图确认关系”。

适用边界与注意点

这套方案有几个前提需要先确认：

• 需要本地已有 Gortex 二进制，它不是纯脚本技能
• 目标代码应当是本地 git 仓库，索引依赖版本管理状态
• 想直接接到代理上使用，还需要一个支持 MCP 的编码代理或 CLI/API 客户端
• 技能资料里没有提供自动抽取到的安装与使用说明，因此建议在接入敏感流程之前先审阅上游项目，确认二进制来源与权限行为后再跑