代码结构搜索替换
给一段代码形状和替换写法,在指定目录里按语法结构批量查找与改写,默认先预演。
功能与用途
全仓库把 console.log 换成 logger.info、删掉所有 as any 断言、把 require 改成 import,用文本搜索容易漏掉换行和括号的差异,正则改起来又容易误伤字符串里的同名内容。这个 Skill 用 ast-grep 把模式当成代码来解析,按语法树匹配,覆盖 25 种语言;它默认只做预演,先告诉你会在哪些文件的哪一行改什么,确认后才写入,并且能提前拦下写成了正则的那些模式,省掉反复排查「为什么一条都没匹配上」。
适用场景
- 仓库要从 py2 风格的 Optional[X] 迁到 X :仓库要从 py2 风格的 Optional[X] 迁到 X | None,涉及两百多个文件不能靠手改。
- 代码评审要找出所有空 catch 块,用文本 grep 抓不:代码评审要找出所有空 catch 块,用文本 grep 抓不准嵌套结构。
- 想给项目加一条禁止提交 TODO 的检查,接到 CI 里每次:想给项目加一条禁止提交 TODO 的检查,接到 CI 里每次 PR 自动跑。
适用人群
- 后端工程师
- 代码重构与迁移工程师
- 团队代码质量负责人
使用步骤
- 指定待处理的代码目录并声明目标编程语言。
- 使用占位符编写符合语法树结构的代码匹配模式与替换模板。
- 运行默认的替换命令预演,检查涉及的文件和代码差异。
- 确认改动无误后添加应用参数,将修改实际写入文件。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-10
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
AST-aware structural code search and rewrite via ast-grep.
依赖与权限
- 读取用户主动提供的内容