---

name: explore-codebase description: 使用并行子代理高效探索代码库的模式。当需要理解代码结构、查找模式或收集上下文时使用。 allowed-tools: Task, Read, Glob, Grep

探索代码库技能

使用并行子代理高效探索代码库的模式。

何时加载此技能

• 需要理解代码库的某些部分
• 在做出决策前收集上下文信息
• 需要查找模式、约定或现有实现

探索策略

快速搜索（自行完成）

Glob("**/*{关键词}*")
Grep(pattern="函数名", type="ts")

适用于查找特定内容。

广泛理解（生成探索者子代理）

生成并行探索者子代理：

Task(
  subagent_type: "explorer",  # 自定义dotagent代理（小写）
  model: "haiku",
  prompt: |
    查询：{具体问题}
    提示：{查找位置}
    范围：{如有需要则限制}

    返回结构化YAML：
    - 发现（位置、相关性、摘要）
    - 观察到的模式
    - 相关领域
    - 空白点
)

可同时为不同领域生成多个探索者。

注意： 使用小写 "explorer" 表示在 @.claude/agents/explorer.md 中定义的自定义dotagent代理。内置的 "Explore"（首字母大写）是行为更简单的Claude Code代理。

综合结果

将探索者输出整合为连贯理解：

• 跨领域的通用模式
• 集成点
• 发现的约束条件
• 需注意的空白点

输出格式

探索后总结为：

代码库上下文：
  架构摘要：字符串
  现有模式：[字符串]
  集成点：[字符串]
  约束条件：[字符串]
  空白点：[字符串]

原则

• 并行优于顺序 - 同时生成多个探索者
• 广度优于深度 - 先广泛探索
• 结构化输出 - 始终生成YAML摘要
• 记录空白点 - 未找到的内容很重要