使用 ripgrep、fd 和 tree 搜索代码库内容、文件名或目录结构,支持文件类型、上下文、深度和结果数量的过滤。
代码搜索技能( Cast) : Fast 代码搜索工具, 用于探索代码库.
功能概述
代码搜索技能( Cast) : Fast 代码搜索工具, 用于探索代码库.是一项面向实际任务的技能,主要用于Provides structure grep( 内容搜索), glob( 文件名搜索), 和树( 指令结构) 通过 riggrep, fd, 和树。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
- 实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
使用与执行
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
结果检查与注意事项
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
代码搜索技能(Code Search Skill)
一款高效的代码搜索工具包,用于探索代码库。通过 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]
grep — 搜索文件内容
# 基础搜索
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)
glob — 搜索文件名
# 查找所有 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)
tree — 展示目录结构
# 默认深度(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— 显示文件大小
check — 验证依赖项
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的结果按修改时间倒序排列(最新修改的排在最前)
热门AI工具
相关专题
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.8万人学习
最新文章