SuperAPI AI 工具集

hyper-architecture-expo

编程与开发

查看项目

更新于 11-04 21:28

技能介绍

用途

该技能面向使用 React Native、Expo、Expo Router 和 TypeScript 构建 Android 与 iOS 应用的场景,用于搭建、审查或重构可扩展的应用架构。其目标是让路由、功能、数据、原生与平台边界在应用增长过程中保持清晰、可理解、可测试。

主要能力

  • 以 Expo Router 为中心,引导项目在 Expo 托管或 Expo prebuild 模式下建立结构。
  • 要求严格 TypeScript:边界处校验运行时输入,避免 any 与未经检查的类型断言;在 React Native 0.88 下默认使用严格 TypeScript API,不使用 react-native/Libraries/* 深层导入。
  • 按领域/功能组织代码,推荐 src/app 存放路由,业务代码放入 src/features/<domain> 与范围受限的 src/shared/*,避免把所有逻辑堆入全局 components、hooks、utils 或 services。
  • 保持路由文件以组合为主,业务规则和可复用数据访问下沉到功能/应用层。
  • 按所有权与生命周期区分服务端状态、客户端 UI 状态、表单状态与持久化设备状态。
  • 对原生平台差异使用 .ios.ts(x)/.android.ts(x) 或小型适配器显式表达。
  • 对应用配置、权限、密钥、存储、原生工具链与 EAS 相关操作设置安全关口;将 EXPO_PUBLIC_* 视为公开信息,服务端密钥不得打包进客户端。
  • 依据已安装的 Expo SDK 与项目证据验证架构,必要时对照带日期的官方参考(如 SDK 58 对应 react-native 0.88、react 19.3、expo-router 58)。

使用方式

技能按阶段推进:先确认项目事实(Expo SDK、React Native、Router、TypeScript、包管理器、工作区模式、托管/CNG 与已提交 ios/android 目录、路由根目录、别名、项目命令等);再盘点路由、功能、共享模块、状态/数据、原生配置与测试;随后将发现分类为官方事实、安全问题或 Hypercore 约定,制定优先级计划;定义目标边界与最小迁移切片并实施可逆改动;最后运行聚焦检查与项目级检查,并输出包含决策、版本/来源、结果与残余风险的报告。默认用户可见交付物为韩语,代码标识符、命令、路径、包名与 API 名称保持原样。技能采用有界验证-修复循环:每轮变更最多两轮修复,只有关键类型、路由、原生配置与安全关口通过才保留改动。

适用场景

适用于 Expo/React Native/TypeScript 项目的架构搭建、实现、审查或修复,涉及应用配置、目录结构、Expo Router、状态与数据流、原生配置、平台差异、测试或架构审查。对既有项目,除非用户要求迁移或存在安全/正确性问题,应保留其可行约定。

限制

不适用于无 Expo 的裸 React Native、普通 Web React、无架构影响的单一视觉组件、纯部署工作或纯文档总结。运行安装、EAS 构建/更新/提交、签名、商店发布,以及在已提交原生目录上运行 prebuild,均需明确授权。Expo Go 运行成功不能证明开发/独立构建、权限、配置插件或原生模块可用。默认不采用实验性路径(如 Swift Package Manager、experiments.noxcturnalTransformWorker、expo-location/next)。具体项目命令、包版本与原生能力需以本地文件和官方文档为准,资料未提供的内容暂未提供。