SuperAPI AI 工具集

file-search

通用与其它

查看项目

更新于 10-15 16:44

技能介绍

用途:该技能用于在项目中快速进行文件名与内容搜索,适合按 glob 定位文件、跨目录查找关键词或正则、查看匹配上下文,以及替代常见的 find + grep 组合。

主要能力:通过 rg --files 配合 --glob 枚举文件名;用正则执行高性能内容搜索;用 -C N 输出匹配前后各 N 行上下文;用 --type 按文件类型过滤以减少噪声;并在搜索前检查 rg 是否可用。

使用方式:先运行 rg --version 确认已安装 ripgrep;可选运行 python scripts/test_skill.py 自检;随后按需执行命令,例如:rg --files --glob "*.rs" /path/to/projects 列出 Rust 文件;rg "TODO|FIXME" /path/to/projects 搜索关键词;rg -C 3 "fn main" /path/to/projects --type rust 带上下文和类型过滤搜索。

适用场景:需要快速列出匹配文件、定位关键词或正则、理解符号使用上下文、并在大型仓库中按类型缩小扫描范围时。

限制与依赖:需要 ripgrep (rg) >= 13.0.0,运行自检脚本需 Python >= 3.8。缺少必要源数据、标识符、文件或凭据时不应使用;不应输出编造结果或不支持的结论;若目标可用更简单方式直接回答,也不适用。执行前需确认任务在范围内且输入完整,并明确假设、局限与警告。输出文件名建议为 file_search_result.md,并附验证摘要。