SuperAPI AI 工具集

expo-architecture

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:在 Expo 托管或 Expo prebuild 项目(面向 Android 与 iOS)中进行架构搭建、实现、审查与整改。适用于 Expo/React Native/TypeScript 的应用初始化、目录结构、Expo Router、状态与数据流、原生配置、平台差异、测试和架构评审;不适用于无 Expo 的裸 React Native、普通 Web React、无架构影响的单组件、纯部署工作或仅文档摘要。棕地项目默认保留现有可用约定,除非用户要求迁移或存在安全/正确性问题。

主要能力:围绕 Expo Router 引导或重构应用,保持路由文件精简;按领域/特性组织代码而非全局技术分类桶;以显式门控保护密钥、权限、原生配置、存储与 Android/iOS 差异;在应用当前官方指导前先依据已安装的 Expo SDK 与项目证据进行验证。

使用方式:先依据 package.json、应用配置、路由入口、TypeScript/Metro/Babel 配置、原生目录、现有源码/测试与锁文件确认 Expo SDK、React Native、Expo Router、TypeScript、包管理器、工作区模式,以及托管/CNG、是否提交 ios/ 或 android/、开发构建或 Expo Go 约束。随后按支持文件顺序阅读 architecture-rules.md,再按受影响主题阅读 project-structure.md、routing-and-navigation.md、data-state-and-boundaries.md、native-platform-and-security.md、testing-and-validation.md;仅当当前 SDK/API 行为影响决策时阅读带日期的官方参考。工作流程为:确认范围与副作用门控、盘点架构、分类发现为 Official/Safety/Hypercore 约定、定义目标边界与最小迁移切片、实现可逆变更、运行聚焦与项目级检查、以韩语报告决策与残余风险。倾向在 src/app 放置路由,非路由代码放在其外,按 src/features/<domain> 与范围有限的 src/shared/* 组织,避免全局 components/hooks/utils/services 桶。保持 TypeScript 严格模式,在边界验证不可信运行时数据,避免 any 与非受检类型断言。按所有权与生命周期分离服务端状态、客户端 UI 状态、表单状态与持久化设备状态。EXPO_PUBLIC_* 视为公开;小密钥仅存于平台安全存储,绝不打包服务端密钥。平台差异用 .ios.ts(x)/.android.ts(x) 或小型适配器显式表达。使用已安装 SDK 与 expo install 兼容性,而非猜测版本。

限制:未经明确授权,不得执行包安装、prebuild --clean、EAS 构建/更新/提交、签名或商店发布;不得编造项目命令、包、原生能力、API 契约或环境变量;不得套用未检查项目规模与既有约定的通用文件夹模板;不得让领域特性导入路由文件、让 UI 导入基础设施内部或使用造成循环的宽泛 barrel 文件;不得将密钥放入源码、应用配置 extra、EXPO_PUBLIC_*、日志、AsyncStorage 或客户端包;不得把 Expo Go 成功当作开发/独立构建、权限、配置插件或原生模块可用的证明;不得进行无已验证增量边界的无限重构或迁移。验证修复循环有界,仅修复观察到的失败,最多两轮。完成条件:项目模式与 SDK 已识别、适用的关键门控通过、变更已验证且残余风险已记录;若缺少授权、存在不安全原生效用、包不兼容未解决或必要验证不可用,则阻塞。输出面向用户的交付物、报告、计划、交接说明与验证说明默认使用韩语,代码标识符、命令、路径、schema 键、包名、API 名与来源摘录保留其所需语言。资料未提供具体价格、收费或平台支持范围等信息。