file-search

核心用法

file-search 是一个纯文档型 Skill，旨在帮助用户快速掌握 fd 和 rg（ripgrep）两大高效搜索工具的使用方法。该 Skill 不提供自动执行功能，而是作为命令参考手册，向用户展示如何在本地环境中进行文件搜索操作。

文件查找功能：通过 fd 命令实现基于正则表达式的文件名搜索，支持按扩展名（如 \.rs$ 匹配 Rust 文件）或精确名称（-g 全局匹配）进行定位。相比传统 find 命令，，fd 语法更简洁、执行速度更快。

内容搜索功能：通过 rg 命令实现跨文件内容检索，支持正则表达式匹配（如 TODO|FIXME）、上下文行显示（-C 3）以及按文件类型过滤（--type rust）。ripgrep 默认忽略 .gitignore 中的文件，并自动递归搜索，大幅提升开发效率。

显著优点

1. 工具权威性：fd 和 ripgrep 均为开源社区广泛认可的高性能工具，GitHub 星标数分别超过 30k 和 45k，经过大量生产环境验证。
2. 零学习成本：Skill 提供即开即用的命令示例，用户无需查阅冗长文档即可上手。
3. 跨平台兼容：通过 dnf 包管理器安装，适用于 Fedora/RHEL 等主流 Linux 发行版。
4. 纯文档安全：无代码执行逻辑，从根本上杜绝恶意操作风险。

潜在缺点与局限性

1. 非自动化 Skill：该 Skill 仅提供命令参考，不会自动执行搜索操作，用户需手动复制命令到终端运行。
2. 外部依赖要求：必须预先安装 fd-find 和 ripgrep 包，未安装时命令无法使用。
3. 平台限制：当前安装配置仅提供 dnf 方案，Debian/Ubuntu 用户需自行适配 apt install fd-find ripgrep。
4. 功能单一：仅限于搜索场景，不涉及结果处理、批量操作等进阶工作流。

适合的目标群体

• 后端/全栈开发者：需要在大型代码库中快速定位文件或检索特定代码模式。
• DevOps 工程师：在服务器日志、配置文件中高效查找关键信息。
• 开源贡献者：在多仓库项目中追踪 TODO/FIXME 标记或函数定义。
• 命令行爱好者：追求比传统 find + grep 更现代的搜索体验。

使用风险

1. 依赖可用性风险：若系统未安装 fd/rg，命令执行将失败，建议用户先运行安装命令。
2. 路径权限风险：搜索系统目录（如 /etc、、/var`）可能需要 sudo 权限，普通用户可能遇到访问拒绝。
3. 正则表达式误用：复杂的正则模式可能导致意外匹配大量文件，建议在关键操作前先用小范围测试。
4. 性能考量：在超大规模目录（百万级文件）中搜索时，建议添加 --type 或路径限制以优化性能。