pi-codegraph-fix

为Pi编码代理集成CodeGraph,并修复跨项目会话路径问题。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-codegraph-fix。
它的用途是:为Pi编码代理集成CodeGraph,并修复跨项目会话路径问题。
完整的 Skill 内容见:https://321skill.com/skills/pi-codegraph-fix/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请用CodeGraph分析一下当前项目的入口文件和主要模块的依赖关系。”,它会基于正确的工作目录调用CodeGraph,返回清晰的代码依赖图,帮助你快速理解项目架构。或者在进行跨项目调试时,AI能准确引用不同仓库中的相关代码片段。

介绍

此Skill是一个针对Pi编码代理的扩展,核心功能是将CodeGraph作为一个MCP(模型上下文协议)侧车工具进行集成。它主要解决了在Pi代理的跨项目编码会话中,工作目录上下文(ctx.cwd)可能不正确或丢失的问题,确保CodeGraph能准确分析不同项目中的代码结构。

使用时,你需要确保Pi编码代理和CodeGraph服务已就绪。安装此扩展后,Pi代理在调用CodeGraph分析代码时,会自动应用修复,正确传递当前项目的工作目录,从而获得准确的代码依赖图、函数调用关系等信息。

它非常适合需要频繁在多个代码仓库或项目间切换进行代码分析、重构或理解的开发者。特别是那些依赖Pi代理进行深度代码理解和导航,但遇到因项目路径错误导致分析失效的用户。

建议在安装前确认你的Pi代理版本兼容性。由于它依赖于CodeGraph作为后端服务,请确保CodeGraph已正确配置并运行。在单一项目环境中,此修复可能不明显,但在多项目工作流中价值显著。

核心特点

核心区别在于专门修复了Pi代理在跨项目会话中传递给CodeGraph的工作目录上下文错误,这是许多同类集成工具未处理的问题,确保了多项目环境下代码分析的准确性。

注意事项

不适合仅进行单项目开发或不需要使用CodeGraph进行深度代码结构分析的用户。

常见问题

这个扩展和原版pi-codegraph有什么区别?

主要增加了对跨项目会话中工作目录上下文的修复,解决了原版可能出现的路径错误问题。

必须要有CodeGraph服务才能用吗?

是的,这是一个集成扩展,需要后端CodeGraph服务支持才能提供代码分析功能。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-codegraph-fix/raw/index.md 读取 pi-codegraph-fix 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。