SuperAPI AI 工具集

smart-explore

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:smart-explore 用于结构化探索代码库。它通过 tree-sitter 做 AST 解析,提供三个 MCP 工具:smart_search(跨目录发现文件与符号)、smart_outline(获取单文件结构骨架)、smart_unfold(展开单个符号的完整源码)。核心理念是先索引、按需获取,先拿到代码地图再读实现细节,从而避免每次直接读取整文件。

主要能力:smart_search 会遍历目录、解析代码文件并返回带签名、行号与匹配原因的排名符号及折叠文件视图,单次调用替代 Glob→Grep→Read 的发现循环;smart_outline 返回函数、类、方法、属性、导入等完整骨架;smart_unfold 返回指定符号的完整源码,包含 JSDoc、装饰器,AST 节点边界保证完整性。技能本身只加载指令,需自行调用 MCP 工具。

使用方式:推荐三步流程——smart_search(query="<主题>", path="./src") 发现文件与符号;smart_outline(file_path="<file>") 获取结构;smart_unfold(file_path="<file>", symbol_name="<name>") 查看实现。参数方面,query 必填,path 默认当前目录,max_results 默认 20、上限 50,file_pattern 可选过滤。

适用与限制:适合代码行数较多的代码探索与文档编写;约 100 行以内的小文件、非代码文件(JSON、markdown、配置)以及精确字符串/正则搜索仍建议用 Read、Grep、Glob。需要跨 6 个以上文件综合理解或端到端架构叙述时,应使用 Explore agent,本技能不做跨文件综合。内置语言包括 JavaScript、TypeScript、TSX/JSX、Python、Go、Rust、Ruby、Java、C、C++;未识别扩展名会退化为纯文本搜索,smart_outline 与 smart_unfold 不再提取结构化符号。可通过项目根目录 .claude-mem.json 注册自定义 tree-sitter 语法,需先安装对应 npm 包;多数语言实际上需要提供自定义 query。Markdown 有特殊支持:outline 提取标题,search 覆盖代码围栏,unfold 展开标题小节,YAML frontmatter 会作为合成符号显示。其他细节资料未提供。