pi-shazam
为AI编码助手提供代码库结构感知与分析的工具集。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-shazam。 它的用途是：为AI编码助手提供代码库结构感知与分析的工具集。 完整的 Skill 内容见：https://321skill.com/skills/pi-shazam/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我分析一下`src/services`目录下的模块依赖关系，并建议如何解耦。” AI会调用Pi-Shazam的工具分析该目录的结构和导入导出关系，然后基于分析结果给出具体的解耦建议，比如提取公共接口或引入依赖注入。
介绍
Pi-Shazam 是一个专为 AI 编码助手设计的原生工具包，旨在解决 AI 在处理大型或复杂项目时，因缺乏对代码库整体结构的理解而导致的代码生成不准确、上下文理解偏差或重构建议不合理等问题。它通过提供七种结构分析工具，帮助 AI 深入洞察代码库的模块划分、依赖关系、文件组织等关键信息。
使用方式非常便捷，开发者可以通过 npm 直接安装，并将其配置到支持 MCP（Model Context Protocol）的 AI 编码工具中，例如 Cursor、Claude Desktop 或 Windsurf。配置完成后，AI 助手在分析或操作代码时，便能主动调用 Pi-Shazam 提供的分析能力，获取更精准的代码库上下文。
这个工具非常适合那些在复杂项目中重度依赖 AI 助手（如 Claude、Cursor）进行代码编写、重构或系统理解的开发者。无论是接手一个遗留项目、进行大规模代码审查，还是规划模块拆分，Pi-Shazam 都能为 AI 提供必要的“地图”，提升协作效率。
建议在项目初期或进行重大架构调整前启用此工具，以便 AI 获得最佳的结构认知。需要注意的是，其分析基于静态代码结构，对于高度动态或运行时生成的结构可能效果有限，且分析大型代码库可能需要一定时间。
核心特点
它并非通用的代码分析工具，而是专为增强AI编码助手（特别是Pi coding agent）的“代码库感知”能力而设计，原生集成了7种针对性的结构分析视角；同时，它通过支持MCP协议，能无缝接入Cusor、Claude Desktop等主流AI编码环境，实现开箱即用的深度集成。
注意事项
不适合用于分析严重依赖运行时动态生成代码或结构的项目。
常见问题
Pi-Shazam 支持哪些AI工具？
支持所有兼容MCP协议的工具，如Cursor、Claude Desktop、Windsurf等。
它和普通的代码导航插件有什么区别？
核心区别是它专为AI设计，提供结构化分析数据供AI理解，而非直接给人提供图形化导航界面。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-shazam/raw/index.md 读取 pi-shazam 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-shazam/raw/index.md（查看排版版本）