使用 ripgrep、fd 和 tree 搜索代码库内容、文件名或目录结构,支持文件类型、上下文、深度和结果数量的过滤。
代码搜索技能( Cast) : Fast 代码搜索工具, 用于探索代码库.是一项面向实际任务的技能,主要用于Provides structure grep( 内容搜索), glob( 文件名搜索), 和树( 指令结构) 通过 riggrep, fd, 和树。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
一款高效的代码搜索工具包,用于探索代码库。通过 ripgrep、fd 和 tree 这三个命令行工具,提供结构化的内容搜索(grep)、文件名搜索(glob)和目录结构展示(tree)功能。
请先运行依赖检查:
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh check
所有命令均通过统一入口执行:
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh[options]
# 基础搜索
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh grep "func main" --path /some/project
# 字面量匹配(不启用正则表达式)
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh grep "fmt.Println(" --literal --path /some/project
# 按文件类型过滤
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh grep "import" --type go --path /some/project
# 显示上下文行
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh grep "TODO" --context 2 --path /some/project
# 限制结果数量
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh grep "error" --max 20 --path /some/project
选项说明:
--path — 指定搜索目录(默认为当前目录)--type — 文件类型过滤器:go、py、ts、js 等(可重复使用)--literal — 将搜索模式视为字面量文本,而非正则表达式--max — 最大返回结果数(默认:100)--context — 在匹配行周围显示 N 行上下文(默认:0)# 查找所有 Go 文件
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh glob "*.go" --path /some/project
# 查找测试文件
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh glob "*_test.go" --path /some/project
# 查找配置文件
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh glob "*.{json,yaml,yml,toml}" --path /some/project
# 按类型过滤(仅文件)
bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh glob "config" --type f --path /some/project
选项说明:
--path — 指定搜索目录(默认为当前目录)--type — f:仅匹配文件;d:仅匹配目录--max — 最大返回结果数(默认:200)# 默认深度(3 层) bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh tree --path /some/project # 浅层视图 bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh tree --path /some/project --depth 1 # 显示文件大小 bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh tree --path /some/project --depth 2 --size
选项说明:
--path — 目标目录(默认为当前目录)--depth — 最大遍历深度(默认:3)--size — 显示文件大小bash /root/.openclaw/workspace/skills/code-search/scripts/search.sh check
所有命令均输出结构化文本,并带有清晰的分隔标识:
[SEARCH RESULTS: grep] / [SEARCH RESULTS: glob] / [DIRECTORY TREE][END RESULTS] / [END TREE][TRUNCATED: ...][ERROR] ....git、node_modules、pycache、vendor、构建产物等目录.gitignore 规则grep 和 glob 的结果按修改时间倒序排列(最新修改的排在最前)相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习
最新文章