@kafeg/pi-grep-ast
基于AST的代码搜索工具，提供结构化上下文和行号
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@kafeg/pi-grep-ast。 它的用途是：基于AST的代码搜索工具，提供结构化上下文和行号 完整的 Skill 内容见：https://321skill.com/skills/kafeg-pi-grep-ast/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用grep-ast技能，在src目录下搜索所有调用`fetchData`函数的地方。'，它会解析目录下的代码AST，应用匹配`fetchData`的模式，并返回每个匹配所在的文件名和精确行号，帮助你快速定位相关代码逻辑。
介绍
这是一个为Pi AI平台设计的代码搜索扩展，它解决了传统文本搜索在代码库中定位特定模式时缺乏语义理解、容易产生误报或遗漏的问题。该工具通过解析代码的抽象语法树（AST），让正则表达式搜索能感知代码结构，从而更精准地找到目标代码片段，并附带行号信息，便于快速定位。
使用时，开发者可以在Pi中调用该技能，输入正则表达式和目标文件或目录。工具会先解析代码的AST，然后在语法结构的上下文中应用正则表达式进行匹配，最终返回带有行号的、结构清晰的搜索结果。这避免了在字符串层面搜索时匹配到注释、字符串字面量等非代码逻辑部分。
它非常适合需要频繁审查、分析或重构代码的开发者，尤其是前端开发、后端开发和全栈开发人员。在进行代码静态分析、排查代码漏洞或梳理代码结构时，它能显著提升效率和准确性。
建议在需要对大型或复杂代码库进行模式匹配时使用此工具。请注意，其效果依赖于正则表达式的编写质量和代码语言的AST解析支持。对于非结构化的文本文件或工具不支持的语言，其优势可能无法发挥。
核心特点
与传统的纯文本grep工具相比，它通过集成AST解析，使正则表达式搜索能区分代码逻辑、注释和字符串，大幅减少误报；同时，它专为Pi AI平台设计，搜索结果直接整合了行号，便于在AI对话中快速引用和跳转。
注意事项
不适合搜索非代码的纯文本文件，或工具未提供AST解析器的编程语言。
常见问题
pi-grep-ast支持哪些编程语言？
具体支持的语言需查看其官方文档，通常支持JavaScript/TypeScript等主流语言。
它和IDE自带的搜索有什么区别？
它通过AST提供更精准的语义搜索，并能作为Pi AI的技能被调用和集成到自动化流程中。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/kafeg-pi-grep-ast/raw/index.md 读取 @kafeg/pi-grep-ast 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/kafeg-pi-grep-ast/raw/index.md（查看排版版本）