pi-codebase-router
为Pi提供索引优先的代码库路由，优先使用语义索引而非传统搜索。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-codebase-router。 它的用途是：为Pi提供索引优先的代码库路由，优先使用语义索引而非传统搜索。 完整的 Skill 内容见：https://321skill.com/skills/pi-codebase-router/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“在我的项目里，找到处理用户认证的所有相关函数和组件。” 它会优先查询语义索引，返回与“用户认证”语义相关的代码文件、函数定义及其调用关系，而不是仅仅包含“auth”字样的所有文件。接着你可以问：“这个登录组件的状态管理逻辑是怎样的？” AI会基于索引上下文给出更精准的解释。
介绍
pi-codebase-router 旨在解决开发者在大型代码库中快速、精准定位代码的痛点。传统 grep 或 shell 搜索依赖关键词匹配，在理解代码语义和上下文方面存在局限，导致搜索结果不精确或遗漏。该技能通过集成 opencode-codebase-index 语义索引，将自然语言查询映射到代码库的语义层面，从而提供更符合开发者意图的代码片段、函数或文件位置。
使用方式简单直接。开发者只需在 Pi 中安装此技能，即可在对话中直接询问关于代码库的问题。技能会自动优先查询语义索引，仅在必要时回退到 grep/shell 等传统搜索方式，确保效率和准确性。它还提供了 guardrails（防护机制）、cb* 提示词模板、工作流技能，并支持会话开始或写入后自动索引等可选功能，形成一个完整的代码导航增强方案。
该技能特别适合需要频繁在复杂或陌生代码库中工作的开发者，例如接手遗留项目、进行代码审查或快速理解新模块。无论是前端、后端还是全栈开发者，都能从中受益，显著减少“找代码”的时间消耗，将精力更集中于核心开发任务。
建议在初次使用前，为你的项目代码库建立完整的语义索引，以获得最佳体验。对于频繁变更的代码库，可以启用 after-write auto-indexing 功能以保持索引的实时性。需要注意的是，语义索引的构建和查询会消耗一定的计算资源，在超大型项目或资源受限的环境下可能需要权衡。
核心特点
核心区别在于其“索引优先”的路由策略，强制优先使用 opencode-codebase-index 语义索引进行代码搜索，仅在索引不可用或失败时才降级到 grep/shell，这比单纯提供多种搜索方式的技能更能保证搜索结果的语义相关性和准确性。
注意事项
不适合仅需简单文件名或固定字符串匹配的轻量级搜索场景，且初次建立大型代码库的语义索引需要一定时间。
常见问题
这个技能和直接用 grep 命令有什么区别？
它优先使用语义索引理解你的查询意图，返回相关代码片段，而 grep 仅进行文本匹配，在复杂代码库中准确率更高。
需要提前为我的代码库做额外配置吗？
是的，为了发挥最大效用，你需要先为你的代码库建立 opencode-codebase-index 语义索引，技能提供了自动索引的选项来简化这个过程。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-codebase-router/raw/index.md 读取 pi-codebase-router 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-codebase-router/raw/index.md（查看排版版本）