file-search-skill
AI技能，系统教授高效命令行代码与文件搜索策略。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：file-search-skill。 它的用途是：AI技能，系统教授高效命令行代码与文件搜索策略。 完整的 Skill 内容见：https://321skill.com/skills/file-search-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想在这个Java项目里找到所有抛出自定义异常‘InvalidUserException’的地方。” 它会先建议你使用语法感知搜索工具 ast-grep (sg) 来精准匹配代码结构，避免正则表达式的复杂和误匹配，并给出类似 `sg -p 'throw new InvalidUserException($$$)' --lang java .` 的命令示例。接着，它会解释为何在此场景下 sg 比单纯的 ripgrep (rg) 更合适。
介绍
File Search Skill 是一个专为AI代理设计的技能，旨在解决开发者在大型代码库或文件系统中进行高效、精准搜索的痛点。它并非一个直接执行搜索的工具，而是一个“策略导师”，通过教授何时、如何选择和使用最合适的命令行搜索工具（如 ripgrep, fd, ast-grep 等），来提升开发者的信息检索效率。
使用该技能时，AI代理会引导用户根据具体场景（如搜索纯文本、结构化代码、非文本文件或进行代码统计）选择最佳工具，并提供具体的命令示例、最佳实践和常见陷阱规避方法。例如，当用户需要搜索代码中的特定模式时，AI会建议使用 ripgrep 而非传统 grep，并指导如何限定文件类型以提高速度。
它非常适合所有需要与代码和文件系统打交道的开发者、技术写作者和运维人员，尤其是那些希望摆脱低效的“find + grep”组合，或对众多现代搜索工具（rg, fd, sg, semgrep等）感到困惑，不知如何选择的新手和中级用户。
与市面上许多仅封装单一搜索命令的AI技能不同，File Search Skill 的核心价值在于其“策略性”和“工具链导航”。它不绑定单一工具，而是提供了一个覆盖从文件发现、文本搜索、语法感知搜索到代码分析的完整工具选择矩阵和决策框架，帮助用户构建系统化的搜索工作流，这是它与同类技能最显著的区别。
核心特点
该技能的核心区别在于它不提供单一的搜索功能，而是作为一个“搜索策略导师”，系统化地教授如何根据场景在 ripgrep、fd、ast-grep、semgrep 等现代工具链中做出最优选择，并传授最佳实践，旨在提升用户的底层搜索方法论，而非执行一次性的搜索任务。
注意事项
该技能本身不直接执行搜索操作，不适合需要AI代理立即返回具体文件内容或搜索结果的即时性任务。
常见问题
这个技能能帮我直接找到某个文件里的代码吗？
不能直接找到。它是一个教学技能，会指导你使用哪个命令行工具（如rg）以及如何构造命令来高效地自己找到代码。
我需要事先安装那些搜索工具（如rg, fd）吗？
是的，该技能教授的是如何使用这些外部命令行工具，因此你需要先在系统上安装它们才能应用所学策略。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/file-search-skill/raw/index.md 读取 file-search-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/file-search-skill/raw/index.md（查看排版版本）