@akaza21/pi-codeindex
为Pi Agent和命令行提供本地代码导航与结构分析工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@akaza21/pi-codeindex。 它的用途是：为Pi Agent和命令行提供本地代码导航与结构分析工具。 完整的 Skill 内容见：https://321skill.com/skills/akaza21-pi-codeindex/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析一下项目根目录下 `src/utils/auth.ts` 文件中 `validateToken` 函数的调用关系。”，它会调用 pi-codeindex 生成该函数的调用图，展示所有调用它的位置以及它内部调用的其他函数，并以清晰的结构呈现。或者，你可以说：“在 `src/components` 目录下搜索所有使用了 `useState` 钩子且包含 `async` 关键字的React函数组件。”，它会执行一次结构搜索并返回匹配的代码片段列表。
介绍
这个Skill旨在解决开发者在本地代码库中难以快速理解代码结构、追踪调用关系和进行精确搜索的问题。它通过建立本地索引，为Pi Agent和命令行工具提供强大的代码导航能力，包括生成调用图、支持结构搜索和SCIP协议。
使用时，开发者需要先安装该Skill，并在目标代码库中运行索引命令。之后，无论是通过Pi Agent的对话界面还是命令行，都可以查询函数定义、查看调用关系、进行结构化的代码搜索，从而快速定位和理解代码逻辑。
它非常适合需要频繁阅读、审查或重构大型、复杂代码库的开发者，如全栈工程师、智能体开发者和维护遗留系统的工程师。对于需要深入分析项目架构或排查跨文件依赖问题的场景尤其有帮助。
建议在初次使用前，为你的核心项目建立完整的索引。由于索引过程可能消耗一定时间和计算资源，建议在开发间歇期进行。注意，它主要服务于代码理解和导航，而非直接的代码编辑或构建任务。
核心特点
核心区别在于它专为Pi Agent生态深度集成，提供了基于SCIP的精确结构搜索和调用图生成，而不仅仅是简单的文本搜索或符号跳转。这使得在复杂项目中进行跨文件的逻辑关系追踪和模式匹配更加高效和准确。
注意事项
不适合用于实时编辑代码或执行构建、测试等开发流水线任务。
常见问题
pi-codeindex 支持哪些编程语言？
它通过SCIP协议支持多种语言，具体取决于底层索引器（如LSIF/SCIP索引器）的支持范围，通常包括TypeScript/JavaScript、Java、Go、Python等主流语言。
这个工具需要网络连接吗？
核心的代码索引和导航功能完全在本地运行，无需网络连接，保护了代码隐私。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/akaza21-pi-codeindex/raw/index.md 读取 @akaza21/pi-codeindex 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/akaza21-pi-codeindex/raw/index.md（查看排版版本）