intentbar 是一个通过自然语言快速导航的解决方案，本技能负责将其完整接入现有代码库。由于 intentbar 未发布到 npm，所有代码随技能提供，需要手动复制到项目中。
用途
帮助开发者在自己的项目中安装并配置 intentbar，使用户能够通过自然语言查询快速跳转到应用内的目标页面。最终交付一个可用的命令面板，而非仅有一个待填写的配置文件。
主要能力
- 源码复制：将技能自带的 src/、templates/ 和 docs/ 目录中的代码复制到项目合适位置，无需构建步骤，依赖为零。
- 站点地图生成：指导 Agent 阅读代码库中的路由、组件、翻译文件和导航标签，编写符合用户语言的 sitemap，包含每个目的地的描述和意图列表。
- 服务端处理程序挂载：提供 createHandler 用于创建 API 端点，支持 Next.js App Router 等框架，API Key 保留在服务端。
- 命令面板集成：若项目已有命令面板，则向其中添加 AI 解析行；若没有，则复制模板中的命令面板组件，并绑定 ⌘K/Ctrl+K 快捷键。
- 回退行配置（可选）：当查询不是目的地时，可将查询转发到聊天或搜索页面。
使用方式
技能按步骤执行：
- 复制源码到项目，根据项目布局选择目标目录并记录别名。
- 学习应用：找出所有只读路由，理解每个页面的用途，收集用户词汇（翻译文件、导航标签、页面标题、帮助文档等），记录支持的语言。
- 编写 sitemap：创建 intentbar.sitemap.ts，使用 defineSitemap 定义目的地，每个条目包含 id、path、breadcrumb、description 和 intents。保持 sitemap 精简（建议 15–30 个目的地），每个目的地配置 6–12 个意图。
- 挂载处理程序：在服务端创建 API 路由，使用项目已有的认证辅助函数进行授权。
- 设置密钥：将 OPENAI_API_KEY 添加到服务端环境变量，不得暴露给客户端。
- 集成命令面板：检查现有命令面板，若有则添加解析行；若无则复制模板，需确保项目已配置 Tailwind 和 shadcn/ui，并调整导入别名。
- 配置回退行（可选）：为无法匹配查询提供回退路径。
适用场景
- 希望为 Web 应用添加自然语言导航功能的团队。
- 使用 Next.js、React Router 或 TanStack Router 的项目。
- 已有命令面板或愿意引入 shadcn/ui 命令面板的项目。
- 需要多语言支持的应用（意图列表需覆盖所有发布语言）。
限制
- 仅支持只读目的地，不包含 API 路由、创建/删除流程、结账、登出等操作型页面。
- 依赖 OpenAI API，需要配置 OPENAI_API_KEY。
- 命令面板模板需要 Tailwind CSS 和 shadcn/ui，否则需改用无头 hook 或先安装依赖。
- sitemap 大小直接影响每次查询的 token 成本和响应速度，需控制在合理范围。
- 多租户支持为可选功能，仅当 URL 中包含工作区、团队、组织或项目标识时启用。
- 具体收费、价格、平台兼容性等细节暂未提供。