Skip to content

参考

基于 software-mansion-labs/skills README 与 skills/ 目录编写。

速查

  • /plugin marketplace add software-mansion-labs/skills/plugin install skills@swmansion/reload-plugins;或 npx skills add software-mansion-labs/skills
  • 更新/plugin marketplace update swmansion
  • skillsreact-native-best-practices(8 子主题)· fishjam · detour · radon-mcp · rnrepo · expo-horizon · typegpu
  • 动画分层:CSS 过渡 → CSS 动画 → shared value → Skia canvas → GPU shader → layout
  • Reanimated 4runOnJS 已删 → scheduleOnRN(来自 react-native-worklets
  • 加载模型:顶层 SKILL.md = 目录,reference 按需加载
  • 许可:README + 多个 SKILL.md 标 MIT,仓库根无独立 LICENSE 文件

skills 清单全表

Skill触发词(节选)覆盖
react-native-best-practicesReact Native / Expo / Reanimated / Gesture Handler / 任何 RN 代码任务顶层目录,路由到 8 个子主题
animationsuseSharedValue / withTiming / Skia / WebGPU / 动画CSS 过渡·动画、shared value、canvas、GPU shader、layout、120fps
gesturesGestureDetector / pan / pinch / swipe / dragGesture Handler,v2 builder / v3 hook API
svgreact-native-svg / SVG / 图标 / 图表React Native SVG + 选型对照
on-device-aiExecuTorch / useLLM / OCR / 端侧 AI端侧 LLM / 视觉 / 语音 / embeddings
rich-textreact-native-enriched / 富文本 / Markdown富文本编辑器 + Markdown 渲染
multithreadingworklet / scheduleOnUI / 后台线程react-native-worklets 三 runtime
audioreact-native-audio-api / AudioContext / 录音播放 / 录音 / 音效 / 分析 / worklet
jsijsi::Runtime / HostObject / TurboModule / NitroC++ ↔ JS 引擎边界
fishjamFishjam / WebRTC / room / peer / livestreamhosted 实时音视频,4 SDK
detourDetour / deferred deep link / Branch / AppsFlyer延迟深链 SDK(onboarding + migrate)
radon-mcpRadon IDE / view_screenshot / app logsRadon IDE MCP 工具调试
rnrepoRNRepo / slow builds / prebuilt artifacts预构建产物提速约 2×(beta)
expo-horizonMeta Quest / Horizon OS / expo-horizon-core迁移 Expo 应用到 Meta Quest
typegpuTypeGPU / WebGPU / WGSL / GPU shader类型化 GPU 管线

动画方式对照(animations 子主题)

方式用什么库 / API典型场景
CSS 过渡 / CSS 动画Reanimated 4 CSS-like API简单属性过渡、循环动画
shared value 动画useSharedValue + useAnimatedStyle + withTiming/withSpring/withDecay命令式、手势联动交互
canvas 动画@shopify/react-native-skiausePathValue / SKSL / Atlas)复杂 2D 绘制、路径、粒子、精灵
GPU shader 动画react-native-wgpu + TypeGPU(@typegpu/noise@typegpu/sdfWGSL 计算管线、仿真、3D
layout 动画FadeIn / LinearTransition / keyframes / itemLayoutAnimation进入退出、布局变化、列表项、共享元素
scroll-drivenuseAnimatedScrollHandler / useScrollOffset / scrollTo滚动驱动动画

安装与更新

text
# 作为插件(推荐)
/plugin marketplace add software-mansion-labs/skills
/plugin install skills@swmansion
/reload-plugins

# 更新到最新版
/plugin marketplace update swmansion
bash
# 通过开放 skills CLI(可进 Claude Code / Cursor / Codex)
npx skills add software-mansion-labs/skills

Reanimated 4 与 worklets 关键点

旧(弃用)新(Reanimated 4 / worklets)
调 RN 线程函数runOnJS(fn)(...args)scheduleOnRN(fn, ...args)
调 UI 线程runOnUIscheduleOnUI
调 Worker runtimerunOnRuntimescheduleOnRuntime
手势库低层触摸PanResponder(JS 线程)Gesture Handler(UI 线程)
  • worklet 函数体首行加 'worklet';;传给调度 API 的内联回调由 Babel 插件自动 workletize
  • runtime 间不共享内存,跨界靠序列化(不可变拷贝)或 Synchronizable(共享可变)
  • react-native-worklets 是 Reanimated / Gesture Handler / Skia 的共同底层

各 skill 的关键约束速记

Skill硬约束
animationsrunOnJS 已删;worklet 里调 JS 用 scheduleOnRN
gesturesGestureHandlerRootView 必须在根;别用 PanResponder;别混 RN 触摸与 RNGH
audioAudioContext / AudioRecorder 单例;空闲 suspend();参数变化用 AudioParam 调度
on-device-aiinitExecutorch + adapter;查 isReady;用 _QUANTIZED;STT 16kHz/TTS 24kHz;需新架构
jsi单线程规则;Value 不可拷贝用 shared_ptr;零拷贝 ArrayBufferMutableBuffer
fishjammanagement token 不出后端;peer token 24h;Sandbox URL 不进生产客户端
detour概率匹配默认 850 分 / 15 分钟窗;不路由敏感数据
rnrepobeta、仅新架构;原生 patch 的库要 denyListDISABLE_RNREPO=1 关闭
expo-horizon先装 expo-horizon-core;别自动装 location/notifications;Quest 无 GPS;改配置后 expo prebuild --clean

许可

  • README 底部标 ## License MITreact-native-best-practices / fishjam / rnrepo 等多个 SKILL.md frontmatter 也写 license: MIT
  • 但截至本次核查,仓库根目录无独立 LICENSE 文件——严格意义上属「文档中声明 MIT、无标准 LICENSE 文件」。引用 / 分发前建议以仓库最新状态自行确认。

资源链接