building-react-native-application

React Native 应用

设置

项目	类型	必需	适用时机	完成条件	方法
Node.js 22.12+	用户	必需	全部	node --version 报告版本为 22.12 或更高	https://nodejs.org
固定规则	自动	必需	创建新应用脚手架	根目录 AGENTS.md 中包含此行	将 - `<target_path>` follows building-react-native-application; load it before changing code there. 添加到根目录 AGENTS.md（若不存在则创建），并添加到根目录 CLAUDE.md（若存在且未导入 AGENTS.md）；若文件中已有此行则跳过

工作流

1. 设置 — 按顺序处理适用时机涵盖此请求的每一行 设置：若满足完成条件 → 跳过；若为 user → 必需时停止并打印其方法，若可选则不提供也继续；若为 ask → 填写请求中已回答的内容，在一条消息中询问其余内容，并记录每个答案；若为 auto 和 static → 执行。
2. 契约 — 阅读 native-app-contract.md。
3. 配方 — 匹配一行 配方；打开其“阅读”列中的所有文档。

• 跨越多行的请求（例如创建带表单的新屏幕）需匹配每一行。

使用指南

意图	示例说法	阅读
设置	"设置 building-react-native-application"，"building-react-native-application 准备好了吗？"	设置 — 对每一行运行工作流步骤 1，然后报告每一行的状态
搭建脚手架	"在 apps/mobile 中创建 Expo 应用"，"在此处搭建脚手架"，"为应用添加 lint 和环境变量处理"	scaffolding-application.md、managing-package-installs.md、setting-up-nativewind.md、managing-environment.md、managing-linting.md
结构	"这个模块应该放在哪里？"，"两个功能需要用到这个 hook"，"把这个组件移到正确的层级"	managing-project-structure.md、managing-linting.md
屏幕 / 功能	"添加设置屏幕"，"新增订单功能"，"自定义标签栏"，"从链接打开此屏幕"	managing-project-structure.md、creating-screen.md
UI 基础组件	"在 src/ui 中添加 Dialog"，"根据规格构建 select"	managing-project-structure.md、creating-ui-component.md、managing-styling.md
数据	"从 API 获取订单"，"为结账添加 mutation"，"格式化订单日期"	managing-data.md、managing-environment.md
异步 UI 状态	"显示带有加载和错误状态的订单列表"，"添加下拉刷新"	creating-async-component.md、managing-data.md
错误 / 反馈	"保存失败时显示 toast"，"报告崩溃"，"处理未知链接"	managing-errors.md、managing-data.md
表单 / 多步骤	"添加个人资料表单"，"将结账设计为三步表单"	creating-form.md、managing-data.md
样式 / 主题	"应用设计令牌"，"更改品牌颜色"，"添加深色模式"，"覆盖 className"	managing-styling.md
身份验证	"添加登录流程"，"在 API 调用中附加令牌"，"遇到 401 时退出登录"	setting-up-authentication.md、managing-data.md
身份验证守卫	"保护账户屏幕"，"登录后要求完成个人资料设置"，"添加邀请链接"，"限制只有成员才能访问团队屏幕"	setting-up-auth-guard.md、setting-up-authentication.md、creating-screen.md
平台修复	"键盘遮住了输入框"，"标题栏后方出现白色闪屏"，"保持启动画面，直到字体加载完成"，"将 Inter 用作正文字体"	managing-platform-fixes.md