@yusukeshib/pi-ast-read
低Token消耗语义化按需读取大型源码工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@yusukeshib/pi-ast-read。 它的用途是：低Token消耗语义化按需读取大型源码工具 完整的 Skill 内容见：https://321skill.com/skills/yusukeshib-pi-ast-read/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“用pi-ast-read列出src/main.ts的所有符号大纲”，它会解析文件AST并返回所有函数、类、接口的列表及位置信息。
对AI说：“读取src/main.ts中handleRequest函数的完整代码”，它会仅拉取该函数对应的代码片段，无需加载整个文件。
介绍
日常使用大模型处理大型源码文件时，全量读取文件内容会消耗大量Token，不仅提升调用成本，还容易因上下文窗口限制丢失关键信息。多数场景下用户仅需要文件中特定函数、类等局部内容，全量加载的性价比极低。 使用时它会先基于AST解析目标源码文件，快速提取文件内的所有符号（包括函数、类、接口、顶层变量等）生成结构化大纲，你可以先通过大纲定位到需要的目标符号，再单独拉取对应符号的代码片段，无需加载整个文件的全量内容。 适合需要让AI分析大型项目源码的前后端开发者、开展代码审计的安全研发人员、刚接手陌生项目需要快速梳理代码结构的新员工、基于大模型开发代码辅助工具的研发人员。 使用前建议先确认目标文件的编程语言是否在当前版本的支持列表内，定位到目标符号后再发起读取请求，避免一次性拉取过多无关符号，才能最大化发挥节省Token、提升处理效率的优势。
核心特点
不同于普通粗粒度源码分块读取工具，它基于AST做语义级符号解析，先输出全文件符号大纲再按需读取指定片段，Token消耗更低，目标代码定位更精准。
注意事项
仅支持解析语法合规的结构化源码文件，无法处理非代码文本或存在严重语法错误的代码。
常见问题
使用这个工具能节省多少Token？
通常可节省70%以上的无效Token，源码文件越大节省效果越明显。
目前支持哪些编程语言？
当前优先支持JavaScript/TypeScript，其他语言支持可关注官方更新。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/yusukeshib-pi-ast-read/raw/index.md 读取 @yusukeshib/pi-ast-read 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/yusukeshib-pi-ast-read/raw/index.md（查看排版版本）