react-native-best-practices

react-native-best-practices 技能概览

这个技能是做什么的

react-native-best-practices 技能是一份面向实际项目问题的 React Native 性能优化指南，专门用于诊断和修复真实应用中的慢启动、掉帧、重渲染、内存泄漏和包体过大等问题。它最适合在你需要的不只是一个泛泛提示，而是一个能帮你根据症状选对修复方案的决策型 react-native-best-practices 指南时使用。

适合谁用，适合哪些场景

如果你在做 React Native 或 Expo 应用，并且需要处理 FPS、TTI、Hermes 行为、Bridge 开销、FlashList、原生模块或动画卡顿，那么这个 react-native-best-practices skill 很合适。它也很适合用于排查性能回归、优化 release candidate，或撰写一个聚焦明确的 react-native-best-practices for Performance Optimization 提示词。

它为什么不一样

这个仓库的结构兼顾了快速查找和进一步深挖：有速查模式、配置片段、命令，以及关于 bundle 分析、线程、内存泄漏和原生 profiling 等主题的深入参考。相比松散的提示词，它更可执行，因为它会把 agent 引向具体证据，而不是只给抽象建议。

如何使用 react-native-best-practices 技能

安装并启用

在你的 agent 环境里，按照目录提供的安装流程执行 react-native-best-practices install，然后带着明确说明症状和平台的任务来调用它。仓库默认提示词是：Use $react-native-best-practices to diagnose and improve React Native performance. 如果你的工具链支持按 package 安装 skill，那么仓库路径是 callstackincubator/agent-skills，该 skill 位于 skills/react-native-best-practices。

给技能一个准确的问题描述

好的 react-native-best-practices usage 一定从窄范围目标开始：平台、症状和约束。比如，与其说“提升 app 性能”，不如说“在 Android 上使用 Hermes 的 Reanimated bottom sheet 中降低掉帧”。同时要补充最近改了什么、哪里慢、你已经测过什么。这样技能才能更快把问题映射到正确的参考资料。

先读这些文件

先看 SKILL.md，再检查 POWER.md、agents/openai.yaml，以及与你的问题最相关的参考文件。针对 JS bundle 工作，优先看 references/bundle-analyze-js.md、references/bundle-barrel-exports.md 和 references/bundle-code-splitting.md。针对运行时卡顿或渲染问题，阅读 references/js-measure-fps.md、references/js-profile-react.md 和 references/js-lists-flatlist-flashlist.md。针对原生启动和内存问题，重点查看 references/native-measure-tti.md、references/native-threading-model.md 和 references/native-memory-leaks.md。

把粗糙目标改写成可用提示词

这个技能的高质量提示词应包含：应用类型、RN 版本、平台、指标、复现路径，以及任何 profiler 输出。示例：“审计我们在 iOS 17、RN 0.78、已启用 Hermes 的 React Native app。添加三个重导航页面后 TTI 回退了；请检查 bundle size、启动时 imports 和原生初始化顺序，并给出最小改动集和验证步骤。” 这种写法能帮助 react-native-best-practices usage 产出更聚焦、可验证的结果。

react-native-best-practices 技能常见问题

这只适合性能工作吗？

是的，这正是它的主要适用场景。react-native-best-practices 技能关注的是性能相关问题的诊断和优化，不是通用的应用架构、功能设计或 UI 文案。如果你的任务与延迟、内存、包体大小或渲染成本无关，普通的 React Native 提示词通常就够了。

它能替代日常调试或 profiling 吗？

不能。它可以提升排查质量，但你仍然需要真实信号：profiler trace、bundle 报告、日志和复现步骤。这个 skill 能帮你判断该看什么、哪些权衡更重要，但没有证据，它无法替你推断出应用的真正瓶颈。

对初学者友好吗？

友好，前提是你想要的是一份有引导的 react-native-best-practices guide，而不是一篇理论堆砌的文档。初学者如果先贴出具体症状，再要求一个按优先级排序的检查清单，通常收获最大。高级用户则更能从仓库里的具体参考和优化路径中获益。

什么时候不该用它？

不要把它当作产品决策、后端延迟分析或无关 JavaScript 排错的替代品。如果你只是想快速得到一个不涉及性能背景的代码风格答案，它也不合适。此时使用它只会增加流程成本，却不会提高结果质量。

如何改进 react-native-best-practices 技能

先说可测量的症状

最好的输出来自明确说明“坏了什么、发生在哪里、你是怎么知道的”这类输入。可以这样说：“在加入 analytics SDK 初始化后，启动时间增加了 1.8s。”或者“一个有 200 行和图片缩略图的 FlashList 在滚动时卡顿。”症状越具体，react-native-best-practices for Performance Optimization 就越能缩小搜索范围。

补充环境约束

说明你是否使用 Hermes、Expo、Reanimated、Fabric、Turbo Modules，或自定义原生栈。也要提到版本限制，比如 RN 0.78 和 0.79+，因为不同版本的建议可能会变化。这会直接影响安装决策、启动行为，以及某个修复是否值得增加复杂度。

要求给出有证据支撑的修复方案

不要只要点子，也要验证步骤。比如可以要求：“对每条建议，请说明应该改善哪个指标、如何验证，以及要注意哪些回归风险。”这样能减少空泛建议，也更容易把输出直接转成工单或 PR 计划。

从第一轮答案继续迭代

如果第一次结果太宽泛，就继续补充 profiler trace、bundle analyzer 输出，或者一段最小代码样例。然后让技能按可能性排序，并区分高影响改动和低风险清理项。react-native-best-practices 最有价值的地方就在这种迭代中：它能把模糊直觉转成具体的优化计划。