用途:为 React Native 和 Expo 应用开发提供一套按优先级组织的最佳实践规则,适用于构建组件、优化列表与滚动性能、用 Reanimated 实现动画、处理图片与媒体、配置原生模块或字体,以及组织含原生依赖的 monorepo 项目。
主要能力:规则按优先级和前缀分类。列表性能(CRITICAL,list-performance-)包括用 FlashList 处理大列表、记忆化列表项组件、稳定回调引用、避免内联样式对象、将函数提取到渲染外、优化列表图片、把昂贵工作移出列表项、用 item types 处理异构列表。动画(HIGH,animation-)包括只动画 transform 和 opacity、用 useDerivedValue 处理计算动画、用 Gesture.Tap 替代 Pressable。导航(HIGH,navigation-)建议用原生 stack 和原生 tabs 替代 JS 导航器。UI 模式(HIGH,ui-)包括用 expo-image、Galeria 图片灯箱、Pressable 替代 TouchableOpacity、处理安全区域、用 contentInset 处理头部、原生上下文菜单与模态、用 onLayout 而非 measure()、用 StyleSheet.create 或 Nativewind。状态管理(MEDIUM,react-state-)包括最小化状态订阅、dispatcher 模式、首渲染回退,以及 React Compiler 相关注意点。渲染(MEDIUM,rendering-)包括文本包裹在 Text 组件中、避免用 falsy && 做条件渲染。Monorepo(MEDIUM,monorepo-)包括原生依赖放在 app 包、跨包统一版本。配置(LOW,fonts-、imports-)包括用 config plugin 配置自定义字体、组织设计系统导入、提升 Intl 对象创建。
使用方式:按需阅读各规则文件(如 rules/list-performance-virtualize.md、rules/animation-gpu-properties.md),每个文件含原因说明、错误与正确代码示例及补充参考;完整指南见 AGENTS.md。
限制:资料未提供安装命令、版本要求、收费或平台支持信息。