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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-codegraph-fix/raw/index.md(查看排版版本)