Codebase Exploration 是一个专注于代码库系统性探索与发现的技能，目标是帮助开发者快速理解不熟悉的代码、定位具体实现、映射架构模式，并回答与代码位置相关的问题。
用途
该技能用于系统性地探索与发现代码库，采用高级搜索技术、模式识别和代码分析手段。典型应用包括：首次探索陌生代码库、查找特定功能在何处实现、在全库中寻找某模式的示例、理解组件之间如何交互、定位某个 API 或模式的所有使用位置、绘制架构组织、查找项目中相似的代码，以及回答“某功能在哪里”“哪个文件包含某逻辑”“找出做某事的代码”这类问题。
主要能力
该技能具备搜索策略、探索工作流与多角度发现等核心能力。
搜索策略方面：支持基于模式的搜索，可按命名约定、代码模式、架构标记和文件组织来定位；支持上下文感知搜索，理解代码关系、映射依赖、追踪执行流程并发现相关组件；支持多角度发现，可按功能、结构、命名和模式进行搜索。
决策框架方面：提供搜索策略与工具选择建议。例如“用户认证在哪里”对应搜索认证关键词与登录模式；“数据流如何工作”对应查找 models、services、controllers 模式；“哪个文件处理某 API”对应搜索端点与路由定义；“查找所有数据库查询”对应搜索 ORM 模式与 SQL 关键词；“定位错误处理”对应查找 try-catch 与错误类。工具选择方面，grep/rg 适合文本模式匹配，find/fd 适合文件名与路径匹配，ast-grep 适合代码结构匹配，LSP 工具适合符号与引用查找，git log 适合历史上下文。
探索工作流包括：定位（明确寻找目标、原因、所需细节程度与合适彻底程度）、映射结构（识别顶层组织、查找关键标记如入口点与配置文件、记录目录命名模式）、执行搜索（选择合适的工具、使用多个搜索角度、记录发现）、分析与综合（连接线索、识别模式、对发现进行优先级排序）。
使用方式
该技能提供三个彻底程度级别：快速级别（快速、宏观）约 30 秒，涵盖文件结构概览、高层模式匹配、目录组织与主要入口点；中等级别（平衡深度）约 2-3 分钟，涵盖详细文件检查、跨文件模式发现、架构映射与常见模式分析；非常彻底级别（深度挖掘）约 5-10 分钟，涵盖穷尽式代码分析、复杂模式匹配、依赖追踪与边界情况发现。
当出现以下情况时调用该技能：首次探索陌生代码库、需要查找特定功能实现位置、在全库中寻找某模式示例、理解组件如何交互，以及提出“某功能在哪里”“哪个文件包含某逻辑”“找出做某事的代码”等问题时。
当出现以下情况时不应调用：调试已知缺陷（应使用 debugger-skill）、重构代码（应使用 refactoring-specialist-skill）、审查代码质量（应使用 code-reviewer-skill）、从零编写新代码（应使用相应开发者技能）。
针对不同问题类型有对应的处理方式。“某功能在哪里实现”时：按名称搜索、搜索相关术语、检查明显位置、在测试中查找。“某功能如何工作”时：找到其定义、找到其使用、追踪流程、理解依赖。“哪些文件使用某对象”时：搜索其导入、使用 LSP 查找引用、搜索其被调用的方法。
最佳实践与限制
最佳实践建议：先宽后窄（先了解整体布局，再识别模式，最后定位具体区域）；使用多个搜索角度（按名称、按内容、按结构、按符号）；跟随线索（检查导入以发现依赖、使用 LSP 查找引用、根据文件位置判断架构线索、检查 git 历史获取上下文）；边探索边记录。
需避免的反模式包括：无上下文地搜索、忽略文件结构、依赖单一搜索方法、忘记测试文件、跳过配置文件。
相关技能方面：当探索发现缺陷时可使用 debugger-skill；评估发现的模式可使用 architect-reviewer-skill；改进找到的代码可使用 refactoring-specialist-skill；复杂架构问题可使用 technical-advisory-skill。
该技能的详细技术参考与代码示例分别见 REFERENCE.md 与 EXAMPLES.md。具体安装命令、收费方式、价格、支持的平台等信息暂未提供。