技能介绍

为什么移动端工作不能套通用 Web 流程

移动端开发有一堆独属坑位：RN 构建时平台工具链（Android/iOS/Expo）的依赖冲突、版本升级时的 breaking changes、CI 流程里移动端签名/构建缓存问题、排障时混淆平台层错误（比如 iOS 的 CocoaPods 与 Android 的 Gradle 问题）。通用编码助手常把移动端当 Web 项目处理，给出不符合平台特性的建议，反而浪费时间。

技能如何解决：聚焦 RN 工作流的结构化指导

构建与初始化：针对 RN 项目的平台差异，提供 Android（Gradle 配置、SDK 版本对齐）、iOS（CocoaPods 安装、Xcode 证书）、Expo（EAS 构建流程）的构建排查路径。
版本升级：覆盖 RN 跨版本升级时的关键检查点，比如依赖兼容性、平台 API 变化、第三方库适配建议。
CI 集成：指导配置 GitHub Actions 处理移动端特有的构建步骤，比如 iOS 的 xcodebuild 签名参数、Android 的 ./gradlew 任务链、缓存策略优化。
故障排除：针对 RN 常见错误（如白屏、原生模块报错、性能卡顿）提供分层排查思路，区分 JavaScript 层与原生层问题。

适用边界与注意点

该技能需要React Native 项目作为载体，且需提前安装对应平台工具链（如 Xcode、Android SDK、Expo CLI）。适合配合兼容 Agent Skills 的编码助手（如 Claude Code、Codex、Cursor）使用，聚焦「指导工作流」而非替代工具链本身——复杂原生代码修改仍需人工确认。