@isac322/pi-codegraph
为Pi和OMP提供工作树感知的代码图索引管理工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@isac322/pi-codegraph。 它的用途是：为Pi和OMP提供工作树感知的代码图索引管理工具。 完整的 Skill 内容见：https://321skill.com/skills/isac322-pi-codegraph/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我为当前Pi项目的main分支初始化CodeGraph索引。”，它会引导你运行相应的初始化命令并配置监听。或者，在切换工作树后
对AI说：“同步一下新工作树的代码索引。”，它会触发工具更新索引以匹配新环境。
介绍
该Skill旨在解决开发者在Pi和OMP平台上进行代码分析时，因多工作树（worktree）环境导致的代码索引混乱、更新不及时或占用过多资源的问题。它通过一套工具集，自动化管理代码图的索引生命周期，确保索引与当前活跃的工作树状态保持一致。
使用时，开发者通常需要先通过npm安装此包，然后在项目中配置或运行相应的命令来初始化和维护代码图索引。该工具能够监听工作树的切换，自动挂起非活跃索引、激活或重建当前工作树所需的索引，从而集成到现有的开发流程中。
它非常适合在Pi或OMP生态中进行中大型项目开发、需要频繁切换分支或工作环境的团队开发者，以及对代码导航、依赖分析、重构等有较高要求的工程师。
建议在项目初期或引入新工作流时进行配置，并注意其可能对构建或开发服务器产生的额外资源开销。对于小型或单工作树项目，其收益可能不明显。
核心特点
核心区别在于其“工作树感知”能力，能根据git worktree的切换自动管理对应的代码图索引，而同类工具通常只管理单一代码库的静态索引。
注意事项
不适用于不使用git worktree或代码结构极其简单的项目。
常见问题
这个工具支持哪些代码分析功能？
主要提供代码图索引的生成与管理，为上层代码导航、搜索、依赖分析等工具提供基础支持。
它和普通的代码索引工具有什么不同？
它能感知并自动适配多个git工作树，为每个工作树维护独立的索引，避免交叉污染。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/isac322-pi-codegraph/raw/index.md 读取 @isac322/pi-codegraph 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/isac322-pi-codegraph/raw/index.md（查看排版版本）