SuperAPI AI 工具集

explore-codebase

编程与开发

查看项目

更新于 10-24 17:17

技能介绍

用途

explore-codebase 用于导航和理解代码库结构,核心手段是 code-review-graph 的 MCP 工具,通过代码知识图谱快速定位模块、函数、类及其相互关系,帮助完成代码审查、调试、重构等任务的前期探索。

主要能力

  • 整体度量:运行 list_graph_stats_tool 查看代码库整体指标。
  • 架构总览:运行 get_architecture_overview_tool 获取高层的社区(community)结构。
  • 模块定位:用 list_communities_tool 找出主要模块,再用 get_community_tool 查看模块细节。
  • 语义查找:用 semantic_search_nodes_tool 查找特定函数或类。
  • 关系追踪:用 query_graph_tool 配合 callers_of、callees_of、imports_of 等模式追踪调用与依赖关系。
  • 执行路径:用 list_flows_tool 和 get_flow_tool 理解执行流程。
  • 文件下钻:对某个文件使用 children_of,查看其下所有函数与类。
  • 复杂度识别:用 find_large_functions_tool 找出复杂的大函数。

使用方式

技能建议自顶向下推进:先看统计与架构等宽泛信息,再逐步收窄到具体区域。同时设有 Token 效率规则:

  1. 在调用其他图谱工具前,先执行 get_minimal_context_tool(task="<your task>")。
  2. 所有调用使用 detail_level="minimal",仅在最小信息不足时才升级为 "standard"。
  3. 目标是在 ≤5 次工具调用、≤800 个总输出 token 内完成审查、调试或重构任务。

技能明确提醒:修改代码前应先阅读实现及其测试;图谱用于缩小范围,不能替代源码。

适用场景

适合在陌生或大型代码库中做初次探索、定位相关模块、追踪调用依赖、理解执行流程,以及在审查、调试、重构前快速建立代码地图。

限制

该技能依赖 code-review-graph MCP 工具集;图谱结果只用于缩小探索范围,具体实现与测试仍需阅读源码确认。关于安装命令、收费与价格、支持平台等信息,资料暂未提供。