React Navigation 导航构建指南
为 React Native 应用提供 React Navigation 7 导航界面的选型与实现参考。
内容限于 React Navigation 配置与 UI 模式,没有凭据、数据访问、外部副作用或破坏性操作,符合低权限范围;但未提供用户确认、回滚或敏感数据处理说明,且作者身份未被验证,因此扣分。
文档明确限定 React Navigation 7,覆盖 API 选择、平台前置依赖和多项 Android/iOS/web 限制,降低误用风险;但没有测试、CI、版本兼容矩阵或可诊断的失败反馈,静态证据不足,故扣分。
目标用户、适用场景和不适用范围较清楚,涵盖 stacks、tabs、drawers、sheets、headers 与 safe areas,并说明平台限制;但没有中文使用说明,触发条件仍较宽泛,且未评估中国大陆网络下外部文档可达性,故扣分。
采用主文件路由到分主题 reference 的渐进式结构,包含 MIT 许可证、依赖前置条件、示例、相关主题和限制说明;但缺少独立的维护责任、更新路径、变更记录和明确版本治理,故扣分。
提供大量 Static API 与 Dynamic API 示例,能够直接指导常见 React Navigation 7 导航 UI 实现;但示例未在文件中提供执行验证,覆盖完整应用集成、错误处理和项目依赖协调有限,按静态上限给分。
引用了 React Navigation 和 React Native 的规范文档,并提供可审计的代码示例与平台条件;但没有提交测试、CI 执行结果或第三方复现证据,静态可验证性有限,故扣分。
- 仅适用于 React Navigation 7;项目若使用其他版本,示例和 API 可能失效。
- 抽屉、Material top tabs、native bottom tabs、form sheets 等功能依赖额外原生包、平台版本或构建配置,安装与兼容性仍需在目标项目中核验。
- 文档包含部分 unstable API 和面向未来平台版本的功能,升级 React Native、Expo 或 React Navigation 前应重新核对官方文档。
- 本评估未执行示例、测试或构建,也未验证引用文档在中国大陆网络中的可达性。
这个 Skill 能做什么,适合哪些场景?
该技能面向使用 React Navigation 7 构建 React Native 导航界面的开发者。它覆盖堆栈、底部标签、原生底部标签、顶部标签、抽屉和表单页等模式,也涉及标题栏及安全区域处理。对于已有导航项目,它建议沿用现有的静态或动态 API;新项目则优先考虑静态 API。技能通过多个主题参考文件,将具体问题映射到相应的实现指南。
它检查现有项目采用的导航 API 风格,并据此选择静态 API 或动态 API 的参考方式;针对堆栈、标签、抽屉、表单页、标题栏和安全区域等问题,定位到对应的 Markdown 参考文件;输出面向 React Navigation 7 的导航 UI 实现指导。
- React Native 开发者需要组织页面和模态界面时,参考堆栈导航模式。
- 开发者需要实现底部标签、响应式侧边栏或原生 iOS/Android 标签时,选择相应的标签导航指南。
- 开发者需要加入底部表单页或其他表单页界面时,参考 form-sheet 指南。
- 开发者需要配置底部标签或抽屉导航器的标题栏时,使用标题栏参考。
- 开发者需要处理状态栏、标题栏内边距或标签栏内边距时,使用安全区域指南。
这个 Skill 有哪些优点和局限?
- 覆盖堆栈、多个标签导航、抽屉、表单页、标题栏和安全区域等常见导航 UI 场景。
- 提供问题到参考文件的明确映射,便于按需查阅。
- 同时说明静态 API 与动态 API 的选型原则。
- 采用 MIT 许可证。
- 明确只适用于 React Navigation 7,其他版本的 API 和模式可能不适用。
- 源码仅展示 SKILL.md,未提供参考文件内容、测试结果或平台验证证据。
- 安装说明针对整个技能集合,单独安装该技能的步骤未被文档化。
- 内容聚焦导航 UI,不涵盖更广泛的 React Native 性能、升级或测试工作流。
如何安装这个 Skill?
该仓库提供的是包含多个技能的集合。源码 README 记录的 Codex 项目级安装方式是:git clone https://github.com/callstackincubator/agent-skills.git;cp -r agent-skills/skills/* .codex/skills/。用户级安装可将目标目录复制到 ~/.codex/skills/。README 未提供只安装 skills/react-navigation/ 的独立命令。
如何使用这个 Skill?
将 react-navigation 技能目录放入 Codex 可识别的 skills 目录后,重启 Codex;随后在涉及 React Navigation 7 的任务中使用技能,例如:请根据现有项目的导航 API 风格,实现一个带安全区域处理的底部标签导航界面。