用途:该技能用于审查和规划 React Native 功能的结构,覆盖目录布局、导航、深链接、错误边界、渲染安全与代码质量,适用于新功能设计、PR 结构审查、添加深链接或接入导航、隔离崩溃以及合并前质量检查。平台为 iOS 与 Android,React Native 0.76+,默认假设新架构互操作。
主要能力:功能结构方面,要求功能独立放在 src/features/{name}/,禁止跨功能导入(仅通过 shared/ 共享),index.ts 只暴露公开 API,业务逻辑抽到 hooks 与工具,区分 screen、components、hooks。导航与深链接方面,要求屏幕注册时使用类型安全参数,每个可导航屏幕配置深链接,处理冷启动与后台恢复两种生命周期,深链接进入需鉴权屏幕前先检查登录态,优雅处理过期或无效内容,参数视为可选并校验,返回键行为正确,退出登录时重置导航栈。渲染安全方面,条件渲染需正确处理假值,空渲染返回 null 而非 undefined,列表项使用稳定唯一 key。韧性方面,应用根与每个功能各设错误边界,优雅降级,不静默吞错,回退 UI 保持简单。代码质量方面,禁止 any 与无说明的 @ts-ignore,不留 console.log 与注释代码,TODO 需关联工单,props 使用具名接口,文件约 300 行、函数约 50 行以内。
使用方式:按清单逐项检查功能结构与 PR,示例中参数访问应写 route.params?.itemId 并做空值判断,条件渲染用 count > 0,文本用 user?.name ?? 'Guest',根组件用 ErrorBoundary 包裹 Navigator,功能内再包一层。
限制:错误边界只捕获渲染与生命周期错误,不捕获事件处理器或异步错误;深链接冷启动与后台恢复路径不同,均需测试;undefined 在 Android 的 Text 中会崩溃而 iOS 静默通过;用数组索引作 key 会在重排或删除时导致错误重渲染。具体安装命令与收费信息暂未提供。