| description | 创建或初始化 React Native 应用前使用。适用于用户要求新建 RN App、选择 Expo 或 React Native Community CLI、判断 New Architecture 或 Legacy Architecture、配置 Android/iOS 原生工程、接入原生模块、从 0.74 到 0.85 选择版本时；若用户没有明确目标架构和平台范围，必须先询问，禁止直接创建项目。 版本要求: React Native 0.74-0.85, legacy versions before 0.74。环境要求: Expo, React Native Community CLI, Android, iOS, New Architecture, Legacy Architecture。 |
| metadata | {"env":"Expo, React Native Community CLI, Android, iOS, New Architecture, Legacy Architecture","version":"React Native 0.74-0.85, legacy versions before 0.74"} |
| name | rn-create-app |
Pre Requirement(必读)
当要求不符合时，禁止使用该 Skill。
- 版本要求: React Native 0.74-0.85, legacy versions before 0.74
- 环境要求: Expo, React Native Community CLI, Android, iOS, New Architecture, Legacy Architecture
Rn Create App
Overview
在创建 React Native 应用前，先确认初始化路径、架构、版本和平台边界；信息不全时不要直接执行创建命令。
When To Invoke
- 用户要求“创建 React Native 应用”“初始化 RN 项目”“搭一个 RN App”。
- 用户需要在 Expo、React Native Community CLI、已有 Android/iOS 原生 App 集成 RN 之间做选择。
- 用户提到 RN 版本、新架构、旧架构、Bridgeless、TurboModule、Fabric 或原生模块。
Stop Rule
缺少以下信息时先读取项目根目录 .hyar/ARCH_CONTEXT.md；已有同一前置项答案时直接复用。仍缺信息时先问，不要创建：
- 初始化路径：Expo managed/CNG、React Native Community CLI 新项目、还是已有 Android/iOS 原生 App 集成 RN。
- 架构目标：New Architecture、Legacy Architecture，或“必须兼容某个旧 RN/旧原生模块”。
- 目标版本：最新稳定版、指定版本，还是历史兼容版本。
- 平台范围：Android、iOS、双端，是否需要真机能力或只需模拟器。
- 包管理器：RN 项目默认使用
yarn，除非目标模板或用户明确要求 npm、pnpm 或 Expo 默认命令。
Pre-Question Best Practice
每个前置问题都必须提供“最佳实践”选项。默认值按最小化、最新技术、通用技术排序：
- 初始化路径：默认使用 React Native Community CLI 新项目；如果需求明确可由 Expo managed/CNG 覆盖，再切换 Expo。
- 架构目标：默认 New Architecture；只有旧 SDK、旧模块或历史版本兼容要求明确时才选 Legacy。
- 目标版本：默认最新稳定 React Native 版本；只有已有项目或依赖矩阵要求时才锁历史版本。
- 平台范围：默认 Android + iOS 双端最小可运行 App；真机能力仅在用户需求涉及硬件、账号、推送或平台 SDK 时纳入。
- 包管理器：默认
yarn，遵循 RN 项目约定；已有 lockfile 或 Expo 模板命令时跟随项目事实。
用户回答任一前置问题后，使用 arch-context-collect 记录问题描述、前置项名称、用户回答、适用 Skill 和更新时间。
Workflow
- 读取现有项目事实：
package.json、react-native.config.js、android/gradle.properties、Gradle 文件、ios/Podfile。
- 需要版本判断时读取
references/rn-version-architecture.md。
- 路径选择：
- Expo managed/CNG：适合 Expo SDK、config plugins、development build 能覆盖的 App。
- Community CLI：适合直接维护
android/、ios/、Gradle、CocoaPods、原生 SDK 的 App。
- 既有原生 App 集成 RN：先设计宿主集成、Bundle、导航和发布链路，不走普通
init。
- 版本策略：
- RN
0.76+ 新项目默认按 New Architecture 处理；旧架构必须有明确兼容原因。
- RN
0.74-0.75 先确认 newArchEnabled。
- RN
<0.74 默认按历史/Legacy 兼容任务处理。
- 创建命令：
- Expo:
npx create-expo-app@latest MyApp
- Expo prebuild:
npx expo prebuild
- Community CLI:
npx @react-native-community/cli@latest init MyApp --version latest
- 指定版本:
npx @react-native-community/cli@latest init MyApp --version 0.85.0
- 验收：依赖安装成功；Android debug 构建或 Gradle model 检查通过；iOS
pod install 和 Debug 构建通过；自定义原生能力不能只用 Expo Go 验收。
Anti-Patterns
- 用户没有明确架构时直接运行
create-expo-app 或 react-native init。
- 把 Expo、Expo Go、prebuild、development build 混为同一种运行方式。
- 在 RN 0.76+ 中默认按旧桥写新模块，却没有记录 Legacy 兼容原因。
- 在 RN 0.74-0.75 中假设新架构必然默认启用。
- 在已有原生宿主项目中直接创建一个独立 RN App，然后让用户手动迁移。
References
references/rn-version-architecture.md：当涉及 RN 0.74-0.85、0.85 之前版本、Expo/CLI/native module 差异时读取。
