@vladstudio/pi-skim
快速提取JS/TS/Swift代码结构，无需阅读源码
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@vladstudio/pi-skim。 它的用途是：快速提取JS/TS/Swift代码结构，无需阅读源码 完整的 Skill 内容见：https://321skill.com/skills/vladstudio-pi-skim/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请帮我速览一下 `src/utils/apiClient.ts` 这个文件的主要结构和导出。’ 它会调用 pi-skim 工具，快速解析该文件，并返回其中定义的所有导出函数、它们的类型签名、以及可能使用的关键依赖，让你在几秒钟内掌握该模块的职责和接口。
介绍
在开发或审查大型代码库时，快速理解文件的核心结构（如导出了什么、函数签名、使用了哪些钩子）往往需要通读大量源码，效率低下。pi-skim 通过 ast-grep 技术，直接解析抽象语法树，能瞬间生成代码文件的结构化概览，包括导出项、函数签名、React Hooks 使用情况等关键信息，而无需加载和阅读完整的源代码文件。
使用方式非常简单，在支持 Pi 扩展的 AI 开发环境中（如 Cursor、Claude 等），安装此 Skill 后，即可通过指令或对话触发对指定代码文件的“速览”分析。例如，你可以直接要求 AI 助手“速览一下 src/components/Button.tsx 文件”，AI 便会调用此工具并返回清晰的结构报告。
它非常适合需要快速熟悉新项目代码结构的开发者、进行代码审查的工程师、以及希望提高代码导航效率的任何人。对于维护大型遗留项目或参与开源项目贡献的初期阶段，这个工具能显著降低理解成本。
建议在需要初步评估文件内容、寻找特定导出或理解模块依赖关系时使用。需要注意的是，它提供的是结构概览，而非完整的逻辑实现细节，因此深度调试或理解复杂算法时，仍需结合具体代码阅读。
核心特点
与同类代码摘要工具相比，它不依赖语言服务器或复杂的索引，而是基于轻量级的 ast-grep，启动和解析速度极快；同时，它专注于输出开发者最关心的“结构”信息（如 exports, hooks, signatures），而非生成自然语言描述，结果更精确、格式更统一。
注意事项
不适合需要理解复杂函数内部具体实现逻辑或算法细节的场景。
常见问题
pi-skim 支持哪些编程语言？
目前支持 JavaScript, JSX, TypeScript, TSX 和 Swift。
使用它需要预先建立项目索引吗？
不需要，它基于 ast-grep 实时分析单个文件，无需索引。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/vladstudio-pi-skim/raw/index.md 读取 @vladstudio/pi-skim 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/vladstudio-pi-skim/raw/index.md（查看排版版本）