@alpsckr/pi-codegraph
在 pi 中集成 CodeGraph 代码索引与搜索工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@alpsckr/pi-codegraph。 它的用途是：在 pi 中集成 CodeGraph 代码索引与搜索工具 完整的 Skill 内容见：https://321skill.com/skills/alpsckr-pi-codegraph/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我追一下 UIManager 到 ViewBase 的调用链”，它会调用 codegraph_trace 工具从代码索引中提取调用关系，并返回从 UIManager 到 ViewBase 的完整路径，包括每个中间函数和文件位置。或者你说“改 UIManager 会影响哪些地方？”，它会使用 codegraph_impact 工具分析影响范围，列出所有依赖该模块的代码区域。
介绍
这个 Skill 解决了在 AI 编码过程中无法高效理解代码结构、追踪调用链、分析影响范围的问题。开发者经常需要手动翻阅代码或依赖外部工具才能获取这些信息，而 pi-codegraph 将 CodeGraph 的代码索引能力直接嵌入到 pi 环境中，让 AI 代理可以实时查询代码关系。
使用方式很简单，你只需要先安装扩展并执行 /codegraph init 初始化项目索引。之后就可以通过自然语言指令来查询代码结构、调用链、影响范围等，例如“帮我追一下 UIManager 到 ViewBase 的调用链”。所有操作都在 pi 的对话界面内完成，无需切换工具。
它非常适合需要频繁进行代码理解、重构、Bug 排查的开发者团队或个人。尤其是那些使用 AI 编码助手（如 Claude、Cursor）但希望获得更精准代码上下文的人群，以及需要快速熟悉陌生项目的新成员。
建议在项目初期就初始化索引，并定期使用 /codegraph sync 同步代码变更。需要注意的是，它主要依赖本地文件系统，索引文件存储在 .codegraph/ 目录中，不要与 CodeGraph MCP 同时启用，否则会导致工具重复。
常见问题
如何安装 pi-codegraph？
在 pi 终端中执行 `pi install npm:@alpsckr/pi-codegraph`，然后执行 `/reload` 即可。首次使用需要运行 `/codegraph init` 初始化索引。
可以同时使用 CodeGraph MCP 和这个扩展吗？
不建议同时启用，否则模型会看到两套 CodeGraph 工具，导致工具重复或冲突。建议只使用其中一种。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/alpsckr-pi-codegraph/raw/index.md 读取 @alpsckr/pi-codegraph 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/alpsckr-pi-codegraph/raw/index.md（查看排版版本）