Agent Skills
返回列表
💻

Gemini MCP 代码库分析路由

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/route-large-codebase-analysis-through-gemini-mcp-tool。

技能介绍

问题：大型代码库分析会撑爆上下文窗口

在真实工程中，单个文件可能就有数千行，整个仓库更庞大。如果直接让编程代理读取并推理这些内容，很容易超出模型的上下文窗口，导致分析截断、推理质量下降，或者不得不把大量内容塞进提示词，使工作流变得笨重且不可靠。问题不在于代理不会分析，而在于分析所需的输入规模与代理能舒适处理的范围不匹配。

技能如何工作：把分析任务路由给专用工具

@user_3c6cb52e/route-large-codebase-analysis-through-gemini-mcp-tool 的核心思路是：让 MCP 编程代理在需要处理大文件或大型代码库时，不再自己硬扛全部内容，而是通过 Gemini MCP 工具把分析任务委托给外部运行时，例如 Gemini CLI 或 Antigravity CLI。代理保持当前工作流不变，只把分析请求发出去，再接收结构化结果，从而避免上下文溢出，同时利用专用运行时的代码理解能力。

关键能力包括：

  • 在现有 MCP 宿主（如 Claude Code 或 Claude Desktop）中直接调用路由工具
  • 将大型文件、模块或整个仓库的分析任务转交给 Gemini 或 Antigravity CLI
  • 无需改变代理自身的任务编排方式，结果可直接回流继续推理

典型流程是：先确认宿主支持 MCP，并已配置好 Gemini 或 Antigravity CLI 的认证；然后在需要分析大体积代码时，代理通过该工具发起请求，由外部运行时完成解析、检索或总结，再返回关键信息。

适用边界与注意点

重要变更：Google 已于 2026-06-18 退役 Gemini CLI，因此该工具现在默认使用 Antigravity CLI（agy）。如果你仍在配置旧版 Gemini CLI，需要切换到 Antigravity CLI 并重新完成认证，否则路由可能无法生效。

其他限制：

  • 需要 Node.js v16.0.0 或更高版本
  • 宿主必须支持 MCP，例如 Claude Code 或 Claude Desktop
  • 外部 CLI 的认证与网络访问需要自行配置，技能本身不处理凭证分发
  • 该技能适合“分析路由”，不替代索引、搜索或重构等完整工程流程

整体来看，它适合作为编程代理处理大型代码库时的上下文保护层：把重活交给专门的运行时，让代理专注于编排与决策。

使用场景

  • 单文件过大超出上下文窗口时，将整个文件的分析委托给 Antigravity CLI，代理只接收摘要结果。
  • 需要分析整个仓库的依赖关系与调用链路，但仓库规模过大无法直接塞进提示词时。
  • 在 Claude Code 中做大型代码库重构前，先通过该技能让外部运行时完成影响范围分析。
  • Claude Desktop 里处理超大代码文件时，路由给 Gemini 运行时并返回结构化结论继续推理。

适合人员

  • 在 Claude Code 中开发大型项目的工程师，需要分析整个仓库但上下文窗口不够用。
  • 使用 MCP 宿主做代码审查的开发者，想在不离开当前工作流的情况下分析超大文件。
  • 在 Claude Desktop 中处理复杂代码库的开发者，希望把重活交给 Antigravity CLI。
  • 搭建自动化代码分析流水线的工程师，需要把外部 CLI 的分析结果集成进 agent 工作流。