pi-codebase-reader
基于AST的智能代码库阅读器，为PI提供文件概览与探索能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-codebase-reader。 它的用途是：基于AST的智能代码库阅读器，为PI提供文件概览与探索能力。 完整的 Skill 内容见：https://321skill.com/skills/pi-codebase-reader/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用codebase reader分析一下./src目录下的代码结构。” 它会扫描目录，基于AST生成每个文件的核心类、函数和导出项大纲。接着你可以继续问：“详细解释一下UserService这个类的主要方法。” 其内置的探索子代理会定位到该文件并为你详细解读。
介绍
该Skill旨在解决开发者在面对复杂或陌生代码库时，难以快速理解项目结构和文件核心逻辑的问题。它通过解析代码的抽象语法树（AST），生成清晰的文件大纲，帮助开发者迅速把握代码脉络。
使用时，开发者只需在PI中调用该Skill并指定目标代码库路径，它便会自动分析代码，生成结构化的文件概览。此外，它还集成了一个探索子代理，可以进一步深入回答关于代码库的特定问题，实现交互式探索。
它非常适合需要快速审查、熟悉或维护大型代码库的开发者，尤其是全栈工程师、技术负责人或接手遗留项目的程序员。对于参与代码审计、开源项目贡献或新员工入职熟悉代码的场景尤为有用。
建议在初次接触项目或进行代码审查时优先使用此Skill获取宏观视图。注意，其分析深度和准确性依赖于代码本身的可解析性，对于极度混乱或包含大量动态生成代码的项目，效果可能打折扣。
核心特点
核心区别在于其基于AST进行深度代码结构解析，而非简单的文件列表或关键词匹配，能提供更精准的函数、类定义等大纲信息；并且内置了可交互的探索子代理，允许进行多轮对话式代码查询。
注意事项
不适合分析非文本格式的二进制文件，或语法极度不规范导致AST解析失败的代码。
常见问题
pi-codebase-reader支持哪些编程语言？
主要支持常见语言如JavaScript/TypeScript、Python等，具体取决于底层AST解析器的能力。
需要联网使用吗？
不需要，代码分析在本地完成，但安装时需要从npm获取包。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-codebase-reader/raw/index.md 读取 pi-codebase-reader 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-codebase-reader/raw/index.md（查看排版版本）