pi-diet-ast
为Pi提供按需的AST结构搜索与替换工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-diet-ast。 它的用途是：为Pi提供按需的AST结构搜索与替换工具。 完整的 Skill 内容见：https://321skill.com/skills/pi-diet-ast/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘使用pi-diet-ast，帮我把项目中所有`console.log(error)`替换为`logger.error(error)`，但不要改动`console.info`。’ 它会分析代码结构，定位所有`console.log`调用且参数为`error`的AST节点，并生成安全的替换脚本。或者，你可以直接运行工具并指定自定义的AST模式规则文件。
介绍
pi-diet-ast 旨在解决开发者在Pi环境中进行代码重构、模式匹配和批量修改时，传统文本搜索替换不够精确和灵活的问题。它基于抽象语法树（AST）进行结构化的搜索与替换，能够智能地理解代码结构，避免因格式差异或简单文本匹配导致的错误修改。
使用该工具，开发者可以通过定义特定的AST模式（pattern）来精确匹配代码中的目标结构，并指定替换规则。通常通过命令行或集成到构建流程中调用，例如在项目根目录运行相关命令，工具会扫描指定文件，应用规则进行安全的代码转换。
它非常适合前端、后端及全栈开发人员，尤其是那些需要维护大型代码库、进行代码迁移（如框架升级、API变更）、实施代码规范或编写自定义代码转换脚本的工程师。对代码质量和重构效率有较高要求的团队也能从中受益。
使用前建议仔细阅读AST模式语法文档，并在非生产分支或副本上先行测试替换规则，确保转换符合预期。由于依赖于具体的AST解析器，需确认其支持的编程语言与你的项目技术栈匹配。
核心特点
核心在于提供“按需”（on-demand）的AST操作能力，直接集成于Pi环境，而非通用的独立AST工具；其搜索替换规则针对Pi项目的常见代码模式进行了优化，开箱即用性更强。
注意事项
不适合对非文本源代码（如二进制文件）或该工具AST解析器不支持的语言进行结构化处理。
常见问题
pi-diet-ast 能处理哪些编程语言？
主要处理Pi项目相关的语言（如JavaScript/TypeScript），具体支持需查看其AST解析器配置。
和直接使用sed或IDE全局替换有什么区别？
基于AST结构匹配，能理解代码逻辑，避免破坏语法或误改相似文本，更安全精准。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-diet-ast/raw/index.md 读取 pi-diet-ast 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-diet-ast/raw/index.md（查看排版版本）