agent-skill
让AI使用ast-grep进行结构化代码搜索的Claude插件
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-skill。 它的用途是：让AI使用ast-grep进行结构化代码搜索的Claude插件 完整的 Skill 内容见：https://321skill.com/skills/agent-skill-ast-grep/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用ast-grep帮我找出这个React项目中，所有在useEffect钩子外部调用的setState。”，它会理解你的结构查询意图，生成对应的AST匹配规则，扫描项目并返回精确的文件和行号位置。或者说：“查找所有没有try-catch包裹的async函数”，它会定位出潜在的未处理错误风险的代码段。
介绍
这个Skill解决了传统文本搜索无法理解代码结构的问题。它让Claude能够理解和编写ast-grep规则，在代码库中执行基于抽象语法树（AST）的高级搜索，例如查找所有缺少错误处理的异步函数，或定位在特定上下文中使用的React钩子。
使用方式非常简单，安装后，在Claude Code中直接向Claude提出基于代码结构的搜索请求，例如“找出所有参数超过3个的函数”或“搜索类方法内部的console.log调用”。Claude会分析你的意图，自动生成并测试相应的ast-grep规则，然后在整个项目中执行搜索并返回结果。
它非常适合需要深度分析或重构大型、复杂代码库的开发者，尤其是前端开发、后端开发和全栈开发人员。当代码逻辑复杂、文本搜索难以精确定位模式，或者需要批量审查代码规范时，这个Skill能显著提升效率。
使用前请确保已在系统上安装ast-grep命令行工具。目前Claude Code无法在所有适用场景下自动触发该技能，因此有时需要你在提问中明确指示“使用ast-grep来查找…”。
核心特点
与基于纯文本匹配的搜索工具（如grep）不同，它基于代码的抽象语法树进行结构感知搜索，能精准匹配如“函数定义”、“条件语句块”等逻辑模式。它通过Claude智能生成和验证搜索规则，降低了直接编写复杂AST查询语法的门槛。
注意事项
不适合简单的文本查找或对没有安装ast-grep环境的项目进行即时搜索。
常见问题
ast-grep和普通grep有什么区别？
ast-grep基于代码结构（AST）搜索，能理解编程逻辑（如查找函数定义），而grep只进行文本匹配。
需要提前学习ast-grep的规则语法吗？
不需要，Claude会根据你的自然语言描述自动生成和测试搜索规则。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-skill-ast-grep/raw/index.md 读取 agent-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-skill-ast-grep/raw/index.md（查看排版版本）