📌 explore-code 是什么?

在代码库里找"某个功能是怎么实现的""这个 bug 大概在哪""这段逻辑谁在调用",靠 grep 搜关键字往往搜不精准、追不彻底。explore-code 是 RigorPilot 系列的技能,让 AI 带着你的问题去探索代码库,把答案和调用链一起找出来。

它和"全局搜索"的区别在于:搜索只是给你一堆匹配行,它则是理解你的意图,追踪函数调用、数据流向、继承关系,把散落的线索串成一条完整的逻辑链,告诉你"事情是怎么发生的"。

无论是定位 bug、理解历史实现、还是评估改动影响面,explore-code 都能省下大量来回翻文件的时间。

🧩 核心功能

代码定位:按描述定位函数、类、模块、配置。

调用链追踪:追踪函数调用、数据流、事件流。

逻辑理解:讲清一段代码"为什么这么写"。

影响面分析:改一处,评估会影响哪些地方。

历史追溯:结合提交记录理解代码演进。

复用识别:找出可复用的现有实现,避免重复造轮子。

👍 优点

精准:带着问题找,比漫无目的翻快得多。

深入:能把调用链和因果关系串起来。

省事:不用在编辑器里来回跳转。

⚠️ 不足与局限

对动态特性(反射、动态加载、运行时绑定)的追踪可能不完整。

超大型代码库里,一次探索的深度有限。

结论仍需你在关键节点上亲自确认。

🙋 适合谁用

开发者:定位 bug、理解实现、评估改动。

维护老系统的人:快速搞清历史代码的逻辑。

代码评审者:理解改动背后的上下文。

技术负责人:评估某个功能改动的风险。

🛠️ 第一次安装

前提:电脑装了 Node.js(18+),有支持 Skill 的 AI 工具(如 Claude Code)。打开终端执行:

bash
npx skills add lllllllama/rigorpilot-skills --skill explore-code

CLI 会自动检测你装的 AI 助手,确认安装位置后即可使用,装完可以用 npx skills list 确认它在列表里。

✍️ 上手:几个真实例子

场景一:定位 bug

提示词
这个登录偶发失败的问题,帮我追踪登录流程的完整调用链,找出可疑的地方。

场景二:理解历史实现

提示词
这段做缓存失效的代码为什么这么写?帮我讲清它的设计意图和潜在问题。

场景三:评估影响面

提示词
如果我把这个函数签名改了,会影响哪些地方?帮我列出来。

🎯 典型应用场景

Bug 定位:快速缩小问题范围。

功能理解:搞清某个功能的实现细节。

改动评估:改之前先看影响面。

代码复用:找现成的实现避免重复。

⚖️ 和类似方案对比

和 grep/ripgrep 相比,explore-code 不是按"字符串匹配"工作,而是按"语义和调用关系"工作,因此能回答"这个逻辑是谁触发的、会走到哪"这类搜索工具答不了的问题。当然,快速找某个确切符号时,搜索工具仍然更快,两者互补。

💡 常见问题 FAQ

问:找某个确切函数名用谁?
直接搜索更快;explore-code 更适合"理解逻辑、追调用链"这类问题。

问:能跨仓库探索吗?
通常以当前项目为主,跨仓库的依赖会给出线索但需自行确认。

问:会误判吗?
动态绑定、反射等场景可能不全,关键结论要自己核验。

问:和历史代码有关怎么办?
可以让它结合 git 提交记录一起看,理解代码为什么变成这样。

🤖 适合哪些 AI 工具

Claude Code、Cursor、Codex、GitHub Copilot 等支持 Skill 的工具都能装。