@davehardy20/pi-ast-grep-tools
基于ast-grep的结构化代码搜索替换Pi工具包
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@davehardy20/pi-ast-grep-tools。 它的用途是：基于ast-grep的结构化代码搜索替换Pi工具包 完整的 Skill 内容见：https://321skill.com/skills/davehardy20-pi-ast-grep-tools/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'匹配src目录下所有console.log调用，替换为统一的logger.info调用'，它会生成对应AST匹配规则，批量完成跨文件替换并反馈修改结果。
对AI说：'查找项目中所有var声明的变量，批量改为合适的let/const声明'，它会基于AST精准识别代码结构，避免误改字符串中的var内容。
介绍
传统文本级代码搜索替换无法识别代码语法结构，面对同名变量、格式差异大的同逻辑代码时，极易出现误匹配、漏匹配问题，在批量重构、规范整改场景下效率极低且容易引入线上故障。 它封装了ast-grep的AST语法树匹配能力，安装后只需配置目标代码结构规则与替换模板，即可快速完成跨文件的精准代码搜索与批量替换操作。 适合需要维护中大型代码库的一线开发者、负责团队代码规范落地的技术负责人、需要做老旧版本代码迁移的项目工程师，尤其是经常需要批量调整代码结构的研发人员。 使用前建议先掌握ast-grep的基础匹配语法规则，先在小范围测试文件集上验证规则的匹配准确性，确认无误后再执行全库批量操作，避免误改核心业务代码。
核心特点
它是专门适配Pi生态的ast-grep封装包，可直接在Pi工作流中调用AST级代码搜改能力，无需单独对接ast-grep原生接口。
注意事项
仅支持ast-grep已适配的编程语言，无法处理无对应AST解析器的小众语言或自定义DSL。
常见问题
和普通文本搜索替换有什么区别？
基于AST语法结构匹配，不受代码格式、换行、空格影响，匹配精度更高。
需要单独安装ast-grep吗？
无需手动单独安装，包依赖会自动处理ast-grep相关依赖。
给 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（查看排版版本）