Expo Router 导航助手
为 Expo 应用设计文件路由与原生导航结构。
内容主要提供导航代码指导,未见恶意行为、凭据处理、数据外传或高危外部操作;README披露遥测默认关闭并说明数据范围,且有MIT许可证。扣分在于技能本身缺少用户确认、变更回滚、依赖安全和数据流边界说明,且发布者在本评估注册表中未验证、维护责任不清。
路由、链接、Stack、表单页、标签和搜索均有具体示例及部分故障排查;但存在SDK 54/55/56和iOS版本差异,若不匹配会导致API或导入错误,且未见针对关键路径的测试、类型检查或可复现执行证据。按静态上限和不确定性扣分。
目标场景和覆盖范围清晰,包含路由结构、动态路由、NativeTabs、搜索、表单页和iOS工具栏,并标注若干平台与SDK限制。扣分在于非适用边界、触发条件、输入输出契约和中文使用支持不充分;部分核心能力依赖Expo Router及特定SDK,但不完全依赖海外在线服务。
Front matter包含名称、描述、版本和MIT许可证;文档按主题拆分引用,提供示例、限制和常见问题,README还说明安装与更新路径,仓库有基础CI检查。扣分在于缺少技能级变更日志、维护负责人、稳定的兼容性矩阵和更完整的安装前置依赖说明,且部分引用文档位于未提供的references目录之外。
技能能直接给出常见Expo Router导航结构和代码样例,覆盖面较广,具有相对手写查找的边际价值。扣分在于示例未被静态外部执行验证,部分API受SDK、平台和实验性状态限制,缺少从用户需求到完整可交付改动的验证步骤,仍需项目级适配和复核。
证据包括结构化源文件、具体代码样例、版本限制、限制项及指向Expo官方文档的引用;仓库也有通用技能限制和版本检查CI。扣分在于没有技能专属测试、执行日志或第三方复现结果,且无法仅凭给定材料核验多数API示例的当前正确性。
- 使用前核对项目的Expo SDK、expo-router版本及目标平台;示例混用SDK 54、55、56和iOS 18/26能力。
- NativeTabs来自unstable API,工具栏和部分Zoom/表单页能力具有明确的平台或SDK限制,不能假设跨平台等价。
- 文档强调移除旧路由文件和修改导航结构,但没有提供迁移前备份、确认或回滚流程。
- 应将Expo官方文档和实际类型检查作为最终依据,静态技能内容可能落后于依赖版本。
这个 Skill 能做什么,适合哪些场景?
这是一个面向 Expo Router 应用的开源导航技能,覆盖文件路由、动态路由、路由分组和目录组织。它指导开发者使用 Link、原生 Stack、页面标题、模态页、表单页、NativeTabs、标题栏、工具栏和搜索栏。技能还提供路由结构、标签页、表单页、搜索及缩放转场等参考文档。它适合正在构建或重构 Expo Router 导航的开发者,但不负责屏幕样式、颜色、控件、动画或视觉效果。
它读取并依据 Expo Router 的路由参考文档,指导开发者在 app 目录中组织路由、创建 _layout.tsx 栈布局、配置动态路由和路由分组,并使用 Link、Link.Preview、Link.Menu、Stack、Stack.Title、模态页、表单页和 NativeTabs 编写导航代码。它还规定文件命名、路径别名和路由文件迁移规则,并给出标题栏、工具栏、搜索栏及 Apple Zoom 转场的配置示例。
- 正在创建 Expo Router 应用、需要从零设计 app 目录和文件路由结构的开发者。
- 需要在多个标签页之间共享详情页或其他公共页面的开发者。
- 希望为 iOS 导航加入链接预览、长按菜单、原生标题栏或搜索栏的开发者。
- 需要将某个页面配置为模态页或可调整高度的表单页的开发者。
- 正在重构导航目录、移动旧路由文件并希望避免路由组织反模式的开发者。
这个 Skill 有哪些优点和局限?
- 覆盖 Expo Router 常见导航能力,包括文件路由、原生栈、标签页、模态页和表单页。
- 提供具体的 TypeScript/TSX 配置示例和路由组织规则。
- MIT 许可,且由 Expo 团队维护的官方技能集合提供。
- 范围集中于导航和路由,不覆盖屏幕样式、颜色、控件、动画、媒体或视觉效果。
- 源资料未提供测试套件、支持平台验证结果或故障排查案例。
- 部分建议涉及 iOS 专属能力或版本条件,例如搜索栏和 Apple Zoom 转场。
如何安装这个 Skill?
该技能属于 expo/skills 仓库的 23 个技能之一。使用 Skills CLI 安装整套技能:npx skills@latest add expo/skills --skill '*',然后从项目根目录运行并重启或刷新智能代理会话。Claude Code 可运行 claude plugin install expo@claude-plugins-official;Codex 可运行 codex plugin add expo@openai-curated。源资料未提供仅初始安装 expo-router 单个技能的 CLI 命令。
如何使用这个 Skill?
安装后,在 Expo Router 项目中向代理提出具体导航任务,例如:Build a native-feeling Expo Router screen with tabs, modals, and headers. 代理会根据任务上下文选择该技能,并参考其 route-structure.md、tabs.md、toolbar-and-headers.md、form-sheet.md、search.md 和 zoom-transitions.md 文件。