用途
Exploration Tools 是一套用于代码库探索的工具定义与使用模式集合,来源于 takeokunn/nixos-configuration 技能库。它的主要目的是让智能体(Agent)在需要探索代码库时,直接引用这一技能,而不是在每个智能体的提示中内联重复定义工具。这样可以统一工具的使用方式,减少重复描述,并让探索行为遵循一致的规范。
主要能力
该技能围绕四类工具展开:
- Glob:用于文件发现。
- Grep:用于内容搜索。
- Read:用于读取文件内容。
- LSP:用于符号导航,包括 LSP_goToDefinition、LSP_findReferences,以及 Serena 的 find_symbol、find_referencing_symbols。
技能中提供了一棵决策树(decision_tree name="tool_selection"),用于根据搜索需求选择工具:需要文件发现时用 Glob;需要内容搜索时用 Grep;需要跳转到定义时用 LSP_goToDefinition 或 Serena find_symbol;需要查找引用时用 LSP_findReferences 或 Serena find_referencing_symbols;需要读取内容时用 Read。
使用方式
技能强调“先窄后宽”的探索策略:从较窄的搜索范围开始,只有在结果不足时才扩大范围。最佳实践(best_practices)包括:
- 用 Glob 做文件发现,用 Grep 做内容搜索。
- 对发现结果始终返回 file:line 形式的引用。
- 从较窄的搜索范围开始,必要时再扩大。
- 在可用时使用 LSP 工具进行精确的符号导航。
- 过滤掉二进制文件和生成文件。
- 使用 head_limit 将结果限制在可管理的规模。
技能还列出了反模式(anti_patterns),例如不加过滤地搜索整个代码库;并建议从文件类型或目录过滤器开始。
适用场景
该技能适用于智能体在代码库中定位相关代码模式、审查输出一致性等任务。它与相关智能体(related_agents)关联,用于定位相关代码模式、审查输出一致性;也与相关技能(related_skills)关联,包括通过 Serena MCP 进行替代符号导航,以及使用这些工具进行证据收集的方法论。
限制
技能中定义了错误升级机制(error_escalation),继承自 core-patterns#error_escalation,用于处理以下情况:轻微不一致、含糊指引、冲突约束、不安全或误导性的检索指引。关于该技能的具体安装方式、收费模式、支持平台等信息,资料中暂未提供。