@davehardy20/pi-ast-grep-tools
基于AST的代码结构搜索与替换工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@davehardy20/pi-ast-grep-tools。 它的用途是：基于AST的代码结构搜索与替换工具 完整的 Skill 内容见：https://321skill.com/skills/davehardy20-pi-ast-grep-tools/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'在项目中搜索所有console.log调用并列出文件路径和行号。' AI会调用ast_grep_search工具，使用模式console.log($A)进行AST匹配，返回精确结果。如果需要对搜索结果执行替换，可以说：'将项目中所有var声明替换为const，注意不要修改其他变量。' AI会先搜索确认模式，再调用ast_grep_replace安全替换。
介绍
这个Skill解决了传统文本搜索在代码重构中无法识别语法结构的问题。在实际开发中，开发者经常需要批量查找或替换特定代码模式，但使用grep或正则表达式容易误匹配注释、字符串中的内容，甚至破坏代码语法。此工具通过AST（抽象语法树）匹配，能够精确识别代码的语法结构，避免误伤，让搜索和替换更加安全可靠。
使用方式很简单，你只需要在支持Pi的环境中安装该包，然后通过自然语言指令即可调用。例如，你可以说“搜索项目中所有console.log调用”，AI会自动使用ast_grep_search工具进行AST匹配，返回精确的文件位置和代码片段。如果需要替换，可以说“将所有var声明替换为const”，AI会调用ast_grep_replace工具，在保证语法正确的前提下批量修改文件。此外，还支持/ast-grep-status命令查看当前包名、版本、源码路径和支持的语言。
它非常适合需要频繁进行代码重构、代码审查、批量修改的团队或个人。尤其是那些已经使用智能体（如Pi）辅助开发的开发者，包括后端开发、前端开发、智能体开发人员，都可以在大型代码库中快速定位和修改代码模式，提升开发效率。无论你是清理遗留代码中的日志，还是统一命名规范，这个工具都能让AI帮你精准完成。
建议在重构前先用搜索功能验证模式是否匹配预期结果，再执行替换操作，避免意外修改。需要注意的是，它目前仅支持TypeScript、JavaScript和TSX三种语言，其他语言（如Python、Go）需要等待ast-grep的后续扩展。另外，替换操作会直接修改文件，建议在版本控制下进行，以便回滚。
常见问题
支持哪些编程语言？
目前支持TypeScript、JavaScript和TSX（React JSX语法），后续随ast-grep更新可能扩展更多语言。
如何安装这个Skill？
在Pi环境中运行命令：pi install npm:@davehardy20/pi-ast-grep-tools，或者从GitHub安装：pi install git:github.com/davehardy20/pi-ast-grep-tools。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/davehardy20-pi-ast-grep-tools/raw/index.md 读取 @davehardy20/pi-ast-grep-tools 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/davehardy20-pi-ast-grep-tools/raw/index.md（查看排版版本）