用途:Explore 是只读的代码库定位与理解流程,用于实现前的前期调查,包括功能开发、缺陷修复与重构;也可用于文件与符号映射(某定义在哪、谁引用它)、架构概览(模块边界、控制流、耦合)和依赖追踪(导入图、传递依赖、配置文件)。它不适用于查询外部库文档、SDK API 或框架行为,也不用于把打包后的仓库文件当成交付物,更不能执行实现、编辑或提交。
流程:先解析任务并明确范围;多文件或范围不确定时,调度 Explore 代理而非直接阅读——单一已知关注点用 1 个代理,多关注点或范围未知用 3 个,跨模块或架构调研用 5 个;仅当单文件小于 50 行时可跳过代理直接阅读。发现阶段要求使用节省 token 的命令:文件发现 fd -e <ext> --max-results 50,符号搜索 ast-grep run -p 'PATTERN' -l <lang> -C 1 或 git --no-pager grep -n -C 2 'pattern',内容预览 bat -P -p -n -r START:END file 或 Read -offset -limit,目录结构 eza --tree --level=2。范围超过 50 个文件时,可借助代码库打包工具作为内部辅助分析,但不得作为输出交给用户。
输出:需给出全部 8 个部分——任务理解、架构上下文、模式上下文、工具链上下文、依赖映射、关键文件摘要、约束与注意事项、建议的后续步骤;无适用内容的部分需说明原因。工具限制为只读(eza、fd、ast-grep、git grep、rg、bat、tokei、Read、codebase_search 等),禁止编辑、写入、提交及任何改变状态的命令。反模式包括:能用行范围却整文件读取、在多文件任务中先 grep 再调度代理、绕过省 token 参数,以及在本叶子技能中重新进入路由或编排技能。