smart-explore 是做什么的？
基于 tree-sitter AST 解析的令牌优化结构代码搜索。当需要理解代码结构、查找函数或高效探索代码库时，替代完整文件阅读。
功能
- 结构搜索：通过解析 AST 查找函数、类、变量定义等
- 令牌优化：仅返回相关结构信息，避免加载整个文件
- 多语言支持：利用 tree-sitter 语法，支持 Python、JavaScript、TypeScript、Go、Rust 等
- 精确匹配：基于语法树而非文本模式匹配，减少误报
使用场景
- 快速定位代码库中的函数定义
- 了解模块或文件的整体结构
- 重构时查找引用或依赖关系
- 学习新项目时快速熟悉代码组织
平台支持
兼容 Claude Code、Cursor、Codex 等主流 AI 编码代理平台。
工作原理
使用 tree-sitter 解析源代码生成 AST，然后基于查询语法搜索特定节点类型（如函数声明、类定义）。结果以结构化格式（如 JSON）返回，包含位置、名称和签名信息，极大减少令牌消耗。
示例
# 假设在项目根目录
npm run smart-explore "function" -- --path src/
或者使用 AI 代理内置调用：
/smart-explore 查找所有数据库相关函数
配置
可通过环境变量或技能配置文件调整搜索深度、忽略目录等参数。参考 SKILL.md 获取完整文档。
许可
MIT License