用途
该技能用于快速将 React Native / Expo 项目中的错误、红屏、崩溃、卡死和构建失败转换为经过验证的修复方案，覆盖 iOS 和 Android 两个平台。
主要能力
- 内置约 460 条已知失败条目，每条包含症状、原因、修复方法、状态、平台和负责该修复流程的技能。
- 提供查找工具
find-fix.mjs，可按首行错误文本、日志文件、条目 id 或平台进行查询。 - 提供陷阱扫描工具
check-known-pitfalls.mjs，在首次设备构建、发布、依赖或 SDK 升级前扫描仓库中可见的已知失败。 - 目录按区域组织，包括构建、iOS、Android、发布、依赖、lint、测试、E2E、动画、国际化、服务、状态、质量门、性能、视觉一致性、技能、游戏和运行时等。
- 支持将新解决的失败记录到目录并验证。
使用方式
- 捕获首行错误信息、产生错误的命令和平台。
- 在仓库根目录运行
node ${CLAUDE_SKILL_DIR}/scripts/find-fix.mjs . --text "<首行错误>"进行查找。 - 根据匹配结果采取行动：仅
MATCH行是诊断；MATCH?行需确认症状；标记为需人工的条目应暂停并发送一条消息等待。 - 若匹配条目指定了某个技能，则加载该技能并按流程修复；否则直接应用修复。
- 修复后重新运行失败命令，再运行该区域的质量门。
- 将新失败记录到目录并运行验证脚本。
适用场景
- React Native / Expo 项目开发中的错误诊断与修复。
- 构建失败、Xcode / Gradle 问题、模拟器或仿真器异常。
- 发布签名、商店上传失败。
- 依赖安装与升级问题。
- Jest 测试、Maestro E2E 流程失败。
- 动画、Skia、手势、国际化、RTL、广告、购买、音频、隐私、状态管理、导航、性能与可访问性等问题。
限制
- 仅覆盖目录中已知的失败类型，未知失败需按诊断循环处理。
- 部分条目标记为需人工介入（如钥匙串、协议、许可证、401/403、签名密钥等），必须暂停等待。
- 版本相关事实以
node_modules/中安装的源码为准，训练数据可能过时。 - 修复必须针对根因，禁止放宽检查、跳过测试或删除证据。
- 一次只改一处，三次假设失败后应停止并报告。
- 不得销毁证据或其他会话状态来“重新开始”。
版本与平台
资料提及 React Native 0.86、Expo SDK 57，以及 Xcode、Gradle、Jest、Metro、EAS、Maestro 等工具链，覆盖 iOS 和 Android。具体安装命令、收费信息等资料未提供。