Explore Codebase 是一个用于在编辑代码前理解代码仓库的技能,其核心是借助 codegraph 索引来导航和理解代码库结构。
用途 该技能用于仓库入门、编写 AGENTS.md、梳理架构,或定位相关代码。它帮助使用者在动手修改前先建立对代码库的整体认识。
主要能力
- 优先使用宿主暴露的 MCP 工具(codegraph_explore、codegraph_node);若未暴露,则通过 CLI(codegraph explore、codegraph node)获得相同输出。
- 优先采用图结果来识别入口点、调用路径、依赖方和影响范围。
- 对任何关键结论,通过阅读其指向的源码进行确认。
- 若索引缺失或过期,先运行 $build-graph。
- 若 codegraph 不可用或为空,则改用 rg、清单文件、README 文件和配置检查继续工作。
使用方式 工作流如下:
- 若索引为空或过期,构建或同步索引($build-graph)。
- 使用 codegraph files --format grouped 查看模块布局。
- 使用 codegraph explore "<任务或区域>" 一次性获取相关符号的源码及调用路径;使用 codegraph context "<任务>" 获取任务形态的打包信息。
- 使用 codegraph node -f <文件> --symbols-only 查看某文件的符号以及谁依赖它(被许多其他文件“使用”的文件即为枢纽文件)。
- 使用 codegraph callers|callees <符号> 和 codegraph impact <符号> 缩小到特定符号和风险瓶颈。
AGENTS.md 用途 当协助 safe-code 编写或校对 AGENTS.md 时,遵循 safe-code 技能中 references/agents-md-authoring.md 的规范编写规则(决策测试、调查顺序、提取/排除内容)。本技能的任务是提供由图支撑的事实,以输入这些规则,而非定义单独的编写流程。 优先采用由图支撑的事实:
- 主要模块和文件
- 入口点和调用路径
- 被许多其他文件依赖的枢纽文件(需谨慎)
- 索引检测到的语言
- 未测试的热点(codegraph affected 映射不到任何测试的源文件) 不要将原始图转储复制到文档中,而应将其转换为紧凑的交接事实。
适用场景 适用于仓库入门、AGENTS.md 编写、架构映射,或查找相关代码等需要在编辑前理解代码库的任务。
限制 若 codegraph 不可用或索引为空,需退回到 rg、清单文件、README 和配置检查。索引缺失或过期时需先构建。具体平台、收费、价格等信息暂未提供。